# Satoshi API - Bitcoin Transaction AI Explanation

> Satoshi API - Bitcoin Transaction AI Explanation is a paid API for AI agents from bitcoinsapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a natural-language AI-generated explanation of a Bitcoin transaction's fee level and expected confirmation timing

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/ai/explain/transaction/%7Btxid%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satoshi-api-bitcoin-transaction-ai-explanation-f03f4c69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LLxSUd4O7l9EeZFzCnvfV

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-bitcoin-transaction-ai-explanation-f03f4c69 -d '<json body>'
```

Example prompt: Can you explain what's going on with this Bitcoin transaction — txid a1b2c3d4e5f6... — like whether the fee is reasonable and if it's likely to confirm soon?

## When to prefer this

Use this endpoint when you need a human-readable, AI-generated explanation of a specific Bitcoin transaction's fee adequacy and confirmation prospects — especially useful for agents helping non-technical users understand why a payment is delayed or whether a transaction will confirm promptly.

## Known failure modes

- Invalid or malformed txid returns an error response
- Transaction not found in mempool or blockchain history
- Upstream Bitcoin node or mempool data unavailable causing service errors
- Payment not received (x402 payment required, $0.01 USDC per call)

## 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 object containing the original txid, the provider name ('satoshi-api'), and a plain-English explanation of the transaction's fee level and expected confirmation behavior based on current mempool conditions.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "txid",
   "explanation"
  ],
  "properties": {
   "txid": {
    "type": "string"
   },
   "provider": {
    "type": "string"
   },
   "explanation": {
    "type": "string"
   }
  }
 },
 "example": {
  "txid": "{txid}",
  "provider": "satoshi-api",
  "explanation": "This transaction pays a moderate fee and is likely to confirm when the next block has room."
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satoshi-api-bitcoin-transaction-ai-explanation-f03f4c69/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)