# Ozmium OHLC Candle History API

> Ozmium OHLC Candle History API is a paid API for AI agents from ozmium.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns OHLC candlestick history with window high/low extremes for crypto, metals, forex, indices, and stocks

## Facts

- Endpoint: GET https://ozmium.org/v1/candles
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ozmium-ohlc-candle-history-api-ecdafafc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-32R5FdFiiAqPNqJeq0n3

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 ozmium-ohlc-candle-history-api-ecdafafc
```

Example prompt: Can you pull the OHLC candle history for ETH-USD over the last 30 days from Ozmium, including the highest high and lowest low across the whole window?

## When to prefer this

Use this endpoint when you need historical OHLC price data with windowed high/low extremes across crypto (via Coinbase), metals, forex, indices, or stocks in a single unified API. Prefer it over raw Coinbase candles when you also need non-crypto assets or want the pre-computed window extremes without post-processing.

## Known failure modes

- Invalid product symbol returns error or empty candles array
- days parameter exceeding 350 results in unsupported range error
- Missing required query parameters returns 400 or malformed response
- Unknown asset class or unsupported sym/cls combination returns error
- x402 payment failure (insufficient USDC balance) blocks the request

## How this service works

OHLC history with window extremes (highest high / lowest low over the window). Crypto via Coinbase (GET /v1/candles?product=ETH-USD&days=30; hourly bars <= 7d, six-hour <= 31d, daily <= 350d). Metals / indices / forex / stocks via ?sym=XAU&cls=Commodities[&quote=USD]. Returns { productId, days, high, low, candles, series: [[startSec, open, high, low, close], ...] } oldest first. Full details: GET /v1.

## Output

Returns a JSON object with productId, days, window-level high and low extremes, total candle count, and a time series array of [startSec, open, high, low, close] tuples ordered oldest-first. Bar resolution is hourly for up to 7 days, six-hourly for up to 31 days, and daily for up to 350 days.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "string"
      },
      "product": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "low": {
         "type": "number"
        },
        "days": {
         "type": "number"
        },
        "high": {
         "type": "number"
        },
        "candles": {
         "type": "number"
        },
        "productId": {
         "type": "string"
        }
       }
      },
      "network": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ozmium-ohlc-candle-history-api-ecdafafc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ozmium.org](https://www.zero.xyz/host/ozmium.org/llms.txt)