{"openapi":"3.1.0","info":{"title":"EVM Wallet Balance API","version":"1.0.0","description":"Live native-coin balance for any EVM wallet address across the major chains as an API, read straight from each network's public JSON-RPC node. For any 0x address it returns the native balance (in coin units and in wei), the transaction count (nonce), and whether the address is a smart contract. Check one chain, or fan out across every supported chain at once to see where a wallet holds funds — Ethereum, Polygon, BNB Smart Chain, Arbitrum, Optimism, Base and Avalanche. The wallet-balance and address-lookup layer every wallet app, portfolio tracker and dashboard needs. Live, no key, no cache. Distinct from gas-fee and price APIs — this is on-chain address balances.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/walletbalance-api","description":"oanor gateway"}],"tags":[{"name":"Balance"},{"name":"Multichain"},{"name":"Chains"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/balance":{"get":{"operationId":"get_v1_balance","tags":["Balance"],"summary":"Native balance + nonce + is-contract on one chain","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"EVM 0x address","schema":{"type":"string"},"example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},{"name":"chain","in":"query","required":false,"description":"Chain: ethereum|polygon|bsc|arbitrum|optimism|base|avalanche","schema":{"type":"string"},"example":"ethereum"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Ethereum","chain":"ethereum","native":"ETH","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","balance":5.68884045,"tx_count":5896,"balance_wei":"5688840446715981478","is_contract":true},"meta":{"timestamp":"2026-06-09T03:02:01.958Z","request_id":"3c668ee4-d9b4-474a-be9e-f6cb0b5fac9e"},"status":"ok","message":"Balance retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/multichain":{"get":{"operationId":"get_v1_multichain","tags":["Multichain"],"summary":"Native balance across all supported chains","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"EVM 0x address","schema":{"type":"string"},"example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","balances":[{"name":"Ethereum","chain":"ethereum","native":"ETH","balance":5.68884045,"balance_wei":"5688840446715981478"},{"name":"Polygon","chain":"polygon","native":"POL","balance":587.18416127,"balance_wei":"587184161272371208074"},{"name":"BNB Smart Chain","chain":"bsc","native":"BNB","balance":0.16845671,"balance_wei":"168456709324951673"},{"name":"Arbitrum One","chain":"arbitrum","native":"ETH","balance":0.0836298,"balance_wei":"83629801081906257"},{"name":"Optimism","chain":"optimism","native":"ETH","balance":0.18052508,"balance_wei":"180525078403843023"},{"name":"Base","chain":"base","native":"ETH","balance":3.12358375,"balance_wei":"3123583750894794344"},{"name":"Avalanche C-Chain","chain":"avalanche","native":"AVAX","balance":0.27899096,"balance_wei":"278990955379450746"}],"chains_checked":7,"chains_with_balance":7},"meta":{"timestamp":"2026-06-09T03:02:02.153Z","request_id":"d476b88c-fd30-4348-9885-612113c7b25e"},"status":"ok","message":"Multichain balance retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/chains":{"get":{"operationId":"get_v1_chains","tags":["Chains"],"summary":"Supported chains and aliases","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7,"chains":[{"key":"ethereum","name":"Ethereum","native":"ETH"},{"key":"polygon","name":"Polygon","native":"POL"},{"key":"bsc","name":"BNB Smart Chain","native":"BNB"},{"key":"arbitrum","name":"Arbitrum One","native":"ETH"},{"key":"optimism","name":"Optimism","native":"ETH"},{"key":"base","name":"Base","native":"ETH"},{"key":"avalanche","name":"Avalanche C-Chain","native":"AVAX"}],"aliases":{"op":"optimism","arb":"arbitrum","bnb":"bsc","eth":"ethereum","pol":"polygon","avax":"avalanche","matic":"polygon","binance":"bsc"}},"meta":{"timestamp":"2026-06-09T03:02:02.258Z","request_id":"f13cb66c-c788-49b6-95a9-91c0160c59d9"},"status":"ok","message":"Chains retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chains":["ethereum","polygon","bsc","arbitrum","optimism","base","avalanche"],"source":"Public chain RPC (publicnode) eth_getBalance/getTransactionCount/getCode (live)","service":"walletbalance-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/chains":"Supported chains and aliases.","GET /v1/balance":"Native balance + nonce + is-contract on one chain (address=0x…, chain=ethereum).","GET /v1/multichain":"Native balance across all supported chains (address=0x…)."},"description":"Live EVM wallet native-coin balance from each chain's public RPC: for any 0x address, the native balance (coin units and wei), the transaction count (nonce) and whether it is a smart contract. Check one chain, or fan out across all supported chains (Ethereum, Polygon, BSC, Arbitrum, Optimism, Base, Avalanche) to see where a wallet holds funds. Live, no key. Distinct from gas-fee and price APIs — this is on-chain address balances.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:02.375Z","request_id":"cf405689-f772-47aa-8c07-3ff2d642201b"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1200,"monthly_call_quota":80000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":420000,"rps_limit":40,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":6800,"monthly_call_quota":2200000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/walletbalance-api"}