# Satoshi API - Bitcoin Withdrawal Batch Fee Briefing

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

Analyzes a planned Bitcoin withdrawal batch and recommends whether to send now or wait for lower fees, including cost estimates and savings potential.

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/briefings/withdrawal-batch
- Price: $0.1/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-withdrawal-batch-fee-briefing-d5499e6b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JWkuyO_uW2tI-OFb-8TDH

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-withdrawal-batch-fee-briefing-d5499e6b -d '<json body>'
```

Example prompt: I need to send a batch of 50 Bitcoin withdrawals with 20 funding inputs, average output vsize of 48 bytes, and a fee budget of 500000 sats — my urgency is low and I can wait up to 12 hours. Should I send now or wait for a better fee window?

## When to prefer this

Choose this endpoint when an application or AI agent needs to make an intelligent, data-driven decision about whether to execute a Bitcoin withdrawal batch immediately or defer it to save on fees. It is specifically designed for batch scenarios (multiple outputs, multiple inputs) rather than single transactions, and provides actionable agent directives rather than just raw fee data. Prefer it over generic mempool APIs when you need a structured recommendation and savings estimate tied to your specific batch parameters.

## Known failure modes

- Missing required fields such as withdrawal_count or input_count returns a 400 validation error
- Invalid urgency string or input_type enum value may cause processing failure
- Mempool data unavailability may degrade recommendation quality
- Payment not included or insufficient USDC via x402 protocol returns 402 Payment Required
- Extremely large batch sizes may exceed computation limits

## 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 natural-language briefing string summarizing conditions, a batch object with estimated vsize and withdrawal count, a decision object recommending an action (e.g. 'wait_for_fee_window') and quantifying potential savings in satoshis, a costs object with fee breakdowns, and an agent_action object with a batch policy directive (e.g. 'defer_batch') that an AI agent can act on directly.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "urgency": {
   "enum": [
    "low",
    "normal",
    "high",
    "urgent"
   ],
   "type": "string"
  },
  "input_type": {
   "enum": [
    "p2wpkh",
    "p2tr",
    "p2pkh",
    "p2sh",
    "p2wsh"
   ],
   "type": "string"
  },
  "input_count": {
   "type": "integer",
   "description": "Number of funding inputs."
  },
  "avg_output_vsize": {
   "type": "integer",
   "description": "Average output vsize."
  },
  "withdrawal_count": {
   "type": "integer",
   "description": "Number of withdrawal outputs."
  },
  "batch_window_hours": {
   "type": "integer"
  },
  "target_fee_budget_sats": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "briefing",
   "batch",
   "decision",
   "agent_action"
  ],
  "properties": {
   "batch": {
    "type": "object"
   },
   "costs": {
    "type": "object"
   },
   "briefing": {
    "type": "string"
   },
   "decision": {
    "type": "object"
   },
   "agent_action": {
    "type": "object"
   }
  }
 },
 "example": {
  "batch": {
   "estimated_vsize": 2420,
   "withdrawal_count": 50
  },
  "briefing": "Bitcoin withdrawal batch plan",
  "decision": {
   "action": "wait_for_fee_window",
   "potential_savings_sats": 20000
  },
  "agent_action": {
   "batch_policy": "defer_batch"
  },
  "x402_price_usd": "$0.10"
 },
 "mimeType": "application/json"
}
```

## More

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