{"uid":"cap_EPDwQDAsZLjXBHe2-Om_n","slug":"phantom-api-celo-token-balances-29b41a44","name":"Phantom API — Celo 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/celo/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_gr0_cV3D5DZpI0mylW_G8","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 and native token balances for a given wallet address on the Celo network, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What token balances does wallet 0x4f4495243837681061C4743b74B3eEdf548D56A5 hold on the Celo network? Also check the cUSD contract at 0x765DE816845861e75A25fCA122bb6898B8B1282a.","exampleUseCases":[{"title":"DeFi portfolio snapshot on Celo","prompt":"Can you pull all the token balances for my Celo wallet 0x4f4495243837681061C4743b74B3eEdf548D56A5? I want to see everything I'm holding on-chain."},{"title":"Verify specific token holdings before swap","prompt":"Before I make a swap, check if my Celo wallet 0xAbC123... has any cUSD at contract 0x765DE816845861e75A25fCA122bb6898B8B1282a and how much."},{"title":"Monitor airdrop receipt on Celo","prompt":"Did wallet 0xDef456... receive the airdropped governance token at contract 0x471EcE3750Da237f93B8E339c536989b8978a438 on Celo yet? Show me the current balance."}],"resultDescription":"Returns a list of token balance records for the specified Celo wallet address, including token amounts and metadata (such as symbol, decimals, and contract address) for each held token, filtered to any specified contract addresses if provided.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Non-existent contract address returns zero balance or error","Network congestion may cause slower-than-usual response","Unsupported token standards may not appear in results","Missing required 'owner' field returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you specifically need token balance data on the Celo network and want fast, pay-per-call access without a subscription or API key overhead. Ideal for agents querying Celo DeFi portfolios, verifying on-chain holdings, or enriching wallet data with current balances across ERC-20 and native tokens on Celo.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:46:37.107Z","isFirstParty":false}