{"uid":"cap_kvgIJRAnjfbqI0-FgN9Pf","slug":"who-bought-or-sold-a-token-7871fdd8","name":"Who Bought or Sold a Token","description":"Who bought and who sold a token in the last hours: buy and sell count and USD volume, net flow, buy/sell ratio, the top buyer and seller wallets with net USD, and the largest trades, read from the swap events of its biggest DEX pools (Uniswap v2/v3 style, Aerodrome, Velodrome, PancakeSwap, Trader Joe and more) on Base, Ethereum, BSC, Arbitrum, Polygon, Avalanche or Optimism. Flags one-sided selling and a single wallet dumping. For trading agents before or after a buy. Window 1 to 24 hours.","url":"https://agentsvc.io/api/v1/proxy/token-flows?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"base, ethereum, bsc, arbitrum, polygon, avalanche or optimism. Default base"},"hours":{"type":"number","default":6,"description":"Window in hours, 1 to 24 (shortened on very fast chains)"},"token":{"type":"string","description":"Token contract address"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KMmMhRN36xl-py_k8wl7S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes DEX swap events for a token over 1–24 hours to return buy/sell counts, USD volumes, net flow, top wallets, and largest trades across 7 major EVM chains.","exampleAgentPrompt":"Before I buy this token, check who's been buying and selling it on Base over the last 6 hours — I need to know the buy/sell ratio, net flow, and whether any single wallet has been dumping. The token address is 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed.","exampleUseCases":[{"title":"Pre-buy due diligence on new token","prompt":"I'm thinking about buying this token on Base — can you pull the last 6 hours of buy and sell activity for 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed and tell me if there's heavy selling pressure or any whale dumping?"},{"title":"Detect whale dumping after launch","prompt":"Check the last 2 hours of trading for token 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E on Avalanche — I want to know if a single wallet is responsible for most of the sells and what the net flow looks like."},{"title":"Post-buy monitoring for exit signals","prompt":"I just bought a token on Arbitrum at 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 — monitor the last 12 hours of swap activity and flag if one-sided selling starts or if the sell volume in USD is overtaking buys."}],"resultDescription":"Returns buy and sell counts, total USD buy/sell volume, net flow (buy minus sell USD), buy/sell ratio, flags for one-sided selling and single-wallet dumping, ranked list of top buyer and seller wallet addresses with their net USD traded, and the largest individual trades observed from DEX swap events.","failureModes":["Invalid or unrecognized token contract address returns an error or empty result","Token has no DEX pools on the specified chain — no swap data available","Hours parameter outside 1–24 range is rejected or clamped","Unsupported chain name returns a validation error","Very new tokens with insufficient swap history may return sparse or zero data","Payment failure (insufficient USDC balance) blocks the request"],"whenToPreferThis":"Choose this endpoint when you need granular, on-chain buy/sell flow analytics for a specific token on a major EVM chain — especially when evaluating dump risk, whale activity, or net trading pressure before or after a trade. Prefer this over generic price APIs when you need wallet-level detail and DEX-sourced swap event data across Uniswap v2/v3-style and other DEX protocols.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:39:29.430Z","isFirstParty":false,"canonicalSlug":"who-bought-or-sold-a-token-7871fdd8"}