# Satoshi API – AI-Explained Bitcoin Block Lookup

> Satoshi API – AI-Explained Bitcoin Block Lookup is a paid API for AI agents from bitcoinsapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns an AI-generated natural-language explanation of a specific Bitcoin block identified by its hash or height, including fee and mempool context.

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/ai/explain/block/%7Bhash_or_height%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satoshi-api-ai-explained-bitcoin-block-lookup-17a99b2d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HUAyp4aRgwWcs6S3C1Gl9

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 satoshi-api-ai-explained-bitcoin-block-lookup-17a99b2d -d '<json body>'
```

Example prompt: Can you give me an AI-generated plain-English explanation of Bitcoin block 840000 — what happened in it, what fees were like, and any notable mempool context?

## When to prefer this

Choose this endpoint when you need a human-readable, AI-generated narrative explanation of a specific Bitcoin block — ideal for block explorer UIs, educational tools, AI agents that need to reason about historical Bitcoin fee environments, or any app where raw block data needs to be translated into plain English. Prefer this over raw block data APIs when the consumer is a human or an LLM that benefits from contextual prose rather than structured numbers.

## Known failure modes

- Invalid or non-existent block hash returns an error or empty explanation
- Block height out of range (e.g. future blocks) returns a not-found error
- Malformed input schema causes a 400 bad request
- Payment not provided or insufficient USDC results in a 402 payment required error
- Network timeout if mempool data source is temporarily unavailable

## How this service works

Know when to send Bitcoin and when to wait. Satoshi API gives apps and AI agents live fee recommendations, mempool context, and cost estimates. Free, open source.

## Output

A JSON response containing an 'ok' boolean status and a 'source' field ('satoshi-api'), along with an AI-generated natural-language explanation of the requested Bitcoin block — covering block contents, transaction fee levels, mempool conditions, and notable context at the time the block was mined.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "ok": {
    "type": "boolean"
   },
   "source": {
    "type": "string"
   }
  }
 },
 "example": {
  "ok": true,
  "source": "satoshi-api"
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satoshi-api-ai-explained-bitcoin-block-lookup-17a99b2d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bitcoinsapi.com](https://www.zero.xyz/host/bitcoinsapi.com/llms.txt)