{"slug":"tanod-dev-v1-chain-token-trades-4a1254","title":"chainpeek (Tanod) recent large trades on a token","host":"tanod.dev","method":"POST","resource":"https://tanod.dev/v1/chain/token-trades","category":"market","description":"chainpeek (Tanod) recent large trades on a token: big buys and sells above a USD size on Base or Ethereum, read from DEX swap events. Use when an agent needs the recent large buys and sells of an ERC-20 token: side, USD size, sender.","price_listed":0.01,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:137","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"chain":"base","min_usd":9000,"token":"0x940181a94A35A4569E4529A3CDfB74e38FD98631"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"chain":{"default":"base","description":"base (default) or ethereum.","enum":["base","ethereum"],"type":"string"},"min_usd":{"default":1000,"description":"Smallest trade to report, in USD of the quote side (default 1000, minimum 100).","maximum":1000000000,"minimum":100,"type":"number"},"token":{"description":"ERC-20 token address (0x + 40 hex).","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"window_minutes":{"default":60,"description":"How far back to read, in minutes (default 60). At most 60 on Base and 240 on Ethereum, so that the window fits one eth_getLogs read of at most 2,000 blocks per pool.","maximum":240,"minimum":1,"type":"integer"}},"required":["token"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"block":{"type":["integer","null"]},"cached":{"type":"boolean"},"chain":{"type":"string"},"decimals":{"type":["integer","null"]},"eth_usd":{"type":["number","null"]},"min_usd":{"type":"number"},"note":{"type":"string"},"pools":{"items":{"properties":{"address":{"type":"string"},"dex":{"type":"string"},"fee_tier":{"type":"integer"},"liquidity_usd":{"type":"number"},"quote_asset":{"type":"string"},"stable":{"type":"boolean"}},"type":"object"},"type":"array"},"reason":{"type":["string","null"]},"returned":{"type":"integer"},"swaps_scanned":{"type":"integer"},"token":{"type":"string"},"trade_count":{"type":"integer"},"trades":{"items":{"properties":{"block":{"type":"integer"},"dex":{"type":"string"},"pool":{"type":"string"},"side":{"enum":["buy","sell"]},"time":{"type":["string","null"]},"timestamp":{"type":["integer","null"]},"token_amount":{"type":["string","null"]},"token_amount_raw":{"type":"string"},"tx":{"type":"string"},"usd":{"type":"number"},"wallet":{"type":["string","null"]}},"type":"object"},"type":"array"},"truncated":{"type":"boolean"},"wallets_unavailable":{"type":"integer"},"window":{"properties":{"blocks":{"type":"integer"},"from_block":{"type":"integer"},"from_time":{"type":["string","null"]},"minutes":{"type":"integer"},"to_block":{"type":"integer"},"to_time":{"type":"string"}},"type":"object"}},"required":["chain","token","window","pools","trades","trade_count","truncated","note"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"chainpeek (Tanod) recent large trades on a token: big buys and sells above a USD size on Base or Ethereum, read from DEX swap events. Use when an agent needs the recent large buys and sells of an ERC-20 token: side, USD size, sender.","last_updated":"2026-10-12T02:28:08.454Z","schemes":["exact"]}