{"uid":"cap_nKiGW0XEAVLf3Z3Q8ulXH","slug":"kair-os-trade-smart-money-flow-fb8e0c60","name":"kair-os.trade Smart Money Flow","description":"Base token flow evidence: recent sampled swaps in one authenticated direct USDC Uniswap V3 pool, exact transfer counterparties and nominal USDC flows. At most 1800 blocks and eight transactions. Historical PnL, winning-wallet qualification and qualified smart-money net flow are unknown; this version does not rank winning wallets.","url":"https://kair-os.trade/smart-money/flow?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"fenetre":{"enum":["1h","24h","7d"],"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_G-jbMQpva26oqRrNBIg_4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent USDC token transfer flows for a Base token across sampled Uniswap V3 pool swaps, showing exact counterparties and nominal USDC amounts within a configurable time window.","exampleAgentPrompt":"Show me the smart money USDC flow for the Base token at 0x4200000000000000000000000000000000000006 over the last 24 hours — I want to see recent swap counterparties and how much USDC is moving.","exampleUseCases":[{"title":"Spotting early accumulation of a new token","prompt":"Pull the last hour of USDC flow for the Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to see which wallets have been buying and how much USDC they're putting in."},{"title":"Checking if smart money is exiting a position","prompt":"Give me the 24-hour USDC swap flow for Base token 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — I need to see if there are large USDC outflows suggesting smart money is selling."},{"title":"Validating token activity before investing","prompt":"Before I buy this token, can you check the 7-day Uniswap V3 USDC flow for 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefd2 on Base and tell me who the main counterparties have been?"}],"resultDescription":"Returns a list of up to 8 recent sampled swap transactions from a single authenticated Uniswap V3 USDC pool on Base, covering at most 1800 blocks. Each entry includes exact transfer counterparty addresses and nominal USDC flow amounts. Does not include historical PnL, wallet rankings, or smart-money qualification scores.","failureModes":["Invalid token address format returns a schema validation error","Token has no active USDC Uniswap V3 pool on Base — returns empty or error","Time window enum value not in {1h, 24h, 7d} causes request rejection","No transactions found within the sampled block range — empty result set","Payment authentication failure (x402) if USDC payment is not attached correctly"],"whenToPreferThis":"Use this endpoint when you need raw, evidence-based on-chain swap data for a specific Base token — particularly the exact wallet counterparties and USDC amounts from recent Uniswap V3 pool transactions. It is best suited for short-window, real-time flow observation rather than historical PnL ranking or multi-pool aggregation. Choose this over higher-level analytics services when you need the underlying transfer-level data and are willing to do your own wallet qualification or scoring downstream.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:31:45.204Z","isFirstParty":false,"canonicalSlug":"kair-os-trade-smart-money-flow-fb8e0c60"}