# Explorer Gateway API — Bitcoin Block List

> Explorer Gateway API — Bitcoin Block List is a paid API for AI agents from api.blockchain.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-29).

Returns a paginated list of recent Bitcoin blocks from the blockchain.com explorer gateway, starting from the chain tip or a specified block height.

## Facts

- Endpoint: POST https://api.blockchain.com/explorer-gateway-kt/x402/btc/blocks?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/explorer-gateway-api-bitcoin-block-list-f8551b66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_11kRoSp7ZrCHQg8es_sqA

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 explorer-gateway-api-bitcoin-block-list-f8551b66 -d '<json body>'
```

Example prompt: Can you pull the last 20 Bitcoin blocks from the blockchain.com explorer, starting from the current chain tip?

## When to prefer this

Use this endpoint when you need a paginated list of Bitcoin blocks from a trusted, established block explorer (blockchain.com) with x402 micropayment access. Prefer this over alternatives when you need BTC-specific block listings with cursor-based pagination and don't require full transaction details per block.

## Known failure modes

- Invalid 'after' cursor height returns an error or empty result
- Limit exceeding 50 is rejected or capped
- Network or gateway timeout if the Bitcoin node is slow to respond
- Malformed request body returns a 400 error
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Blockchain explorer gateway — Solana, Bitcoin, Bitcoin Cash, Ethereum

## Output

A JSON array of Bitcoin block records, up to 50 blocks, ordered descending by block height. Each record contains block metadata (height, hash, timestamp, transaction count, etc.) for the requested range of the Bitcoin chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "after": {
   "type": "integer",
   "format": "int64",
   "nullable": true,
   "description": "Cursor for pagination — block height to start from (inclusive, descending). Omit to start from the current chain tip."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 1,
   "description": "Number of blocks to return (capped at 50)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "format": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/explorer-gateway-api-bitcoin-block-list-f8551b66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockchain.com](https://www.zero.xyz/host/api.blockchain.com/llms.txt)