{"uid":"cap_BqB94j2J1gTa6FlrlZvRR","slug":"satoshi-api-bitcoin-fee-intelligence-briefing-e405b7ee","name":"Satoshi API - Bitcoin Fee Intelligence 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/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_CxgJ573TvU3tIOcYNlow4","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 structured send-or-wait recommendation with live Bitcoin fee rates, mempool pressure context, and cost estimates for a transaction","exampleAgentPrompt":"Before I send this Bitcoin transaction, check current mempool conditions and tell me whether I should broadcast now or wait — and what fee rate I should use if I send now.","exampleUseCases":[{"title":"Autonomous Bitcoin payment timing","prompt":"I have a non-urgent Bitcoin payment to make — check the current mempool and tell me if I should send now or defer, and how much I'd save by waiting."},{"title":"Wallet fee suggestion before broadcast","prompt":"My user is about to send a Bitcoin transaction. What sat/vB fee should I set for a next-block confirmation, and is mempool pressure high or low right now?"},{"title":"Scheduled BTC send decision agent","prompt":"I'm running an automated Bitcoin payout job — pull a fee briefing and tell me the recommended fee rate and whether to proceed now or recheck in 30 minutes."}],"resultDescription":"A JSON object containing: a plain-English executive summary and briefing string, a decision object with recommended action (send or wait), recommended fee rate in sat/vB, max acceptable fee rate, and recheck interval in minutes; a costs object comparing send-now vs wait-for-low-fee scenarios in satoshis and sat/vB with savings estimate; a next_block object with mempool pressure level and projected block count; an agent_action object with broadcast policy and recheck timing; and an estimator confidence object with level and signal source.","failureModes":["Mempool data unavailable — returns error if upstream mempool source is unreachable","Invalid input schema — malformed POST body may return 400","Payment not fulfilled — x402 payment required, returns 402 if USDC payment not attached","Stale data — estimator_confidence may reflect lower confidence during mempool data gaps","Rate limiting or provider downtime causing 5xx responses"],"whenToPreferThis":"Choose this endpoint when an AI agent or application needs a structured, actionable decision (not just raw fee data) about whether to broadcast a Bitcoin transaction now or defer. It is ideal for autonomous payment agents, wallet UIs needing plain-English guidance, or scheduled BTC payout systems where cost optimization matters. Prefer it over raw mempool APIs when you need savings estimates, broadcast policy strings, and recheck intervals ready for direct agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:38.498Z","isFirstParty":false}