{"uid":"cap_L6cHPSh5AhPjLaaWk3dhZ","slug":"phantom-api-berachain-token-balances-49d434dc","name":"Phantom API — Berachain 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/berachain/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_vVW9uY9PdS-aJHW_tkV14","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 Berachain network, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What ERC-20 token balances does the Berachain wallet 0x1234...abcd currently hold — show me everything, or just check the balances for contract 0xTokenA and 0xTokenB if you want to narrow it down.","exampleUseCases":[{"title":"DeFi portfolio snapshot for Berachain","prompt":"Can you pull all the token balances for my Berachain wallet 0xAbCd1234...5678 so I can see my full on-chain portfolio?"},{"title":"Check specific token holdings on Berachain","prompt":"Does the wallet 0xDeF456...9012 on Berachain hold any of these tokens — 0xTokenContractA and 0xTokenContractB? Show me their balances."},{"title":"Berachain wallet due diligence","prompt":"I'm reviewing a counterparty's Berachain address 0x9876...FEDC — can you fetch all their current token balances so I can assess their holdings before we proceed?"}],"resultDescription":"Returns a list of token balances held by the specified wallet on the Berachain network, including token contract addresses, amounts, and potentially token metadata such as symbol and decimals. If specific contract addresses are provided, only balances for those tokens are returned.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Contract address array contains invalid addresses, causing partial or failed lookups","Berachain node or RPC unavailability results in a timeout or 503 error","Wallet with no token holdings returns an empty balances array","Rate limiting or payment failure (x402) if the $0.01 USDC fee is not properly handled"],"whenToPreferThis":"Choose this endpoint when you specifically need token balance data on the Berachain network and want a fast, pay-per-call API without a subscription. Ideal for agents performing one-off wallet lookups, DeFi portfolio checks, or due diligence on Berachain addresses without the overhead of running your own node or managing an RPC subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:56:50.391Z","isFirstParty":false}