{"uid":"cap_XDASfp6GHvrH3TWoumQ8g","slug":"satoshi-api-bitcoin-fee-landscape-f9766cf2","name":"Satoshi API - Bitcoin Fee Landscape","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/landscape","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["recommendation","currentFees"],"properties":{"reasoning":{"type":"string"},"scenarios":{"type":"array"},"confidence":{"type":"number"},"currentFees":{"type":"object"},"recommendation":{"type":"string","description":"Send-or-wait verdict for the current Bitcoin fee market."},"potentialSavingsPct":{"type":"number"}}},"example":{"reasoning":"Mempool pressure is elevated; waiting about 2 hours can reduce the expected fee.","scenarios":[{"action":"wait","urgency":"low","targetFeeSatVb":12}],"confidence":0.82,"currentFees":{"hourFeeSatVb":12,"fastestFeeSatVb":22,"halfHourFeeSatVb":18},"recommendation":"wait","potentialSavingsPct":46.8},"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":"unknown","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_lMwD540ccQpZVclzzulJ5","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 a send-or-wait recommendation with live Bitcoin fee estimates, mempool context, confidence score, and potential savings percentage","exampleAgentPrompt":"Should I send this Bitcoin transaction right now or wait for fees to drop? Give me the current fee landscape with a send-or-wait verdict and tell me how much I could save by waiting.","exampleUseCases":[{"title":"Timing a large Bitcoin transfer","prompt":"I need to send a large Bitcoin payment — should I do it now or wait? Tell me the current fee rates in sat/vB and whether holding off could save me a meaningful amount."},{"title":"Automated wallet fee optimization","prompt":"Before my app sends this Bitcoin transaction, check the current mempool conditions and give me a recommendation on whether to send now or wait, along with the fastest, half-hour, and one-hour fee rates."},{"title":"User-facing fee advisory in a Bitcoin app","prompt":"My user is about to make a Bitcoin payment — pull the fee landscape right now and tell me the confidence level on the recommendation so I can decide whether to show them a 'wait and save' prompt."}],"resultDescription":"A JSON object containing: a 'recommendation' field ('send' or 'wait'), current fee rates (fastestFeeSatVb, halfHourFeeSatVb, hourFeeSatVb in sat/vB), a human-readable 'reasoning' string, a 'confidence' score (0–1), a 'potentialSavingsPct' percentage, and an array of 'scenarios' with suggested actions, urgency levels, and target fee rates.","failureModes":["Upstream mempool data source unavailable — may return stale or error response","Malformed input schema causing 400 Bad Request","x402 payment failure or insufficient USDC balance preventing access","Low confidence score (below 0.5) when mempool conditions are volatile and unpredictable","Rate limiting if payment mechanism fails"],"whenToPreferThis":"Choose this endpoint when an agent or app needs a ready-made send-or-wait decision with human-readable reasoning rather than raw fee data alone. It is ideal for user-facing Bitcoin wallets, automated payment schedulers, or cost-optimization workflows that need an AI-interpretable recommendation plus potential savings estimate — not just a list of fee tiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:32.624Z","isFirstParty":false}