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

# OHLCV Candles

OHLCV candles for a single asset and interval. Both `start_time` and `end_time` are required.

Supported intervals: `1m`, `5m`, `15m`, `1h`, `4h`, `1d`.

## Example

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" "https://hyper.polynode.dev/v2/candles?coin=BTC&interval=1h&start_time=1776000000000&end_time=1776090000000"
```

```json theme={null}
[
  {
    "t": 1775998800000,
    "T": 1776002399999,
    "s": "BTC",
    "i": "1h",
    "o": "71052.0",
    "c": "70855.0",
    "h": "71106.0",
    "l": "70833.0",
    "v": "1726.25425",
    "n": 26227
  }
]
```

| Field | Description               |
| ----- | ------------------------- |
| `t`   | Open time (Unix ms)       |
| `T`   | Close time (Unix ms)      |
| `s`   | Symbol                    |
| `i`   | Interval                  |
| `o`   | Open price                |
| `c`   | Close price               |
| `h`   | High price                |
| `l`   | Low price                 |
| `v`   | Volume (base asset units) |
| `n`   | Number of trades          |


## OpenAPI

````yaml GET /exchange/candles
openapi: 3.1.0
info:
  title: hypernode API
  description: >-
    Real-time HyperLiquid L1 streaming and REST API for market data, trading,
    and account management.
  contact:
    name: hypernode
    url: https://hyper.polynode.dev
  version: 1.0.0
servers:
  - url: https://hyper.polynode.dev
    description: Production
security: []
paths:
  /exchange/candles:
    get:
      tags:
        - Market Data
      summary: OHLCV candles
      operationId: get_candles
      parameters:
        - name: coin
          in: query
          required: true
          schema:
            type: string
        - name: interval
          in: query
          required: false
          schema:
            type: string
            default: 1h
            enum:
              - 1m
              - 5m
              - 15m
              - 1h
              - 4h
              - 1d
        - name: start_time
          in: query
          required: true
          schema:
            type: integer
        - name: end_time
          in: query
          required: true
          schema:
            type: integer
        - name: network
          in: query
          required: false
          schema:
            type: string
            default: mainnet
      responses:
        '200':
          description: Candles array
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Candle'
components:
  schemas:
    Candle:
      type: object
      properties:
        t:
          type: integer
          description: Open time (ms)
        T:
          type: integer
          description: Close time (ms)
        s:
          type: string
          description: Symbol
        i:
          type: string
          description: Interval
        o:
          type: string
          description: Open price
        c:
          type: string
          description: Close price
        h:
          type: string
          description: High price
        l:
          type: string
          description: Low price
        v:
          type: string
          description: Volume
        'n':
          type: integer
          description: Number of trades

````