{"uid":"cap_kc5hCI8rcCL5g10T9XsSi","slug":"phantom-api-optimism-token-balances-a52be399","name":"Phantom API – Optimism 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/optimism/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_tLOaYIaBdR0Fj_ehydX_z","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 token balances for a given wallet address on the Optimism network, optionally filtered by specific contract addresses.","exampleAgentPrompt":"What ERC-20 token balances does wallet 0xAbC...123 hold on Optimism — check all tokens, or just these two contracts: 0xToken1 and 0xToken2?","exampleUseCases":[{"title":"DeFi portfolio snapshot on Optimism","prompt":"Show me all the ERC-20 token balances held by wallet 0x4200...dead on Optimism so I can see their full on-chain portfolio."},{"title":"Check if wallet holds a specific token","prompt":"Does wallet 0xAbc...789 currently hold any USDC on Optimism? Look up just the USDC contract 0x7F5c764cBc14f9669B88837ca1490cCa17c31607."},{"title":"Multi-wallet airdrop eligibility check","prompt":"I need to verify token balances on Optimism for wallet 0xDef...456 — specifically check these three contract addresses to see if they qualify for our airdrop threshold."}],"resultDescription":"Returns a list of token balances associated with the specified wallet address on Optimism, including token contract addresses and balance amounts. When specific contract addresses are provided, results are filtered to those tokens only.","failureModes":["Invalid or malformed owner address returns an error or empty result","Invalid contract addresses in the array may be ignored or cause a validation error","Wallet with no token balances returns an empty list","Payment failure (x402) blocks the request before execution","Rate limiting or network issues on the Optimism RPC layer may cause timeouts"],"whenToPreferThis":"Use this endpoint when you specifically need ERC-20 token balance data on the Optimism L2 network. Prefer it over generic multi-chain endpoints when Optimism is the target chain, and over Ethereum mainnet endpoints when querying Optimism-native or bridged tokens. Its pay-per-call model via x402 makes it suitable for low-frequency or agent-driven queries without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T18:55:19.960Z","isFirstParty":false,"canonicalSlug":"phantom-api-optimism-token-balances-a52be399"}