{"uid":"cap_gZ2fV7rpZxWvblHJEoxQF","slug":"bitcoin-mempool-blocks-next-block-fee-projections-208f82ab","name":"Bitcoin Mempool Blocks & Next-Block Fee Projections","description":"Projected next Bitcoin blocks from this node's live mempool, ordered by cluster-mempool chunk fee rate: for each of the next 4 blocks the tx count, vsize, total fees and min / median / max sat/vB, the fee rate the next block needs, and a fee-rate histogram of the whole mempool.","url":"https://diamond.btc-intel.workers.dev/api/x402/mempool_blocks?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of":"2026-11-07T18:00:00Z","product":"mempool_blocks","histogram":[{"vsize":260000,"tx_count":800,"to_sat_vb":3,"from_sat_vb":2}],"projected_blocks":[{"block":1,"vsize":995800,"tx_count":2900,"total_fees_btc":0.031,"fee_rate_sat_vb":{"max":250,"min":2.1,"median":3}}],"next_block_min_fee_sat_vb":2.1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_W7DJl8A_Mv1og-xCo_jVl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live mempool histogram and projected block-by-block fee rates, vsize, tx counts, and minimum fee for the next block.","exampleAgentPrompt":"What's the minimum sat/vB fee I need to get my Bitcoin transaction confirmed in the next block right now, and can you show me the projected fee rates and congestion for the next few blocks?","exampleUseCases":[{"title":"Optimize Bitcoin transaction fee","prompt":"I'm about to broadcast a Bitcoin transaction — what's the current minimum fee in sat/vB to make it into the next block, and what do the next few projected blocks look like in terms of congestion and fees?"},{"title":"Monitor mempool congestion for a wallet app","prompt":"Pull the live mempool block histogram for me — I need the vsize, tx count, and fee rate range for each projected block so I can show users realistic confirmation time estimates."},{"title":"Decide when to send a low-priority Bitcoin payment","prompt":"The mempool isn't super congested right now, is it? Can you check the projected blocks and tell me the median fee rate so I can decide whether to send my payment now at a low fee or wait?"}],"resultDescription":"Returns a JSON object with: timestamp (as_of), product name, a mempool histogram array (each bucket with vsize, tx_count, to_sat_vb, from_sat_vb), an array of projected_blocks (each with block index, vsize, tx_count, total_fees_btc, and fee_rate_sat_vb with max/min/median), and next_block_min_fee_sat_vb indicating the minimum fee rate needed to enter the next block.","failureModes":["Payment not received — returns 402 if USDC/Lightning payment is missing or insufficient","Rate limiting or worker timeout if mempool data feed is temporarily unavailable","Stale data possible if upstream mempool node is lagging — check as_of timestamp","Malformed response if mempool is unusually empty or in an edge state"],"whenToPreferThis":"Use this endpoint when you need real-time, structured Bitcoin mempool fee projections broken down block-by-block — particularly useful for wallets, payment processors, or agents that need to set precise sat/vB fees programmatically. Prefer this over static fee estimators when you need live data with histogram granularity and next-block minimum fee in a single call with no account required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T00:38:23.188Z","isFirstParty":false,"canonicalSlug":"bitcoin-mempool-blocks-next-block-fee-projections-208f82ab"}