{"uid":"cap_RK8miRTc0B-1iKscTI4dP","slug":"arbitrum-one-erc-20-token-transfer-history-be4af4ad","name":"Arbitrum One ERC-20 Token Transfer History","description":"List a wallet's recent transfers of one ERC-20 token (default USDC) on Arbitrum One, in and out, over the last N blocks (1-2,000, default 1,000): direction, counterparty, amount and transaction, newest first, up to 50. Use to confirm a payment arrived or see what was sent; for the current balance use arb_token_balance. Malformed addresses are rejected with 400, uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/arb/token-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","required":["address"],"properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0xaf88d065e77c8cC2239327C5EDb3A432268e5831"],"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 8 minutes on Arbitrum One)"},"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"}}}}}}},"responseSchema":{"type":"json","example":{"chain":"Arbitrum One","count":1,"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chainId":42161,"toBlock":123456789,"fromBlock":123456290,"transfers":[{"tx":"0x…","raw":"2500000","block":123456780,"token":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","amount":"2.5","symbol":"USDC","direction":"in","counterparty":"0x…"}],"truncated":false}},"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_e1PCRBBcelY5N7UKc5AG0","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":"Lists recent ERC-20 token transfers (in and out) for a wallet address on Arbitrum One, with direction, counterparty, amount, and transaction hash, newest first.","exampleAgentPrompt":"Can you pull the last 500 blocks of USDC transfer history for my Arbitrum wallet 0xAbC123...def456 — I need to see if a payment came in and who sent it?","exampleUseCases":[{"title":"Confirm incoming payment arrived","prompt":"Did my USDC payment land yet? Check the last 1000 blocks of transfers for 0xAbC123...def456 on Arbitrum One and tell me if anything came in."},{"title":"Audit outgoing token sends","prompt":"Show me all the USDC I sent out from 0xDe789...abc123 on Arbitrum over the last 2000 blocks — I need to see who I paid and how much each time."},{"title":"Investigate unknown ERC-20 activity","prompt":"Can you check what transfers happened for token contract 0xTokenAddr...111 to and from my Arbitrum wallet 0xMyWallet...222 over the past 500 blocks? I want to see if anything unexpected moved."}],"resultDescription":"Returns a JSON object containing the wallet address, chain name and chain ID, the block range scanned (fromBlock, toBlock), a count of transfers found, and an array of transfer objects each with direction (in/out), counterparty address, amount, token symbol, token contract, block number, and transaction hash. A truncated flag indicates if results were capped at 50.","failureModes":["Malformed or invalid wallet address returns HTTP 400 with no charge","Invalid or non-ERC-20 token contract address may return empty transfers array","blocks parameter outside 1–2000 range may be rejected or clamped","Wallet with no transfers in the specified block range returns an empty transfers array","Network or RPC node errors may cause 500 responses"],"whenToPreferThis":"Use this endpoint when you need a chronological history of ERC-20 token movements (in and out) for a specific Arbitrum One wallet — especially to confirm payment receipt, audit recent activity, or identify counterparties. For current token balance use the companion arb_token_balance endpoint. Prefer this over generic block explorers when you need structured, agent-consumable transfer data without scraping HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:35:35.456Z","isFirstParty":false,"canonicalSlug":"arbitrum-one-erc-20-token-transfer-history-be4af4ad"}