{"openapi":"3.1.0","info":{"title":"Zilliqa API","version":"1.0.0","description":"Live on-chain data from the Zilliqa network (ZIL), one of the first sharded public blockchains with a dual-block architecture (transaction blocks carry transfers, directory-service blocks coordinate the shards): the live chain state (number of TX and DS blocks, current TX and DS epochs, block rates, number of shards, minimum gas price), an address's ZIL balance and nonce, a transaction block's number, time, transaction count, gas and DS block, and a transaction's amount, gas, sender, recipient and receipt.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/zilliqa-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Account"},{"name":"Block"},{"name":"Transaction"},{"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live sharded chain state: TX/DS blocks, epochs, shards, gas","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"zilliqa","source":"Zilliqa","num_peers":87,"num_shards":1,"native_token":"ZIL","ds_block_rate":0.0058,"num_ds_blocks":286505,"num_tx_blocks":28650494,"tx_block_rate":0.58,"current_ds_epoch":286505,"current_tx_epoch":28650494,"num_transactions":0,"transaction_rate":0,"min_gas_price_zil":0.002},"meta":{"timestamp":"2026-06-10T13:59:57.352Z","request_id":"caf5e336-514a-47b8-8fcf-0c967afd1111"},"status":"ok","message":"Network state 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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"An address ZIL balance and nonce","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Zilliqa base16 address (40 hex)","schema":{"type":"string"},"example":"43e6a5c00e25d7e37530db5005086e72fd398a9d"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"nonce":201318,"exists":true,"source":"Zilliqa","address":"43e6a5c00e25d7e37530db5005086e72fd398a9d","balance_zil":82533750.83995956},"meta":{"timestamp":"2026-06-10T13:59:57.792Z","request_id":"f1aa8723-a631-4a1d-a1f2-0a26034132ab"},"status":"ok","message":"Account 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/txblock":{"get":{"operationId":"get_v1_txblock","tags":["Block"],"summary":"A transaction block number, time, txns, gas and DS block","description":"","parameters":[{"name":"number","in":"query","required":false,"description":"TX block number or latest","schema":{"type":"string"},"example":"latest"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Zilliqa","gas_used":0,"block_num":28650496,"gas_limit":200000,"timestamp":"2026-06-10T13:59:53.872Z","block_hash":"2f5e77392b57fa1c2b58403f6363080d701721b784876c6f6f882f9e73df52a3","rewards_zil":0,"tx_fees_zil":0,"ds_block_num":286505,"prev_block_hash":"b0b2f9fd5a10a42a24f7e33f34b6b96309d7b7fbe823968be6f84a4a2083728f","num_micro_blocks":0,"num_transactions":0},"meta":{"timestamp":"2026-06-10T13:59:58.223Z","request_id":"77b32fc8-00b6-45a4-825a-ae8c98ac3b51"},"status":"ok","message":"Transaction 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/transaction":{"get":{"operationId":"get_v1_transaction","tags":["Transaction"],"summary":"A transaction amount, gas, sender, recipient and receipt","description":"","parameters":[{"name":"hash","in":"query","required":true,"description":"Transaction hash (64 hex)","schema":{"type":"string"},"example":"814a408c40e0694cf32d55caa7fa978555ef91f03b65c4e60c6a2ab51459a672"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hash":"814a408c40e0694cf32d55caa7fa978555ef91f03b65c4e60c6a2ab51459a672","nonce":173462,"source":"Zilliqa","success":true,"epoch_num":8000000,"gas_limit":50,"amount_zil":16743.8,"to_address":"8ec8e69ddfee14b0695301069e1a3c77afee98ee","gas_price_zil":0.003,"cumulative_gas":50,"sender_pub_key":"0x03418612da4ea914d985a234285ac3b2bee7f0986ef1440895d330f1b1beab813e"},"meta":{"timestamp":"2026-06-10T13:59:58.657Z","request_id":"92f907e6-0df3-4442-bfec-eb0b19bebd04"},"status":"ok","message":"Transaction 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 and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Zilliqa JSON-RPC API via a public node (api.zilliqa.com, live)","service":"zilliqa-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/account":"An address's ZIL balance and nonce (address=43e6a5c00e25d7e37530db5005086e72fd398a9d).","GET /v1/network":"Live sharded chain state: TX/DS blocks, epochs, shards, gas price.","GET /v1/txblock":"A transaction block's number, time, txns, gas and DS block (number=latest|N).","GET /v1/transaction":"A transaction's amount, gas, sender, recipient and receipt (hash=64 hex)."},"description":"Live on-chain data from the Zilliqa network (ZIL), one of the first sharded public blockchains with a dual-block architecture (transaction blocks carry transfers, directory-service blocks coordinate the shards), via a public Zilliqa node. The network endpoint returns the number of TX and DS blocks, current TX and DS epochs, block rates, number of shards and minimum gas price; the account endpoint returns an address's ZIL balance and nonce; the txblock endpoint returns a transaction block's number, time, transaction count, gas and DS block; the transaction endpoint returns a transaction's amount, gas, sender, recipient and receipt. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, Celestia, EOS, Filecoin and EVM on-chain APIs and from price feeds — this is Zilliqa's own ZIL account state, dual-block sharded architecture, blocks and transactions.","num_tx_blocks":28650497,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T13:59:59.153Z","request_id":"2f0931b5-f40f-466a-9dd9-4830feb6ec69"},"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":9000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":136000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":884000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5400,"monthly_call_quota":4620000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/zilliqa-api"}