{"openapi":"3.1.0","info":{"title":"Bitcoin Historical Metrics API","version":"1.0.0","description":"The long-run on-chain economics of Bitcoin as time series, served from the public blockchain.com charts feed. Where snapshot APIs report the chain state right now, this is the history: how the hash rate, mining difficulty, miners' revenue, daily transaction count, transaction fees, market price, market capitalisation, circulating supply, mempool size, average block size, estimated on-chain transaction volume, daily unique addresses, UTXO count and median confirmation time have moved over months and years. The metric endpoint returns one metric's full daily time series over a chosen window (30 days to all-time) with summary statistics — first, last, change, percent change, minimum, maximum and average. The latest endpoint returns a metric's current value with its change versus the previous reading and versus 30 days ago. The metrics endpoint lists every available metric with its unit and category. This is the historical and charting view of Bitcoin's network economics — distinct from the live mempool-snapshot, the multi-chain network-stats and the price-feed APIs in the catalogue. Live, no key on the upstream, nothing stored.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bitcoinmetrics-api","description":"oanor gateway"}],"tags":[{"name":"Metrics"},{"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/latest":{"get":{"operationId":"get_v1_latest","tags":["Metrics"],"summary":"A metric current value + recent change","description":"","parameters":[{"name":"metric","in":"query","required":true,"description":"Metric key","schema":{"type":"string"},"example":"difficulty"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-04","name":"Difficulty","unit":"","value":138955357012247.55,"metric":"difficulty","source":"blockchain.com","category":"mining","change_pct_30d":4.89,"change_pct_vs_prev":0},"meta":{"timestamp":"2026-06-12T01:41:31.772Z","request_id":"e89ea6ee-4ba8-4dfb-b81e-ef6e88c58721"},"status":"ok","message":"Latest value 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":"One metric time series + summary","description":"","parameters":[{"name":"metric","in":"query","required":true,"description":"Metric key (see /v1/metrics)","schema":{"type":"string"},"example":"hashrate"},{"name":"timespan","in":"query","required":false,"description":"30days, 90days, 1year, 2years, 5years, all","schema":{"type":"string"},"example":"1year"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Hash Rate","unit":"TH/s","metric":"hashrate","series":[{"date":"2025-06-12","value":934223897.6608},{"date":"2025-06-13","value":915286926.7623},{"date":"2025-06-14","value":949216466.5546},{"date":"2025-06-15","value":854616743.0405},{"date":"2025-06-16","value":917456209.4405},{"date":"2025-06-17","value":741505703.5204},{"date":"2025-06-18","value":879752529.6005},{"date":"2025-06-19","value":798061223.2805},{"date":"2025-06-20","value":948875942.6405},{"date":"2025-06-21","value":886036476.2405},{"date":"2025-06-22","value":672382290.4804},{"date":"2025-06-23","value":672382290.4804},{"date":"2025-06-24","value":735221756.8804},{"date":"2025-06-25","value":898604369.5205},{"date":"2025-06-26","value":986579622.4806},{"date":"2025-06-27","value":722653863.6004},{"date":"2025-06-28","value":911172262.8005},{"date":"2025-06-29","value":995260121.1336},{"date":"2025-06-30","value":843035679.3575},{"date":"2025-07-01","value":779081248.5097},{"date":"2025-07-02","value":889547992.7013},{"date":"2025-07-03","value":877919914.3654},{"date":"2025-07-04","value":924432227.7092},{"date":"2025-07-05","value":912804149.3733},{"date":"2025-07-06","value":930246266.8772},{"date":"2025-07-07","value":877919914.3654},{"date":"2025-07-08","value":825593561.8535},{"date":"2025-07-09","value":953502423.5492},{"date":"2025-07-10","value":994200697.725},{"date":"2025-07-11","value":872105875.1974},{"date":"2025-07-12","value":918141001.6128},{"date":"2025-07-13","value":859946006.0576},{"date":"2025-07-14","value":910161831.2289},{"date":"2025-07-15","value":1029424416.0106},{"date":"2025-07-16","value":822284137.1792},{"date":"2025-07-17","value":853669027.9112},{"date":"2025-07-18","value":903884853.0825},{"date":"2025-07-19","value":891330896.7897},{"date":"2025-07-20","value":935269743.8145},{"date":"2025-07-21","value":941546721.9609},{"date":"2025-07-22","value":941546721.9609},{"date":"2025-07-23","value":878776940.4969},{"date":"2025-07-24","value":922715787.5217},{"date":"2025-07-25","value":1004316503.425},{"date":"2025-07-26","value":970032969.1339},{"date":"2025-07-27","value":869131963.3113},{"date":"2025-07-28","value":919884194.7455},{"date":"2025-07-29","value":710531240.0793},{"date":"2025-07-30","value":869131963.3113},{"date":"2025-07-31","value":976980455.109},{"date":"2025-08-01","value":957948368.3212},{"date":"2025-08-02","value":919884194.7455},{"date":"2025-08-03","value":983324484.0383},{"date":"2025-08-04","value":1084828946.9068},{"date":"2025-08-05","value":875475992.2405},{"date":"2025-08-06","value":913540165.8162},{"date":"2025-08-07","value":1021388657.614},{"date":"2025-08-08","value":870485436.2762},{"date":"2025-08-09","value":746374213.3917},{"date":"2025-08-10","value":868625162.1369},{"date":"2025-08-11","value":945836287.6602},{"date":"2025-08-12","value":881493683.0575},{"date":"2025-08-13","value":1003744631.8027},{"date":"2025-08-14","value":1042350194.5643},{"date":"2025-08-15","value":862190901.6767},{"date":"2025-08-16","value":978007589.9616},{"date":"2025-08-17","value":978007589.9616},{"date":"2025-08-18","value":990876110.8821},{"date":"2025-08-19","value":862190901.6767},{"date":"2025-08-20","value":907230724.8986},{"date":"2025-08-21","value":958704808.5808},{"date":"2025-08-22","value":939585701.6416},{"date":"2025-08-23","value":980001769.6142},{"date":"2025-08-24","value":1057370330.3732},{"date":"2025-08-25","value":909080588.9184},{"date":"2025-08-26","value":967107009.4877},{"date":"2025-08-27","value":967107009.4877},{"date":"2025-08-28","value":1025133430.0569},{"date":"2025-08-29","value":1063817710.4364},{"date":"2025-08-30","value":1018686049.9937},{"date":"2025-08-31","value":851054168.3491},{"date":"2025-09-01","value":1038028190.1834},{"date":"2025-09-02","value":1050922950.3099},{"date":"2025-09-03","value":883291068.6654},{"date":"2025-09-04","value":902633208.8552},{"date":"2025-09-05","value":957592801.74},{"date":"2025-09-06","value":946761026.3535},{"date":"2025-09-07","value":1041437128.9888},{"date":"2025-09-08","value":1082012601.5468},{"date":"2025-09-09","value":1129350652.8645},{"date":"2025-09-10","value":1149638389.1435},{"date":"2025-09-11","value":1014386813.9501},{"date":"2025-09-12","value":811509451.1601},{"date":"2025-09-13","value":953523605.1131},{"date":"2025-09-14","value":1034674550.2291},{"date":"2025-09-15","value":1102300337.8258},{"date":"2025-09-16","value":1082012601.5468},{"date":"2025-09-17","value":865610081.2375},{"date":"2025-09-18","value":1087599379.1412},{"date":"2025-09-19","value":1188749380.7898},{"date":"2025-09-20","value":1082611043.2193},{"date":"2025-09-21","value":1146294045.7616},{"date":"2025-09-22","value":1061383375.7052},{"date":"2025-09-23","value":1018928040.677},{"date":"2025-09-24","value":1082611043.2193},{"date":"2025-09-25","value":997700373.1629},{"date":"2025-09-26","value":934017370.6205},{"date":"2025-09-27","value":1096762821.562},{"date":"2025-09-28","value":1167521713.2757},{"date":"2025-09-29","value":990624483.9915},{"date":"2025-09-30","value":1139218156.5902},{"date":"2025-10-01","value":1076906913.2838},{"date":"2025-10-02","value":1019764936.4753},{"date":"2025-10-03","value":884796047.8242},{"date":"2025-10-04","value":1004768393.2919},{"date":"2025-10-05","value":1117242467.1678},{"date":"2025-10-06","value":922287405.7828},{"date":"2025-10-07","value":1034761479.6588},{"date":"2025-10-08","value":1109744195.5761},{"date":"2025-10-09","value":899792591.0076},{"date":"2025-10-10","value":989771850.1084},{"date":"2025-10-11","value":1102245923.9844},{"date":"2025-10-12","value":1087249380.8009},{"date":"2025-10-13","value":1139737281.943},{"date":"2025-10-14","value":1267207899.0024},{"date":"2025-10-15","value":1079751109.2092},{"date":"2025-10-16","value":1124278123.987},{"date":"2025-10-17","value":1159633832.2093},{"date":"2025-10-18","value":1203393599.4625},{"date":"2025-10-19","value":1013767941.3654},{"date":"2025-10-20","value":1086700886.7874},{"date":"2025-10-21","value":1093994181.3295},{"date":"2025-10-22","value":1115874064.9561},{"date":"2025-10-23","value":1035647824.992},{"date":"2025-10-24","value":1305499723.0533},{"date":"2025-10-25","value":1166927126.7515},{"date":"2025-10-26","value":1072114297.703},{"date":"2025-10-27","value":1072114297.703},{"date":"2025-10-28","value":1181513715.8359},{"date":"2025-10-29","value":929747081.6589},{"date":"2025-10-30","value":1240553837.6668},{"date":"2025-10-31","value":1085484607.9585},{"date":"2025-11-01","value":1069977684.9876},{"date":"2025-11-02","value":1201786530.2397},{"date":"2025-11-03","value":1100991530.9293},{"date":"2025-11-04","value":1015703454.5897},{"date":"2025-11-05","value":1069977684.9876},{"date":"2025-11-06","value":1085484607.9585},{"date":"2025-11-07","value":1100991530.9293},{"date":"2025-11-08","value":930415378.2501},{"date":"2025-11-09","value":1093238069.4439},{"date":"2025-11-10","value":1085484607.9585},{"date":"2025-11-11","value":1186279607.2689},{"date":"2025-11-12","value":1086613750.3494},{"date":"2025-11-16","value":1203542966.8475},{"date":"2025-11-17","value":938612125.0887},{"date":"2025-11-18","value":1006737198.6838},{"date":"2025-11-19","value":1037015009.1705},{"date":"2025-11-20","value":991598293.4404},{"date":"2025-11-21","value":1142987345.8741},{"date":"2025-11-22","value":1082431724.9006},{"date":"2025-11-23","value":1074862272.2789},{"date":"2025-11-24","value":1082431724.9006},{"date":"2025-11-25","value":870487051.4935},{"date":"2025-11-26","value":1241390229.956},{"date":"2025-11-27","value":1061465507.6302},{"date":"2025-11-28","value":1113270480.6428},{"date":"2025-11-29","value":1016787038.9871},{"date":"2025-11-30","value":1239441135.1157},{"date":"2025-12-01","value":987099826.17},{"date":"2025-12-02","value":942569006.9443},{"date":"2025-12-03","value":979678022.9657},{"date":"2025-12-04","value":979678022.9657},{"date":"2025-12-05","value":883194581.31},{"date":"2025-12-06","value":1209753922.2985},{"date":"2025-12-07","value":1187488512.6857},{"date":"2025-12-08","value":1098426874.2343},{"date":"2025-12-09","value":957412613.3528},{"date":"2025-12-10","value":1150379496.6643},{"date":"2025-12-11","value":1179902024.3227},{"date":"2025-12-12","value":1068190154.3849},{"date":"2025-12-13","value":1053456497.083},{"date":"2025-12-14","value":942954067.3191},{"date":"2025-12-15","value":987155039.2247},{"date":"2025-12-16","value":1082923811.6867},{"date":"2025-12-17","value":1016622353.8284},{"date":"2025-12-18","value":1060823325.734},{"date":"2025-12-19","value":1068190154.3849},{"date":"2025-12-20","value":1082923811.6867},{"date":"2025-12-21","value":1016622353.8284},{"date":"2025-12-22","value":1023989182.4793},{"date":"2025-12-23","value":1068190154.3849},{"date":"2025-12-24","value":1171325755.4979},{"date":"2025-12-25","value":1016973817.7683},{"date":"2025-12-26","value":1149714808.6043},{"date":"2025-12-27","value":1002315474.1679},{"date":"2025-12-28","value":1142344841.8825},{"date":"2025-12-29","value":1134974875.1607},{"date":"2025-12-30","value":877026039.8969},{"date":"2025-12-31","value":980205574.0024},{"date":"2026-01-01","value":1112864974.9952},{"date":"2026-01-02","value":1061275207.9425},{"date":"2026-01-03","value":1142344841.8825},{"date":"2026-01-04","value":1068645174.6643},{"date":"2026-01-05","value":972835607.2806},{"date":"2026-01-06","value":958095673.8369},{"date":"2026-01-07","value":1083385108.1079},{"date":"2026-01-08","value":965289669.1289},{"date":"2026-01-09","value":1033929118.9984},{"date":"2026-01-10","value":1179552938.5756},{"date":"2026-01-11","value":888305299.4211},{"date":"2026-01-12","value":1033929118.9984},{"date":"2026-01-13","value":982960782.1463},{"date":"2026-01-14","value":902867681.3789},{"date":"2026-01-15","value":1012085546.0618},{"date":"2026-01-16","value":946554827.252},{"date":"2026-01-17","value":1084897455.8504},{"date":"2026-01-18","value":1019366737.0406},{"date":"2026-01-19","value":1092178646.8293},{"date":"2026-01-20","value":968398400.1886},{"date":"2026-01-21","value":997523164.1041},{"date":"2026-01-22","value":1163912656.9542},{"date":"2026-01-23","value":985930374.4705},{"date":"2026-01-24","value":690151262.1293},{"date":"2026-01-25","value":760574860.3058},{"date":"2026-01-26","value":873252617.3881},{"date":"2026-01-27","value":859167897.7528},{"date":"2026-01-28","value":774659579.9411},{"date":"2026-01-29","value":901422056.6587},{"date":"2026-01-30","value":922549136.1116},{"date":"2026-01-31","value":971845654.8352},{"date":"2026-02-01","value":838040818.2999},{"date":"2026-02-02","value":830998458.4822},{"date":"2026-02-03","value":929591495.9293},{"date":"2026-02-04","value":1000015094.1058},{"date":"2026-02-05","value":894379696.8411},{"date":"2026-02-06","value":1021142173.5587},{"date":"2026-02-07","value":1116396723.6284},{"date":"2026-02-08","value":1063649660.9827},{"date":"2026-02-09","value":1019852322.001},{"date":"2026-02-10","value":900973830.4795},{"date":"2026-02-11","value":982311745.7311},{"date":"2026-02-12","value":1107446999.9643},{"date":"2026-02-13","value":944771169.4611},{"date":"2026-02-14","value":1038622610.136},{"date":"2026-02-15","value":1232582254.1976},{"date":"2026-02-16","value":1094933474.541},{"date":"2026-02-17","value":1032365847.4244},{"date":"2026-02-18","value":957284694.8844},{"date":"2026-02-19","value":1020622252.4873},{"date":"2026-02-20","value":983397435.8767},{"date":"2026-02-21","value":854191933.3527},{"date":"2026-02-22","value":1177205689.6626},{"date":"2026-02-23","value":1062356354.0857},{"date":"2026-02-24","value":1184383773.1361},{"date":"2026-02-25","value":1119781021.8742},{"date":"2026-02-26","value":1004931686.2973},{"date":"2026-02-27","value":1012109769.7709},{"date":"2026-02-28","value":1026465936.718},{"date":"2026-03-01","value":1069534437.5593},{"date":"2026-03-02","value":976219352.4031},{"date":"2026-03-03","value":961863185.456},{"date":"2026-03-04","value":933150851.5618},{"date":"2026-03-05","value":1192841923.705},{"date":"2026-03-06","value":1052672432.0365},{"date":"2026-03-07","value":951731239.9234},{"date":"2026-03-08","value":966151410.2253},{"date":"2026-03-09","value":994991750.829},{"date":"2026-03-10","value":994991750.829},{"date":"2026-03-11","value":1002201835.9799},{"date":"2026-03-12","value":930100984.4706},{"date":"2026-03-13","value":872420303.2631},{"date":"2026-03-14","value":922890899.3197},{"date":"2026-03-15","value":901260643.8668},{"date":"2026-03-16","value":901260643.8668},{"date":"2026-03-17","value":915680814.1687},{"date":"2026-03-18","value":1002201835.9799},{"date":"2026-03-19","value":966151410.2253},{"date":"2026-03-20","value":958881917.8174},{"date":"2026-03-21","value":917823292.9612},{"date":"2026-03-22","value":1077444735.2153},{"date":"2026-03-23","value":1064142948.3608},{"date":"2026-03-24","value":831361678.4068},{"date":"2026-03-25","value":1017586694.37},{"date":"2026-03-26","value":1097397415.497},{"date":"2026-03-27","value":1010935800.9427},{"date":"2026-03-28","value":1157255456.3423},{"date":"2026-03-29","value":957728653.5247},{"date":"2026-03-30","value":904521506.1066},{"date":"2026-03-31","value":904521506.1066},{"date":"2026-04-01","value":1077444735.2153},{"date":"2026-04-02","value":964379546.9519},{"date":"2026-04-03","value":898750099.8899},{"date":"2026-04-04","value":828969681.6295},{"date":"2026-04-05","value":1098384828.1592},{"date":"2026-04-06","value":884234327.0715},{"date":"2026-04-07","value":953315133.874},{"date":"2026-04-08","value":1022395940.6764},{"date":"2026-04-09","value":994763617.9555},{"date":"2026-04-10","value":863510085.0308},{"date":"2026-04-11","value":849693923.6703},{"date":"2026-04-12","value":1070752505.4382},{"date":"2026-04-13","value":1022395940.6764},{"date":"2026-04-14","value":1132925231.5604},{"date":"2026-04-15","value":863510085.0308},{"date":"2026-04-16","value":1050028263.3974},{"date":"2026-04-17","value":968172577.6598},{"date":"2026-04-18","value":1031290054.5635},{"date":"2026-04-19","value":1064992343.9283},{"date":"2026-04-20","value":876259523.4853},{"date":"2026-04-21","value":909961812.8501},{"date":"2026-04-22","value":882999981.3583},{"date":"2026-04-23","value":815595402.6286},{"date":"2026-04-24","value":1004328223.0716},{"date":"2026-04-25","value":943664102.215},{"date":"2026-04-26","value":1004328223.0716},{"date":"2026-04-27","value":930183186.469},{"date":"2026-04-28","value":936923644.342},{"date":"2026-04-29","value":856038149.8664},{"date":"2026-04-30","value":943664102.215},{"date":"2026-05-01","value":1064992343.9283},{"date":"2026-05-02","value":897607937.21},{"date":"2026-05-03","value":1000953347.1459},{"date":"2026-05-04","value":981197688.9786},{"date":"2026-05-05","value":987782908.3677},{"date":"2026-05-06","value":928515933.8656},{"date":"2026-05-07","value":935101153.2547},{"date":"2026-05-08","value":968027250.2003},{"date":"2026-05-09","value":1126072515.5392},{"date":"2026-05-10","value":987782908.3677},{"date":"2026-05-11","value":1086561199.2045},{"date":"2026-05-12","value":882419398.1418},{"date":"2026-05-13","value":915345495.0874},{"date":"2026-05-14","value":994368127.7568},{"date":"2026-05-15","value":963695673.6867},{"date":"2026-05-16","value":1025406923.1512},{"date":"2026-05-17","value":950708405.5707},{"date":"2026-05-18","value":950708405.5707},{"date":"2026-05-19","value":964289954.2217},{"date":"2026-05-20","value":1032197697.4767},{"date":"2026-05-21","value":862428339.3391},{"date":"2026-05-22","value":1059360794.7787},{"date":"2026-05-23","value":1113686989.3828},{"date":"2026-05-24","value":889591436.6411},{"date":"2026-05-25","value":1120477763.7083},{"date":"2026-05-26","value":943917631.2452},{"date":"2026-05-27","value":950708405.5707},{"date":"2026-05-28","value":1100105440.7318},{"date":"2026-05-29","value":959580184.8629},{"date":"2026-05-30","value":980866173.4256},{"date":"2026-05-31","value":994681189.9527},{"date":"2026-06-01","value":932513615.5806},{"date":"2026-06-02","value":759825908.9916},{"date":"2026-06-03","value":746010892.4645},{"date":"2026-06-04","value":980866173.4256}],"source":"blockchain.com","summary":{"max":1305499723.0533,"min":672382290.4804,"last":980866173.4256,"first":934223897.6608,"change":46642275.7648,"points":355,"average":991569058.7889,"change_pct":4.99},"category":"mining","timespan":"1year"},"meta":{"timestamp":"2026-06-12T01:41:32.015Z","request_id":"893a2f1c-14f2-4870-af1a-04e9c8bbd223"},"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":"Directory of available metrics","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":15,"source":"blockchain.com","metrics":[{"name":"Market Price","unit":"USD","chart":"market-price","metric":"price","category":"market"},{"name":"Market Capitalization","unit":"USD","chart":"market-cap","metric":"marketcap","category":"market"},{"name":"Hash Rate","unit":"TH/s","chart":"hash-rate","metric":"hashrate","category":"mining"},{"name":"Difficulty","unit":"","chart":"difficulty","metric":"difficulty","category":"mining"},{"name":"Miners Revenue","unit":"USD","chart":"miners-revenue","metric":"miners-revenue","category":"mining"},{"name":"Transactions per Day","unit":"count","chart":"n-transactions","metric":"transactions","category":"network"},{"name":"Transaction Fees","unit":"USD","chart":"transaction-fees-usd","metric":"fees-usd","category":"network"},{"name":"Cost per Transaction","unit":"USD","chart":"cost-per-transaction","metric":"cost-per-tx","category":"network"},{"name":"Circulating Supply","unit":"BTC","chart":"total-bitcoins","metric":"supply","category":"supply"},{"name":"Mempool Size","unit":"bytes","chart":"mempool-size","metric":"mempool-bytes","category":"network"},{"name":"Average Block Size","unit":"MB","chart":"avg-block-size","metric":"block-size","category":"network"},{"name":"Est. Transaction Volume","unit":"USD","chart":"estimated-transaction-volume-usd","metric":"tx-volume-usd","category":"network"},{"name":"Unique Addresses per Day","unit":"count","chart":"n-unique-addresses","metric":"unique-addresses","category":"network"},{"name":"UTXO Count","unit":"count","chart":"utxo-count","metric":"utxo-count","category":"network"},{"name":"Median Confirmation Time","unit":"minutes","chart":"median-confirmation-time","metric":"confirmation-time","category":"network"}],"timespans":["30days","60days","90days","180days","1year","2years","3years","5years","8years","all"]},"meta":{"timestamp":"2026-06-12T01:41:32.109Z","request_id":"e48c57a1-9213-48a2-a848-f6e28c136e95"},"status":"ok","message":"Metrics directory 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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"metric is one of the keys from /v1/metrics (hash-rate, difficulty, miners-revenue, transactions, fees-usd, market price, supply …). timespan is 30days, 90days, 1year (default), 2years, 5years or all. Each metric is a daily time series; values carry the unit shown in the metrics directory.","source":"blockchain.com charts API (api.blockchain.info/charts, live)","service":"bitcoinmetrics-api","btc_price":61450.38,"endpoints":{"GET /v1/meta":"This document.","GET /v1/latest":"A metric's current value with recent change (metric=difficulty).","GET /v1/metric":"One metric's time series + summary over a window (metric=hashrate, timespan=1year).","GET /v1/metrics":"Directory of all available metrics with their units and categories."},"description":"The long-run on-chain economics of Bitcoin as time series, from blockchain.com. metric returns one metric's full time series over a chosen window with summary stats (first, last, change, min, max, average); latest returns a metric's current value with recent change; metrics lists every available metric (hash rate, difficulty, miners revenue, transactions, fees, market price/cap, supply, mempool size, block size, on-chain volume, unique addresses, UTXO count, confirmation time). Live, no key, nothing stored. The historical / charting view of Bitcoin's network economics — distinct from the live mempool-snapshot, multi-chain network-stats and price-feed APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:41:32.331Z","request_id":"6dd2c0d4-cff0-4bb7-be95-333eae167176"},"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":26000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":640,"monthly_call_quota":305000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1910,"monthly_call_quota":1320000,"rps_limit":40,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4480,"monthly_call_quota":4700000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bitcoinmetrics-api"}