{"uid":"cap_IvIjKhMFhVpjp16vElFDd","slug":"agent-data-tools-revmesh2074-workers-dev-token-buyers-and-sellers-0853cda4","name":"Token Buyers and Sellers","description":"Token buyers and sellers. Who bought and who sold a token lately: the wallets that took the most of an ERC-20 from DEX pools and routers (buyers) or sent the most to them (sellers) over recent blocks, from its live Transfer logs on Base (default), Ethereum, Arbitrum, Optimism or Polygon, with bought, sold, net and transfers. Contracts are left out; plain wallet-to-wallet moves only count in netAll. Use to see who accumulates or dumps a token before you trade it.","url":"https://agent-data-tools.revmesh2074.workers.dev/token/buyers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"chain":{"type":"string","examples":["base"],"description":"base (default), ethereum, arbitrum, optimism or polygon"},"limit":{"type":"integer","examples":[10],"description":"Buyers and sellers to return each, 1 to 20 (default 10)"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0x940181a94A35A4569E4529A3CDfB74e38FD98631"],"description":"Token: 0x ERC-20 address, or a ticker such as AERO, DEGEN or USDC"},"blocks":{"type":"integer","examples":[1800],"description":"How many recent blocks to read, 100 to 10000 (default 1800: about an hour on Base, 6 hours on Ethereum)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"note":{"type":"string"},"chain":{"type":"string"},"token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"number"}}},"buyers":{"type":"array","items":{"type":"object","properties":{"sold":{"type":"string"},"bought":{"type":"string"},"netAll":{"type":"string"},"address":{"type":"string"},"netViaDex":{"type":"string"},"transfers":{"type":"number"}}}},"sellers":{"type":"array","items":{"type":"object","properties":{"sold":{"type":"string"},"bought":{"type":"string"},"netAll":{"type":"string"},"address":{"type":"string"},"netViaDex":{"type":"string"},"transfers":{"type":"number"}}}},"toBlock":{"type":"number"},"fromBlock":{"type":"number"},"truncated":{"type":"boolean"},"transfersRead":{"type":"number"},"dexContractsSeen":{"type":"number"}}}}}}},"responseSchema":{"type":"object","properties":{"note":{"type":"string"},"chain":{"type":"string"},"token":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"number"}}},"buyers":{"type":"array","items":{"type":"object","properties":{"sold":{"type":"string"},"bought":{"type":"string"},"netAll":{"type":"string"},"address":{"type":"string"},"netViaDex":{"type":"string"},"transfers":{"type":"number"}}}},"sellers":{"type":"array","items":{"type":"object","properties":{"sold":{"type":"string"},"bought":{"type":"string"},"netAll":{"type":"string"},"address":{"type":"string"},"netViaDex":{"type":"string"},"transfers":{"type":"number"}}}},"toBlock":{"type":"number"},"fromBlock":{"type":"number"},"truncated":{"type":"boolean"},"transfersRead":{"type":"number"},"dexContractsSeen":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KPt3JPs695YtiRQV4B9uF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns the top wallet buyers and sellers of an ERC-20 token over recent blocks by analyzing DEX Transfer logs on Base, Ethereum, Arbitrum, Optimism, or Polygon.","exampleAgentPrompt":"Who are the top 10 buyers and sellers of AERO on Base over the last 1800 blocks? I want to see which wallets are accumulating versus dumping before I decide to trade.","exampleUseCases":[{"title":"Pre-trade whale accumulation check","prompt":"Before I buy into DEGEN, can you show me who the top 10 buyers and sellers have been on Base over the last hour? I want to see if any big wallets are quietly accumulating or dumping."},{"title":"Dump risk detection for a token","prompt":"I'm holding this token at 0x4200000000000000000000000000000000000006 on Optimism — can you check the last 3000 blocks and tell me if any wallets have been selling large amounts? Show me the top 10 sellers."},{"title":"Ethereum whale activity monitoring","prompt":"Show me the top 5 buyers and top 5 sellers of USDC on Ethereum over the last 500 blocks — I want to know which wallets are moving the most through DEX pools right now."}],"resultDescription":"Returns two ranked lists (buyers and sellers) of wallet addresses with their bought amount, sold amount, net DEX position, net all-transfers position, and transfer count. Also includes token metadata (symbol, address, decimals), the block range scanned, total transfers read, number of DEX contracts seen, and a truncated flag if results were cut off.","failureModes":["Unknown or unresolvable ticker symbol returns an error or empty result","Token address not found on the specified chain","Block range outside 100–10000 returns a validation error","Limit outside 1–20 returns a validation error","Chain name not in supported list returns an error","Very new tokens with few transfers may return sparse or empty buyer/seller lists","Rate-limited or congested RPC may cause timeouts for large block ranges"],"whenToPreferThis":"Use this endpoint when you need on-chain evidence of who is actually buying or selling an ERC-20 token through DEX pools in near real-time, across Base, Ethereum, Arbitrum, Optimism, or Polygon. It is especially useful for pre-trade due diligence, whale tracking, dump detection, or spotting accumulation patterns. Prefer it over price-only APIs when wallet-level behavior matters, and over portfolio APIs when you want market-wide buyer/seller flow rather than a single wallet's history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-06T06:35:54.363Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-token-buyers-and-sellers-0853cda4"}