# Satoshi API - Bitcoin Fee Intelligence Briefing

> Satoshi API - Bitcoin Fee Intelligence 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 structured send-or-wait recommendation with live Bitcoin fee rates, mempool pressure context, and cost estimates for a transaction

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/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-intelligence-briefing-e405b7ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BqB94j2J1gTa6FlrlZvRR

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

Example prompt: Before I send this Bitcoin transaction, check current mempool conditions and tell me whether I should broadcast now or wait — and what fee rate I should use if I send now.

## When to prefer this

Choose this endpoint when an AI agent or application needs a structured, actionable decision (not just raw fee data) about whether to broadcast a Bitcoin transaction now or defer. It is ideal for autonomous payment agents, wallet UIs needing plain-English guidance, or scheduled BTC payout systems where cost optimization matters. Prefer it over raw mempool APIs when you need savings estimates, broadcast policy strings, and recheck intervals ready for direct agent consumption.

## Known failure modes

- Mempool data unavailable — returns error if upstream mempool source is unreachable
- Invalid input schema — malformed POST body may return 400
- Payment not fulfilled — x402 payment required, returns 402 if USDC payment not attached
- Stale data — estimator_confidence may reflect lower confidence during mempool data gaps
- Rate limiting or provider downtime causing 5xx responses

## 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 plain-English executive summary and briefing string, a decision object with recommended action (send or wait), recommended fee rate in sat/vB, max acceptable fee rate, and recheck interval in minutes; a costs object comparing send-now vs wait-for-low-fee scenarios in satoshis and sat/vB with savings estimate; a next_block object with mempool pressure level and projected block count; an agent_action object with broadcast policy and recheck timing; and an estimator confidence object with level and signal source.

## 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-intelligence-briefing-e405b7ee/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)