KUCOIN API

Get Premium Index

GET

https://api-futures.kucoin.com/api/v1/premium/query

domain:Futures

api-channel:Public

api-permission:NULL

api-rate-limit-pool:Public

sdk-service:Futures

sdk-sub-service:Market

sdk-method-name:getPremiumIndex

api-rate-limit-weight:3

Discription

Submit request to get premium index (Update snapshots once per second, real-time query).

Request

Query Params

symbol

string

required

Symbol of the contract. Please refer to Get Symbol endpoint: premiumsSymbol1M, premiumsSymbol8H

Examples:

.XBTUSDTMPI.XBTUSDTMPI8H

startAt

integer <int64>

optional

Start time (milliseconds)

Example:

1728663338000

endAt

integer <int64>

optional

End time (milliseconds)

Example:

1728692138000

reverse

boolean

optional

This parameter functions to judge whether the lookup is reversed. True means “yes”. False means “no”. This parameter is set as True by default.

Default:

true

Example:

true

offset

integer <int64>

optional

Start offset. The unique attribute of the last returned result of the last request. The data of the first page will be returned by default.

Example:

254062248624417

forward

boolean

optional

This parameter functions to judge whether the lookup is forward or not. True means “yes” and False means “no”. This parameter is set as true by default.

Default:

true

Example:

true

maxCount

integer <int64>

optional

Max. record count. The default record count is 10; the maximum length cannot exceed 100

<= 100

Default:

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api-futures.kucoin.com/api/v1/premium/query?symbol=&startAt=1728663338000&endAt=1728692138000&reverse=true&offset=254062248624417&forward=true&maxCount=10'

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

hasMore

boolean

required

Whether there are more pages

dataList

array [object {4}]

required

Example

{
  "code": "200000",
  "data": {
    "hasMore": true,
    "dataList": [
      {
        "symbol": ".XBTUSDTMPI",
        "granularity": 60000,
        "timePoint": 1730558040000,
        "value": 0.00006
      },
      {
        "symbol": ".XBTUSDTMPI",
        "granularity": 60000,
        "timePoint": 1730557980000,
        "value": -0.000025
      }
    ]
  }
}

Modified at 2025-03-19 02:11:52

Get Interest Rate Index

Get 24hr stats