{"uid":"cap_1yyLVqEKG8e9MG03KMtxA","slug":"cdp-bitcoinsapi-com-e004ddf8","name":"Bitcoin Fee Landscape & Send-or-Wait Advisor","description":"Satoshi API Bitcoin fee landscape: send now or wait timing and confirmation context for agents, backed by 46.8% average fee-savings analysis.","url":"https://cdp.bitcoinsapi.com/api/v1/fees/landscape","method":"GET","headers":{},"bodySchema":{"type":"object","input":{"type":"http","method":"GET","resource":"https://cdp.bitcoinsapi.com/api/v1/fees/landscape","queryParams":{}},"output":{"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"},"properties":{"input":{"type":"object","properties":{"queryParams":{"type":"object","properties":{}}}},"output":{"type":"object","required":["type","mimeType","example"],"properties":{"type":{"type":"string"},"schema":{"type":"object"},"example":{"type":"object"},"mimeType":{"type":"string"}}}}},"responseSchema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["trend","reasoning","scenarios","confidence","fee_sources","current_fees","recommendation","fee_environment"],"properties":{"trend":{"type":"object","required":["direction","mempool_change_pct","snapshots_available"],"properties":{"direction":{"type":"string"},"mempool_change_pct":{"type":"number"},"snapshots_available":{"type":"number"}}},"reasoning":{"type":"string"},"scenarios":{"type":"object","required":["send_now","wait_1hr","wait_low"],"properties":{"send_now":{"type":"object","required":["target","fee_rate","total_btc","total_sats"],"properties":{"target":{"type":"string"},"fee_rate":{"type":"number"},"total_btc":{"type":"number"},"total_sats":{"type":"number"}}},"wait_1hr":{"type":"object","required":["target","fee_rate","total_btc","total_sats","savings_vs_now_pct"],"properties":{"target":{"type":"string"},"fee_rate":{"type":"number"},"total_btc":{"type":"number"},"total_sats":{"type":"number"},"savings_vs_now_pct":{"type":"number"}}},"wait_low":{"type":"object","required":["target","fee_rate","total_btc","total_sats","savings_vs_now_pct"],"properties":{"target":{"type":"string"},"fee_rate":{"type":"number"},"total_btc":{"type":"number"},"total_sats":{"type":"number"},"savings_vs_now_pct":{"type":"number"}}}}},"confidence":{"type":"string"},"fee_sources":{"type":"object","required":["note","core_estimate","mempool_ancestor","next_block_source","source_spread_pct","mempool_individual"],"properties":{"note":{"type":"string"},"core_estimate":{"type":"number"},"mempool_ancestor":{"type":"number"},"next_block_source":{"type":"string"},"source_spread_pct":{"type":"number"},"mempool_individual":{"type":"number"}}},"current_fees":{"type":"object","required":["one_day","next_block","six_blocks"],"properties":{"one_day":{"type":"number"},"next_block":{"type":"number"},"six_blocks":{"type":"number"}}},"recommendation":{"type":"string"},"fee_environment":{"type":"object","required":["level","message"],"properties":{"level":{"type":"string"},"message":{"type":"string"}}}}},"meta":{"type":"object","required":["chain","cached","syncing","timestamp","max_blocks","request_id","node_height","cache_age_seconds"],"properties":{"chain":{"type":"string"},"cached":{"type":"boolean"},"syncing":{"type":"boolean"},"timestamp":{"type":"string"},"max_blocks":{"type":"null"},"request_id":{"type":"null"},"node_height":{"type":"number"},"cache_age_seconds":{"type":"number"}}}}},"example":{"request":{"input":{"queryParams":{}}},"response":{"data":{"trend":{"direction":"falling","mempool_change_pct":-23.8,"snapshots_available":6},"reasoning":"Fees are very low at 1.3 sat/vB. Great time to send.","scenarios":{"send_now":{"target":"next block","fee_rate":1.3,"total_btc":0.00000182,"total_sats":182},"wait_1hr":{"target":"~6 blocks (~1 hour)","fee_rate":2.125,"total_btc":0.00000297,"total_sats":298,"savings_vs_now_pct":-63.5},"wait_low":{"target":"~144 blocks (~1 day)","fee_rate":1,"total_btc":0.0000014,"total_sats":140,"savings_vs_now_pct":23.1}},"confidence":"high","fee_sources":{"note":"Short-term rates use mempool analysis (what you actually need). Long-term rates use Core's historical estimator.","core_estimate":4.443,"mempool_ancestor":1.3,"next_block_source":"mempool_ancestor","source_spread_pct":241.8,"mempool_individual":1.3},"current_fees":{"one_day":1,"next_block":1.3,"six_blocks":2.125},"recommendation":"send","fee_environment":{"level":"rock-bottom","message":"Fees are near the minimum. This is as cheap as it gets — excellent time to send or consolidate UTXOs."}},"meta":{"chain":"main","cached":true,"syncing":false,"timestamp":"2026-05-29T18:35:33.979071+00:00","max_blocks":null,"request_id":null,"node_height":951600,"cache_age_seconds":0}}},"exampleRequest":{"input":{"queryParams":{}}},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_uPMxZIiRHZnWV84y_nytp","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 for Bitcoin transactions with current fee rates, scenario comparisons, and potential savings percentage based on mempool analysis.","exampleAgentPrompt":"What's the Bitcoin fee landscape right now — should I send my transaction immediately or wait, and how much could I save by waiting?","exampleUseCases":null,"resultDescription":"A JSON object containing a 'send' or 'wait' recommendation, current fee rates (next block, 6 blocks, 1 day in sat/vB), scenario breakdowns for send-now vs wait-1hr vs wait-1day with total sats cost and savings percentages, a confidence level (e.g. 'high'), a human-readable reasoning string, the fee environment label (e.g. 'rock-bottom'), and a mempool trend object showing direction and change percentage.","failureModes":["Mempool data temporarily unavailable — may return stale or partial fee data","Network connectivity issues to Bitcoin node or mempool source — 503 or timeout","Insufficient fee source data to compute confidence — low confidence score returned","Payment not included or invalid x402 payment — 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when an AI agent or wallet needs a holistic send-or-wait decision with scenario comparison rather than just a raw fee number. It is preferable over a simple fee estimator when the user wants to understand potential savings, timing tradeoffs, and mempool context in a single call. Ideal for agents automating Bitcoin payments who need actionable guidance with reasoning, not just sat/vB rates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T20:27:34.741Z","isFirstParty":false}