{"openapi":"3.1.0","info":{"title":"Superposition API","version":"1.0.0","description":"Live EVM on-chain data for Superposition (chain id 55244) — an Arbitrum-Orbit DeFi Layer-3 with ETH gas and on-chain yield-bearing Super Assets — served directly from the public Superposition JSON-RPC with server-side resilience. The status endpoint returns the chain and network id, the latest block height and the node client version. The block endpoint returns a block by number (or the latest) with its hash, parent hash, timestamp, transaction count, gas used and gas limit, miner and size. The gas endpoint returns the current gas price in both wei and gwei. The balance endpoint returns the ETH balance and outgoing transaction count for any address, converted from base wei (18 decimals) into whole ETH with exact big-integer scaling. Every figure is read live from the chain over JSON-RPC — nothing bundled or modelled — behind a short server-side cache with keep-warm so the feed stays fast and fresh. Ideal for explorers, wallet and dashboard tooling, gas trackers, address monitors and DeFi analytics across the Superposition and Arbitrum-Orbit ecosystem. Live keyless upstream. 5 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/superposition-api","description":"oanor gateway"}],"tags":[{"name":"Superposition"},{"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":["Superposition"],"summary":"Address balance & tx count","description":"","parameters":[{"name":"address","in":"query","required":false,"description":"EVM address (0x + 40 hex)","schema":{"type":"string"},"example":"0x000000000000000000000000000000000000dEaD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Superposition","symbol":"ETH","address":"0x000000000000000000000000000000000000dEaD","balance":1.0e-5,"tx_count":0,"balance_wei":"10050000000000"},"meta":{"timestamp":"2026-06-15T20:40:08.090Z","request_id":"4981929c-9721-4260-b2dc-a7923e71cf5a"},"status":"ok","message":"Superposition balance retrieved","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":["Superposition"],"summary":"Block by number (or latest)","description":"","parameters":[{"name":"number","in":"query","required":false,"description":"Block number; omit for latest","schema":{"type":"string"},"example":"1000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hash":"0xb86cb8703f8ba7bb76525e892c52bcd656b4e2b86acb30a3d32129ace70c9293","chain":"Superposition","miner":"0xa4b000000000000000000073657175656e636572","number":1000000,"gas_used":31186,"tx_count":2,"gas_limit":1125899906842624,"timestamp":1741262438,"size_bytes":906,"parent_hash":"0x7ec8723cedcf0cf48d16c5904764e0028aaf95e428d57cf142abe59df94a9fc8","timestamp_iso":"2025-03-06T12:00:38.000Z"},"meta":{"timestamp":"2026-06-15T20:40:08.345Z","request_id":"f3d3f5a0-1999-4f43-84bc-715cf0a18b0c"},"status":"ok","message":"Superposition block retrieved","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":["Superposition"],"summary":"Current gas price","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Superposition","source":"eth_gasPrice","symbol":"ETH","gas_price_wei":10000000,"gas_price_gwei":0.01},"meta":{"timestamp":"2026-06-15T20:40:08.447Z","request_id":"bd21d3e2-03a8-45ce-a0d3-5f2fc8f79c48"},"status":"ok","message":"Superposition gas retrieved","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/status":{"get":{"operationId":"get_v1_status","tags":["Superposition"],"summary":"Chain status","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Superposition","source":"Superposition L3 RPC (Arbitrum Orbit)","symbol":"ETH","chain_id":55244,"network_id":55244,"latest_block":3219532,"client_version":"nitro/vdevelopment/linux-amd64/go1.25.10"},"meta":{"timestamp":"2026-06-15T20:40:08.534Z","request_id":"2025e450-0189-4e93-aec1-3d5103bcd34b"},"status":"ok","message":"Superposition status retrieved","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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"Superposition API","chain":"Superposition","source":"Superposition Arbitrum-Orbit JSON-RPC nodes","symbol":"ETH","chain_id":55244,"endpoints":["/v1/status","/v1/block","/v1/gas","/v1/balance","/v1/meta"],"description":"Live EVM on-chain data for Superposition — an Arbitrum-Orbit DeFi Layer-3 with ETH gas and on-chain 'Super Assets' yield.","documentation":"https://superposition-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T20:40:08.628Z","request_id":"45ca3328-b195-4db0-98ca-403aedcb81dd"},"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":340,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1220,"monthly_call_quota":15400,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3470,"monthly_call_quota":80000,"rps_limit":16,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8410,"monthly_call_quota":328000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/superposition-api"}