# Token Buyers and Sellers > Token Buyers and Sellers is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-06). 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. ## Facts - Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/token/buyers?utm_source=zero.xyz - Price: $0.01/call - Payment: x402 - Status: unknown - Last checked: 2026-11-06 - Activations on Zero: 0 - Provider: agent-data-tools.revmesh2074.workers.dev - Website: https://agent-data-tools.revmesh2074.workers.dev - Tags: x402 - Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-token-buyers-and-sellers-0853cda4 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IvIjKhMFhVpjp16vElFDd Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agent-data-tools-revmesh2074-workers-dev-token-buyers-and-sellers-0853cda4 ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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 … (truncated) ``` ## Response schema (JSON Schema) ```json { "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" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-token-buyers-and-sellers-0853cda4/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)