# Satoshi API - Bitcoin Send-or-Wait Fee Briefing

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

Returns a live AI-powered recommendation on whether to send a Bitcoin transaction now or wait for lower fees, including cost estimates and mempool context.

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/briefings/send-or-wait
- Price: $0.05/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satoshi-api-bitcoin-send-or-wait-fee-briefing-69cfa29d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zyVyuP2i-G4N-cw-wxCrv

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-send-or-wait-fee-briefing-69cfa29d -d '<json body>'
```

Example prompt: Should I send this Bitcoin transaction now or wait? It's a 250 vbyte transaction, normal urgency, targeting 6 confirmations — give me a fee recommendation and tell me how much I'd save by waiting.

## When to prefer this

Use this endpoint when an app or AI agent needs a structured, actionable recommendation on whether to broadcast a Bitcoin transaction immediately or defer — especially when fee cost optimization matters. Prefer this over raw mempool APIs when you need a pre-interpreted decision (send/wait), estimated savings, and an agent-ready action directive rather than raw fee rate data alone.

## Known failure modes

- Missing required vsize field returns a validation error
- Invalid urgency enum value may return an error or default behavior
- Network or mempool data unavailability may cause delayed or degraded response
- Payment failure via x402 protocol returns 402 Payment Required
- Extremely large vsize values may produce unexpected fee estimates

## 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 briefing string, a decision object (action: 'send' or 'wait', recommended fee rate in sat/vb, savings vs sending now in sats), an agent_action object with broadcast policy and next polling endpoint, and a costs object comparing send-now vs target-confirmation fee totals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vsize": {
   "type": "integer",
   "description": "Transaction virtual size in vbytes."
  },
  "urgency": {
   "enum": [
    "low",
    "normal",
    "high",
    "urgent"
   ],
   "type": "string",
   "description": "How costly delay is for this transaction."
  },
  "use_case": {
   "type": "string",
   "description": "Optional caller use case such as wallet_send or channel_open."
  },
  "amount_sats": {
   "type": "string",
   "description": "Optional transaction amount for fee-percent math."
  },
  "target_confirmations": {
   "type": "integer",
   "description": "Confirmation target in blocks."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "briefing",
   "decision",
   "agent_action",
   "costs"
  ],
  "properties": {
   "costs": {
    "type": "object"
   },
   "value": {
    "type": "object"
   },
   "request": {
    "type": "object"
   },
   "briefing": {
    "type": "string"
   },
   "decision": {
    "type": "object"
   },
   "fee_context": {
    "type": "object"
   },
   "agent_action": {
    "type": "object"
   },
   "x402_price_usd": {
    "type": "string"
   }
  }
 },
 "example": {
  "costs": {
   "send_now": {
    "total_fee_sats": 8000,
    "fee_rate_sat_vb": 32
   },
   "requested_target": {
    "total_fee_sats": 4500,
    "fee_rate_sat_vb": 18
   }
  },
  "request": {
   "vsize": 250,
   "urgency": "normal",
   "target_confirmations": 6
  },
  "briefing": "Bitcoin send-or-wait decision",
  "decision": {
   "action": "wait",
   "target_fee_sat_vb": 18,
   "recommended_fee_sat_vb": 18,
   "savings_vs_send_now_sats": 3500
  },
  "agent_action": {
   "action": "wait",
   "next_call": "/api/v1/briefings/send-or-wait",
   "broadcast_policy": "defer_non_urgent",
   "recommended_fee_sat_vb": 18
  },
  "x402_price_usd": "$0.05"
 },
 "mimeType": "application/json"
}
```

## More

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