{"openapi":"3.1.0","info":{"title":"Conflux On-Chain API","version":"1.0.0","description":"Live on-chain data from the Conflux (CFX) network — a high-throughput Layer-1 that orders blocks with the Tree-Graph DAG consensus (not a single chain) and runs two spaces: the native Core space (cfx: addresses) and an EVM-compatible eSpace. Served live from a public Conflux Core-space JSON-RPC node as clean JSON. Conflux is distinctive for its storage-collateral model and a built-in proof-of-stake interest rate. Read the chain state (chain id, current epoch, block number, latest-finalized epoch, pending-tx count and the PoS interest rate); the supply (circulating, issued, staked and storage-collateral CFX); a block (the pivot block of an epoch) by epoch number or hash; or a Core-space address's CFX balance and staked balance. Read live from Conflux, nothing cached. This is Conflux's own Tree-Graph, storage-collateral and PoS layer — distinct from the Bitcoin, Decred, Ergo, Nervos and other on-chain APIs and from price feeds.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/conflux-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Supply"},{"name":"Block"},{"name":"Balance"},{"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":"Chain state — chain id, epoch, block number, finalized epoch, PoS interest","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"conflux","source":"Conflux","chain_id":1029,"consensus":"Tree-Graph DAG (GHAST)","network_id":1029,"block_number":362695783,"epoch_number":149585224,"native_token":"CFX","pending_tx_count":6,"latest_finalized_epoch":149584980,"latest_checkpoint_epoch":149520000,"pos_interest_rate_per_block":2057282496000},"meta":{"timestamp":"2026-06-10T22:58:22.031Z","request_id":"ae4d1733-bf5a-41e0-bac4-a8d209892f4d"},"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/supply":{"get":{"operationId":"get_v1_supply","tags":["Supply"],"summary":"Circulating, issued, staked and storage-collateral CFX","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Conflux","native_token":"CFX","total_issued_cfx":5788447553.196771,"total_staking_cfx":887692356.188266,"total_collateral_cfx":3276375.27598517,"total_circulating_cfx":5788447553.196771,"total_espace_tokens_cfx":296154761.2741488},"meta":{"timestamp":"2026-06-10T22:58:22.325Z","request_id":"5605e696-e23c-4c9c-90d8-df8233bf111c"},"status":"ok","message":"Supply 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":["Block"],"summary":"A block (epoch pivot) by epoch number, tag or hash","description":"","parameters":[{"name":"epoch","in":"query","required":false,"description":"Epoch number or tag (latest_state, latest_finalized)","schema":{"type":"string"},"example":"latest_state"},{"name":"hash","in":"query","required":false,"description":"Block hash (0x + 64 hex)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hash":"0x867105636372522ed45a25f8d07a4c92e42728daf0b082bd7b30f00886c0c840","miner":"cfx:aamgvyzht7h1zxdghb9ee9w26wrz8rd3gj837392dp","height":149585220,"source":"Conflux","gas_used":0,"gas_limit":54000000,"timestamp":"2026-06-10T22:58:12.000Z","difficulty":359067596443,"size_bytes":0,"parent_hash":"0xf3d1644e03ec869676d7171491ab726fff747772a3045eb5f2bfe66ad6628b24","pow_quality":"0xba4e8a9bd0","block_number":362695775,"epoch_number":149585220,"transaction_count":0},"meta":{"timestamp":"2026-06-10T22:58:22.607Z","request_id":"0d2d0863-cf1e-4524-8647-c199f747c869"},"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/balance":{"get":{"operationId":"get_v1_balance","tags":["Balance"],"summary":"A Core-space address's CFX balance and staked balance","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Conflux Core-space address (cfx:...)","schema":{"type":"string"},"example":"cfx:aara421audx4ev6t7c40a3f6vzjwf5a3apxbm53nxc"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Conflux","address":"cfx:aara421audx4ev6t7c40a3f6vzjwf5a3apxbm53nxc","balance_cfx":53578.30923481,"staking_balance_cfx":0,"storage_collateral_cfx":0},"meta":{"timestamp":"2026-06-10T22:58:23.286Z","request_id":"a106ce78-146e-49d5-af2f-d5e87e65020f"},"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":{"source":"Conflux Core-space JSON-RPC (main.confluxrpc.com, live)","service":"conflux-api","consensus":"Tree-Graph DAG (GHAST)","endpoints":{"GET /v1/meta":"This document.","GET /v1/block":"A block (epoch pivot) by epoch number or hash (epoch=149620000 or hash=0x…, or tag latest_state).","GET /v1/supply":"Circulating, issued, staked and storage-collateral CFX.","GET /v1/balance":"A Core-space address's CFX balance and staked balance (address=cfx:...).","GET /v1/network":"Chain state — chain id, epoch, block number, finalized epoch, PoS interest."},"description":"Live on-chain data from the Conflux (CFX) network, a high-throughput Layer-1 that orders blocks with the Tree-Graph DAG consensus and runs a native Core space (cfx: addresses) plus an EVM-compatible eSpace, via a public Conflux Core-space JSON-RPC node. The network endpoint returns the chain state (chain id, epoch, block number, latest-finalized epoch, pending-tx count, PoS interest rate); the supply endpoint returns circulating, issued, staked and storage-collateral CFX; the block endpoint returns a block by epoch number or hash; the balance endpoint returns a Core-space address's CFX balance and staked balance. Live, no key, nothing stored. Distinct from the Bitcoin, Decred, Ergo, Nervos and other on-chain APIs and from price feeds — this is Conflux's own Tree-Graph, storage-collateral and PoS layer.","epoch_number":149585225,"native_token":"CFX","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:58:23.578Z","request_id":"94615dcc-b49b-4bbe-bb08-ed05550b9f49"},"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":950,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1080,"monthly_call_quota":34000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":175000,"rps_limit":28,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":6750,"monthly_call_quota":880000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/conflux-api"}