Skip to main content
GET
/
v1
/
tv
/
kline_history
Get Kline History
curl --request GET \
  --url https://api.perpo.trade/v1/tv/kline_history \
  --header 'perpo-account-id: <perpo-account-id>' \
  --header 'perpo-key: <perpo-key>' \
  --header 'perpo-signature: <perpo-signature>' \
  --header 'perpo-timestamp: <perpo-timestamp>'
{
  "s": "ok",
  "o": [
    2.105,
    2.155,
    2.105,
    2.0285,
    1.8,
    2.55,
    2.55
  ],
  "c": [
    2.1,
    2.155,
    2.057,
    1.86,
    1.8,
    2.55,
    2.48
  ],
  "h": [
    2.155,
    2.155,
    2.105,
    2.0285,
    1.8,
    2.55,
    3.175
  ],
  "l": [
    2.1,
    2.155,
    2.02,
    1.85,
    1.8,
    2.55,
    2.48
  ],
  "v": [
    22,
    0,
    2,
    3000,
    26,
    0,
    2
  ],
  "a": [
    46.2,
    0,
    4.114,
    5635,
    46.8,
    0,
    6.1
  ],
  "t": [
    1761955200,
    1762041600,
    1762128000,
    1762214400,
    1762300800,
    1762646400,
    1762732800
  ]
}

Headers

​
perpo-timestamp
string
required
​
perpo-account-id
string
required
​
perpo-key
string
required
​
perpo-signature
string
required

Query Parameters

​
symbol
string
required

Symbol name

​
resolution
string
required

1m/5m/15m/30m/1h/4h/12h/1d/1w/1mon

​
from
string

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).

​
to
string

If the range from from to to contains only 500 klines, then all 500 will be returned, starting from to and moving backward.

​
limit
number

Numbers of klines you want to query. Maximum of 1000 klines allowed.

Response

200 - application/json

OK

​
s
string
required
Example:

"ok"

​
o
number[]
required
Example:
[
  2.105,
  2.155,
  2.105,
  2.0285,
  1.8,
  2.55,
  2.55
]
​
c
number[]
required
Example:
[2.1, 2.155, 2.057, 1.86, 1.8, 2.55, 2.48]
​
h
number[]
required
Example:
[
  2.155,
  2.155,
  2.105,
  2.0285,
  1.8,
  2.55,
  3.175
]
​
l
number[]
required
Example:
[2.1, 2.155, 2.02, 1.85, 1.8, 2.55, 2.48]
​
v
number[]
required
Example:
[22, 0, 2, 3000, 26, 0, 2]
​
a
number[]
required
Example:
[46.2, 0, 4.114, 5635, 46.8, 0, 6.1]
​
t
integer<int64>[]
required
Example:
[
  1761955200,
  1762041600,
  1762128000,
  1762214400,
  1762300800,
  1762646400,
  1762732800
]