{"uid":"cap_CvQ0d7ggC_3z1dPfUZ1lg","slug":"satoshi-api-bitcoin-fee-intelligence-3cb138a0","name":"Satoshi API - Bitcoin Fee Intelligence","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/ai/fees/advice","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["advice"],"properties":{"advice":{"type":"string"},"urgency":{"type":"string"},"provider":{"type":"string"},"structured":{"type":"object"}}},"example":{"advice":"Wait if the transaction is not urgent; target 12 sat/vB for a lower-cost confirmation.","urgency":"normal","provider":"satoshi-api","structured":{"recommendation":"wait","targetFeeSatVb":12,"estimatedSavingsPct":46.8}},"mimeType":"application/json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wZPpGrL-CyghgkwxjhG1W","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns AI-generated Bitcoin transaction fee advice, urgency rating, and cost estimates based on live mempool conditions","exampleAgentPrompt":"Should I send my Bitcoin transaction right now, or wait for fees to drop? Give me the current fee advice including what sat/vB to target and how much I could save by waiting.","exampleUseCases":[{"title":"Timing a large Bitcoin payout","prompt":"I need to send a large Bitcoin payment to a supplier — is now a good time, or should I wait for fees to come down? Tell me the target fee rate and estimated savings if I wait."},{"title":"Automated wallet fee optimization","prompt":"Before my app sends a Bitcoin withdrawal, check the current mempool conditions and tell me whether to send now or queue it for later, and what fee rate to use."},{"title":"User-facing fee alert in a Bitcoin app","prompt":"My user wants to know if Bitcoin fees are normal or elevated right now, and what sat per vbyte they should set for a standard confirmation — can you get that for them?"}],"resultDescription":"Returns a JSON object with a human-readable advice string (e.g. 'Wait if not urgent; target 12 sat/vB'), an urgency label (e.g. 'normal', 'high'), a structured block containing a recommendation action ('wait' or 'send'), target fee rate in sat/vB, and estimated savings percentage if the user waits.","failureModes":["Mempool data source temporarily unavailable — returns degraded or cached advice","Malformed input schema — returns 400 with validation error","Service overload or rate limiting — returns 429","Network timeout if mempool provider is slow to respond"],"whenToPreferThis":"Choose this endpoint when you need human-readable, AI-interpreted Bitcoin fee advice rather than raw fee data. It is ideal for AI agents that need to decide whether to trigger a Bitcoin transaction autonomously, or for apps that want to surface plain-language fee guidance to end users. Prefer this over raw mempool APIs when you need urgency classification, savings estimates, and actionable recommendations in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:39.079Z","isFirstParty":false}