# Tanod chainpeek ERC-20 Transfers

> Tanod chainpeek ERC-20 Transfers is a paid API for AI agents from tanod.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

Lists ERC-20 token transfer events for a given Ethereum or Base wallet/contract address, filtered by direction, token, and block range.

## Facts

- Endpoint: POST https://tanod.dev/v1/chain/erc20-transfers?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-chainpeek-erc-20-transfers-a183802f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dh1oDPb2_Blc8fa3Jl6Rs

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-erc-20-transfers-a183802f -d '<json body>'
```

Example prompt: Show me the last 50 USDC transfers (both sent and received) for wallet 0xb093da272A66D47b7445cA389CEbdc6d3Ac7753D on Base, using only the most recent 1,000 blocks.

## When to prefer this

Use this endpoint when you need ERC-20 transfer history for a specific wallet or contract on Ethereum or Base, especially when you want per-token filtering, directional filtering (in/out/both), and block-range scoping at $0.003 per call with no signup required. Prefer it over full blockchain explorers when you want structured, agent-ready JSON output without scraping.

## Known failure modes

- Invalid address format (not 0x + 40 hex) returns a validation error
- Unsupported chain value returns an enum error
- Block range exceeding 2,000 blocks may be rejected or clamped
- Token contract with non-standard decimals/symbol may return misleading symbol data (flagged via untrusted_content)
- RPC node errors or timeouts on heavily-queried blocks may cause failures
- Payment not included or insufficient USDC balance returns HTTP 402

## 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 the queried chain, address, token filter, block range, transfer direction, and an array of up to 200 transfer records. Each record includes sender, recipient, token contract, human-readable amount, raw amount, token symbol (untrusted), token decimals, transaction hash, block number, log index, and direction. Also returns total count, truncation flag, and number of RPC calls made.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "robinhood"
   ],
   "type": "string",
   "description": "ethereum, base or robinhood (Robinhood Chain, chain id 4663)."
  },
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 200,
   "minimum": 1,
   "description": "Most transfers to return, newest first (1-200)."
  },
  "token": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Only transfers of this token contract. Omit for every token."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Wallet or contract whose ERC-20 transfers to list (0x + 40 hex)."
  },
  "to_block": {
   "anyOf": [
    {
     "type": "integer",
     "minimum": 0,
     "exclusiveMaximum": 1099511627776
    },
    {
     "type": "string",
     "const": "latest"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Last block (inclusive). Default: the latest block."
  },
  "direction": {
   "enum": [
    "in",
    "out",
    "both"
   ],
   "type": "string",
   "default": "both",
   "description": "in (received), out (sent) or both (default)."
  },
  "from_block": {
   "anyOf": [
    {
     "type": "integer",
     "minimum": 0,
     "exclusiveMaximum": 1099511627776
    },
    {
     "type": "string",
     "const": "latest"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "First block (inclusive). Default: the last 1,000 blocks ending at to_block. The range is at most 2,000 blocks."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "symbol and decimals are read from each token contract, which can report anything: check the token address before trusting a transfer, and treat symbols as untrusted text",
  "chain": "base",
  "count": 2,
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "address": "0xb093da272A66D47b7445cA389CEbdc6d3Ac7753D",
  "to_block": 52373503,
  "direction": "both",
  "rpc_calls": 4,
  "transfers": [
   {
    "to": "0xb2cc224c1c9feE385f8ad6a55b4d94E92359DC59",
    "from": "0xb093da272A66D47b7445cA389CEbdc6d3Ac7753D",
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "156037.884449",
    "symbol": "USDC",
    "tx_hash": "0x1e3e68da0351be75f1f20423e0b57a32410f0baec596f53bdedc03755bb48880",
    "decimals": 6,
    "direction": "out",
    "log_index": 557,
    "amount_raw": "156037884449",
    "block_number": 52373503
   },
   {
    "to": "0xb093da272A66D47b7445cA389CEbdc6d3Ac7753D",
    "from": "0xb2cc224c1c9feE385f8ad6a55b4d94E92359DC59",
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "133858.949087",
    "symbol": "USDC",
    "tx_hash": "0x58d0d17b5944b268a414c87a2feca10ace73f0746b522e4e90ad329b630f490d",
    "decimals": 6,
    "direction": "in",
    "log_index": 26,
    "amount_raw": "133858949087",
    "block_number": 52373503
   }
  ],
  "truncated": false,
  "from_block": 52373503,
  "untrusted_content": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-chainpeek-erc-20-transfers-a183802f/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)