{"uid":"cap_lSbggdBLG8OAal3mDxlLQ","slug":"cdp-bitcoinsapi-com-44a0c106","name":"Satoshi API AI Fee Advice","description":"Satoshi API AI fee advice: plain-language Bitcoin fee recommendations for agents, wallets, and bots.","url":"https://cdp.bitcoinsapi.com/api/v1/ai/fees/advice","method":"GET","headers":{},"bodySchema":{"type":"object","input":{"type":"http","method":"GET","resource":"https://cdp.bitcoinsapi.com/api/v1/ai/fees/advice","queryParams":{"context":{"type":"string","required":false,"description":"Transaction context: DCA, consolidation, payment, etc."},"urgency":{"enum":["low","medium","high"],"type":"string","default":"medium","required":false,"description":"Transaction urgency"},"amount_btc":{"type":"string","required":false,"description":"Transaction amount in BTC (optional context)"}}},"output":{"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"},"properties":{"input":{"type":"object","properties":{"queryParams":{"context":{"type":"string","required":false,"description":"Transaction context: DCA, consolidation, payment, etc."},"urgency":{"enum":["low","medium","high"],"type":"string","default":"medium","required":false,"description":"Transaction urgency"},"amount_btc":{"type":"string","required":false,"description":"Transaction amount in BTC (optional context)"}}}},"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":["advice","context","urgency","fee_data","provider","structured"],"properties":{"advice":{"type":"string"},"context":{"type":"string"},"urgency":{"type":"string"},"fee_data":{"type":"object","required":["1_day_sat_vb","6_blocks_sat_vb","next_block_sat_vb"],"properties":{"1_day_sat_vb":{"type":"number"},"6_blocks_sat_vb":{"type":"number"},"next_block_sat_vb":{"type":"number"}}},"provider":{"type":"string"},"structured":{"type":"object","required":["wait","action","confidence","fee_environment","estimated_savings_pct","recommended_fee_sat_vb"],"properties":{"wait":{"type":"boolean"},"action":{"type":"string"},"confidence":{"type":"string"},"fee_environment":{"type":"string"},"estimated_savings_pct":{"type":"number"},"recommended_fee_sat_vb":{"type":"number"}}}}},"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":{"context":"payment","urgency":"medium","amount_btc":"0.5"}}},"response":{"data":{"advice":"For a medium-urgency payment of 0.5 BTC, I recommend setting a fee around 2.1 sat/vB to confirm within about 6 blocks (roughly an hour). Fees are currently low but rising, so acting soon at this rate balances cost and speed well. Avoid the lowest 1 sat/vB fee since mempool congestion is increasing and could delay your transaction beyond your desired timeframe.","context":"payment","urgency":"medium","fee_data":{"1_day_sat_vb":1,"6_blocks_sat_vb":2.124,"next_block_sat_vb":4.614999999999999},"provider":"azure_openai","structured":{"wait":false,"action":"send","confidence":"high","fee_environment":"low","estimated_savings_pct":78.3,"recommended_fee_sat_vb":4.614999999999999}},"meta":{"chain":"main","cached":true,"syncing":false,"timestamp":"2026-05-29T20:21:18.204228+00:00","max_blocks":null,"request_id":null,"node_height":951608,"cache_age_seconds":0}}},"exampleRequest":{"input":{"queryParams":{"context":"payment","urgency":"medium","amount_btc":"0.5"}}},"tags":["x402"],"displayCostAmount":"0.01","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.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_TBc1vWaXg06tTdHhBFIjZ","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 plain-language AI-generated Bitcoin fee recommendations with structured guidance on whether to send now or wait, target fee rate, and estimated savings.","exampleAgentPrompt":"Should I send my 0.5 BTC payment right now or wait for lower fees — it's medium urgency, not something that needs to confirm in the next block?","exampleUseCases":null,"resultDescription":"A JSON object containing a human-readable advice string explaining whether to send or wait, the recommended fee in sat/vB, the current fee environment label (e.g. 'rock-bottom'), confidence level, estimated savings percentage versus sending immediately, and the urgency echo. Also includes structured fields: wait (bool), action, confidence, fee_environment, recommended_fee_sat_vb, and raw fee data for next-block/6-block/1-day windows.","failureModes":["Upstream mempool or fee data unavailable — may return stale cached response or error","Invalid urgency enum value returns 422 validation error","Bitcoin node out of sync — meta.syncing flag set to true, advice may be unreliable","Network timeout if Azure OpenAI backend is slow or unavailable","x402 payment required if USDC payment header is missing or invalid"],"whenToPreferThis":"Use this endpoint when you need a human-readable, AI-synthesized recommendation — not just raw fee numbers — especially for wallets, bots, or agents that need to communicate fee strategy in natural language to end users. Prefer this over raw fee estimator endpoints when you want a 'send vs wait' decision with confidence and savings context already computed. Ideal for DCA bots, payment processors, or wallet UIs that want opinionated guidance rather than raw sat/vB data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T21:28:09.185Z","isFirstParty":false}