{"uid":"cap_9eWPIgp7p9IWs1YE2EMqM","slug":"phantom-api-token-transfers-lookup-dfc9fbd6","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/bob/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_jyxYxqxq4jZaf0B-Hetr0","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, with optional filtering by contract, block range, and pagination.","exampleAgentPrompt":"Pull all token transfers for wallet 0xAbC123...def456 from block 18000000 to 18500000, sorted ascending, across these contracts: [0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48], and return up to 100 results.","exampleUseCases":[{"title":"Audit wallet token activity","prompt":"Show me all token transfers in and out of wallet 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe over the last 500 blocks, sorted from oldest to newest, up to 50 results."},{"title":"Track specific ERC-20 movements","prompt":"Fetch all USDC transfers for address 0x1234abcd...5678efgh — filter to just the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and give me up to 200 records in descending order."},{"title":"Paginate large transfer history","prompt":"I already queried token transfers for 0xOwnerAddress and got a pageKey back — can you continue fetching the next page of results, still sorted descending and capped at 100 transfers?"}],"resultDescription":"Returns a list of token transfer events for the specified owner address, each including sender, recipient, token contract, amount, block number, and transaction hash. Also returns a pagination key (pageKey) when more results are available beyond the requested maxCount.","failureModes":["Invalid or malformed owner address returns an error or empty result set","Invalid block numbers (fromBlock/toBlock) may return an error or unexpected range","Expired or invalid pageKey causes pagination failure","Unsupported contract address formats cause query errors","Rate limiting or payment failure (x402) blocks the request","Empty result set returned when no transfers exist for the given parameters"],"whenToPreferThis":"Use this endpoint when you need historical token transfer data for a specific wallet address on a supported blockchain network, especially when filtering by contract address or block range. Prefer this over general transaction endpoints when your focus is token movements (ERC-20, ERC-721, etc.) rather than native currency transfers or smart contract calls. The pay-per-call x402 model makes it cost-effective for low-frequency lookups without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:52:48.614Z","isFirstParty":false}