{"uid":"cap_Ua-imPf0-nRVGxMZaQlcM","slug":"axiom-works-erc20-transfer-events-466855b2","name":"Axiom Works ERC20 Transfer Events","description":"ERC20 Transfer events for a token and/or wallet via eth_getLogs, decoded (from, to, amount with decimals, tx hash, block). Default last 1000 blocks, max 5000. Example: {token:\"0x8335…2913\", address:\"0x88b1…3ff6\", chain:\"base\"} → newest first. Use it to confirm incoming payments. $0.003.","url":"https://api.axiomworks.co.uk/chain/erc20-transfers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain (default base)"},"limit":{"type":"string","description":"Max items (default 50, max 200)"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC20 contract (recommended; required unless scanning known tokens for a wallet)"},"blocks":{"type":"string","description":"Lookback blocks (default 100, max 5000)"},"wallet":{"type":"string","description":"Alias for address (owner wallet)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet to filter (optional if token given)"},"to_block":{"type":"string"},"direction":{"enum":["in","out","any"],"type":"string"},"from_block":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"number"},"to_block":{"type":"number"},"transfers":{"type":"array"},"from_block":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"chain":"base","count":29,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","source":"eth_getLogs Transfer(address,address,uint256)","address":"0x88b1c747c33A5868A34057D8C57318E5602b3ff6","chain_id":8453,"to_block":53552083,"direction":"any","transfers":[{"to":"0x88b1c747c33a5868a34057d8c57318e5602b3ff6","tx":"0x5cdcc3b513e329cc0e6121b25b4ee07082274ef323a0a6256361f6f0756c06a9","from":"0xdefe5f9f39d0f0a5f3c83594cd65a8e70015b370","block":53551892,"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","amount":"0.01","symbol":"USDC","log_index":844,"amount_raw":"10000"},{"to":"0x88b1c747c33a5868a34057d8c57318e5602b3ff6","tx":"0x18bd39f2a187db8d08918793e9c7f18ccb8e54730de104fe7122acf63414323c","from":"0xdefe5f9f39d0f0a5f3c83594cd65a8e70015b370","block":53551891,"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","amount":"0.005","symbol":"USDC","log_index":1147,"amount_raw":"5000"}],"from_block":53551083,"total_matched":29}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IwQFgwN2Xnwkfk9BP0fI0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches decoded ERC20 Transfer events (from, to, amount, tx hash, block) for a given token contract and/or wallet address on EVM chains via eth_getLogs","exampleAgentPrompt":"Can you check whether a USDC payment arrived at wallet 0x88b1c747c33A5868A34057D8C57318E5602b3ff6 on Base in the last 500 blocks — I'm looking for any incoming transfers from token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"Confirm incoming customer payment","prompt":"Has wallet 0x88b1c747c33A5868A34057D8C57318E5602b3ff6 received any USDC (token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base in the last 200 blocks? I want to confirm a customer payment came through before releasing their order."},{"title":"Audit outgoing token transfers","prompt":"Show me all outgoing ERC20 transfers from wallet 0xdefe5f9f39d0f0a5f3c83594cd65a8e70015b370 on Ethereum for the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 over the last 1000 blocks — direction out only."},{"title":"Monitor DeFi contract inflows","prompt":"Fetch up to 200 incoming ERC20 transfers to contract 0x88b1c747c33A5868A34057D8C57318E5602b3ff6 on Arbitrum for token 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 across the last 5000 blocks so I can see recent liquidity inflows."}],"resultDescription":"A JSON object containing the chain, scanned block range (from_block, to_block), total_matched count, and an array of decoded Transfer events sorted newest first. Each transfer includes the sender address (from), recipient address (to), human-readable token amount with symbol (e.g. '0.01 USDC'), raw amount, transaction hash (tx), block number, log index, and token contract address.","failureModes":["Invalid or non-checksummed token/address returns a 400 validation error","Requesting blocks beyond the 5000-block maximum returns an error or truncated result","Unsupported chain value returns a 400 enum validation error","No matching transfers in the requested range returns an empty transfers array with count 0","Rate limiting or payment failure returns a 402 Payment Required","Very high-activity tokens with many events may hit the 200-item limit even within the block window"],"whenToPreferThis":"Use this endpoint when you need decoded, human-readable ERC20 transfer history for a specific token or wallet without running your own node. It is especially suited for confirming incoming payments, auditing token flows, and monitoring on-chain activity across Base, Ethereum, Arbitrum, Optimism, and Polygon. It is superior to raw eth_getLogs calls because it decodes amounts with proper decimals and returns structured JSON ready for agent consumption. For checking a single transaction's status use the transaction confirmation endpoint; for wallet balance snapshots use the balances endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:33:05.810Z","isFirstParty":false,"canonicalSlug":"axiom-works-erc20-transfer-events-466855b2"}