# Bitcoin On-Chain Network Intelligence

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

Returns real-time Bitcoin network health metrics including hashrate, mining difficulty, block height, mempool transaction count, fee estimates by priority, and inter-block timing from a local Bitcoin Core node.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/onchain/btc
- Price: $0.05/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-a2dce0ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6m59KLCdzEV2uIoUfe_A1

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-a2dce0ab
```

Example prompt: What are the current Bitcoin network stats right now — hashrate, mining difficulty, current block height, mempool size, and recommended fees for fast versus slow confirmation?

## When to prefer this

Choose this endpoint when you need a comprehensive snapshot of Bitcoin on-chain health in a single call — combining hashrate, difficulty, block height, mempool depth, and fee estimates together. Prefer this over block-explorer scraping or exchange APIs when you need raw network fundamentals rather than price data, and when you need fee-priority tiers for transaction construction or wallet UX.

## Known failure modes

- Bitcoin Core node temporarily unavailable — 503 or timeout
- Blockchain.com or Blockstream data source unreachable — stale or missing fields
- Payment not received or invalid x402 payment header — 402 Payment Required
- Rate limit exceeded — 429 Too Many Requests

## How this service works

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

## Output

Returns a JSON object with Bitcoin network metrics: network hashrate in TH/s, current mining difficulty, latest block height, mempool transaction count, fee estimates broken down by confirmation priority tier, and average minutes between recent blocks — all sourced live from a local Bitcoin Core pruned node.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "local_node",
  "mempool": {
   "size_mb": 78.3,
   "pressure": "medium",
   "tx_count": 45230,
   "fee_trend": "rising",
   "total_fees_btc": 1.23
  },
  "network": {
   "difficulty": 92047231342.4,
   "peer_count": 18,
   "hashrate_eh": 742.3
  },
  "last_block": {
   "height": 891234,
   "size_kb": 1543,
   "tx_count": 3421
  },
  "fee_estimates": {
   "unit": "sat/vB",
   "one_hour": 12.1,
   "next_block": 25.3,
   "thirty_min": 18.5
  }
 }
}
```

## More

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