# Bitcoin Whale Transaction Tracker

> Bitcoin Whale Transaction Tracker is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.05/call, status down (last checked 2026-09-15).

Tracks large Bitcoin transactions (whales) from a live full-node ZMQ stream, returning BTC/USD values, fee rates, size, ancestry, RBF flags, and confirmation status with sub-second freshness

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/bitcoin/whales
- Price: $0.05/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-a2a31362
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KtmG1VJklQuypgHlEPFCM

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-a2a31362
```

Example prompt: Show me all Bitcoin whale transactions above 50 BTC from the last 24 hours — I want to see their USD value, fee rate, size, whether they're RBF-flagged, and a summary of what's going on.

## When to prefer this

Choose this endpoint when you need near-real-time Bitcoin whale transaction data with rich per-transaction metadata (fee rates, RBF, ancestors/descendants) sourced directly from a full node rather than a third-party aggregator. Ideal for on-chain research, mempool monitoring, or detecting large BTC movements with configurable size thresholds and lookback windows up to 168 hours.

## Known failure modes

- Threshold too high returns empty transaction list
- Lookback window exceeding 168h returns error or is clamped
- Node sync lag during network stress may delay freshest mempool entries
- Invalid parameter types (non-numeric threshold) return 400 bad request
- Payment not included or insufficient USDC returns 402 payment required

## How this service works

Professional crypto market intelligence. Real-time prices, signals, and market scoring.

## Output

A list of large Bitcoin transactions matching the threshold filter, each with txid, BTC and USD value, fee rate (sat/vB), transaction size in bytes, ancestor and descendant counts, BIP125 RBF flag, and confirmation status — plus an aggregate summary (count, total BTC, total USD) across all matched transactions. Data is sourced from a live Bitcoin Core full node via ZMQ with sub-second freshness.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "_meta": {
   "source": "btc_core_node_zmq_whale_stream",
   "disclaimer": "Informational research data only — not investment advice."
  },
  "query": {
   "hours": 24,
   "limit": 50,
   "min_btc": 100
  },
  "whales": [
   {
    "txid": "abc123...def89012",
    "confirmed": true,
    "total_btc": 1250.5,
    "total_usd": 98523100,
    "bip125_rbf": false,
    "fee_rate_satvb": 28.5
   }
  ],
  "summary": {
   "count": 42,
   "total_btc": 18754.2,
   "total_usd": 1478234567.8,
   "confirmed_pct": 0.833,
   "rbf_flagged_count": 7,
   "avg_whales_per_hour": 1.75
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-carbon-cashmere-de-a2a31362/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)