# Tanod chainpeek — Token Large Trades

> Tanod chainpeek — Token Large Trades is a paid API for AI agents from tanod.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns recent large DEX trades (buys and sells above a USD threshold) for an ERC-20 token on Base or Ethereum, read from on-chain swap events

## Facts

- Endpoint: POST https://tanod.dev/v1/chain/token-trades?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-chainpeek-token-large-trades-35497a9d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SN47hEj5CRNLVdtFR5n7W

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 tanod-chainpeek-token-large-trades-35497a9d -d '<json body>'
```

Example prompt: Show me all trades above $5000 for the token at 0x940181a94A35A4569E4529A3CDfB74e38FD98631 on Base in the last 60 minutes — I want to see any big buys or sells.

## When to prefer this

Use this endpoint when you need fast, on-chain-verified large-trade data for a specific ERC-20 token on Base or Ethereum, sourced directly from DEX swap events rather than aggregated off-chain feeds. Prefer it for whale monitoring, pre-trade context, or smart-money flow detection where raw chain data is required. It covers Uniswap V2, V3, and Aerodrome pools with the most liquidity, making it reliable for major tokens. Not suitable for tokens trading exclusively on centralized exchanges or very illiquid tokens with no supported pools.

## Known failure modes

- Invalid token address format (not 0x + 40 hex) — validation error returned
- Token has no supported pools (Uniswap V2/V3 or Aerodrome against WETH/USDC) — empty pools list returned
- window_minutes exceeds chain limit (>60 on Base, >240 on Ethereum) — error or clamped response
- min_usd below 100 — rejected by schema validation
- No trades found in the window above the threshold — empty trades array returned
- Network or RPC error reading on-chain events — upstream error response
- Payment not processed (x402 protocol) — 402 Payment Required

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

A JSON object containing: a list of trades (each with transaction hash, DEX name, pool address, side (buy/sell), USD size, token amount, wallet address, block number, and timestamp), the scanned pool metadata (DEX, quote asset, liquidity in USD), current block number, chain, and a note explaining data limitations (only top-3 liquidity pools scanned, wallet may be a router/aggregator, one routed trade may appear as multiple swaps).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum"
   ],
   "type": "string",
   "default": "base",
   "description": "base (default) or ethereum."
  },
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "ERC-20 token address (0x + 40 hex)."
  },
  "min_usd": {
   "type": "number",
   "default": 1000,
   "maximum": 1000000000,
   "minimum": 100,
   "description": "Smallest trade to report, in USD of the quote side (default 1000, minimum 100)."
  },
  "window_minutes": {
   "type": "integer",
   "default": 60,
   "maximum": 240,
   "minimum": 1,
   "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Read from DEX swap events on chain (Uniswap V2, Uniswap V3 and, on Base, Aerodrome pools against WETH or USDC; at most the 3 pools with the most liquidity). It can miss trades on pools that are not scanned. The size is the quote side of the swap in USD (WETH at the current Chainlink ETH/USD price); amounts are heuristic. `wallet` is the transaction sender: through a router, aggregator or smart wallet that can be a bot or a relayer, not the end holder. One routed trade can appear as several swaps. Size-based only: no wallet is labelled or ranked. Not investment advice.",
  "block": 52461129,
  "chain": "base",
  "pools": [
   {
    "dex": "aerodrome",
    "stable": false,
    "address": "0x6cDcb1C4A4D1C3C6d054b27AC5B77e89eAFb971d",
    "quote_asset": "USDC",
    "liquidity_usd": 44545183.18
   },
   {
    "dex": "aerodrome",
    "stable": false,
    "address": "0x7f670f78B17dEC44d5Ef68a48740b6f8849cc2e6",
    "quote_asset": "WETH",
    "liquidity_usd": 3858604.97
   },
   {
    "dex": "uniswap_v3",
    "address": "0x3d5D143381916280ff91407FeBEB52f2b60f33Cf",
    "fee_tier": 3000,
    "quote_asset": "WETH",
    "liquidity_usd": 2661411.55
   }
  ],
  "token": "0x940181a94A35A4569E4529A3CDfB74e38FD98631",
  "cached": false,
  "reason": null,
  "trades": [
   {
    "tx": "0x0d08f5aedf984615b360f373108eabea43acb3e4f97de806850e5bcdbcb2894a",
    "dex": "aerodrome",
    "usd": 9180.2,
    "pool": "0x6cDcb1C4A4D1C3C6d054b27AC5B77e89eAFb971d",
    "side": "buy",
    "time": "2026-10-11T09:09:01Z",
    "block": 52460197,
    "wallet": "0x70a99c4127620129D0CA30827E0FC9B75eC2891b",
    "timestamp": 1791709741,
    "token_amount": "9274.165371123016801974",
    "token_amount_raw": "9274165371123016801974"
   },
   {
    "tx": "0xa65de3f36a97445714345b89aff0cb6628947d5081c6bbc529c31699bf24ed2a",
    "dex": "aerodrome",
    "usd": 11852.25,
    "pool": "0x6cDcb1C4A4D1C3C6d054b27AC5B77e89eAFb971d",
    "side": "buy",
    "time": "2026-10-11T09:03:05Z",
    "block": 52460019,
    "wallet": "0x27006aAf498A8140dBB539C352c4669cA6A8A988",
    "timestamp": 1791709385,
    "token_amount": "12010.72977496842960896",
    "token_amount_raw": "12010729774968429608960"
   },
   {
    "tx": "0xf101adf9fd237b41693481f81ac5181c3c0c7675164e46666e150ec8140ef6f8",
    "dex": "aerodrome",
    "usd": 11827.83,
    "pool": "0x6cDcb1C4A4D1C3C6d054b27AC5B77e89eAFb971d",
    "side": "buy",
    "time": "2026-10-11T09:02:49Z",
    "block": 52460011,
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-chainpeek-token-large-trades-35497a9d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)