# Bitcoin Bulk Block Range Extractor

> Bitcoin Bulk Block Range Extractor is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/btc-derivatives/blocks-range
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-66325f9c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_665eMXCzA7x6YUQFNk3Fr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-carbon-cashmere-de-66325f9c
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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).

## Output

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.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "end_block": "840143",
   "start_block": "840000"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-carbon-cashmere-de-66325f9c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.carbon-cashmere.de](https://www.zero.xyz/host/api.carbon-cashmere.de/llms.txt)