{"uid":"cap_sWo4PTd77MdW7acGbbtFL","slug":"satoshi-api-stuck-bitcoin-transaction-rescue-planner-731fddd3","name":"Satoshi API - Stuck Bitcoin Transaction Rescue Planner","description":"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.","url":"https://bitcoinsapi.com/api/v1/tx/stuck/rescue-plan?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"txid":{"type":"string","description":"Transaction id to diagnose."},"urgency":{"enum":["low","normal","high","urgent"],"type":"string"},"target_confirmations":{"type":"integer"}}},"responseSchema":{"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"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GwbEpiHpnzfhIHtj_Ps_T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Diagnoses a stuck Bitcoin transaction and returns a concrete rescue plan (RBF fee bump or CPFP) with recommended fee rates and estimated cost","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Urgent payment stuck in mempool","prompt":"My Bitcoin payment txid a1b2c3d4e5f6789... hasn't confirmed in 8 hours and I need it through ASAP — treat this as high urgency and target 1 confirmation, what's the rescue plan?"},{"title":"Low-urgency stuck transaction cost check","prompt":"I sent a Bitcoin transaction (txid: 9f8e7d6c5b4a...) two days ago and it's still unconfirmed — urgency is low and I just need 6 confirmations eventually, how much would an RBF bump cost me?"},{"title":"Automated agent rescuing stuck on-chain payment","prompt":"Check transaction c3d4e5f6a7b8... stuck in the mempool and give me a step-by-step rescue plan with the recommended fee rate — I need this confirmed within 2 blocks so urgency is critical."}],"resultDescription":"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.","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T19:28:22.721Z","isFirstParty":false,"canonicalSlug":"satoshi-api-stuck-bitcoin-transaction-rescue-planner-731fddd3"}