{"uid":"cap_zyVyuP2i-G4N-cw-wxCrv","slug":"satoshi-api-bitcoin-send-or-wait-fee-briefing-69cfa29d","name":"Satoshi API - Bitcoin Send-or-Wait Fee Briefing","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/briefings/send-or-wait","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"},"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_sub4UtaYLBJJm4KDGlTJl","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":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Wallet app smart send timing","prompt":"My user wants to send 100,000 sats and the transaction is 250 vbytes. It's not urgent — they can wait a few hours. Should I broadcast it now or defer? What fee rate should I use if I send now versus waiting for 6 confirmations?"},{"title":"Lightning channel open cost check","prompt":"I need to open a Lightning channel — the transaction is 400 vbytes and this is a channel_open use case. It's high urgency because the channel needs to be up fast. What's the current recommended fee rate and total cost in sats, and should I send now?"},{"title":"Automated Bitcoin payout scheduler","prompt":"I'm running automated Bitcoin payouts and want to minimize fees. Each payout transaction is 180 vbytes, urgency is low, and I'm targeting 12 confirmations. Tell me whether to send now or wait, and what fee rate to use."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T20:27:18.673Z","isFirstParty":false}