{"uid":"cap_665eMXCzA7x6YUQFNk3Fr","slug":"api-carbon-cashmere-de-66325f9c","name":"Bitcoin Bulk Block Range Extractor","description":"Bulk Bitcoin block extract (max 144 blocks per call = $1.44 cap). Returns array of per-block summaries (height, time, miner pool, tx count, witness/taproot/ordinals/op_return stats, total output, coinbase reward).","url":"https://api.carbon-cashmere.de/v1/btc-derivatives/blocks-range","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"end":949843,"start":949700,"blocks":[{"height":949700,"tx_count":2540,"miner_pool":"Foundry USA","taproot_pct":12.5,"witness_pct":97.1}],"returned":144}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"end_block":"840143","start_block":"840000"}}},"response":{"end":950909,"note":"Heights outside our captured range (pre-pipeline-deploy or post-pruning) are silently skipped.","start":950886,"blocks":[{"height":950886,"tx_count":6745,"block_time":"2026-05-25T00:43:42+00:00","miner_pool":"F2Pool","taproot_pct":3.069999933242798,"witness_pct":99.91000366210938,"total_out_btc":4399.7606497,"op_return_count":6519,"inscriptions_count":11,"coinbase_reward_btc":3.13157083},{"height":950887,"tx_count":3987,"block_time":"2026-05-25T01:04:04+00:00","miner_pool":null,"taproot_pct":17.280000686645508,"witness_pct":96.44000244140625,"total_out_btc":4926.08803491,"op_return_count":1697,"inscriptions_count":146,"coinbase_reward_btc":3.14463897},{"height":950888,"tx_count":4569,"block_time":"2026-05-25T01:39:30+00:00","miner_pool":null,"taproot_pct":10.9399995803833,"witness_pct":94.98999786376953,"total_out_btc":7683.32046088,"op_return_count":1873,"inscriptions_count":4,"coinbase_reward_btc":3.1532463},{"height":950889,"tx_count":4425,"block_time":"2026-05-25T01:50:13+00:00","miner_pool":null,"taproot_pct":15.34000015258789,"witness_pct":96.58999633789062,"total_out_btc":3011.9530176,"op_return_count":1978,"inscriptions_count":115,"coinbase_reward_btc":3.14269191},{"height":950890,"tx_count":6626,"block_time":"2026-05-25T01:51:14+00:00","miner_pool":"Foundry USA","taproot_pct":5.070000171661377,"witness_pct":99.66999816894531,"total_out_btc":230.83505351,"op_return_count":6420,"inscriptions_count":13,"coinbase_reward_btc":3.13272165},{"height":950891,"tx_count":6035,"block_time":"2026-05-25T01:55:56+00:00","miner_pool":null,"taproot_pct":3.859999895095825,"witness_pct":99.38999938964844,"total_out_btc":4717.8014234,"op_return_count":5424,"inscriptions_count":28,"coinbase_reward_btc":3.13350449},{"height":950892,"tx_count":5595,"block_time":"2026-05-25T02:01:30+00:00","miner_pool":"ViaBTC","taproot_pct":5.269999980926514,"witness_pct":99.25,"total_out_btc":1335.57438597,"op_return_count":4797,"inscriptions_count":10,"coinbase_reward_btc":3.13538658},{"height":950893,"tx_count":5888,"block_time":"2026-05-25T02:06:16+00:00","miner_pool":"Foundry USA","taproot_pct":5.300000190734863,"witness_pct":99.06999969482422,"total_out_btc":3597.33548883,"op_return_count":5247,"inscriptions_count":23,"coinbase_reward_btc":3.13437157},{"height":950894,"tx_count":7121,"block_time":"2026-05-25T02:06:38+00:00","miner_pool":"Foundry USA","taproot_pct":0.20999999344348907,"witness_pct":99.97000122070312,"total_out_btc":11.03910704,"op_return_count":7088,"inscriptions_count":3,"coinbase_reward_btc":3.12977377},{"height":950895,"tx_count":5725,"block_time":"2026-05-25T02:14:41+00:00","miner_pool":null,"taproot_pct":6.96999979019165,"witness_pct":98.69000244140625,"total_out_btc":26051.37160029,"op_return_count":4733,"inscriptions_count":47,"coinbase_reward_btc":3.1355788},{"height":950896,"tx_count":6605,"block_time":"2026-05-25T02:17:08+00:00","miner_pool":null,"taproot_pct":2.4100000858306885,"witness_pct":99.79000091552734,"total_out_btc":189.69616169,"op_return_count":6344,"inscriptions_count":13,"coinbase_reward_btc":3.1345295},{"height":950897,"tx_count":5953,"block_time":"2026-05-25T02:23:06+00:00","miner_pool":"Foundry USA","taproot_pct":7.119999885559082,"witness_pct":99.02999877929688,"total_out_btc":1323.56858682,"op_return_count":5081,"inscriptions_count":40,"coinbase_reward_btc":3.13522394},{"height":950898,"tx_count":7013,"block_time":"2026-05-25T02:24:04+00:00","miner_pool":"Foundry USA","taproot_pct":1.350000023841858,"witness_pct":99.91000366210938,"total_out_btc":193.41562781,"op_return_count":6899,"inscriptions_count":7,"coinbase_reward_btc":3.1304477},{"height":950899,"tx_count":6617,"block_time":"2026-05-25T02:26:25+00:00","miner_pool":"F2Pool","taproot_pct":4.639999866485596,"witness_pct":99.6500015258789,"total_out_btc":915.47898043,"op_return_count":6299,"inscriptions_count":24,"coinbase_reward_btc":3.1312459},{"height":950900,"tx_count":3819,"block_time":"2026-05-25T02:44:08+00:00","miner_pool":"Foundry USA","taproot_pct":17.100000381469727,"witness_pct":96.80999755859375,"total_out_btc":3220.17172306,"op_return_count":1895,"inscriptions_count":74,"coinbase_reward_btc":3.14347354},{"height":950901,"tx_count":4169,"block_time":"2026-05-25T03:02:31+00:00","miner_pool":null,"taproot_pct":11.510000228881836,"witness_pct":96.83000183105469,"total_out_btc":3177.58150223,"op_return_count":2309,"inscriptions_count":28,"coinbase_reward_btc":3.14698782},{"height":950902,"tx_count":4589,"block_time":"2026-05-25T03:14:14+00:00","miner_pool":null,"taproot_pct":13.180000305175781,"witness_pct":97.5199966430664,"total_out_btc":3026.10668042,"op_return_count":2834,"inscriptions_count":186,"coinbase_reward_btc":3.14339677},{"height":950903,"tx_count":5499,"block_time":"2026-05-25T03:21:54+00:00","miner_pool":null,"taproot_pct":12.819999694824219,"witness_pct":98.81999969482422,"total_out_btc":5632.90321503,"op_return_count":4211,"inscriptions_count":427,"coinbase_reward_btc":3.13709638},{"height":950904,"tx_count":4292,"block_time":"2026-05-25T03:50:48+00:00","miner_pool":"Foundry USA","taproot_pct":11.420000076293945,"witness_pct":96.87999725341797,"total_out_btc":3784.43450102,"op_return_count":1913,"inscriptions_count":9,"coinbase_reward_btc":3.1477455},{"height":950905,"tx_count":3022,"block_time":"2026-05-25T04:00:32+00:00","miner_pool":null,"taproot_pct":15.390000343322754,"witness_pct":97.08999633789062,"total_out_btc":2164.58723839,"op_return_count":1464,"inscriptions_count":77,"coinbase_reward_btc":3.15465333},{"height":950906,"tx_count":5851,"block_time":"2026-05-25T04:01:32+00:00","miner_pool":"F2Pool","taproot_pct":6.320000171661377,"witness_pct":99.56999969482422,"total_out_btc":316.27028941,"op_return_count":5193,"inscriptions_count":106,"coinbase_reward_btc":3.13234587},{"height":950907,"tx_count":3510,"block_time":"2026-05-25T04:22:03+00:00","miner_pool":"F2Pool","taproot_pct":19.260000228881836,"witness_pct":95.20999908447266,"total_out_btc":25541.0957581,"op_return_count":1254,"inscriptions_count":90,"coinbase_reward_btc":3.14532301},{"height":950908,"tx_count":6434,"block_time":"2026-05-25T04:22:45+00:00","miner_pool":"F2Pool","taproot_pct":3.6700000762939453,"witness_pct":99.91999816894531,"total_out_btc":495.78888752,"op_return_count":6329,"inscriptions_count":23,"coinbase_reward_btc":3.13156358},{"height":950909,"tx_count":5342,"block_time":"2026-05-25T04:28:16+00:00","miner_pool":null,"taproot_pct":7.320000171661377,"witness_pct":98.98999786376953,"total_out_btc":5587.06881299,"op_return_count":4529,"inscriptions_count":73,"coinbase_reward_btc":3.13607157}],"returned":24}},"exampleRequest":{"end_block":"840143","start_block":"840000"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_41mb4OgXowyXmgSR6Edu7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches per-block summaries for a range of Bitcoin blocks (up to 144 blocks per call), including miner pool, tx count, witness/taproot/ordinals/OP_RETURN stats, total output, and coinbase reward.","exampleAgentPrompt":"Pull the per-block summary for Bitcoin blocks 840000 through 840143 — I want to see miner pools, taproot and witness percentages, inscription counts, OP_RETURN counts, total BTC output, and coinbase rewards for each block.","exampleUseCases":null,"resultDescription":"An array of per-block objects covering the requested height range, each with: block height, ISO timestamp, miner pool name (or null if unknown), transaction count, witness adoption %, taproot adoption %, total output in BTC, OP_RETURN count, inscriptions count, and coinbase reward in BTC. Also includes the actual start/end heights returned and a note about silently skipped heights outside the captured pipeline range.","failureModes":["Requested range exceeds 144 blocks — call will be rejected or capped","Block heights outside the captured pipeline range are silently skipped with no error","Invalid or non-integer block height parameters return an error","start_block greater than end_block causes an error or empty result","Payment not included or insufficient USDC causes x402 payment required error"],"whenToPreferThis":"Use this endpoint when you need bulk Bitcoin block-level analytics across multiple consecutive heights in a single call — especially for on-chain research into miner pool distribution, taproot/witness adoption trends, ordinals/inscriptions activity, or OP_RETURN usage. Prefer it over single-block APIs when you need up to 144 blocks at once without making repeated individual calls. It is best suited for batch analysis, historical research, and trend detection rather than real-time monitoring of a single block.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:48:32.880Z","isFirstParty":false}