{"uid":"cap_RaAcCFpIqaQ2adhUc-jTv","slug":"cdp-bitcoinsapi-com-ad3ec7e4","name":"Satoshi API Next-Block Forecast","description":"Satoshi API next-block forecast: Bitcoin block fee pressure and inclusion timing for agents deciding whether to broadcast now.","url":"https://cdp.bitcoinsapi.com/api/v1/mining/nextblock?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","input":{"type":"http","method":"GET","resource":"https://cdp.bitcoinsapi.com/api/v1/mining/nextblock","queryParams":{}},"output":{"type":"json","schema":{"type":"object","required":["height","tx_count","median_fee_rate"],"properties":{"top_5":{"type":"array"},"height":{"type":"integer"},"tx_count":{"type":"integer"},"max_fee_rate":{"type":"number"},"min_fee_rate":{"type":"number"},"total_fees_btc":{"type":"number"},"median_fee_rate":{"type":"number"}}},"example":{"top_5":[{"txid":"example-txid","fee_rate":122}],"height":840000,"tx_count":2800,"max_fee_rate":122,"min_fee_rate":5.1,"total_fees_btc":0.36,"median_fee_rate":14.2},"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":["top_5","height","tx_count","max_fee_rate","min_fee_rate","total_weight","total_fees_btc","median_fee_rate"],"properties":{"top_5":{"type":"array","items":{"type":"object","required":["txid","fee_rate","fee_sats"],"properties":{"txid":{"type":"string"},"fee_rate":{"type":"number"},"fee_sats":{"type":"number"}}}},"height":{"type":"number"},"tx_count":{"type":"number"},"max_fee_rate":{"type":"null"},"min_fee_rate":{"type":"null"},"total_weight":{"type":"number"},"total_fees_btc":{"type":"null"},"median_fee_rate":{"type":"null"}}},"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":{"top_5":[{"txid":"d5df767b515bd6e2dd85e90de1766d0cd86cf372671b6b3d96e3a0b94ada885c","fee_rate":100.3,"fee_sats":33500},{"txid":"bfd89a7bbdf1f48caeb0df801043cddebe1c436110c5fe9d295f2270a277ce3f","fee_rate":100,"fee_sats":14100},{"txid":"56c722dc9146a828deedd34108c705e4461fea1b5830b74fffd4a70dc05a20c0","fee_rate":85.11,"fee_sats":12000},{"txid":"c3082bc2354eed066db24cce2cad500ec4cc0e6c29021e8ebf9ca35d53c689e9","fee_rate":79.19,"fee_sats":8711},{"txid":"f85122315453b962a6631491134fc3cabd374e72ffbfafb4a196012111b5c582","fee_rate":77.48,"fee_sats":10925}],"height":951609,"tx_count":567,"max_fee_rate":null,"min_fee_rate":null,"total_weight":652383,"total_fees_btc":null,"median_fee_rate":null},"meta":{"chain":"main","cached":true,"syncing":false,"timestamp":"2026-05-29T20:26:56.389594+00:00","max_blocks":null,"request_id":null,"node_height":951608,"cache_age_seconds":0}}},"exampleRequest":{"input":{"queryParams":{}}},"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_Km2y7h9dEEMWr-yAO3iGx","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 real-time Bitcoin mempool data for the next expected block, including fee rates, transaction count, and top transactions by fee rate.","exampleAgentPrompt":"What does the next Bitcoin block look like right now — how many transactions are queued, what's the median fee rate, and which transactions are paying the highest fees?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the forecasted next block's height, transaction count, median/max/min fee rates (sat/vByte), total fees in BTC, total weight, and an array of the top 5 transactions by fee rate (txid, fee_rate, fee_sats). Also includes metadata such as chain, cache age, node height, sync status, and request timestamp.","failureModes":["Node syncing: if syncing=true in meta, data may be stale or incomplete","Null fee fields: max_fee_rate, min_fee_rate, total_fees_btc, median_fee_rate may return null if insufficient mempool data","Payment required: HTTP 402 if x402 payment header is missing or insufficient (requires $0.01 USDC per call)","Empty top_5 array: returned if mempool is near-empty","Network errors or node unavailability may return 5xx errors"],"whenToPreferThis":"Use this endpoint when an AI agent or wallet needs to decide whether to broadcast a Bitcoin transaction immediately, estimate the fee needed for next-block inclusion, or monitor real-time mempool pressure. It is specifically optimized for next-block forecasting with human-agent-friendly output, unlike raw mempool RPC calls. Prefer this over the general fee landscape endpoint when you specifically need next-block data and top transaction context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T11:27:50.852Z","isFirstParty":false,"canonicalSlug":"cdp-bitcoinsapi-com-ad3ec7e4"}