{"uid":"cap_3nDYzi-bOKU6Yewlm9wq4","slug":"phantom-api-unichain-token-balances-d99e79e1","name":"Phantom API — Unichain 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/unichain/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_xypUEuyAaZ_8ivzsH7KTu","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 ERC-20 token balances for a given wallet address on the Unichain network, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What ERC-20 token balances does wallet 0xAbC...123 hold on Unichain? Check for contract addresses 0xToken1 and 0xToken2.","exampleUseCases":[{"title":"DeFi portfolio snapshot on Unichain","prompt":"Can you pull all the ERC-20 token balances for my wallet 0xAbC...123 on Unichain so I can see my full portfolio?"},{"title":"Verify specific token holding before swap","prompt":"Before I do a swap, can you check if wallet 0xDef...456 actually holds any USDC — contract 0xUSDC... — on Unichain?"},{"title":"On-chain eligibility check for airdrop","prompt":"I need to confirm which of these wallets — 0xAaa...111, 0xBbb...222 — hold the governance token at contract 0xGov... on Unichain to see who qualifies for the airdrop."}],"resultDescription":"Returns a list of token balances for the specified wallet address on the Unichain network, each entry including the token contract address and the corresponding balance amount. If contract addresses are provided, results are filtered to only those tokens.","failureModes":["Invalid owner address format returns an error or empty result","Contract address array contains invalid or non-existent addresses, returning zero balances","Unichain network congestion or RPC unavailability causes timeout","Wallet address has no token holdings, returning an empty array","Payment not fulfilled via x402 protocol results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you specifically need ERC-20 token balance data on the Unichain network. Prefer it over generic Web3 RPC calls when you want a simple, pay-per-call REST interface without managing your own node infrastructure. It is especially suitable for agents that need quick, multi-token balance lookups on Unichain without subscribing to a full blockchain data provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:19.481Z","isFirstParty":false}