# Carbon & Cashmere Rolling Correlation API

> Carbon & Cashmere Rolling Correlation API 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-15).

Returns rolling correlation statistics between two crypto assets over a configurable lookback window, including current correlation, percentile rank, trend, and market regime classification.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/rolling-correlation/%7Bpair%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/carbon-cashmere-rolling-correlation-api-64f40fc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VYcZnK9-3jHa7ynEv0BqI

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 carbon-cashmere-rolling-correlation-api-64f40fc1
```

Example prompt: What's the current rolling correlation between BTC and ETH — is it in a strongly positive regime right now, and where does today's reading sit relative to the past 90 days?

## When to prefer this

Use this endpoint when you need quantitative rolling correlation statistics between two specific crypto assets, including regime classification and percentile context — particularly useful for pairs trading, portfolio hedging, and co-movement analysis. Prefer this over raw price endpoints when the relationship between two assets matters more than their individual prices.

## Known failure modes

- Invalid or unsupported pair format returns an error or empty response
- Pair with insufficient historical data may return limited statistics
- Malformed path parameter causes a 400 or 404 response
- Payment not included or insufficient triggers x402 payment-required response
- Rate limiting or service unavailability returns 429 or 503

## How this service works

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

## Output

A JSON object containing the base and quote assets, current Pearson correlation coefficient, correlation trend (e.g. stable/rising/falling), regime classification (e.g. strongly_positive), percentile rank within the lookback window, mean and standard deviation over the lookback, number of data points, and window/lookback durations in days.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "BTC",
  "pair": "BTC-ETH",
  "_meta": {
   "disclaimer": "Informational research data only — not investment advice."
  },
  "quote": "ETH",
  "trend": "stable",
  "regime": "strongly_positive",
  "statistics": {
   "std_over_lookback": 0.08,
   "current_percentile": 0.68,
   "mean_over_lookback": 0.78
  },
  "data_points": 540,
  "window_days": 30,
  "lookback_days": 90,
  "current_correlation": 0.82
 }
}
```

## More

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