# Satoshi API - Bitcoin Fee Intelligence (AI Chat)

> Satoshi API - Bitcoin Fee Intelligence (AI Chat) 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).

Answers natural-language questions about Bitcoin transaction fees, mempool conditions, and optimal send timing via a conversational AI endpoint.

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/ai/chat
- 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-bitcoin-fee-intelligence-ai-chat-4b981c12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UjQlNe4ZU2vInwMnHTfmU

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-fee-intelligence-ai-chat-4b981c12 -d '<json body>'
```

Example prompt: What are Bitcoin fees like right now — should I send my transaction immediately or wait for a cheaper window?

## When to prefer this

Choose this endpoint when you need a conversational, AI-interpreted answer about Bitcoin fees and mempool state rather than raw data — ideal for agents that need actionable advice phrased in plain language, or when integrating Bitcoin fee intelligence into a chat-based workflow without parsing raw mempool JSON yourself.

## Known failure modes

- Payment not provided or invalid x402 payment header returns 402 status
- Malformed or empty query body returns error
- Bitcoin network data temporarily unavailable leads to stale or degraded response
- Rate limiting if payment is not processed correctly

## 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 AI-generated natural-language answer about current Bitcoin fees, mempool conditions, and timing recommendations, along with an 'ok' boolean status and a 'source' field identifying the service.

## 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-bitcoin-fee-intelligence-ai-chat-4b981c12/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)