{"uid":"cap_6r3aqYXxV8k_02a9uN8MC","slug":"satoshi-api-bitcoin-payment-health-check-11493d0d","name":"Satoshi API - Bitcoin Payment Health Check","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/bitcoin-payment-health","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["briefing","health","paid_resources"],"properties":{"health":{"type":"object"},"briefing":{"type":"string"},"agent_action":{"type":"object"},"paid_resources":{"type":"object"}}},"example":{"health":{"status":"ok"},"briefing":"Satoshi x402 Bitcoin payment health","paid_resources":{"count":14},"x402_price_usd":"$0.02"},"mimeType":"application/json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nwNt_Lrt9b1WE78SM1ARC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live Bitcoin fee recommendations, mempool health status, and cost estimates to help apps and AI agents decide when to send Bitcoin transactions.","exampleAgentPrompt":"Check the current Bitcoin network health and tell me whether now is a good time to send a payment, or if I should wait for lower fees.","exampleUseCases":[{"title":"Optimal Bitcoin send timing","prompt":"Before I send this Bitcoin payment, check the mempool health and let me know if fees are reasonable right now or if I should hold off."},{"title":"Fee budgeting for wallet app","prompt":"I'm building a Bitcoin wallet — give me the current recommended fee and network health status so I can show users the best time to send."},{"title":"Automated payment agent decision","prompt":"My agent is about to send a Bitcoin transaction — pull the latest fee intelligence and tell it whether to proceed now or wait for network congestion to ease."}],"resultDescription":"Returns a JSON object with a health status object (e.g. {status: 'ok'}), a human-readable briefing string describing current Bitcoin payment health, an agent_action object with a recommendation on whether to proceed or wait, a paid_resources object with resource count, and the price paid ($0.02 USDC).","failureModes":["Missing or invalid authentication/payment header returns 402 or 401","Bitcoin node data unavailable results in degraded health status","Network timeout on mempool data fetch returns error status","Malformed request body returns 400 bad request","Service downtime returns 503"],"whenToPreferThis":"Choose this endpoint when an AI agent or application needs a real-time, opinionated recommendation on Bitcoin transaction timing — not just raw fee data. It is especially useful when you want a pre-interpreted 'proceed or wait' signal rather than raw mempool numbers, and when you need a lightweight $0.02 per-call cost model with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:33:04.516Z","isFirstParty":false}