# Bitcoin Tx Inclusion Proof

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

Returns a Bitcoin Core Merkle inclusion proof, block header, and node-observed confirmations for 1–5 transactions in a single retained Bitcoin block.

## Facts

- Endpoint: GET https://diamond.btc-intel.workers.dev/api/x402/proof?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-tx-inclusion-proof-b663fb75
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oqsB_9C3Fh2H2t6Uu9iFP

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-tx-inclusion-proof-b663fb75
```

Example prompt: Can you get me a Merkle inclusion proof for Bitcoin transactions 3e4e...ab12 and 7f9c...dd34 in block 000000000000000000024bfa...c891 — I need the block header and confirmation count too?

## When to prefer this

Use this endpoint when you need a cryptographically verifiable, standard Bitcoin Core merkleblock proof of transaction inclusion — especially for batch verification of up to 5 txids in one call. It is ideal when you need both the Merkle proof and the raw block header together for independent verification against a trusted header chain. Prefer this over block explorer APIs when you need a machine-verifiable proof artifact rather than human-readable confirmation.

## Known failure modes

- Block not retained by the pruned node — request rejected before payment
- Invalid or malformed locator string (missing colon, wrong hash length, >5 txids)
- Transaction ID not found in the specified block — rejected before payment
- Network or Cloudflare Worker timeout
- Payment not completed or x402 flow interrupted

## How this service works

Batch inclusion receipt for one to five transactions in one retained Bitcoin block. locator=blockhash:txid[,txid...]. Returns a Bitcoin Core Merkle inclusion proof, block header and node-observed confirmations. Retained blocks only; unavailable requests are rejected before payment. Verify against a 

## Output

A JSON object containing: a hex-encoded Bitcoin Core merkleblock Merkle inclusion proof (proof_hex), the 80-byte block header hex (header_hex), block metadata (hash, height, confirmations), the list of queried txids, the product label ('batch_inclusion_receipt'), and a terms disclaimer clarifying proof scope and node retention limits.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "locator"
     ],
     "properties": {
      "locator": {
       "type": "string",
       "maxLength": 389,
       "description": "64-character block hash, colon, and one to five comma-separated unique transaction ids in that block."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "block": {
   "hash": "<blockhash>",
   "height": 0,
   "confirmations": 1
  },
  "terms": "A Merkle inclusion proof for the specified block, not a statement that outputs are unspent or that a payment is irreversible. Verify against a trusted header chain. Availability is limited to blocks this pruned node retains.",
  "txids": [
   "<txid>"
  ],
  "product": "batch_inclusion_receipt",
  "proof_hex": "<hex>",
  "header_hex": "<80-byte block header hex>",
  "proof_format": "bitcoin-core-merkleblock"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-tx-inclusion-proof-b663fb75/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)
