v1
latestOpenAPI 3.0.32026-07-2613529376.3 KBKline
The endpoint retrieves information about market kline.
<Note> The API caches the response for: 1 second </Note> <Warning> Rate limit 1000 requests/10 sec. </Warning> <Note> The maximum number of candles per request is 1440. Use `limit` (default: 1440, max: 1440) to control the number of results. Use `start` and `end` timestamps to page through historical data. </Note> <Note> Request validation errors return HTTP `200` with `success: false`, `result: null`, and a `message` object mapping each invalid field to the corresponding messages — for example `{"market": ["Market is not available."]}` or `{"end": ["End field must be greater then start."]}`. </Note>Query parameters
Trading pair to query. The market must exist and be enabled for trading. Example: BTC_USDT
Start time in Unix seconds. Must be greater than or equal to 0 and not greater than the end parameter. When omitted, the default time window depends on the interval — see the interval parameter. Example: 1596848400
End time in Unix seconds. Must be greater than the start parameter and not greater than the current timestamp. Default value is the current time. Example: 1596927600
Candlestick interval. Possible values: 1s, 10s, 30s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. Default value is 1h. When start and end are omitted, the default time window depends on the interval: sub-minute intervals (1s, 10s, 30s) return the last 10 minutes; minute intervals (1m–30m) return 1 day; hour intervals (1h–12h) return 1 week; day and week intervals (1d, 3d, 1w) return 1 month; the month interval (1M) returns 1 year.
Number of candles to return, from 1 to 1440. Default value is 1440. When limit is set, the server derives start as end − limit × interval.
Response
Successful response
Example response
{
"success": true,
"result": [
[
1631440800,
"45865.62",
"45958.14",
"45981.3",
"45750.23",
"15.327634",
"703140.24230131"
]
]
}