# Bitcoin Mempool Blocks & Next-Block Fee Projections

> Bitcoin Mempool Blocks & Next-Block Fee Projections is a paid API for AI agents from diamond.btc-intel.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-18).

Returns a live mempool histogram and projected block-by-block fee rates, vsize, tx counts, and minimum fee for the next block.

## Facts

- Endpoint: GET https://diamond.btc-intel.workers.dev/api/x402/mempool_blocks?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-mempool-blocks-next-block-fee-projections-208f82ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gZ2fV7rpZxWvblHJEoxQF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bitcoin-mempool-blocks-next-block-fee-projections-208f82ab
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-mempool-blocks-next-block-fee-projections-208f82ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from diamond.btc-intel.workers.dev](https://www.zero.xyz/host/diamond.btc-intel.workers.dev/llms.txt)
