# Bitcoin Block Info by Height or Hash

> Bitcoin Block Info by Height or Hash is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns detailed metadata for a Bitcoin block identified by height or hash, including fees, miner pool, transaction IDs, size, weight, and difficulty.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/bitcoin-block-info
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/proxy-suverse-io-7e077ab2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0Z-7zwGMFmTu3Qqv6cFq2

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 proxy-suverse-io-7e077ab2 -d '<json body>'
```

Example prompt: Can you pull up the full details for Bitcoin block 840000 — I want to know the miner pool, total fees, transaction count, block size and weight, and the list of transaction IDs.

## When to prefer this

Use this endpoint when you need comprehensive metadata about a specific Bitcoin block, including miner identification, fee totals, and transaction ID lists. Prefer this over generic blockchain explorers when your agent needs structured JSON data about block-level Bitcoin state for analysis, monitoring, or on-chain research workflows.

## Known failure modes

- Block not found for the given height or hash — returns 404 or empty result
- Invalid block hash format — returns validation error
- Block height exceeds current chain tip — block does not yet exist
- Network timeout or upstream Bitcoin node unavailable — returns 503
- Payment not included or invalid — returns 402 payment required

## How this service works

Bitcoin block info by height or hash. Returns hash, height, timestamp, tx count, total fees, miner pool ID, size, weight, difficulty, merkle root, version, nonce, up to 100 tx IDs. AI agent BTC block explorer API, network state analysis, mining metrics.

## Output

Returns a structured object containing the block hash, height, timestamp, transaction count, total fees paid to the miner (in satoshis or BTC), miner pool name when identifiable, block size in bytes, block weight, difficulty, merkle root, version, nonce, and a list of up to 100 transaction IDs included in that block.

## Example request

```json
{
 "height": 840000
}
```

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/proxy-suverse-io-7e077ab2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)