# Satoshi API - Stuck Bitcoin Transaction Rescue Planner

> Satoshi API - Stuck Bitcoin Transaction Rescue Planner is a paid API for AI agents from bitcoinsapi.com, paid per call via x402, $0.05/call, status down (last checked 2026-10-13).

Diagnoses a stuck Bitcoin transaction and returns a concrete rescue plan (RBF fee bump or CPFP) with recommended fee rates and estimated cost

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/tx/stuck/rescue-plan?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satoshi-api-stuck-bitcoin-transaction-rescue-planner-731fddd3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sWo4PTd77MdW7acGbbtFL

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-stuck-bitcoin-transaction-rescue-planner-731fddd3 -d '<json body>'
```

Example prompt: My Bitcoin transaction a1b2c3d4e5f6... has been stuck for 6 hours — can you diagnose it and give me a rescue plan with urgency set to high and targeting 3 confirmations?

## When to prefer this

Use this endpoint when an AI agent or application needs to take concrete, automated action on a stuck Bitcoin transaction. Unlike generic mempool explorers, this endpoint returns a machine-readable agent_action directive with exact fee bump parameters, making it ideal for autonomous wallet agents, payment processors, or automated custody systems that need to act without human intervention. Prefer this over generic fee APIs when the specific stuck txid is known and a decision is needed.

## Known failure modes

- Invalid or malformed txid returns an error — ensure the txid is a valid 64-character hex string
- Transaction already confirmed — endpoint may return a no-action-needed response
- Transaction not found in mempool or node — may indicate it was dropped or never broadcast
- Network congestion causing stale fee estimates — recommendation may become outdated within minutes
- Invalid urgency enum value — use only accepted string values (low, medium, high, critical)

## 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, the transaction status, a decision object specifying the recommended action (e.g. rbf_fee_bump or cpfp), the recommended fee rate in sat/vB, an agent_action block with the estimated bump cost in satoshis, and available rescue options. The agent_action field is specifically structured for automated agent execution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "txid": {
   "type": "string",
   "description": "Transaction id to diagnose."
  },
  "urgency": {
   "enum": [
    "low",
    "normal",
    "high",
    "urgent"
   ],
   "type": "string"
  },
  "target_confirmations": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "briefing",
   "txid",
   "decision",
   "agent_action"
  ],
  "properties": {
   "txid": {
    "type": "string"
   },
   "status": {
    "type": "object"
   },
   "briefing": {
    "type": "string"
   },
   "decision": {
    "type": "object"
   },
   "agent_action": {
    "type": "object"
   },
   "rescue_options": {
    "type": "object"
   }
  }
 },
 "example": {
  "txid": "example-txid",
  "briefing": "Bitcoin stuck transaction rescue plan",
  "decision": {
   "action": "rbf_fee_bump",
   "recommended_fee_sat_vb": 22
  },
  "agent_action": {
   "action": "rbf_fee_bump",
   "estimated_bump_sats": 2500
  },
  "x402_price_usd": "$0.05"
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satoshi-api-stuck-bitcoin-transaction-rescue-planner-731fddd3/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)