# Bitcoin Network Health

> Bitcoin Network Health is a paid API for AI agents from bitcoin-network.x402tookit.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-29).

Returns Bitcoin network health metrics including current tip height, block pace vs 10-minute target, difficulty retarget forecast, hashrate trend, and Lightning Network size.

## Facts

- Endpoint: GET https://bitcoin-network.x402tookit.com/btc-network-health?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-network-health-d6a7dcc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-vpaXei5z1hu0Crg2ErJO

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-health-d6a7dcc3
```

Example prompt: Give me a full Bitcoin network health check — current block height, how block pace compares to the 10-minute target, when the next difficulty retarget is expected and by how much, the latest hashrate trend over the past month, and the current Lightning Network size.

## When to prefer this

Choose this endpoint when you need a comprehensive, single-call snapshot of Bitcoin network health covering block production pace, hashrate trends, upcoming difficulty changes, and Lightning Network size. Prefer this over raw blockchain explorers when you want a pre-computed verdict and human-readable summary rather than raw block data. Ideal for monitoring dashboards, agent briefings, or any workflow that needs to detect network anomalies without querying multiple separate APIs.

## Known failure modes

- Upstream data source unavailable — fields may be null
- Invalid window parameter value (must be 1m, 3m, or 6m) — may return error or default
- Lightning Network snapshot data stale or unavailable — lightning object fields may be null
- Network timeout from external Bitcoin data provider — degraded flag may be set with incomplete data

## How this service works

Bitcoin network health: tip height, block pace vs 10 minutes, difficulty retarget forecast, hashrate trend and Lightning size.

## Output

Returns a JSON object with: current tip height, average block time in minutes, block pace description, hashrate in EH/s at latest and window start, hashrate change percent, blocks until next retarget, estimated retarget date, estimated difficulty change percent, previous retarget percent, retarget progress percent, Lightning Network node/channel/capacity snapshot, a boolean degraded flag, a human-readable verdict and summary, a list of reasons for any degradation, data source URL, snapshot timestamp, and a disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "window": {
       "type": "string",
       "description": "Hashrate trend window: 1m (default), 3m or 6m"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "pace": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "lightning": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "nodes": {
         "type": [
          "null",
          "number"
         ]
        },
        "channels": {
         "type": [
          "null",
          "number"
         ]
        },
        "capacityBtc": {
         "type": [
          "null",
          "number"
         ]
        },
        "snapshotDate": {
         "type": [
          "null",
          "string"
         ]
        }
       }
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "tipHeight": {
       "type": [
        "null",
        "number"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "hashrateWindow": {
       "type": [
        "null",
        "string"
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-network-health-d6a7dcc3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bitcoin-network.x402tookit.com](https://www.zero.xyz/host/bitcoin-network.x402tookit.com/llms.txt)