{"uid":"cap_d45yocSwUJvdOI3TMn9Mh","slug":"phantom-api-bnb-token-balances-29a4bf09","name":"Phantom API — BNB 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/bnb/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_Fqvmgbqx9ll_fK8Y2z8V_","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 wallet address on the BNB Chain, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What BEP-20 token balances does wallet 0xAbC123...456 hold on BNB Chain? Also check its balance for the token contracts 0xToken1... and 0xToken2....","exampleUseCases":[{"title":"DeFi portfolio tracker for BNB wallets","prompt":"Check all token balances held by the BNB wallet 0x1234...abcd — I want to see every token it holds on BNB Chain."},{"title":"Verify specific token holdings before a trade","prompt":"Does the wallet 0xDEAD...BEEF hold any CAKE tokens (contract 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82) on BNB Chain?"},{"title":"Monitor whale wallet token positions","prompt":"Pull all token balances for BNB Chain address 0xABCD...1234, including these three contract addresses: 0xContractA, 0xContractB, 0xContractC — I'm tracking this wallet's positions."}],"resultDescription":"Returns a list of token balances for the specified wallet address on BNB Chain, including token amounts and associated contract metadata. When specific contract addresses are provided, results are filtered to those tokens only.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Non-existent contract addresses may return zero balances or errors","Rate limiting or payment failure (x402) if USDC payment is not properly attached","BNB Chain node downtime may cause temporary unavailability","Empty array returned if wallet holds no tokens or no matching contracts found"],"whenToPreferThis":"Use this endpoint when you need on-chain token balance data specifically for the BNB Smart Chain (BNB/BSC network) for a given wallet address. It is preferable when you need fast, pay-per-call access without a long-term API subscription, and supports filtering by specific BEP-20 contract addresses for precision queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:56:14.181Z","isFirstParty":false}