{"uid":"cap_50KjpSjYqA5zYDVy3S4Rs","slug":"phantom-api-token-transfers-lookup-2e0c253b","name":"Phantom API — Token Transfers Lookup","description":"Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.","url":"https://phantom-api-omega.vercel.app/api/adi/token/transfers","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"order":{"enum":["asc","desc"],"type":"string"},"owner":{"type":"string"},"pageKey":{"type":"string"},"toBlock":{"type":"string"},"maxCount":{"type":"number"},"fromBlock":{"type":"string"},"contractAddresses":{"type":"array","items":{"type":"string"}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fuuoZ5sRsFQVkIWyR4qTt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain token transfer history for a given wallet address, optionally filtered by contract addresses, block range, and sort order.","exampleAgentPrompt":"Pull all token transfers for wallet 0xAbC123...def456 from block 18000000 to 18500000, sorted descending, and limit it to 50 results for the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"DeFi portfolio transfer audit","prompt":"Show me all token transfers in and out of my wallet 0xAbC123...def456 over the last month — I want to audit every ERC-20 movement, sorted from newest to oldest, up to 100 results."},{"title":"Contract-specific activity tracker","prompt":"Fetch all transfers of the USDT token (contract 0xdAC17F958D2ee523a2206206994597C13D831ec7) for wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, sorted ascending from block 17000000."},{"title":"Paginated transfer history export","prompt":"Get the next page of token transfer records for wallet 0xDeF789...abc123 using page key 'abc-page-key-xyz', limiting to 25 results — I'm exporting the full history in batches."}],"resultDescription":"Returns a paginated list of token transfer events for the specified wallet, including sender/receiver addresses, token contract, amount transferred, block number, transaction hash, and a page key for fetching subsequent pages.","failureModes":["Invalid or malformed wallet address returns an error or empty result set","Unsupported network or block range out of bounds may return empty transfers","Missing required 'owner' field causes a 400-level validation error","Invalid pageKey causes pagination to fail or restart","Rate limiting or payment failure (x402) blocks the request","Very large block ranges may time out or return truncated results"],"whenToPreferThis":"Choose this endpoint when you need historical token transfer data for a specific wallet address across one or more token contracts, especially when filtering by block range or paginating through large transfer histories. Prefer it over general blockchain explorers when you need structured JSON output suitable for programmatic processing by an AI agent. It is particularly well-suited for DeFi auditing, portfolio tracking, and on-chain activity analysis across 57+ supported networks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:53:13.148Z","isFirstParty":false}