Get Kline (Candlesticks)

Retrieves historical candlestick (kline) data for a given trading symbol and interval.

This endpoint provides historical market data in the form of candlesticks, also known as klines.

Each kline represents aggregated trading information — including open, high, low, close prices, trading volume, and turnover — over a specified time interval.

Users can query by symbol and interval, and optionally specify a startTime, endTime, and limit to control the data range.

This data is commonly used for charting, technical analysis, and historical trend evaluation.

Authentication with a valid API key and read permission scope is required.

Get Candle Chart

get

Required scopes

This endpoint requires the following scopes:

Authorizations

thirdPartyApiKeyAuth

api-keystringRequired

For third party retail API users

Query parameters

symbolstringRequired

Trading symbol

Example: BTCUSDT.PERPPattern: ^[A-Z0-9]+(\.[A-Z0-9]+)?$

intervalstring · enumRequired

Kline interval

Example: 1hPossible values:

startTimeanyRequired

Precise, high-resolution (nanosecond level) integer timestamp.

endTimeanyRequired

Precise, high-resolution (nanosecond level) integer timestamp.

limitinteger · min: 100 · max: 1000OptionalDefault: 100

Responses

200

OK

application/json

get

/api/v1/market/kline

HTTPcURLJavaScriptPython

GET /api/v1/market/kline?symbol=BTCUSDT.PERP&interval=1h&startTime=null&endTime=null HTTP/1.1
Host: trading-api.flipster.io
api-key: YOUR_API_KEY
Accept: */*

200

OK

[
  [
    null
  ]
]