{"uid":"cap_OoHjJqaIMstpWznzHNKfJ","slug":"phantom-api-citrea-token-balances-132fa659","name":"Phantom API — Citrea 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/citrea/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_Z1Nl1kY3y4_Dxyx-k23wJ","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":"Returns token balances for a given owner address on the Citrea network, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What are the token balances for wallet address 0xAbC123...def on the Citrea network, specifically for contract addresses 0xToken1 and 0xToken2?","exampleUseCases":[{"title":"DeFi portfolio snapshot on Citrea","prompt":"Can you check the full token balances for my wallet 0x1234...abcd on the Citrea network so I can see what I'm holding?"},{"title":"Specific token holdings audit","prompt":"Look up the balances of contract addresses 0xAaaa...1111 and 0xBbbb...2222 for wallet 0x9999...ffff on Citrea — I need to verify my ERC-20 positions."},{"title":"Multi-token treasury check","prompt":"Fetch the token balances for our DAO treasury wallet 0xDEAD...BEEF on Citrea across all our issued token contracts so we can prepare a financial report."}],"resultDescription":"An array or mapping of token balances associated with the specified owner address on the Citrea network, with each entry reflecting the balance held for a given token contract. If contract addresses are provided, only balances for those contracts are returned.","failureModes":["Invalid or malformed owner address returns an error or empty result","Non-existent or invalid contract address may return zero balance or error","Citrea network downtime or congestion may cause timeouts","Payment failure via x402 protocol blocks the request","Empty contractAddresses array may return all tokens or error depending on implementation"],"whenToPreferThis":"Choose this endpoint when you specifically need token balance data on the Citrea network and want pay-per-call pricing without a subscription. Ideal for agents that need occasional or infrequent balance lookups across 57+ supported networks via a unified API. Prefer this over general-purpose RPC calls when you want structured balance data without raw blockchain parsing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:00:57.389Z","isFirstParty":false}