# Carbon & Cashmere Macro Snapshot API

> Carbon & Cashmere Macro Snapshot 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 a macro market regime snapshot including DXY, VIX, Gold, Oil, and US 10-Year Yield with a risk-on/risk-off classification score for crypto market context.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/macro-snapshot
- 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/carbon-cashmere-macro-snapshot-api-857159c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CZ8j-PmG0NdXI4oDjxxYF

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-macro-snapshot-api-857159c2
```

Example prompt: What's the current macro market regime right now — are we risk-on or risk-off — and give me the latest DXY, VIX, gold, oil, and 10-year yield readings with their 24-hour moves?

## When to prefer this

Use this endpoint when you need a single consolidated macro snapshot to inform crypto trading decisions, determine risk appetite, or contextualize price signals. Ideal when you want a pre-scored risk-on/risk-off regime rather than raw data you must interpret yourself. Prefer over generic financial data APIs when you need crypto-specific macro intelligence with a ready-made regime classification.

## Known failure modes

- Stale data if markets are closed on weekends or holidays (staleness >48h indicated in freshness.warning)
- Missing or malformed response if upstream market data feed is unavailable
- Payment failure if USDC balance is insufficient for the $0.02 per-call fee
- Rate limiting or authentication errors if x402 payment header is missing or invalid

## How this service works

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

## Output

Returns a JSON object with a regime object (numeric score, classification such as 'risk_on', and contributing factors), a freshness object (stale hours and weekend warning), and an array of macro indicators including DXY, VIX, Gold, Crude Oil (WTI), and US 10-Year Yield with current price, unit, and 24h percent change.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "regime": {
   "score": 1,
   "factors": [
    "DXY -0.44% (risk-on, USD weak)"
   ],
   "classification": "risk_on"
  },
  "freshness": {
   "warning": "Markets closed weekends — staleness >48h likely means weekend/holiday.",
   "stale_hours": 24.5
  },
  "indicators": [
   {
    "name": "US Dollar Index",
    "unit": "index",
    "price": 97.84,
    "symbol": "DXY",
    "change_24h_pct": -0.44
   },
   {
    "name": "CBOE Volatility Index",
    "unit": "index",
    "price": 17.18,
    "symbol": "VIX",
    "change_24h_pct": -1.72
   },
   {
    "name": "Gold",
    "unit": "USD/oz",
    "price": 4723.7,
    "symbol": "GC",
    "change_24h_pct": 0.23
   },
   {
    "name": "Crude Oil (WTI)",
    "unit": "USD/barrel",
    "price": 94.68,
    "symbol": "CL",
    "change_24h_pct": -1.74
   },
   {
    "name": "US 10-Year Yield",
    "unit": "%",
    "price": 4.36,
    "symbol": "TNX"
   }
  ]
 }
}
```

## More

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