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

# candleSnapshot

> Native Hyperliquid `/info` operation. Returns OHLC candles for the coin, interval, and time range in `req`.



## OpenAPI

````yaml /reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#53
openapi: 3.0.0
info:
  title: Uniblock Hyperliquid Info API
  description: >-
    Per-operation request/response docs for the Raw Hyperliquid Info dispatch
    endpoint. Each Hyperliquid Info `type` is a synthetic path through the
    single `POST /v1/hyperliquid/info` unified route.
  version: '1.0'
servers:
  - url: https://api.uniblock.dev/uni
    description: Gateway
security:
  - ApiKeyAuth: []
tags:
  - name: Hyperliquid
paths:
  /v1/hyperliquid/info#53:
    post:
      tags:
        - Hyperliquid
      summary: candleSnapshot
      description: >-
        Native Hyperliquid `/info` operation. Returns OHLC candles for the coin,
        interval, and time range in `req`.
      operationId: candleSnapshot_HyperliquidInfo
      parameters:
        - name: chainId
          required: true
          in: query
          description: Unique identifier for a blockchain network.
          schema:
            type: number
            enum:
              - 999
              - 998
            default: 999
            example: 999
        - name: provider
          required: false
          in: query
          description: >-
            Specify which provider to use. The project's provider priority list
            is used by default if no providers are selected. (Priority list can
            be managed on Uniblock's dashboard)
          schema:
            type: string
            enum:
              - Dwellir
              - Chainstack
              - Covalent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HyperliquidInfo_candleSnapshot_Request'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HyperliquidInfo_candleSnapshot_Response'
components:
  schemas:
    HyperliquidInfo_candleSnapshot_Request:
      type: object
      required:
        - type
        - req
      properties:
        type:
          type: string
          enum:
            - candleSnapshot
          default: candleSnapshot
          example: candleSnapshot
        req:
          type: object
          description: The candle query.
          required:
            - coin
            - interval
            - startTime
          properties:
            coin:
              type: string
              description: >-
                The asset symbol (e.g. `BTC`), or `dex:SYMBOL` for a builder
                DEX.
              example: BTC
            interval:
              type: string
              description: The candle interval (e.g. `1m`, `1h`, `1d`).
              example: 1h
            startTime:
              type: number
              description: Inclusive start time, epoch milliseconds.
              example: 1704067200000
            endTime:
              type: number
              description: >-
                Optional exclusive end time, epoch milliseconds. Defaults to
                now.
              example: 1706745600000
      example:
        type: candleSnapshot
        req:
          coin: BTC
          endTime: 1706745600000
          interval: 1h
          startTime: 1704067200000
    HyperliquidInfo_candleSnapshot_Response:
      type: array
      description: OHLCV candles for the requested coin, interval, and range, oldest first.
      items:
        type: object
        required:
          - t
          - T
          - s
          - i
          - o
          - c
          - h
          - l
          - v
          - 'n'
        properties:
          t:
            type: number
            description: Open time, epoch ms.
            example: 1704067200000
          T:
            type: number
            description: Close time, epoch ms.
            example: 1704070800000
          s:
            type: string
            description: Coin symbol.
            example: BTC
          i:
            type: string
            description: Interval.
            example: 1h
          o:
            type: string
            description: Open price.
            example: '63000.0'
          c:
            type: string
            description: Close price.
            example: '63500.0'
          h:
            type: string
            description: High price.
            example: '63800.0'
          l:
            type: string
            description: Low price.
            example: '62900.0'
          v:
            type: string
            description: Volume.
            example: '1234.5'
          'n':
            type: number
            description: Trade count.
            example: 42
      example: []
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key to access the API (Optional)

````