# Bitcoin Network Status

> Bitcoin Network Status is a paid API for AI agents from diamond.btc-intel.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-21).

Returns current Bitcoin network statistics including block height, mining difficulty, estimated hashrate, next difficulty retarget info, and next halving countdown.

## Facts

- Endpoint: GET https://diamond.btc-intel.workers.dev/api/x402/network?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-network-status-95f2a14b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gyLSIW4SCRr-sBHQ_gsF8

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 bitcoin-network-status-95f2a14b
```

Example prompt: What's the current state of the Bitcoin network — block height, hashrate, how many blocks until the next halving, and when is the next difficulty retarget and by how much?

## When to prefer this

Use this endpoint when you need a single, consolidated snapshot of key Bitcoin network metrics — block height, hashrate, difficulty retarget, and halving countdown — without having to query multiple blockchain explorers or run your own node. Prefer this over raw block explorers when you need structured JSON output suitable for agent pipelines, and when halving or difficulty adjustment forecasting is part of the query.

## Known failure modes

- Upstream Bitcoin node unavailable — returns 5xx error
- Rate limit exceeded — returns 429 if called too frequently
- Stale data if the underlying node is syncing — height may lag slightly
- Network connectivity issues to the Cloudflare Worker — returns 5xx

## How this service works

Bitcoin network status: height, difficulty, estimated hashrate, the next difficulty adjustment (blocks left, estimated change) and the next halving (blocks left, estimated date).

## Output

A JSON object containing: current block height, estimated hashrate in EH/s, blocks remaining until the next difficulty retarget with estimated percentage change, and blocks remaining until the next halving event.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "height": 974953,
  "halving": {
   "blocks_left": 75047
  },
  "product": "network_status",
  "retarget": {
   "blocks_left": 1203,
   "est_change_pct": 1.8
  },
  "hashrate_eh_s": 900
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-network-status-95f2a14b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from diamond.btc-intel.workers.dev](https://www.zero.xyz/host/diamond.btc-intel.workers.dev/llms.txt)
