{"uid":"cap_o08ri_RIOSE_Zhr9IUn0I","slug":"op-mainnet-wallet-balance-checker-dd142e90","name":"OP Mainnet Wallet Balance Checker","description":"Native ETH balance of a OP Mainnet wallet plus the balances of up to 20 ERC-20 tokens you list, formatted with each token's symbol and decimals, read live from OP Mainnet.","url":"https://onchaincheck.dev/optimism/balances?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"tokens":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40})(,0x[0-9a-fA-F]{40}){0,19}$","description":"Comma-separated ERC-20 contract addresses on OP Mainnet, up to 20"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address on OP Mainnet"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"optimism","tokens":[{"raw":"24433911","token":"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85","symbol":"USDC","balance":"24.433911","decimals":6},{"raw":"1000000000000000000","token":"0x4200000000000000000000000000000000000042","symbol":"OP","balance":"1","decimals":18}],"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","nativeSymbol":"ETH","nativeBalance":"0.181079591875347535"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tn0wVOrRqanIEIUG0PrBm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the native ETH balance plus up to 20 ERC-20 token balances for a given OP Mainnet wallet address, with symbols and decimals formatted for readability.","exampleAgentPrompt":"What's the ETH balance and token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Optimism? Also check USDC (0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85) and OP (0x4200000000000000000000000000000000000042) while you're at it.","exampleUseCases":[{"title":"DeFi portfolio snapshot on Optimism","prompt":"Pull the current ETH, USDC, and OP balances for my Optimism wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — USDC is at 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85 and OP is at 0x4200000000000000000000000000000000000042."},{"title":"Pre-transaction balance verification","prompt":"Before I send that transaction, check how much ETH and USDT (0x94b008aA00579c1307B0EF2c499aD98a8ce58e58) are in wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Optimism."},{"title":"Automated wallet monitoring for alerts","prompt":"Check the live WBTC (0x68f180fcCe6836688e9084f035309E29Bf0A2095) and ETH balance for Optimism address 0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97 so I can alert if either drops below a threshold."}],"resultDescription":"A JSON object containing the wallet address, the chain name ('optimism'), the native ETH balance as a human-readable decimal string, and an array of token objects each containing the contract address, symbol, decimals, raw balance integer, and formatted decimal balance.","failureModes":["Invalid or malformed wallet address returns an error","Invalid ERC-20 contract address in the tokens list causes a failure or is skipped","More than 20 token addresses provided will be rejected due to schema constraints","RPC or node connectivity issues may cause temporary failures","Non-existent or zero-balance addresses return zero values, not errors"],"whenToPreferThis":"Choose this endpoint when you need live, real-time ETH and ERC-20 token balances specifically on Optimism (OP Mainnet) for a given wallet. It is ideal for portfolio checks, pre-transaction validations, DeFi integrations, and automated monitoring workflows targeting Optimism L2. Prefer alternatives (sibling endpoints) for Arbitrum One, Base, or Ethereum Mainnet balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:38:32.429Z","isFirstParty":false,"canonicalSlug":"op-mainnet-wallet-balance-checker-dd142e90"}