# btcnode.uk Recent Blocks

> btcnode.uk Recent Blocks is a paid API for AI agents from btcnode.uk, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Returns metadata for the last N Bitcoin blocks (default 10), including height, hash, size, transaction count, and timestamp

## Facts

- Endpoint: GET https://btcnode.uk/api/blocks/recent?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/btcnode-uk-recent-blocks-5b41408c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PI2qbfqVff2IMfxWym5gY

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 btcnode-uk-recent-blocks-5b41408c
```

Example prompt: Can you pull the last 10 Bitcoin blocks from btcnode.uk and show me their heights, hashes, transaction counts, and timestamps?

## When to prefer this

Choose this endpoint when you need quick, low-cost, structured metadata about recent Bitcoin blocks without needing full transaction details. Ideal for dashboards, monitoring pipelines, or any agent workflow that tracks blockchain activity in near-real-time. At $0.001 per call with no signup required, it is optimal for high-frequency polling or lightweight blockchain awareness tasks where a full node RPC is overkill.

## Known failure modes

- Payment not included or invalid — returns 402 Payment Required
- Invalid or unsupported query parameter — returns 400 Bad Request
- Bitcoin node temporarily unavailable — returns 503 Service Unavailable
- Rate limit or network timeout — returns 504 or connection error

## How this service works

Last N blocks (default 10): height, hash, size, txcount, time — flat $0.001 per call, USDC on Base, no signup.

## Output

A flat list of the last N Bitcoin blocks (default 10), each containing block height (integer), block hash (hex string), block size (bytes), transaction count (integer), and block timestamp (Unix time or ISO datetime). Data is sourced live from a Bitcoin Core node.

## 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",
     "properties": {}
    }
   },
   "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/btcnode-uk-recent-blocks-5b41408c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from btcnode.uk](https://www.zero.xyz/host/btcnode.uk/llms.txt)