Get Historical Candlestick

Frequency limit: 20 times/1s (IP)

Description

Query all historical K-line data and return a maximum of 200 pieces of data.

HTTP Request

• GET /api/v2/mix/market/history-candles

Request Example

curl "https://api.cointr.com/api/v2/mix/market/history-candles?symbol=BTCUSDT&granularity=1W&limit=200&productType=usdt-futures"

Request Parameters

Parameter	Type	Required	Description
symbol	String	Yes	Trading pair
productType	String	Yes	Product type USDT-FUTURES USDT professional futures COIN-FUTURES Mixed futures USDC-FUTURES USDC professional futures SUSDT-FUTURES USDT professional futures demo SCOIN-FUTURES Mixed futures demo SUSDC-FUTURES USDC professional futures demo
granularity	String	Yes	K-line particle size - 1m(1 minute) - 3m(3 minutes) - 5m(5 minutes) - 15m(15 minutes) - 30m(30 minutes) - 1H( 1 hour) - 4H(4 hours) - 6H(6 hours) - 12H(12 hours) - 1D(1 day) - 3D ( 3 days) - 1W (1 week) - 1M (monthly line) - 6Hutc (UTC 6 hour line) - 12Hutc (UTC 12 hour line) - 1Dutc (UTC 1-day line) - 3Dutc (UTC 3-day line) - 1Wutc (UTC weekly line) - 1Mutc (UTC monthly line)
startTime	String	No	The start time is to query the k-lines after this time According to the different time granularity, the corresponding time unit must be rounded down to be queried. The millisecond format of the Unix timestamp, such as 1672410780000 Request data after this start time (the maximum time query range is 90 days)
endTime	String	No	The end time is to query the k-lines before this time According to the different time granularity, the corresponding time unit must be rounded down to be queried. The millisecond format of the Unix timestamp, such as 1672410780000 Request data before this end time (the maximum time query range is 90 days)
limit	String	No	Default: 100, maximum: 200

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695865864944,
    "data": [
        [
            "1687708800000",
            "27176.93",
            "27177.43",
            "27166.93",
            "27177.43",
            "2990.08",
            "81246917.3294"
        ],
        [
            "1688313600000",
            "27177.43",
            "27177.43",
            "24000",
            "24001",
            "2989.1",
            "72450031.0448"
        ]
    ]
}

Response Parameters

Parameter	Type	Description
index[0]	String	Milliseconds format of timestamp Unix, e.g. 1597026383085
index[1]	String	Entry price
index[2]	String	Highest price
index[3]	String	Lowest price
index[4]	String	Exit price(Only include the finished K line data)
index[5]	String	Trading volume of the base coin
index[6]	String	Trading volume of quote currency