{"uid":"cap_x5bA4mDyJWIyfPk76qtgS","slug":"bitcoin-fee-forecast-api-e4cdb2a8","name":"Bitcoin Fee Forecast API","description":"Bitcoin fee forecast","url":"https://api.relai.fi/relay/1780781322365/api/fees/predict","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"unit":"sat/vB","current":{"low":2,"high":6,"medium":4},"mempool":{"size_mb":"21.72","congestion":"low","pending_tx":88168},"success":true,"prediction":{"trend":"rising","confidence_pct":95},"updated_at":"2026-06-12T04:31:05.328Z","next_3_blocks":{"block_1":6,"block_2":3,"block_3":2}}},"exampleRequest":null,"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":"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_QLBwmd2hq3ZyVLv7D0zzt","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 predictive forecast of Bitcoin transaction fees","exampleAgentPrompt":"What are the predicted Bitcoin transaction fees right now — I want to know the forecast so I can decide whether to send my transaction immediately or wait for lower fees.","exampleUseCases":null,"resultDescription":"A predicted Bitcoin fee estimate, likely including recommended fee rates (e.g. sat/vByte) for different confirmation speed tiers (fast, medium, slow) based on current mempool and network conditions.","failureModes":["Bitcoin node unavailable or syncing — may return 503 or empty data","Mempool data stale or unavailable — forecast may be inaccurate","Rate limit exceeded — returns 429","Payment not provided or invalid — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a forward-looking Bitcoin fee prediction rather than just the current mempool snapshot. Ideal for wallets, payment processors, or agents deciding when to broadcast a Bitcoin transaction to optimize cost vs. confirmation speed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:22.085Z","isFirstParty":false}