# Carbon Cashmere OHLCV Candlestick Data API

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

Returns historical OHLCV (open, high, low, close, volume) candlestick data for 34+ cryptocurrencies at 15m, 1h, 4h, or 1d intervals, up to 90 days of history.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/ohlcv/:var1
- Price: $0.02/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-f2ea8970
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tgsXOavbBdPcw4c7kmj1X

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

Example prompt: Can you pull the 1-hour OHLCV candlestick data for BTC over the last 30 days so I can run a technical analysis on it?

## When to prefer this

Use this endpoint when you need historical OHLCV candlestick data for one of the 34 supported cryptocurrencies for technical analysis, charting, or backtesting. It is ideal when you need a specific interval granularity (15m, 1h, 4h, or 1d) and up to 90 days of lookback. Prefer this over the real-time price endpoint when you need time-series history rather than a current snapshot.

## Known failure modes

- Unsupported coin ticker returns a validation error — only the 34 listed enum values are accepted
- Invalid interval string (e.g. '1min' instead of '15m') returns an error — must use enum: 15m, 1h, 4h, 1d
- days parameter out of range (less than 1 or greater than 90) returns a validation error
- Payment failure (x402 protocol) if USDC payment of $0.02 is not supplied or rejected
- Network timeout if the upstream data source is temporarily unavailable

## How this service works

Get historical OHLCV candlestick data for 116 cryptocurrencies — open, high, low, close prices with sample count per candle. Intervals: 15min, 1hour, 4hour, 1day. Up to 90 days of history for BTC, ETH, SOL, and 113 more coins. AI agent API for technical analysis, charting, backtesting data feeds, and price history retrieval.

## Output

Returns a JSON object containing the coin ticker, interval label, total candle count, and an array of OHLCV candles — each candle includes open, high, low, close prices and a sample count for that period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "enum": [
        "AAVE",
        "ADA",
        "APT",
        "ARB",
        "ATOM",
        "AVAX",
        "BCH",
        "BNB",
        "BTC",
        "DOGE",
        "DOT",
        "ETC",
        "ETH",
        "HBAR",
        "HYPE",
        "ICP",
        "KAS",
        "LINK",
        "LTC",
        "MATIC",
        "NEAR",
        "ONDO",
        "OP",
        "SKY",
        "SOL",
        "SUI",
        "TAO",
        "TON",
        "TRX",
        "UNI",
        "XLM",
        "XMR",
        "XRP",
        "ZEC"
       ],
       "type": "string",
       "examples": [
        "AAVE",
        "ADA",
        "APT",
        "ARB",
        "ATOM",
        "AVAX",
        "BCH",
        "BNB",
        "BTC",
        "DOGE"
       ],
       "description": "Cryptocurrency ticker symbol (uppercase). 34 supported coins."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "integer",
       "maximum": 90,
       "minimum": 1
      },
      "interval": {
       "enum": [
        "15m",
        "1h",
        "4h",
        "1d"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "coin": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "candles": {
       "type": "array"
      },
      "interval": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

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