# Bitcoin Transaction ETA & Fee Bump Projector

> Bitcoin Transaction ETA & Fee Bump Projector 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-21).

Given a Bitcoin transaction ID, returns its confirmation status, projected block inclusion, effective fee rate, and actionable RBF/CPFP fee-bump recommendations.

## Facts

- Endpoint: GET https://diamond.btc-intel.workers.dev/api/x402/tx_eta?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-transaction-eta-fee-bump-projector-23a1577d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ekWZ4wOR9nxw5ARhgr6Ya

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-transaction-eta-fee-bump-projector-23a1577d
```

Example prompt: My Bitcoin transaction a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 is unconfirmed — how many blocks away is it from confirming, what's its effective fee rate, and what would I need to pay to get it into the next block?

## When to prefer this

Use this endpoint when you need real-time, per-transaction confirmation ETA and fee-bump guidance for a specific unconfirmed Bitcoin transaction. It is superior to generic fee estimators because it accounts for the transaction's own effective fee rate, its position relative to the current mempool, and returns actionable RBF and CPFP budget figures. Prefer it over block explorer scraping for structured, machine-readable output with no account required.

## Known failure modes

- Invalid or malformed txid (not 64 hex characters) returns a validation error
- Already-confirmed transaction may return a different status with no bump recommendations
- Transaction not found in mempool or node's history returns a not-found error
- Network or node sync lag may cause stale mempool snapshot
- Payment not included or underpayment returns 402 Payment Required

## How this service works

Confirmation outlook for a Bitcoin transaction: its effective (cluster chunk) fee rate, the projected block it sits in, the fee rate the next block needs, and the RBF total fee or CPFP child fee that would get it in. Confirmed ones (last 6 blocks) report confirmations.

## Output

A JSON object containing: the txid, UTC timestamp of the check, confirmation status (e.g. 'unconfirmed'), projected block number ahead of current tip, effective fee rate in sat/vB, next-block minimum fee rate in sat/vB, and a 'bump' object with CPFP child fee in satoshis, RBF minimum total fee in satoshis, and target fee rate needed to accelerate.

## 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": [
      "txid"
     ],
     "properties": {
      "txid": {
       "type": "string",
       "maxLength": 64,
       "description": "Transaction id (64 hex characters)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bump": {
   "cpfp_child_fee_sat": 380,
   "rbf_min_total_fee_sat": 310,
   "target_fee_rate_sat_vb": 2.2
  },
  "txid": "a1075db55d416d3ca199f55b6084e2115b9345e16c5cf302fc80e9d5fbf5d48d",
  "as_of": "2026-11-07T18:00:00Z",
  "status": "unconfirmed",
  "product": "transaction_eta",
  "projected_block": 3,
  "effective_fee_rate_sat_vb": 1.2,
  "next_block_min_fee_sat_vb": 2.1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-transaction-eta-fee-bump-projector-23a1577d/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)
