# Bitcoin Mempool Pressure Classifier

> Bitcoin Mempool Pressure Classifier is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns Bitcoin mempool pressure level (low/medium/high/extreme), fee bucket distribution by sat/vB, RBF count/percentage, CPFP candidate count, and total tx count — updated every 5 minutes.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/btc-derivatives/mempool-pressure
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-5e6e1bd1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ip5M6Dhn74px5CHjuq4cf

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 api-carbon-cashmere-de-5e6e1bd1
```

Example prompt: What's the current Bitcoin mempool pressure right now — is it low, medium, high, or extreme — and how are transactions distributed across the fee buckets like 1-2 sat/vB or 5-10 sat/vB?

## When to prefer this

Use this endpoint when you need a quick, pre-classified mempool congestion signal plus fee-band distribution without running your own Bitcoin node. Ideal for agents deciding whether to broadcast a transaction now or wait, setting fee rates, or alerting users to congestion spikes. Prefer over raw mempool APIs when you need a human-readable pressure label and bucketed fee histogram in a single call.

## Known failure modes

- Stale data if the 5-minute refresh cycle is delayed — ts field indicates data age
- Service unavailable (5xx) if the underlying Bitcoin node connection fails
- Rate limiting or payment failure if x402 payment is not correctly handled
- Empty or zero counts during periods of extremely low mempool activity

## How this service works

Bitcoin mempool pressure classification (low/medium/high/extreme) + fee buckets (0-1, 1-2, 2-5, 5-10, 10-20, 20-50, 50-100, 100-200, 200+ sat/vB) + RBF count + CPFP candidate count. Updated every 5 min.

## Output

A JSON object with: pressure classification string (low/medium/high/extreme), total tx_count in mempool, mempool_mb (size in megabytes), rbf_count and rbf_pct (RBF transaction count and percentage), cpfp_candidates count, avg_ancestor_count, min_relay_fee_sat_vb, a fee_buckets_sat_vb object with counts across 9 fee ranges (0-1, 1-2, 2-5, 5-10, 10-20, 20-50, 50-100, 100-200, 200+ sat/vB), and a timestamp. Data is refreshed every 5 minutes.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rbf_pct": 4,
  "pressure": "low",
  "tx_count": 3075,
  "rbf_count": 124,
  "mempool_mb": 0.87,
  "cpfp_candidates": 87,
  "fee_buckets_sat_vb": {
   "0_1": 1240,
   "1_2": 880,
   "2_5": 412
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-carbon-cashmere-de-5e6e1bd1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.carbon-cashmere.de](https://www.zero.xyz/host/api.carbon-cashmere.de/llms.txt)
