{"uid":"cap_WajQOz2Bf4pJwEwYO8_c-","slug":"phantom-api-ethereum-token-balances-ce5b2e79","name":"Phantom API — Ethereum Token Balances","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/ethereum/token/balances","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"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_TBp7FdK1m0-jjSbAOnO16","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":"Fetches ERC-20 token balances for a given Ethereum wallet address across specified contract addresses","exampleAgentPrompt":"Can you check all the ERC-20 token balances for Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, specifically for USDC (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) and USDT (0xdAC17F958D2ee523a2206206994597C13D831ec7)?","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Can you pull all the ERC-20 token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? I want to see what tokens they're holding on Ethereum."},{"title":"Check stablecoin holdings before a transfer","prompt":"Before I send funds, can you check how much USDC and DAI wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B currently holds on Ethereum? USDC contract is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and DAI is 0x6B175474E89094C44Da98b954EedeAC495271d0F."},{"title":"Verify token eligibility for an airdrop","prompt":"I need to verify whether wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e holds any of our governance token (contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984) on Ethereum — can you look that up?"}],"resultDescription":"Returns on-chain ERC-20 token balance data for the specified owner address across the provided contract addresses, including token amounts held in the wallet on the Ethereum network.","failureModes":["Invalid Ethereum address format returns a validation error","Unknown or non-ERC-20 contract address may return zero balance or an error","Rate limiting or payment failure (x402) prevents the call from completing","Network congestion may cause slower-than-expected responses","Empty contractAddresses array may return an error or empty result"],"whenToPreferThis":"Use this endpoint when you need real-time, on-chain ERC-20 token balance lookups for Ethereum wallets without managing your own node infrastructure. Ideal for agents that need portfolio snapshots, eligibility checks, or balance verification on Ethereum, especially when pay-per-call pricing ($0.01 USDC via x402) is preferable to a subscription model. Best suited for targeted queries with known contract addresses rather than broad multi-chain portfolio scanning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:51:15.779Z","isFirstParty":false}