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 Kline (Candlesticks)

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, in minutes (1D, 1W, 1M denotes 1 day, 1 week, 1 month)

Example: 1Possible values:

startTimestringRequired

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

Example: 1765975842095607088

endTimestringRequired

the end of the time range for data retrieval

Example: 1765975842095607088

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

Responses

200

OK

application/json

[startTime, open, high, low, close, volume, turnover]

itemsone ofOptional

stringOptional

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

Example: 1765975842095607088

or

stringOptional

Precise, high-resolution number type.

Example: ###.###

get

/api/v1/market/kline

HTTPcURLJavaScriptPython

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

200

OK

[
  [
    "1765975842095607088",
    "###.###",
    "###.###",
    "###.###",
    "###.###",
    "###.###",
    "###.###"
  ]
]