{"uid":"cap_BlziPozLjlQPAJixlw-r2","slug":"satoshi-api-bitcoin-fee-observatory-block-stats-33b3993e","name":"Satoshi API – Bitcoin Fee Observatory Block Stats","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/observatory/block-stats","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"ok":{"type":"boolean"},"source":{"type":"string"}}},"example":{"ok":true,"source":"satoshi-api"},"mimeType":"application/json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_L9FkpV1G7yhRGe3S4zc0E","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Bitcoin mempool block statistics to help apps and AI agents decide when to send Bitcoin and estimate transaction fees.","exampleAgentPrompt":"What does the Bitcoin mempool look like right now — should I send a transaction or wait for fees to come down, and what fee rate would get me confirmed in the next block?","exampleUseCases":[{"title":"Optimal fee timing for wallet app","prompt":"My Bitcoin wallet needs to recommend whether users should send now or wait — can you pull the current block stats from Satoshi API so I can show them the right fee tier for a next-block confirmation?"},{"title":"Automated Bitcoin payment scheduling","prompt":"I'm building a bot that sends Bitcoin payouts automatically. Before sending, check the current mempool block stats so we only broadcast when fees are below 20 sats/vbyte."},{"title":"Real-time fee dashboard for traders","prompt":"Pull the latest Bitcoin fee observatory block stats so I can display live fee estimates and mempool depth on my trading dashboard right now."}],"resultDescription":"A JSON object with an 'ok' boolean status and a 'source' field confirming the data origin ('satoshi-api'), along with live block statistics including fee rate recommendations, mempool congestion context, and per-block cost estimates useful for deciding when and at what fee to broadcast a Bitcoin transaction.","failureModes":["Invalid or malformed request body returns an error response","Service unavailable during Bitcoin network disruptions or high load","Rate limiting or payment failure (x402) if the $0.005 USDC per-call payment is not properly included","Empty or stale mempool data if the node is not fully synced","Timeout if the mempool is exceptionally large and block stats take too long to compute"],"whenToPreferThis":"Choose this endpoint when your app or agent needs real-time Bitcoin mempool block-level fee intelligence — specifically block statistics and fee rate recommendations — rather than just a simple fee estimate. It is ideal for agents automating Bitcoin payments, wallets that need to advise users on timing, or dashboards requiring live mempool context. Prefer it over generic blockchain explorers when you need structured, AI-agent-friendly fee data at a low per-call cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:28:00.160Z","isFirstParty":false}