{"uid":"cap_0J6Y0wo220BdwCJjsXOUf","slug":"phantom-api-worldchain-token-balances-d89d6f5b","name":"Phantom API — Worldchain 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/worldchain/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_V9m87BIVttUAAsWHrbpUS","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 token balances for a given wallet address on the Worldchain network, optionally filtered by specific contract addresses","exampleAgentPrompt":"What token balances does the Worldchain wallet 0x1234...abcd hold? Also check balances for these specific contracts: 0xabc... and 0xdef...","exampleUseCases":[{"title":"Portfolio snapshot for a Worldchain wallet","prompt":"Show me all the tokens held by the Worldchain address 0xA1B2C3D4E5F6... — I want to know every token and its balance."},{"title":"DeFi dashboard token verification","prompt":"Check if the wallet 0xDEADBEEF... on Worldchain has any balance in these two token contracts: 0x111aaa... and 0x222bbb..."},{"title":"Airdrop eligibility balance check","prompt":"I need to verify whether Worldchain address 0x9988776655... holds any of these airdrop-eligible tokens — contracts are 0xToken1... and 0xToken2..."}],"resultDescription":"Returns a list of token balances for the specified owner address on the Worldchain network, including token contract addresses and corresponding balance amounts, optionally scoped to the provided list of contract addresses.","failureModes":["Invalid or malformed owner wallet address returns an error","Non-existent contract addresses may return zero balances or errors","Worldchain network outage or node unavailability causes request failure","Empty contractAddresses array may return all tokens or nothing depending on implementation","Rate limiting or payment failure (x402) if USDC payment is not properly attached"],"whenToPreferThis":"Use this endpoint when you specifically need token balance data on the Worldchain network. It is ideal for agents building portfolio dashboards, DeFi tools, airdrop checkers, or wallet analytics that target Worldchain. It supports filtering by contract address, making it efficient for targeted balance lookups rather than broad portfolio scans.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:09:20.959Z","isFirstParty":false}