Token buyers and sellers API

From $0.01 per successful call · failed calls are never charged · no account needed · Markdown version: /guides/token-buyers-and-sellers-api.md

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.

Token buyers and sellers $0.01

Inputs: token (required): Token: 0x ERC-20 address, or a ticker such as AERO, DEGEN or USDC; chain: base (default), ethereum, arbitrum, optimism or polygon; blocks: How many recent blocks to read, 100 to 10000 (default 1800: about an hour on Base, 6 hours on Ethereum); limit: Buyers and sellers to return each, 1 to 20 (default 10).

Free first (25 successful calls per caller, no key):

curl "https://agent-data-tools.revmesh2074.workers.dev/token/buyers?token=0x940181a94A35A4569E4529A3CDfB74e38FD98631&trial=1"

With a card key from /credits, in a header or, when your client can only fetch a URL, in the URL:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/token/buyers?token=0x940181a94A35A4569E4529A3CDfB74e38FD98631"
curl "https://agent-data-tools.revmesh2074.workers.dev/token/buyers?token=0x940181a94A35A4569E4529A3CDfB74e38FD98631&api_key=adt_…"

Without a key the same URL answers 402 Payment Required with x402 and MPP terms, so a wallet client pays USDC per call and retries. Over MCP (https://agent-data-tools.revmesh2074.workers.dev/mcp) this tool is token_buyers.

Example result

{
  "chain": "Base",
  "token": {
    "address": "0x940181a94A35A4569E4529A3CDfB74e38FD98631",
    "symbol": "AERO",
    "decimals": 18
  },
  "fromBlock": 37001200,
  "toBlock": 37002999,
  "transfersRead": 1840,
  "truncated": false,
  "dexContractsSeen": 12,
  "buyers": [
    {
      "address": "0x3333333333333333333333333333333333333333",
      "bought": "15230.5",
      "sold": "0",
      "netViaDex": "15230.5",
      "netAll": "15230.5",
      "transfers": 4
    }
  ],
  "sellers": [
    {
      "address": "0x4444444444444444444444444444444444444444",
      "bought": "0",
      "sold": "8800",
      "netViaDex": "-8800",
      "netAll": "-8800",
      "transfers": 2
    }
  ],
  "note": "Bought and sold count transfers from and to DEX pools, routers and other busy contracts; netAll includes plain wallet-to-wallet moves. Contracts are left out of the lists."
}

Tool page, inputs and limits

Trending tokens, Base DEX $0.01

Trending tokens on Base now: the tokens with the most DEX swaps in the last minutes (default 5, up to 10), counted live from Uniswap v2/v3, Aerodrome and Slipstream Swap events, with swaps, pools, share of swaps, symbol, name and busiest pool. Majors (WETH, USDC, cbBTC, stables) are left out unless asked; symbolClash marks copied symbols, so match by address. Use to spot what traders buy now; check token_report before trading.

Inputs: blocks: How many recent Base blocks to count, 30 to 300 (default 150, about 5 minutes; a block every 2 s); limit: Most tokens to return, 1 to 25 (default 15); majors: include to keep WETH, USDC, cbBTC and stables in the list (default: left out).

Free first (25 successful calls per caller, no key):

curl "https://agent-data-tools.revmesh2074.workers.dev/dex/trending?blocks=150&trial=1"

With a card key from /credits, in a header or, when your client can only fetch a URL, in the URL:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/dex/trending?blocks=150"
curl "https://agent-data-tools.revmesh2074.workers.dev/dex/trending?blocks=150&api_key=adt_…"

Example result

{
  "chain": "Base",
  "fromBlock": 37002850,
  "toBlock": 37002999,
  "minutes": 5,
  "swapsCounted": 9120,
  "poolsSeen": 980,
  "count": 1,
  "tokens": [
    {
      "rank": 1,
      "address": "0x2222222222222222222222222222222222222222",
      "symbol": "NEW",
      "name": "New Token",
      "swaps": 412,
      "pools": 2,
      "shareOfSwaps": 0.045,
      "topPool": {
        "address": "0x1111111111111111111111111111111111111111",
        "swaps": 380
      },
      "symbolClash": false
    }
  ],
  "source": "Uniswap v2/v3, Aerodrome and Slipstream Swap events on Base, read live"
}

Tool page, inputs and limits

Questions

How do I pay?

Each successful call costs the tool's price; failed calls are not charged. The first 25 calls are free. Then pay with card credits from $1 (the key goes in an Authorization header or as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.