# Base ERC-20 Token Transfer History for Wallet > Base ERC-20 Token Transfer History for Wallet is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20). Lists recent inbound and outbound transfers of an ERC-20 token (default USDC) for a given wallet address on Base, scanning up to 2,000 recent blocks and returning up to 50 transfers with direction, counterparty, amount, and transaction hash. ## Facts - Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/base/token-transfers?utm_source=zero.xyz - Price: $0.01/call - Payment: x402 - Status: unknown - Last checked: 2026-10-20 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/base-erc-20-token-transfer-history-for-wallet-d86944ff - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oYokLIL67IPq5lAosZLQN 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 base-erc-20-token-transfer-history-for-wallet-d86944ff ``` Example prompt: Can you check whether a USDC payment arrived at 0xAbCd...1234 on Base? Scan the last 500 blocks and show me all incoming and outgoing transfers. ## When to prefer this Use this endpoint when you need to audit or verify ERC-20 token movements (especially USDC) for a specific wallet on the Base network. It is ideal for payment confirmation, financial reconciliation, and counterparty tracing within a recent block window. Prefer it over a full block explorer when you need structured JSON output and direction metadata. Use base_token_balance instead when you only need the current balance, not historical transfers. ## Known failure modes - Malformed or invalid wallet address returns HTTP 400 with no charge - Invalid token contract address returns 400 - blocks parameter outside 1–2000 range is rejected - No transfers found returns an empty transfers array with count 0 - Network or RPC errors may cause 5xx responses - Results are capped at 50; if more exist, truncated=true but older transfers are not accessible ## How this service works 181 pay-per-call tools for AI agents over HTTP or MCP, most at $0.003. Every caller gets 25 free calls; then pay per call in USDC via x402 (Base, Polygon, Arbitrum, Monad, World Chain) or by card with prepaid credits from /credits. No account needed; failed calls are never charged; per-tool reliability is public at /status. Crypto: token prices and wallet portfolios from Uniswap v3, chain reads on Base, Ethereum, Arbitrum, Optimism and Polygon, OFAC sanctions screening. Web: Read public static documentation, pages, PDFs and RSS feeds as clean text, plus link previews and sitemaps. Business: company profiles, domain and email checks. Also Bitcoin, FX, weather, holidays, geocoding, AI text, and JSON, date and validation utilities. ## Output Returns a JSON object with the wallet address, chain name and chain ID, the block range scanned (fromBlock to toBlock), a count of transfers found, and an array of up to 50 transfer objects. Each transfer includes: direction (in/out), counterparty address, token amount (formatted), raw amount, token contract address, token symbol, transaction hash, and block number. A truncated flag indicates whether more than 50 results were cut off. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "address" ], "properties": { "token": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "examples": [ "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" ], "description": "Token: a ticker such as USDT or WETH, or the 0x ERC-20 contract (default: USDC on this network)" }, "blocks": { "type": "integer", "examples": [ 1000 ], "description": "How many recent blocks to scan (1-2000, default 1000; 2,000 blocks is about 67 minutes on Base)" }, "address": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "examples": [ "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" ], "description": "0x wallet address" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "properties": { "chain": { "type": "string" }, "count": { "type": "number" }, "address": { "type": "string" }, "chainId": { "type": "number" }, "toBlock": { "type": "number" }, "fromBlock": { "type": "number" }, "transfers": { "type": "array", "items": { "type": "object", "properties": { "tx": { "type": "string" }, "raw": { "type": "string" }, "block": { "type": "number" }, "token": { "type": "string" }, "amount": { "type": "string" }, "symbol": { "type": "string" }, "direction": { "type": "string" }, "counterparty": { "type": "string" } } } }, "truncated": { "type": "boolean" } } } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "chain": "Base", "count": 1, "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "chainId": 8453, "toBlock": 123456789, "fromBlock": 123456290, "transfers": [ { "tx": "0x…", "raw": "2500000", "block": 123456780, "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "2.5", "symbol": "USDC", "direction": "in", "counterparty": "0x…" } ], "truncated": false } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-erc-20-token-transfer-history-for-wallet-d86944ff/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)