{"openapi":"3.1.0","info":{"title":"Chain Stats API","version":"1.0.0","description":"Live blockchain network statistics across 18 chains, from the public Blockchair feed. Get one network's full stats — price, market cap and dominance, block height, 24h transactions, circulating supply, difficulty, hashrate, mempool size and average fee; compare the major chains side by side, ranked by market cap; and read a chain's mempool congestion (pending transactions, size and fees). A multi-chain network-stats layer — distinct from single-coin price feeds and Bitcoin-only on-chain APIs: it answers how each blockchain is performing right now and how they compare. Live, with a 10-minute upstream cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/chainstats-api","description":"oanor gateway"}],"tags":[{"name":"Chain Stats"}],"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/chain":{"get":{"operationId":"get_v1_chain","tags":["Chain Stats"],"summary":"One network full stats","description":"","parameters":[{"name":"chain","in":"query","required":true,"description":"Chain id (bitcoin) or ticker alias (btc, eth, ltc)","schema":{"type":"string"},"example":"bitcoin"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"bitcoin","nodes":356,"blocks":953157,"source":"Blockchair","price_usd":61384,"difficulty":138955357012247.3,"circulation":2004108666997096,"hashrate_24h":"884161057735711313294","market_cap_usd":1230488358299,"best_block_time":"2026-06-10 22:43:44","transactions_24h":583978,"best_block_height":953156,"transactions_total":1374022221,"market_dominance_pct":55.8,"mempool_transactions":75488,"price_change_24h_pct":-0.4865,"blockchain_size_bytes":746534641183,"mempool_total_fee_usd":5700.0542,"average_transaction_fee_usd_24h":0.31120228183034293},"meta":{"timestamp":"2026-06-10T22:56:11.587Z","request_id":"ee5232ce-c5f3-47e6-8d72-3aa090c40d07"},"status":"ok","message":"Chain stats 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":["Chain Stats"],"summary":"Major chains compared, ranked by market cap","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"chains":[{"chain":"bitcoin","blocks":953157,"price_usd":61384,"market_cap_usd":1230488358299,"transactions_24h":583978,"market_dominance_pct":55.8,"price_change_24h_pct":-0.4865},{"chain":"ethereum","blocks":25291071,"price_usd":1617.34,"market_cap_usd":195231398535,"transactions_24h":2048204,"market_dominance_pct":8.85,"price_change_24h_pct":-1.407},{"chain":"dogecoin","blocks":6385576,"price_usd":0.082371,"market_cap_usd":12737332128,"transactions_24h":22876,"market_dominance_pct":0.58,"price_change_24h_pct":-2.88166},{"chain":"monero","blocks":3693543,"price_usd":334.69,"market_cap_usd":6296192889,"market_dominance_pct":0.29,"price_change_24h_pct":8.72126},{"chain":"bitcoin-cash","blocks":954784,"price_usd":193.39,"market_cap_usd":3876868257,"transactions_24h":10532,"market_dominance_pct":0.18,"price_change_24h_pct":-4.77648},{"chain":"litecoin","blocks":3122931,"price_usd":41.56,"market_cap_usd":3212559496,"transactions_24h":176238,"market_dominance_pct":0.15,"price_change_24h_pct":-3.35014}],"source":"Blockchair"},"meta":{"timestamp":"2026-06-10T22:56:11.833Z","request_id":"31a05754-df4b-4e0f-bdbb-3cb39b26d444"},"status":"ok","message":"Chains compared 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/mempool":{"get":{"operationId":"get_v1_mempool","tags":["Chain Stats"],"summary":"A chain mempool congestion","description":"","parameters":[{"name":"chain","in":"query","required":true,"description":"Chain id or ticker alias","schema":{"type":"string"},"example":"bitcoin"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"bitcoin","source":"Blockchair","mempool_tps":5.55,"mempool_size_bytes":74973996,"mempool_transactions":75488,"mempool_total_fee_usd":5700.0542,"suggested_fee_per_byte_sat":2,"average_transaction_fee_usd_24h":0.31120228183034293},"meta":{"timestamp":"2026-06-10T22:56:11.914Z","request_id":"efc4df7d-0fbe-44a8-bfaf-a0eb261f751c"},"status":"ok","message":"Mempool 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":["Chain Stats"],"summary":"Service metadata and endpoint list","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Blockchair API (api.blockchair.com, live)","service":"chainstats-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/chain":"One network's full stats (chain=bitcoin; tickers like btc/eth/ltc are aliased).","GET /v1/chains":"Major chains compared, ranked by market cap.","GET /v1/mempool":"A chain's mempool congestion (chain=bitcoin)."},"description":"Live blockchain network statistics across 18 chains, from the public Blockchair feed. The chain endpoint returns one network's full stats (price, market cap and dominance, block height, 24h transactions, circulating supply, difficulty, hashrate, mempool size and average fee); the chains endpoint compares the major chains ranked by market cap; the mempool endpoint returns a chain's mempool congestion. A multi-chain network-stats layer, distinct from single-coin price feeds and Bitcoin-only on-chain APIs. Live, with a 10-minute upstream cache.","upstream_status":"ok","supported_chains":["bitcoin","ethereum","litecoin","bitcoin-cash","dogecoin","dash","zcash","monero","groestlcoin","bitcoin-sv","ecash","ripple","stellar","cardano","polkadot","kusama","tezos","mixin"],"bitcoin_price_usd":61384},"meta":{"timestamp":"2026-06-10T22:56:11.972Z","request_id":"8533c8a3-d268-4077-80ea-906390125a3f"},"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":3650,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":790,"monthly_call_quota":82000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2110,"monthly_call_quota":430000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5060,"monthly_call_quota":2630000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/chainstats-api"}