{"uid":"cap_rS5Hqs-HUbgWqMoNoxh4l","slug":"satoshi-api-bitcoin-fee-briefing-c51392ae","name":"Satoshi API - Bitcoin 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/x402/satoshi-bitcoin-fee/fees/briefing","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["briefing","decision","costs","agent_action"],"properties":{"costs":{"type":"object"},"value":{"type":"object"},"briefing":{"type":"string"},"decision":{"type":"object"},"next_block":{"type":"object"},"agent_action":{"type":"object"},"x402_price_usd":{"type":"string"},"executive_summary":{"type":"string"},"estimator_confidence":{"type":"object"}}},"example":{"costs":{"send_now":{"total_fee_sats":4512,"fee_rate_sat_vb":32},"wait_low":{"total_fee_sats":846,"fee_rate_sat_vb":6,"savings_vs_now_sats":3666}},"briefing":"Bitcoin send-or-wait briefing","decision":{"action":"wait","max_fee_sat_vb":32,"recheck_in_minutes":30,"recommended_fee_sat_vb":18},"next_block":{"pressure":"high","projected_block_count":3},"agent_action":{"action":"wait","broadcast_policy":"defer_non_urgent","recheck_after_minutes":30,"recommended_fee_sat_vb":18},"x402_price_usd":"$0.05","executive_summary":"Bitcoin fees are elevated at 32 sat/vB; wait if this is not urgent.","estimator_confidence":{"level":"high","signals":{"source":"mempool_ancestor"}}},"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":"unknown","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_pcAvTCYLd8ac0mONj5Mqy","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 Bitcoin fee briefing with send-or-wait recommendations, mempool context, and cost estimates for AI agents and apps","exampleAgentPrompt":"Check current Bitcoin mempool conditions and tell me whether I should send my transaction now or wait — give me the recommended fee rate, estimated cost in sats, and how long to wait if fees are too high.","exampleUseCases":[{"title":"Automated Bitcoin payment timing","prompt":"I have a non-urgent Bitcoin payment to send — check the mempool right now and tell me if I should broadcast it immediately or defer it, and what fee rate to use when I do send."},{"title":"DCA bot fee optimization","prompt":"My Bitcoin DCA bot is about to send a transaction — is the mempool congested right now? Give me a fee briefing so I know whether to send at the next block or wait 30 minutes for cheaper fees."},{"title":"Real-time fee dashboard for wallet app","prompt":"Pull a live Bitcoin fee briefing for my wallet app — I need current sat/vB rates for fast and slow confirmation, mempool pressure level, and an executive summary I can show users."}],"resultDescription":"A structured JSON briefing containing: an executive summary string, a decision object with action (send/wait), recommended fee rate in sat/vB, and recheck interval in minutes; a costs object comparing send-now vs wait-for-low fees in sats; a next_block object with mempool pressure and projected block count; an agent_action directive with broadcast policy; and an estimator confidence object indicating signal source and confidence level.","failureModes":["Mempool data unavailable — service may return degraded confidence or error if upstream mempool source is unreachable","Invalid or malformed request body — returns error if input schema is not a valid JSON object","Payment failure — x402 payment of $0.05 USDC not processed, request rejected","Rate limiting — excessive calls may be throttled","Stale data — during mempool indexer lag, confidence level may drop to 'low'"],"whenToPreferThis":"Choose this endpoint when an AI agent or app needs to make an autonomous decision about whether to broadcast a Bitcoin transaction — it returns a pre-interpreted action directive (send/wait/defer) with fee rate and timing, rather than raw fee data that requires further interpretation. Ideal for automated wallets, DCA bots, payment processors, and any workflow where minimizing Bitcoin transaction fees is important. Prefer over raw mempool APIs when you need a human-readable briefing and agent-ready action objects without writing your own fee logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:08.229Z","isFirstParty":false}