# Carbon Cashmere Macro-Crypto Correlation API

> Carbon Cashmere Macro-Crypto Correlation API is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.02/call, status down (last checked 2026-09-14).

Returns rolling 7-day and 30-day Pearson correlations between BTC and major macro assets (DXY, VIX, 10Y Treasury, Oil, Gold) with signal interpretation and macro regime classification.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/macro-correlation
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-2935ea03
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RuCAI6mPiX2eLHjGNKEvm

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-2935ea03
```

Example prompt: What's the current macro correlation between Bitcoin and DXY, gold, oil, VIX, and the 10-year Treasury — give me both the 7-day and 30-day Pearson numbers plus the macro regime classification and any signal interpretations like risk-on or diverging.

## When to prefer this

Use this endpoint when you need quantitative rolling Pearson correlations between BTC and traditional macro assets with pre-computed signal labels and regime classification. Prefer this over raw price feeds when you want interpreted cross-asset intelligence (risk-on/off, divergence signals) without doing your own correlation math. Ideal for macro-aware trading agents, risk monitoring dashboards, or any workflow that needs to understand whether BTC is behaving as a risk asset, a safe haven, or diverging from its historical macro relationships.

## Known failure modes

- Insufficient data points for 7d window (min 10 samples required) — returns null or error for that window
- Insufficient data points for 30d window (min 30 samples required) — returns null or error for that window
- Upstream yfinance or market data feed unavailable — 502 or stale data warning
- Payment not received or x402 authorization failure — 402 response blocking access
- Rate limiting or quota exhaustion — 429 response

## How this service works

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

## Output

Returns a JSON object with the current BTC spot price, timestamp, latency, and per-asset correlation objects for DXY, VIX, TNX (10Y Treasury), CL (Crude Oil), and GC (Gold). Each asset entry includes its current price, 24h change, 7-day Pearson correlation, 30-day Pearson correlation, and a signal label (e.g. risk_on_together, diverging, unusual_positive). Also includes a top-level macro_regime string and metadata about the calculation methodology and data sources.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "end_date": "2024-01-31",
   "commodity": "cashmere",
   "start_date": "2024-01-01",
   "carbon_market": "EU_ETS"
  }
 }
}
```

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "btc_price": 84500,
  "correlations": {
   "DXY": {
    "price": 104.2,
    "signal": "inverse",
    "correlation_7d": -0.65
   },
   "VIX": {
    "price": 22.5,
    "signal": "decoupled",
    "correlation_7d": -0.45
   }
  },
  "macro_regime": "mixed"
 }
}
```

## More

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