{"uid":"cap_N0sC57BMP3a3-CS4aYFoa","slug":"satoshi-api-bitcoin-fee-market-research-92ee3beb","name":"Satoshi API - Bitcoin Fee Market Research","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/research/bitcoin-fee-market","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"question":{"type":"string"},"horizon_hours":{"type":"integer"},"include_history":{"type":"boolean"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["briefing","answer","citations"],"properties":{"answer":{"type":"string"},"market":{"type":"object"},"briefing":{"type":"string"},"question":{"type":"string"},"citations":{"type":"array"},"agent_action":{"type":"object"}}},"example":{"answer":"Delay non-urgent transactions if you can.","briefing":"Bitcoin fee market research","citations":[{"endpoint":"/api/v1/fees/landscape"}],"x402_price_usd":"$0.05"},"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_oZECvuWtsCGHAJQLuBKYU","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":"Answers natural-language questions about the Bitcoin fee market, returning live fee recommendations, mempool context, and cost estimates to help decide when to send transactions.","exampleAgentPrompt":"Should I send this Bitcoin transaction now or wait? Check the current fee market and look 6 hours ahead to tell me if fees are likely to drop.","exampleUseCases":[{"title":"Timing a large Bitcoin withdrawal","prompt":"I need to send a large Bitcoin payment — should I do it now or wait for fees to come down? Check the fee market over the next 12 hours and give me a recommendation."},{"title":"Automated wallet fee gating","prompt":"Before executing this Bitcoin transfer, check whether the current mempool fees are reasonable or if we should hold off — look 3 hours ahead and tell me the best course of action."},{"title":"Fee cost estimation for user display","prompt":"A user on my app wants to know how much it will cost in fees to send Bitcoin right now and whether fees are expected to be higher or lower in the next 24 hours — can you get that from the fee market API?"}],"resultDescription":"Returns a JSON object with a natural-language 'answer' (e.g. 'Delay non-urgent transactions if you can'), a 'briefing' summarizing the Bitcoin fee market, a 'market' object with structured mempool and fee data, the original 'question' echoed back, 'citations' listing the underlying data endpoints used, and an 'agent_action' object with a recommended next step for the calling agent.","failureModes":["Invalid or missing 'question' field returns a validation error","horizon_hours out of supported range may return empty forecast data","Mempool data source unavailability may result in stale or partial market context","Malformed JSON body returns HTTP 400","Payment not included or insufficient USDC balance returns HTTP 402"],"whenToPreferThis":"Use this endpoint when an agent or app needs to decide whether to send a Bitcoin transaction based on current and near-future fee conditions. It is preferred over raw mempool APIs because it returns opinionated, agent-ready recommendations in natural language alongside structured data, rather than requiring the caller to interpret raw fee histograms. Best suited for autonomous agents that need to gate or time Bitcoin transactions without human intervention.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:32:06.302Z","isFirstParty":false}