# Bitcoin Block Analytics API

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

Returns per-block analytics for the last N Bitcoin blocks (up to 144), including fee distribution percentiles, SegWit adoption, UTXO set changes, block fill rate, and summary trends from a local Bitcoin Core node.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/block-analytics
- Price: $0.03/call
- Payment: x402
- Status: down
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-5ab80550
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pHwh0m6MZtUVeJpjRmNEd

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-5ab80550
```

Example prompt: Pull Bitcoin block analytics for the last 72 blocks — I want to see the fee distribution percentiles, SegWit adoption rate, block fill rate, and UTXO set changes with a summary of recent trends.

## When to prefer this

Choose this endpoint when you need reliable, node-sourced Bitcoin block analytics including fee percentiles, SegWit adoption, UTXO changes, and fill rates across up to 144 recent blocks. It is ideal for fee market research, mining economics analysis, or on-chain trend monitoring where data integrity from a full node matters over aggregated third-party APIs.

## Known failure modes

- blocks parameter exceeds maximum of 144 — returns validation error
- blocks parameter below minimum of 1 — returns validation error
- Bitcoin Core node temporarily unavailable — returns 5xx or timeout
- Payment not included or insufficient — returns 402 Payment Required
- Invalid query parameter type (non-integer) — returns 400 Bad Request

## How this service works

Professional crypto market intelligence. Real-time prices, signals, and market scoring.

## Output

Returns a JSON object with a 'blocks' array containing per-block stats (fee percentiles, SegWit %, UTXO changes, fill rate), a 'summary' object with aggregate trends, the data source identifier, and an 'updated_at' timestamp. Data is sourced from a local Bitcoin Core node via getblockstats RPC.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "blocks": [
   {
    "height": 941198,
    "fill_pct": 98.2,
    "tx_count": 3421,
    "block_time": "2026-03-18T21:30:00Z",
    "segwit_pct": 87.3,
    "total_fee_btc": 0.234,
    "utxo_increase": 1234,
    "avg_fee_sat_vb": 15.2,
    "feerate_percentiles": {
     "p10": 2.1,
     "p25": 5,
     "p50": 12.3,
     "p75": 25,
     "p90": 45
    }
   }
  ],
  "summary": {
   "avg_fee_trend": "rising",
   "segwit_adoption": 87.3,
   "avg_block_interval_sec": 590
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-carbon-cashmere-de-5ab80550/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)