# BTC Coin Days Destroyed (CDD) — 24h History

> BTC Coin Days Destroyed (CDD) — 24h History is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Retrieves the last 24 hours of Bitcoin Coin Days Destroyed (CDD) data, measuring age-weighted coin movement to detect smart money activity and long-term holder behavior.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/onchain/cdd
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-34b65250
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Pv0MT9Lg9OBQVf0pqoWYw

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-34b65250
```

Example prompt: Pull the last 24 hours of Bitcoin Coin Days Destroyed data — I want to see if long-term holders have been moving coins recently and whether it could signal a market top.

## When to prefer this

Use this endpoint when you need Bitcoin-specific age-weighted on-chain movement data (CDD) rather than raw transaction volume or price data. Ideal for smart money analysis, HODLer behavior tracking, and identifying potential market cycle inflection points. Prefer over generic price or volume endpoints when the user wants to understand whether long-term BTC holders are distributing coins.

## Known failure modes

- Payment not received or invalid x402 payment header — 402 Payment Required
- On-chain data source temporarily unavailable — 503 Service Unavailable
- Rate limit exceeded — 429 Too Many Requests
- Malformed request parameters — 400 Bad Request
- CDD data may lag slightly behind real-time chain state

## How this service works

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

## Output

Returns an array of BTC Coin Days Destroyed values over the past 24 hours, representing the age-weighted volume of moved coins. High CDD values signal long-term holders (HODLers) are selling, while low values suggest dormant coins remain unmoved — useful for identifying potential market tops or bottoms.

## Example request

```json
{
 "query": "{\\\"input\\\": {\\\"type\\\": \\\"http\\\", \\\"method\\\": \\\"GET\\\", \\\"queryParams\\\": {\\\"address\\\": \\\"0x1234567890123456789012345678901234567890\\\", \\\"chain\\\": \\\"ethereum\\\"}}}\", "
}
```

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cdd": [
   {
    "cdd_proxy": 125000.5,
    "avg_coin_age_est": 45.2,
    "total_volume_btc": 15000,
    "whale_volume_btc": 1200.5
   }
  ]
 }
}
```

## More

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