# One Bitcoin Block by Hash

> One Bitcoin Block by Hash is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-01).

Retrieves full details for a single Bitcoin block identified by its 64-character hex hash

## Facts

- Endpoint: POST https://twin.unykorn.org/btc-block?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/one-bitcoin-block-by-hash-7f3f050a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nZnXBjk_SK6TPcx3tlf03

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 one-bitcoin-block-by-hash-7f3f050a -d '<json body>'
```

Example prompt: Can you pull up the Bitcoin block with hash 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f and show me its details?

## When to prefer this

Choose this endpoint when you have a specific Bitcoin block hash and need structured on-chain block data without running your own node. It is ideal for agents querying individual blocks by hash as part of blockchain analytics, transaction auditing, or research workflows. Prefer this over height-based lookups when you already have the hash. Part of the UnyKorn/Genesis402 network, which offers a suite of complementary Bitcoin data endpoints including address balances, UTXOs, and transaction details.

## Known failure modes

- Invalid or malformed hash (not 64 hex characters) returns a validation error
- Hash not found on the Bitcoin network returns a not-found error
- Payment failure via x402 protocol results in 402 response before block data is returned
- Network or upstream Bitcoin node unavailability may result in timeout or 503 error

## How this service works

One Bitcoin block by hash — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object with ok status, block type identifier, and a receipt object containing the payment transaction hash, USD amount charged, and a unique receipt ID, plus a generated_at ISO8601 timestamp. The block data itself is included in the response body for the queried hash.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "hash": {
     "type": "string",
     "pattern": "^[0-9a-fA-F]{64}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "btc-block",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.004,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/one-bitcoin-block-by-hash-7f3f050a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)