> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Candle Schema

> OHLCV candle data. Includes required fields, field types, schema references, and generated JSON details from the 0xArchive OpenAPI contract.

Source OpenAPI: 0xArchive API 1.8.0; 227 paths; 217 component schemas.

OHLCV candle data

## Required Fields

| Field | Type | Description |
| - | - | - |
| `close` | number:double | Closing price |
| `high` | number:double | Highest price during interval |
| `low` | number:double | Lowest price during interval |
| `open` | number:double | Opening price |
| `timestamp` | string:date-time | Candle start timestamp (ISO 8601 UTC) |
| `volume` | number:double | Trading volume in base asset |

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Candle",
  "description": "OHLCV candle data",
  "type": "object",
  "required": [
    "close",
    "high",
    "low",
    "open",
    "timestamp",
    "volume"
  ],
  "properties": {
    "close": {
      "description": "Closing price",
      "type": "number",
      "format": "double",
      "example": 42650.75
    },
    "high": {
      "description": "Highest price during interval",
      "type": "number",
      "format": "double",
      "example": 42750
    },
    "low": {
      "description": "Lowest price during interval",
      "type": "number",
      "format": "double",
      "example": 42300.25
    },
    "open": {
      "description": "Opening price",
      "type": "number",
      "format": "double",
      "example": 42500.5
    },
    "quote_volume": {
      "description": "Trading volume in quote asset (USD)",
      "type": "number",
      "format": "double",
      "example": 53187500
    },
    "timestamp": {
      "description": "Candle start timestamp (ISO 8601 UTC)",
      "type": "string",
      "format": "date-time",
      "example": "2026-01-01T12:00:00Z"
    },
    "trade_count": {
      "description": "Number of trades in interval",
      "type": "integer",
      "example": 4520
    },
    "volume": {
      "description": "Trading volume in base asset",
      "type": "number",
      "format": "double",
      "example": 1250.5
    }
  }
}
```

## Components using this schema

* [ApiResponseCandleArray](/schemas/components/api-response-candle-array)

## Referenced By

Use this shared schema with the generated component index and route-specific endpoint pages during implementation.

## Operations using this component transitively

* [`GET /v1/hyperliquid/candles/{symbol}`](/schemas/operations/get-hyperliquid-candles)
* [`GET /v1/hyperliquid/hip3/candles/{symbol}`](/schemas/operations/get-hip3-candles)
* [`GET /v1/hyperliquid/hip4/candles/{symbol}`](/schemas/operations/get-hip4-candles)
* [`GET /v1/hyperliquid/spot/candles/{symbol}`](/schemas/operations/get-spot-candles)
* [`GET /v1/lighter/candles/{symbol}`](/schemas/operations/get-lighter-candles)
* [`GET /v1/rh-lighter/candles/{symbol}`](/schemas/operations/get-rh-lighter-candles)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.