{"openapi":"3.1.0","info":{"title":"Bitcoin Stats API","version":"1.0.0","description":"Live Bitcoin on-chain economics and network-activity statistics, built on the open blockchain.com dataset — the macro on-chain layer, not raw address or mempool lookups: a live network snapshot (24h transaction count and USD volume, hash rate, market price and cap, total mined supply, miners' revenue), the historical time series of any curated on-chain metric (active addresses, transaction volume, UTXO-set size, mempool size, miner revenue, fees and more), the catalog of available metrics, and Bitcoin's issuance state (total mined, share of the 21M cap, current block reward and estimated next halving).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bitcoinstats-api","description":"oanor gateway"}],"tags":[{"name":"Stats"},{"name":"Metrics"},{"name":"Supply"},{"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/stats":{"get":{"operationId":"get_v1_stats","tags":["Stats"],"summary":"Live Bitcoin network economic snapshot","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"blockchain.com","timestamp":"2026-06-10T13:54:05.000Z","difficulty":138955357012247,"block_height":953110,"hash_rate_ehs":939.42,"blocks_size_mb":221217900,"market_cap_usd":1222456606896,"total_mined_btc":20040968.75,"market_price_usd":60997.88,"transactions_24h":635975,"total_fees_btc_24h":425,"miners_revenue_usd_24h":0,"minutes_between_blocks":10.15,"estimated_tx_volume_usd_24h":6142243337},"meta":{"timestamp":"2026-06-10T14:00:06.899Z","request_id":"a2fe069a-8e30-4e58-adad-1dea5af54999"},"status":"ok","message":"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/metric":{"get":{"operationId":"get_v1_metric","tags":["Metrics"],"summary":"Historical time series of an on-chain metric","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Metric name (see /v1/metrics)","schema":{"type":"string"},"example":"active-addresses"},{"name":"days","in":"query","required":false,"description":"Days of history (1-365)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"days":30,"unit":"addresses","label":"Active addresses per day","latest":{"date":"2026-06-04T00:00:00.000Z","value":538439},"metric":"active-addresses","points":25,"series":[{"date":"2026-05-11T00:00:00.000Z","value":457665},{"date":"2026-05-12T00:00:00.000Z","value":476383},{"date":"2026-05-13T00:00:00.000Z","value":485900},{"date":"2026-05-14T00:00:00.000Z","value":489856},{"date":"2026-05-15T00:00:00.000Z","value":525031},{"date":"2026-05-16T00:00:00.000Z","value":445624},{"date":"2026-05-17T00:00:00.000Z","value":396443},{"date":"2026-05-18T00:00:00.000Z","value":474167},{"date":"2026-05-19T00:00:00.000Z","value":469682},{"date":"2026-05-20T00:00:00.000Z","value":473582},{"date":"2026-05-21T00:00:00.000Z","value":484958},{"date":"2026-05-22T00:00:00.000Z","value":547131},{"date":"2026-05-23T00:00:00.000Z","value":439350},{"date":"2026-05-24T00:00:00.000Z","value":387403},{"date":"2026-05-25T00:00:00.000Z","value":430908},{"date":"2026-05-26T00:00:00.000Z","value":464460},{"date":"2026-05-27T00:00:00.000Z","value":474906},{"date":"2026-05-28T00:00:00.000Z","value":490956},{"date":"2026-05-29T00:00:00.000Z","value":518522},{"date":"2026-05-30T00:00:00.000Z","value":454741},{"date":"2026-05-31T00:00:00.000Z","value":403295},{"date":"2026-06-01T00:00:00.000Z","value":508084},{"date":"2026-06-02T00:00:00.000Z","value":501194},{"date":"2026-06-03T00:00:00.000Z","value":515383},{"date":"2026-06-04T00:00:00.000Z","value":538439}],"source":"blockchain.com"},"meta":{"timestamp":"2026-06-10T14:00:07.138Z","request_id":"fcb42a2c-852f-4f8c-9265-b38907298665"},"status":"ok","message":"Metric 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/metrics":{"get":{"operationId":"get_v1_metrics","tags":["Metrics"],"summary":"The catalog of available on-chain metrics","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":14,"source":"blockchain.com","metrics":[{"name":"active-addresses","unit":"addresses","label":"Active addresses per day"},{"name":"transactions","unit":"transactions","label":"Confirmed transactions per day"},{"name":"transaction-volume-usd","unit":"USD","label":"Estimated transaction volume"},{"name":"mempool-size","unit":"transactions","label":"Unconfirmed transactions in mempool"},{"name":"utxo-count","unit":"outputs","label":"Unspent transaction outputs (UTXO set)"},{"name":"hash-rate","unit":"TH/s","label":"Network hash rate"},{"name":"difficulty","unit":"difficulty","label":"Mining difficulty"},{"name":"miners-revenue-usd","unit":"USD","label":"Miners' revenue"},{"name":"transaction-fees-usd","unit":"USD","label":"Total transaction fees"},{"name":"avg-block-size","unit":"MB","label":"Average block size"},{"name":"cost-per-transaction","unit":"USD","label":"Miners revenue per transaction"},{"name":"market-cap-usd","unit":"USD","label":"Market capitalisation"},{"name":"exchange-volume-usd","unit":"USD","label":"Exchange trade volume"},{"name":"median-confirmation-time","unit":"minutes","label":"Median confirmation time"}]},"meta":{"timestamp":"2026-06-10T14:00:07.320Z","request_id":"aa487118-a796-437a-b8fc-40b9ab14eaed"},"status":"ok","message":"Metrics 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":"Bitcoin supply, issuance, block reward and next halving","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"blockchain.com","block_height":953110,"halving_epoch":4,"percent_mined":95.4332,"remaining_btc":959031.25,"max_supply_btc":21000000,"total_mined_btc":20040968.75,"next_halving_height":1050000,"blocks_to_next_halving":96890,"current_block_reward_btc":3.125,"est_days_to_next_halving":672.8},"meta":{"timestamp":"2026-06-10T14:00:07.506Z","request_id":"e33c2564-ecd7-4c20-8891-abbd4d417a8d"},"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/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":"blockchain.com statistics API (live)","service":"bitcoinstats-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/stats":"Live Bitcoin network economic snapshot.","GET /v1/metric":"Historical time series of an on-chain metric (name=active-addresses, days=30).","GET /v1/supply":"Bitcoin supply, issuance, block reward and next halving.","GET /v1/metrics":"The catalog of available on-chain metrics."},"description":"Live Bitcoin on-chain economics and network-activity statistics as an API, built on the open blockchain.com dataset — the macro on-chain layer, not raw address/transaction/mempool lookups. The stats endpoint returns a live network snapshot (24h transaction count and USD volume, hash rate, market price and cap, total mined supply, miners' revenue); the metric endpoint returns the historical time series of any curated on-chain metric (active addresses, transaction volume, UTXO-set size, mempool size, miner revenue, fees and more); the metrics endpoint lists the available metrics; the supply endpoint returns Bitcoin's issuance state (total mined, share of the 21M cap, current block reward, estimated next halving). Live, no key, nothing stored. Distinct from address/transaction/mempool and mining-pool APIs and from exchange price feeds — this is Bitcoin's aggregate on-chain economics and network activity.","upstream_status":"ok","market_price_usd":60997.88},"meta":{"timestamp":"2026-06-10T14:00:07.681Z","request_id":"1caf1070-db3b-4348-a7f3-9bc1ece75e07"},"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":10000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":146000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2500,"monthly_call_quota":906000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":6100,"monthly_call_quota":4760000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bitcoinstats-api"}