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

# Get kline history

> 
**Limit: 5 request per 10 second per IP address**

`GET /v1/tv/kline_history`

Get the historical klines of the specified symbol




## OpenAPI

````yaml orderly.openapi get /v1/tv/kline_history
openapi: 3.0.1
info:
  title: EVM
  description: ''
  version: 1.0.0
servers:
  - url: https://api.orderly.org
    description: Mainnet
  - url: https://testnet-api.orderly.org
    description: Testnet
security: []
tags:
  - name: public
  - name: private
paths:
  /v1/tv/kline_history:
    get:
      tags:
        - public
      summary: Get kline history
      description: |

        **Limit: 5 request per 10 second per IP address**

        `GET /v1/tv/kline_history`

        Get the historical klines of the specified symbol
      parameters:
        - name: symbol
          in: query
          description: Symbol name
          required: true
          example: PERP_BTC_USDC
          schema:
            type: string
        - name: resolution
          in: query
          description: '`1m/5m/15m/30m/1h/4h/12h/1d/1w/1mon`'
          required: true
          example: 1d
          schema:
            type: string
        - name: from
          in: query
          description: >-
            If the range from from to to contains 1200 klines, only 1000 klines
            will be returned, starting from to and moving backward (due to the
            limit).
          required: false
          example: '1761926400'
          schema:
            type: string
        - name: to
          in: query
          description: >-
            If the range from from to to contains only 500 klines, then all 500
            will be returned, starting from to and moving backward.
          required: false
          example: '1762790400'
          schema:
            type: string
        - name: limit
          in: query
          description: >-
            Numbers of klines you want to query.  Maximum of 1000 klines
            allowed.
          required: false
          example: '1000'
          schema:
            type: number
        - $ref: '#/components/parameters/orderly_timestamp'
        - $ref: '#/components/parameters/orderly_account_id'
        - $ref: '#/components/parameters/orderly_key'
        - $ref: '#/components/parameters/orderly_signature'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KlineHistoryResponse'
      deprecated: false
components:
  parameters:
    orderly_timestamp:
      name: orderly-timestamp
      in: header
      description: Timestamp of the signed request in milliseconds.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: '1649920583000'
    orderly_account_id:
      name: orderly-account-id
      in: header
      description: Account ID of the authenticated account.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: 6.858456565150415e+75
    orderly_key:
      name: orderly-key
      in: header
      description: Public orderly key used to sign the request.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: ed25519:8tm7dnKYkSc3FzgPuJaw1wztr79eeZpN35nHW5pL5XhX
    orderly_signature:
      name: orderly-signature
      in: header
      description: Signature of the request payload generated with the orderly key.
      required: true
      style: simple
      explode: false
      schema:
        type: string
      example: >-
        dG4bkKiqG0dUYLzViRZkvbI6Sy239JxAdNMIBxFZ4w030Jofr0ORV06GHtvXZkaZaWUXE+XAU3fnzKN/5fDeBQ==
  schemas:
    KlineHistoryResponse:
      type: object
      required:
        - s
        - o
        - c
        - h
        - l
        - v
        - a
        - t
      properties:
        s:
          type: string
          example: ok
        o:
          type: array
          items:
            type: number
          example:
            - 2.105
            - 2.155
            - 2.105
            - 2.0285
            - 1.8
            - 2.55
            - 2.55
        c:
          type: array
          items:
            type: number
          example:
            - 2.1
            - 2.155
            - 2.057
            - 1.86
            - 1.8
            - 2.55
            - 2.48
        h:
          type: array
          items:
            type: number
          example:
            - 2.155
            - 2.155
            - 2.105
            - 2.0285
            - 1.8
            - 2.55
            - 3.175
        l:
          type: array
          items:
            type: number
          example:
            - 2.1
            - 2.155
            - 2.02
            - 1.85
            - 1.8
            - 2.55
            - 2.48
        v:
          type: array
          items:
            type: number
          example:
            - 22
            - 0
            - 2
            - 3000
            - 26
            - 0
            - 2
        a:
          type: array
          items:
            type: number
          example:
            - 46.2
            - 0
            - 4.114
            - 5635
            - 46.8
            - 0
            - 6.1
        t:
          type: array
          items:
            type: integer
            format: int64
          example:
            - 1761955200
            - 1762041600
            - 1762128000
            - 1762214400
            - 1762300800
            - 1762646400
            - 1762732800

````