{"uid":"cap_RGE8Ker7gSLB7lrvUflIX","slug":"base-erc-20-transfer-logs-67e77031","name":"Base ERC-20 Transfer Logs","description":"Call when an agent needs ERC-20 Transfer logs on Base filtered by token and/or wallet over a bounded block range (default the latest 2000 blocks, max 10000, at most 50). Amounts are raw and human when decimals() is readable. Read-only. No spend. Send JSON {\"token\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"wallet\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/base-erc20-transfers first.","url":"https://agentshelf.syntexa.ch/v1/base-erc20-transfers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","description":"Transfer recipient. Indexed topic. Do not combine with wallet. EIP-55 or all one case."},"from":{"type":"string","description":"Transfer sender. Indexed topic. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. Do not combine with wallet."},"token":{"type":"string","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"ERC-20 contract on Base. Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (Circle USDC). Omit it to include every token in the window. EIP-55 or all one case."},"wallet":{"type":"string","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"description":"Address that must be the sender or the recipient. Do not also send from or to. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045."},"to_block":{"type":"string","description":"Last block, inclusive, or latest. With from_block, the span must be at most 10000. Omit it to anchor a 2000-block window."},"from_block":{"type":"string","pattern":"^(0|[1-9]\\d*)$","description":"First block, inclusive. With to_block, the span must be at most 10000. Omit both for the latest 2000 blocks."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Neif8ap1H9kye7pNgNzkU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves ERC-20 Transfer event logs on Base mainnet filtered by token contract and/or wallet address over a bounded block range, returning both raw and human-readable amounts.","exampleAgentPrompt":"Can you pull all USDC transfers involving wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base over the latest 2000 blocks, and show me both the raw and human-readable amounts?","exampleUseCases":[{"title":"Audit USDC inflows to a wallet","prompt":"Show me every USDC transfer sent to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base in the last 2000 blocks — I want to see who paid them and how much in human-readable amounts."},{"title":"Monitor token activity over a block range","prompt":"Fetch all ERC-20 transfers for the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base between blocks 22000000 and 22010000 so I can see overall transfer activity in that window."},{"title":"Track outbound transfers from a DeFi wallet","prompt":"Get me all ERC-20 token transfers sent from wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base in the last 2000 blocks — any token, not just USDC — so I can audit recent outflows."}],"resultDescription":"Returns up to 50 ERC-20 Transfer log entries for the specified token and/or wallet within the block window. Each entry includes the transaction hash, block number, token contract address, sender (from), recipient (to), raw amount (uint256 string), and human-readable amount (decimal string if decimals() was readable). Response is read-only with no side effects.","failureModes":["Block range exceeds 10000 blocks — returns error asking you to narrow from_block/to_block","Invalid Ethereum address format — returns validation error; ensure EIP-55 or all-lowercase","Combining wallet with from or to fields — returns error since wallet is mutually exclusive","decimals() not readable on token contract — human amount will be null or omitted","More than 50 results in range — returns first 50 with a truncation indicator","Payment not provided or insufficient — returns 402 Payment Required; try sandbox endpoint first"],"whenToPreferThis":"Use this endpoint when you need on-chain ERC-20 Transfer event history on Base for a specific wallet or token, especially when you need human-readable decoded amounts alongside raw values. Prefer it over generic blockchain explorers when programmatic JSON output is needed in an agent workflow. It is read-only and cheap ($0.005 USDC), making it suitable for frequent polling or audit tasks. Use the free sandbox endpoint (/v1/sandbox/base-erc20-transfers) for testing before spending.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T04:44:13.691Z","isFirstParty":false,"canonicalSlug":"base-erc-20-transfer-logs-67e77031"}