# Satoshi API - Bitcoin Fee Intelligence

> Satoshi API - Bitcoin Fee Intelligence 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 AI-generated Bitcoin transaction fee advice, urgency rating, and cost estimates based on live mempool conditions

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/ai/fees/advice
- 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-3cb138a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CvQ0d7ggC_3z1dPfUZ1lg

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-3cb138a0 -d '<json body>'
```

Example prompt: Should I send my Bitcoin transaction right now, or wait for fees to drop? Give me the current fee advice including what sat/vB to target and how much I could save by waiting.

## When to prefer this

Choose this endpoint when you need human-readable, AI-interpreted Bitcoin fee advice rather than raw fee data. It is ideal for AI agents that need to decide whether to trigger a Bitcoin transaction autonomously, or for apps that want to surface plain-language fee guidance to end users. Prefer this over raw mempool APIs when you need urgency classification, savings estimates, and actionable recommendations in a single call.

## Known failure modes

- Mempool data source temporarily unavailable — returns degraded or cached advice
- Malformed input schema — returns 400 with validation error
- Service overload or rate limiting — returns 429
- Network timeout if mempool provider is slow to respond

## 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

Returns a JSON object with a human-readable advice string (e.g. 'Wait if not urgent; target 12 sat/vB'), an urgency label (e.g. 'normal', 'high'), a structured block containing a recommendation action ('wait' or 'send'), target fee rate in sat/vB, and estimated savings percentage if the user waits.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "advice"
  ],
  "properties": {
   "advice": {
    "type": "string"
   },
   "urgency": {
    "type": "string"
   },
   "provider": {
    "type": "string"
   },
   "structured": {
    "type": "object"
   }
  }
 },
 "example": {
  "advice": "Wait if the transaction is not urgent; target 12 sat/vB for a lower-cost confirmation.",
  "urgency": "normal",
  "provider": "satoshi-api",
  "structured": {
   "recommendation": "wait",
   "targetFeeSatVb": 12,
   "estimatedSavingsPct": 46.8
  }
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satoshi-api-bitcoin-fee-intelligence-3cb138a0/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)