{"uid":"cap_V7GOXbhGkEANtaDBCXRLC","slug":"blockscout-address-token-transfers-96d64189","name":"Blockscout Address Token Transfers","description":"Access to api/v2/addresses/:address_hash/token-transfers. List token transfers involving a specific address with filtering options","url":"https://api.blockscout.com/:chain_id/api/v2/addresses/:address_hash_param/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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"},"address_hash_param":{"type":"string"}}},"queryParams":{"type":"object","properties":{"type":{"type":"string"},"index":{"type":"integer"},"token":{"type":"string"},"filter":{"type":"string"},"items_count":{"type":"integer"},"block_number":{"type":"integer"},"index_in_batch":{"type":"integer"},"batch_log_index":{"type":"integer"},"batch_block_hash":{"type":"string"},"batch_transaction_hash":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_paAusjocCdR5meH5ZALj2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0xcebA9300f2b948710d2653dD7B07f33A8B32118C","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"List all token transfers (ERC-20, ERC-721, ERC-1155) involving a specific blockchain address on a given chain, with filtering by token type, direction, and pagination","exampleAgentPrompt":"Show me all token transfers involving the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet — filter for ERC-20 transfers only and give me the most recent ones first.","exampleUseCases":[{"title":"Wallet token activity audit","prompt":"Pull up all token transfers for the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum so I can see every token it's ever sent or received."},{"title":"NFT transfer history for a collector","prompt":"Show me all the NFT (ERC-721) transfers associated with address 0xAbCd1234... on Polygon — I want to see what NFTs have moved in and out of that wallet."},{"title":"DeFi protocol inflow monitoring","prompt":"List all incoming token transfers to the contract address 0x1234...abcd on Base mainnet, filtered to ERC-20 tokens only, so I can track what deposits have been made."}],"resultDescription":"A paginated list of token transfer objects, each containing the transaction hash, block number, timestamp, sender and receiver addresses, token contract details (name, symbol, type), token ID (for NFTs), and amount transferred. Includes pagination cursors for fetching subsequent pages.","failureModes":["Invalid or malformed address hash returns a 400 error","Unsupported or incorrect chain_id returns a 404 or empty result","Invalid token type filter string returns an error or empty results","Requesting a page beyond available data returns an empty items array","Rate limiting or payment failures return 402 or 429 responses","Chain not indexed by Blockscout returns no data"],"whenToPreferThis":"Use this endpoint when you need a full token transfer history for a specific address across EVM-compatible chains indexed by Blockscout, especially when you need filtering by token type (ERC-20, ERC-721, ERC-1155) or specific token contract. Prefer over general transaction endpoints when the focus is token movements rather than native coin transfers or contract interactions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:37:36.249Z","isFirstParty":false,"canonicalSlug":"blockscout-address-token-transfers-b4681958"}