{"openapi":"3.1.0","info":{"title":"World Chain API","version":"1.0.0","description":"Real-time on-chain data for World Chain (chain-id 480) — the Optimism-Superchain OP Stack layer-2 powering the Worldcoin / World ID ecosystem. Query live network status (latest block height, network id, client version), fetch any block by height or the latest one (timestamp, transaction count, gas used / limit, base fee, miner), read the current gas price in wei and gwei, and look up the native ETH balance and transaction count of any address. A keyless, no-account JSON wrapper over the canonical World Chain JSON-RPC node — decoded from hex into plain decimals and human-readable ETH so you do not have to. Ideal for explorers, wallets, dashboards, gas estimators and analytics on the Worldcoin chain.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/worldchain-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Blocks"},{"name":"Gas"},{"name":"Accounts"},{"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/status":{"get":{"operationId":"get_v1_status","tags":["Network"],"summary":"Network status (latest block, chain id, client version)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"World Chain","chain_id":480,"network_id":480,"rpc_healthy":true,"latest_block":31093224,"native_symbol":"ETH","client_version":"reth/v1.11.3-d6324d6/x86_64-unknown-linux-gnu"},"meta":{"timestamp":"2026-06-15T11:14:47.950Z","request_id":"2dc51046-fab3-43c8-a82d-8c2589637848"},"status":"ok","message":"Chain status 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/block":{"get":{"operationId":"get_v1_block","tags":["Blocks"],"summary":"Block by height (or latest)","description":"","parameters":[{"name":"number","in":"query","required":false,"description":"Block height (decimal or 0x-hex), or \"latest\"","schema":{"type":"string"},"example":"31000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hash":"0x405e963c3531b5eebe7ce8baf29776a2f832bd6070c771580d25dcefbb03096d","miner":"0x4200000000000000000000000000000000000011","number":31000000,"gas_used":7328009,"gas_limit":280000000,"timestamp":1781335639,"size_bytes":36832,"parent_hash":"0xc325ba45cee082be5749172f1a16e1408257a2d0423bb94b75e4f496819b4b45","timestamp_iso":"2026-06-13T07:27:19.000Z","transaction_count":29,"base_fee_per_gas_wei":"500000"},"meta":{"timestamp":"2026-06-15T11:14:48.172Z","request_id":"7e886943-dd50-494a-81c5-c84e36492dfa"},"status":"ok","message":"Block 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/gas":{"get":{"operationId":"get_v1_gas","tags":["Gas"],"summary":"Current gas price (wei + gwei)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"at_block":31093224,"gas_price_wei":"1500000","native_symbol":"ETH","gas_price_gwei":0.002},"meta":{"timestamp":"2026-06-15T11:14:48.294Z","request_id":"468814e8-a029-4e7a-9fd1-fb4facd75167"},"status":"ok","message":"Gas price 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/balance":{"get":{"operationId":"get_v1_balance","tags":["Accounts"],"summary":"Native ETH balance and transaction count of an address","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"0x-prefixed 40-hex EVM address","schema":{"type":"string"},"example":"0x000000000000000000000000000000000000dEaD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"address":"0x000000000000000000000000000000000000dEaD","balance":"0.000216601461783894","balance_wei":"216601461783894","native_symbol":"ETH","transaction_count":0},"meta":{"timestamp":"2026-06-15T11:14:48.381Z","request_id":"e02aa7fd-9470-46b1-8658-84a0744d61a2"},"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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"OP Stack L2 (Optimism Superchain)","chain":"World Chain","network":"mainnet","chain_id":480,"decimals":18,"ecosystem":"Worldcoin / World ID","endpoints":["/v1/status","/v1/block","/v1/gas","/v1/balance","/v1/meta"],"description":"World Chain is an Ethereum layer-2 built on the OP Stack for the Worldcoin / World ID ecosystem.","documentation":"https://worldchain-api.oanor.dev","native_symbol":"ETH"},"meta":{"timestamp":"2026-06-15T11:14:48.458Z","request_id":"3c47a479-752b-4737-9766-8851e57040ac"},"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":4400,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1340,"monthly_call_quota":61500,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3460,"monthly_call_quota":246000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7420,"monthly_call_quota":982000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/worldchain-api"}