{"uid":"cap_Gcl3-aRp5ezKCxEoaHNj9","slug":"phantom-api-soneium-token-balances-f1cffbd2","name":"Phantom API — Soneium 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/soneium/token/balances?utm_source=zero.xyz","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_i2gqgVI3HvOxFr_8D4nCg","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 wallet address on the Soneium network, optionally filtered by specific contract addresses","exampleAgentPrompt":"Check all token balances for the Soneium wallet 0xAbc123...def456, and also specifically tell me how much of the tokens at contracts 0xToken1... and 0xToken2... it holds.","exampleUseCases":[{"title":"DeFi portfolio snapshot on Soneium","prompt":"What tokens does the wallet 0x4F8a...B3C1 currently hold on Soneium? I want a full breakdown of all its token balances."},{"title":"Verify specific token holdings before a trade","prompt":"Before I proceed, can you check whether wallet 0x9D2b...A7F4 holds any of the tokens at contract addresses 0xTokenA... and 0xTokenB... on Soneium?"},{"title":"Audit user wallet for onboarding","prompt":"I need to verify the on-chain token balances of a new user's Soneium wallet — the address is 0x1234...abcd. Pull everything it holds across all tokens."}],"resultDescription":"Returns a list of token balances associated with the specified wallet owner on the Soneium network. Each entry typically includes the token contract address, token symbol or name, and the balance amount held by the wallet. If specific contract addresses are provided, results are filtered to those tokens only.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Contract addresses that don't exist on Soneium return zero balances or errors","Network congestion or RPC issues may cause timeouts","Payment failure via x402 prevents the call from completing","Newly deployed contracts may not yet be indexed"],"whenToPreferThis":"Use this endpoint when you need fast, pay-per-call token balance lookups specifically on the Soneium network without committing to a subscription. It is ideal for agents that need on-demand portfolio or balance checks across multiple token contracts for any wallet, especially in a multi-chain setup where Soneium coverage is explicitly needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:47:53.199Z","isFirstParty":false,"canonicalSlug":"phantom-api-soneium-token-balances-f1cffbd2"}