# Satoshi API - Bitcoin Fee Landscape

> Satoshi API - Bitcoin Fee Landscape is a paid API for AI agents from bitcoinsapi.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a send-or-wait recommendation with live Bitcoin fee estimates, mempool context, confidence score, and potential savings percentage

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/fees/landscape
- Price: $0.005/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-landscape-f9766cf2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XDASfp6GHvrH3TWoumQ8g

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-landscape-f9766cf2 -d '<json body>'
```

Example prompt: Should I send this Bitcoin transaction right now or wait for fees to drop? Give me the current fee landscape with a send-or-wait verdict and tell me how much I could save by waiting.

## When to prefer this

Choose this endpoint when an agent or app needs a ready-made send-or-wait decision with human-readable reasoning rather than raw fee data alone. It is ideal for user-facing Bitcoin wallets, automated payment schedulers, or cost-optimization workflows that need an AI-interpretable recommendation plus potential savings estimate — not just a list of fee tiers.

## Known failure modes

- Upstream mempool data source unavailable — may return stale or error response
- Malformed input schema causing 400 Bad Request
- x402 payment failure or insufficient USDC balance preventing access
- Low confidence score (below 0.5) when mempool conditions are volatile and unpredictable
- Rate limiting if payment mechanism fails

## 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: a 'recommendation' field ('send' or 'wait'), current fee rates (fastestFeeSatVb, halfHourFeeSatVb, hourFeeSatVb in sat/vB), a human-readable 'reasoning' string, a 'confidence' score (0–1), a 'potentialSavingsPct' percentage, and an array of 'scenarios' with suggested actions, urgency levels, and target fee rates.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "recommendation",
   "currentFees"
  ],
  "properties": {
   "reasoning": {
    "type": "string"
   },
   "scenarios": {
    "type": "array"
   },
   "confidence": {
    "type": "number"
   },
   "currentFees": {
    "type": "object"
   },
   "recommendation": {
    "type": "string",
    "description": "Send-or-wait verdict for the current Bitcoin fee market."
   },
   "potentialSavingsPct": {
    "type": "number"
   }
  }
 },
 "example": {
  "reasoning": "Mempool pressure is elevated; waiting about 2 hours can reduce the expected fee.",
  "scenarios": [
   {
    "action": "wait",
    "urgency": "low",
    "targetFeeSatVb": 12
   }
  ],
  "confidence": 0.82,
  "currentFees": {
   "hourFeeSatVb": 12,
   "fastestFeeSatVb": 22,
   "halfHourFeeSatVb": 18
  },
  "recommendation": "wait",
  "potentialSavingsPct": 46.8
 },
 "mimeType": "application/json"
}
```

## More

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