get_large_token_trades
chainpeek: Who is buying this token? Recent large trades: big buys and sells on Base or Ethereum. For Solana use get_large_solana_token_trades; for a quote at your size use get_swap_quote. Returns who bought and sold an ERC-20 in size: the recent large buys and sells of it on Base or Ethereum from DEX swap events (Uniswap V2/V3, Aerodrome): time, side, token amount, USD size, the transaction sender's wallet, tx hash and pool, newest first, at most 50. Size-based only, no wallet is labelled; read from swap events of the top 3 pools, so it can miss trades elsewhere; amounts are heuristic; a bad address or a window over 60 minutes (Base) or 240 (Ethereum) is a 422 (not charged); Base logs reach about 27 min back (window.complete); cached 30 s. Typically 3 to 6 s (pool discovery, header and log reads, senders), at most 25 s. Price: USD 0.01. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/token-large-trades-api.html
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"token": "<token>"
},
"name": "get_large_token_trades"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | base (default) or ethereum. | base |
| token | Yes | ERC-20 token address (0x + 40 hex). | |
| min_usd | No | Smallest trade to report, in USD of the quote side (default 1000, minimum 100). | |
| window_minutes | No | How far back to read, in minutes. At most 60 on Base and 240 on Ethereum. The window is cut by block times; public nodes serve logs only about 8,000 blocks deep (about 27 minutes on Base), so a longer Base window is read as its newest 8,000 blocks and `window` says what was read. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| block | No | ||
| chain | No | ||
| error | No | Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object. | |
| pools | No | ||
| token | No | ||
| cached | No | ||
| reason | No | ||
| trades | No | ||
| window | No | ||
| eth_usd | No | ||
| min_usd | No | ||
| decimals | No | ||
| returned | No | ||
| truncated | No | ||
| trade_count | No | ||
| swaps_scanned | No | ||
| wallets_unavailable | No |