Token flow: net buy and sell volume over time
Token flow of an ERC-20: DEX buy and sell volume, net flow, buy and sell counts, distinct buyers and sellers and the top-5 wallets' share of buying, in time buckets, from live Transfer logs on Base (default), Ethereum, Arbitrum, Optimism or Polygon. Use to see whether a token is being accumulated or dumped right now, and by how few wallets.
Inputs
| Name | Type | Description |
|---|---|---|
token (required) | string | Token: 0x ERC-20 address, or a ticker such as AERO, DEGEN or USDC |
chain | string | base (default), ethereum, arbitrum, optimism or polygon |
blocks | integer | How many recent blocks to read, 100 to 10000 (default 1800: about 6 hours on Ethereum); on Base, which makes a block every 0.2 s, ten times that (default 18000, about an hour, up to 100000) |
buckets | integer | Time buckets to split the window into, 2 to 12 (default 6) |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://glyphcall.com/token/flow?token=0x940181a94A35A4569E4529A3CDfB74e38FD98631"
Or one of your 3 free calls, no key:
curl "https://glyphcall.com/token/flow?token=0x940181a94A35A4569E4529A3CDfB74e38FD98631&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.
Example result
{
"chain": "Base",
"token": {
"address": "0x940181a94A35A4569E4529A3CDfB74e38FD98631",
"symbol": "AERO",
"decimals": 18
},
"fromBlock": 37000000,
"toBlock": 37017999,
"minutes": 60,
"transfersRead": 2840,
"truncated": false,
"dexContractsSeen": 14,
"direction": "net buying",
"totals": {
"bought": "182340.5",
"sold": "121002.1",
"netViaDex": "61338.4",
"buys": 412,
"sells": 305,
"buyers": 188,
"sellers": 140,
"minted": "0",
"burned": "0",
"topBuyerShare": 0.31
},
"buckets": [
{
"fromBlock": 37000000,
"toBlock": 37002999,
"minutesAgo": 60,
"bought": "30110.2",
"sold": "20044.9",
"net": "10065.3",
"buys": 70,
"sells": 51
}
],
"note": "Bought: transfers from DEX contracts to wallets; sold: the reverse."
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is token_flow, and the first 25 successful calls are free:
https://glyphcall.com/mcp