# Bitcoin CPFP Fee Bump Plan

> Bitcoin CPFP Fee Bump Plan is a paid API for AI agents from diamond.btc-intel.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-21).

Calculates CPFP (Child-Pays-For-Parent) fee budget scenarios for a stuck mempool transaction, showing how much a child transaction must pay to accelerate confirmation at a target fee rate.

## Facts

- Endpoint: GET https://diamond.btc-intel.workers.dev/api/x402/cpfp?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-cpfp-fee-bump-plan-a66b0df3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CTYX1bthqojRBqgMv9ryv

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-cpfp-fee-bump-plan-a66b0df3
```

Example prompt: My Bitcoin transaction abc123...txid is stuck in the mempool — figure out how much a child transaction would need to pay to bump the whole package to 20 sat/vB, assuming child sizes of 150, 250, and 400 vbytes.

## When to prefer this

Use this endpoint when you need fee arithmetic for CPFP fee-bumping of a specific stuck mempool transaction, especially when you want to compare multiple child transaction sizes at once. It is preferred over generic fee estimators because it incorporates the actual observed ancestor base fees for the specific transaction, not just current mempool conditions. It does not construct or broadcast transactions, so it is safe to call speculatively for planning purposes.

## Known failure modes

- Invalid or unrecognized txid returns an error or empty plans array
- Target fee rate outside 0.001–10000 sat/vB range is rejected
- Child vbyte sizes outside 60–100000 range are rejected
- More than 25 unique child sizes returns a validation error
- Transaction not found in mempool (confirmed or unknown) may return empty or error response
- Stale snapshot if transaction conditions change between payment and result delivery

## How this service works

CPFP budget scenarios for a mempool transaction and its ancestors. package=txid:target_sat_vb:child_vbytes[,child_vbytes...]. Up to 25 unique sizes; actual ancestor base fees, ceiling arithmetic and observed relay/mempool floors. Not transaction construction, package-policy validation, broadcast or 

## Output

Returns a JSON object with a timestamp, an array of fee plans (one per child size) showing how many satoshis the child must pay given the ancestor's observed base fees and the target fee rate, plus a terms disclaimer clarifying this is arithmetic estimation only — not transaction construction, broadcast, or confirmation guarantee.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "package"
     ],
     "properties": {
      "package": {
       "type": "string",
       "maxLength": 255,
       "description": "txid:target_sat_vb:child_vbytes[,child_vbytes...]. Target 0.001..10000 sat/vB (up to 3 decimals), one to 25 unique child sizes of 60..100000 vbytes."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "<UTC timestamp>",
  "plans": [],
  "terms": "A fee arithmetic estimate, not a transaction, broadcast, relay-policy validation or confirmation guarantee. Assumes one child spending an available output of the selected transaction and no additional unconfirmed inputs. Child size is buyer-supplied. Uses actual base fees of the observed transaction and its ancestors, excluding local fee deltas. Other miners and nodes can have different views and policies. Check output ownership, available value, descendants and package policy. Paid replay preserves the original snapshot; recheck current conditions before acting.",
  "product": "cpfp_budget_batch"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-cpfp-fee-bump-plan-a66b0df3/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)
