# NativeBTC Bitcoin Transaction Insight

> NativeBTC Bitcoin Transaction Insight is a paid API for AI agents from api.nativebtc.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Analyzes a Bitcoin transaction to produce a fee verdict, current mempool state, RBF bump plan, and Bitcoin Core v31 block template compatibility check.

## Facts

- Endpoint: POST https://api.nativebtc.org/v1/bitcoin/insight
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nativebtc-bitcoin-transaction-insight-d8dba652
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MsvjFKrfrVcU2HT9bXBYc

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 nativebtc-bitcoin-transaction-insight-d8dba652 -d '<json body>'
```

Example prompt: Analyze Bitcoin transaction a3f8c1d2e4b56789abcdef0123456789abcdef0123456789abcdef0123456789ab — I want a fee verdict, the current mempool state, an RBF bump plan targeting confirmation within 3 blocks, and a Bitcoin Core v31 template compatibility check.

## When to prefer this

Use this endpoint when you need a single unified call to diagnose a Bitcoin transaction — combining fee analysis, mempool context, RBF bump planning, and Core v31 template checking in one response. Prefer over manual mempool explorers or separate fee-estimation APIs when you need structured, actionable output and RBF replacement guidance in one shot.

## Known failure modes

- Invalid txid format (not 64 hex characters) returns a validation error
- Transaction not found in mempool or blockchain returns not-found error
- Invalid action enum value returns bad request
- signedReplacementHex malformed or invalid returns relay error
- targetBlocks below minimum of 1 returns validation error
- Payment not received or x402 flow incomplete returns 402 Payment Required

## How this service works

Unified Bitcoin transaction analysis: fee verdict, mempool state, RBF bump plan, and Core v31 template check.

## Output

Returns a unified insight report including: fee adequacy verdict (overpaying/underpaying/appropriate), current mempool congestion state, an actionable RBF fee-bump plan with suggested replacement fee rate, and a Bitcoin Core v31 block template compatibility assessment for the given transaction.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "txid": {
   "type": "string",
   "pattern": "^[0-9a-fA-F]{64}$",
   "description": "Bitcoin transaction ID as 64 lowercase or uppercase hex characters."
  },
  "action": {
   "enum": [
    "analyze",
    "broadcast_signed_replacement"
   ],
   "type": "string",
   "description": "Analyze the transaction or relay a user-signed replacement transaction."
  },
  "address": {
   "type": "string",
   "description": "Bitcoin address such as bc1q..., bc1p..., 1..., or 3...."
  },
  "targetBlocks": {
   "type": "number",
   "minimum": 1,
   "description": "Desired confirmation target in blocks."
  },
  "signedReplacementHex": {
   "type": "string",
   "description": "User-signed raw Bitcoin replacement transaction hex. FastPath relays only; it never signs or holds funds."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bump": {
   "method": "rbf_signed_replacement",
   "available": true,
   "additionalFeeSats": 110,
   "signsOrCustodiesFunds": false
  },
  "success": true,
  "summary": "Effective fee rate 2 sat/vB is at or above the 1 sat/vB target.",
  "verdict": "healthy_for_target",
  "templateCheck": {
   "mode": "live_cached",
   "source": "core_v31_optimizer_cache",
   "inBaselineTemplate": false,
   "inOptimizedTemplate": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nativebtc-bitcoin-transaction-insight-d8dba652/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nativebtc.org](https://www.zero.xyz/host/api.nativebtc.org/llms.txt)