# Satoshi API - Bitcoin Fee Briefing

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

Returns a live Bitcoin fee briefing with send-or-wait recommendations, mempool context, and cost estimates for AI agents and apps

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/x402/satoshi-bitcoin-fee/fees/briefing
- Price: $0.05/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-briefing-c51392ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rS5Hqs-HUbgWqMoNoxh4l

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-briefing-c51392ae -d '<json body>'
```

Example prompt: Check current Bitcoin mempool conditions and tell me whether I should send my transaction now or wait — give me the recommended fee rate, estimated cost in sats, and how long to wait if fees are too high.

## When to prefer this

Choose this endpoint when an AI agent or app needs to make an autonomous decision about whether to broadcast a Bitcoin transaction — it returns a pre-interpreted action directive (send/wait/defer) with fee rate and timing, rather than raw fee data that requires further interpretation. Ideal for automated wallets, DCA bots, payment processors, and any workflow where minimizing Bitcoin transaction fees is important. Prefer over raw mempool APIs when you need a human-readable briefing and agent-ready action objects without writing your own fee logic.

## Known failure modes

- Mempool data unavailable — service may return degraded confidence or error if upstream mempool source is unreachable
- Invalid or malformed request body — returns error if input schema is not a valid JSON object
- Payment failure — x402 payment of $0.05 USDC not processed, request rejected
- Rate limiting — excessive calls may be throttled
- Stale data — during mempool indexer lag, confidence level may drop to 'low'

## 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 structured JSON briefing containing: an executive summary string, a decision object with action (send/wait), recommended fee rate in sat/vB, and recheck interval in minutes; a costs object comparing send-now vs wait-for-low fees in sats; a next_block object with mempool pressure and projected block count; an agent_action directive with broadcast policy; and an estimator confidence object indicating signal source and confidence level.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "briefing",
   "decision",
   "costs",
   "agent_action"
  ],
  "properties": {
   "costs": {
    "type": "object"
   },
   "value": {
    "type": "object"
   },
   "briefing": {
    "type": "string"
   },
   "decision": {
    "type": "object"
   },
   "next_block": {
    "type": "object"
   },
   "agent_action": {
    "type": "object"
   },
   "x402_price_usd": {
    "type": "string"
   },
   "executive_summary": {
    "type": "string"
   },
   "estimator_confidence": {
    "type": "object"
   }
  }
 },
 "example": {
  "costs": {
   "send_now": {
    "total_fee_sats": 4512,
    "fee_rate_sat_vb": 32
   },
   "wait_low": {
    "total_fee_sats": 846,
    "fee_rate_sat_vb": 6,
    "savings_vs_now_sats": 3666
   }
  },
  "briefing": "Bitcoin send-or-wait briefing",
  "decision": {
   "action": "wait",
   "max_fee_sat_vb": 32,
   "recheck_in_minutes": 30,
   "recommended_fee_sat_vb": 18
  },
  "next_block": {
   "pressure": "high",
   "projected_block_count": 3
  },
  "agent_action": {
   "action": "wait",
   "broadcast_policy": "defer_non_urgent",
   "recheck_after_minutes": 30,
   "recommended_fee_sat_vb": 18
  },
  "x402_price_usd": "$0.05",
  "executive_summary": "Bitcoin fees are elevated at 32 sat/vB; wait if this is not urgent.",
  "estimator_confidence": {
   "level": "high",
   "signals": {
    "source": "mempool_ancestor"
   }
  }
 },
 "mimeType": "application/json"
}
```

## More

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