K-Line Data

Get historical K-line data for futures trading pairs.

API Information

• Method: GET
• Path: /api/v1/futures/open-api/kline

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Futures trading pair, e.g. BTCUSDT
interval	string	No	K-line interval, default 1m
startTime	int64	No	Start time in milliseconds
endTime	int64	No	End time in milliseconds
limit	int	No	Number of records, default 500, max 1000

Supported K-line intervals:
1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo

Request Example

GET /api/v1/futures/open-api/kline?symbol=BTCUSDT&interval=1m&limit=100

Response Fields

Field	Type	Description
code	int	Status code, 200 indicates success
msg	string	Response message
data	array	K-line data list

K-line Data Object:

• t: Opening time in milliseconds
• o: Open price
• h: High price
• l: Low price
• c: Close price
• v: Volume
• f: true indicates filled placeholder K-line when no trades occur

Response Example

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "t": 1737446400000,
      "o": "68637.5",
      "h": "68637.5",
      "l": "68637.5",
      "c": "68637.5",
      "v": "0",
      "f": true
    },
    {
      "t": 1737446460000,
      "o": "68580.0",
      "h": "68650.2",
      "l": "68550.8",
      "c": "68620.5",
      "v": "12.5"
    }
  ]
}