Market Data Endpoints

Check Server Time

GET /api/v1/time

Test connectivity to the Rest API and get the current server time.

Weight: 1

Parameters:

NONE

json

{
  "serverTime": 1538323200000
}

Exchange Information

GET /api/v1/exchangeInfo

Current exchange trading rules and symbol information

Important Notice

The rateLimits field in the response will be removed in future iterations. A new endpoint will be provided to retrieve rate limit information. Please do not rely on this field.

Weight：1

Parameters：

NONE

json

{
  "timezone": "UTC",
  "brokerFilters": [],
  "symbols": [ // spot symbols
    {
      "filters":[
          {
              "minPrice":"0.01",
              "maxPrice":"100000.00000000",
              "tickSize":"0.01",
              "filterType":"PRICE_FILTER"
          },
          {
              "minQty":"0.0001", // min trade quantity
              "maxQty":"4000", // max trade quantity
              "stepSize":"0.0001",
              "filterType":"LOT_SIZE"
          },
          {
              "minNotional":"10",
              "filterType":"MIN_NOTIONAL"
          },
              {
              "minAmount": "10", // minimum transaction amount
              "maxAmount": "6600000", // maximum trade amount
              "minBuyPrice": "0.01", // minimum buy price
              "filterType": "TRADE_AMOUNT" 
          },
          {
              "maxSellPrice": "999999999", // limit max sell price
              "buyPriceUpRate": "0.1", // maximum sell price
              "sellPriceDownRate": "0.1", // maximum sell price
              "sellPriceDownRate": "0.1", // the maximum sell price of the limit
              "maxEntrustNum": "100000", // the maximum number of orders (contracts)
              "maxConditionNum": "100000", // maximum number of condition orders (contracts)
              "filterType": "LIMIT_TRADING"
          },
          {
              "buyPriceUpRate": "0.1", // Buy cannot be higher than 10% of the marked (contract)/latest (spot) price
              "sellPriceDownRate": "0.1", // Sell cannot be less than 10% of the marked (contract)/latest (spot) price
              "filterType": "MARKET_TRADING"
          },
          {
              "noAllowMarketStartTime": "0", // Market order start time is not allowed 
              "noAllowMarketEndTime": "0", // Do not allow the market order end time
              "limitOrderStartTime": "0", // the start time of a limit order
              "limitOrderEndTime": "0", // Limit order end time
              "limitMinPrice": "0", // the minimum price of a limit order
              "limitMaxPrice": "0", // the maximum price of the limit order
              "filterType": "OPEN_QUOTE"
          }
      ], 
      "exchangeId": "301",
      "symbol": "ETHUSDT",
      "symbolName": "ETHUSDT",
      "status": "TRADING",
      "baseAsset": "ETH",
      "baseAssetName": "ETH",
      "baseAssetPrecision": "0.0001",
      "quoteAsset": "USDT",
      "quoteAssetName": "USDT",
      "quotePrecision": "0.01",
      "icebergAllowed": false,
      "isAggregate": false,
      "allowMargin": true
    }
  ],
  "rateLimits": [ // Note: This field will be removed in future iterations. A new endpoint will be provided to retrieve rate limit information
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalUnit": 1,
      "limit": 3000
    },
    {
      "rateLimitType": "ORDERS",
      "interval": "SECOND",
      "intervalUnit": 60,
      "limit": 60
    }
  ],
  "options": [],
  "contracts": [ // Futures(contracts) symbols
    {
      "filters":[
          {
              "minPrice":"0.01",
              "maxPrice":"100000.00000000",
              "tickSize":"0.01",
              "filterType":"PRICE_FILTER"
          },
          {
              "minQty":"0.0001", // min trade quantity, token quantity not contracts
              "maxQty":"4000", // max trade quantity, token quantity not contracts
              "stepSize":"0.0001",
              "filterType":"LOT_SIZE"
          },
          {
              "minNotional":"10",
              "filterType":"MIN_NOTIONAL"
          },
              {
              "minAmount": "10", // minimum transaction amount
              "maxAmount": "6600000", // maximum trade amount
              "minBuyPrice": "0.01", // minimum buy price
              "filterType": "TRADE_AMOUNT" 
          },
          {
              "maxSellPrice": "999999999", // limit max sell price
              "buyPriceUpRate": "0.1", // maximum sell price
              "sellPriceDownRate": "0.1", // maximum sell price
              "sellPriceDownRate": "0.1", // the maximum sell price of the limit
              "maxEntrustNum": "100000", // the maximum number of orders (contracts)
              "maxConditionNum": "100000", // maximum number of condition orders (contracts)
              "filterType": "LIMIT_TRADING"
          },
          {
              "buyPriceUpRate": "0.1", // Buy cannot be higher than 10% of the marked (contract)/latest (spot) price
              "sellPriceDownRate": "0.1", // Sell cannot be less than 10% of the marked (contract)/latest (spot) price
              "filterType": "MARKET_TRADING"
          },
          {
              "noAllowMarketStartTime": "0", // Market order start time is not allowed 
              "noAllowMarketEndTime": "0", // Do not allow the market order end time
              "limitOrderStartTime": "0", // the start time of a limit order
              "limitOrderEndTime": "0", // Limit order end time
              "limitMinPrice": "0", // the minimum price of a limit order
              "limitMaxPrice": "0", // the maximum price of the limit order
              "filterType": "OPEN_QUOTE"
          }
      ], 
      "exchangeId": "301",
      "symbol": "BTC-SWAP-USDT",
      "symbolName": "BTC-SWAP-USDTUSDT",
      "status": "TRADING",
      "baseAsset": "BTC-SWAP-USDT",
      "baseAssetPrecision": "1",
      "quoteAsset": "USDT",
      "quoteAssetPrecision": "0.1",
      "icebergAllowed": false,
      "inverse": false,
      "index": "BTCUSDT",
      "marginToken": "USDT",
      "marginPrecision": "0.0001",
      "contractMultiplier": "0.0001",
      "underlying": "BTC",
      "riskLimits": [
        {
          "riskLimitId": "200000133",
          "quantity": "1000000.0",
          "initialMargin": "0.01",
          "maintMargin": "0.005"
        },
        {
          "riskLimitId": "200000134",
          "quantity": "2000000.0",
          "initialMargin": "0.02",
          "maintMargin": "0.01"
        },
        {
          "riskLimitId": "200000135",
          "quantity": "3000000.0",
          "initialMargin": "0.03",
          "maintMargin": "0.015"
        },
        {
          "riskLimitId": "200000136",
          "quantity": "4000000.0",
          "initialMargin": "0.04",
          "maintMargin": "0.02"
        }
      ],
      "categories": ["New", "TradFi"] // Contract categories, English names; empty array when no category, multiple when belongs to multiple categories
    },
    {
      "filters":[
          {
              "minPrice":"0.01",
              "maxPrice":"100000.00000000",
              "tickSize":"0.01",
              "filterType":"PRICE_FILTER"
          },
          {
              "minQty":"0.0001",
              "maxQty":"4000",
              "stepSize":"0.0001",
              "filterType":"LOT_SIZE"
          },
          {
              "minNotional":"10",
              "filterType":"MIN_NOTIONAL"
          },
              {
              "minAmount": "10", // minimum transaction amount
              "maxAmount": "6600000", // maximum trade amount
              "minBuyPrice": "0.01", // minimum buy price
              "filterType": "TRADE_AMOUNT" 
          },
          {
              "maxSellPrice": "999999999", // limit max sell price
              "buyPriceUpRate": "0.1", // maximum sell price
              "sellPriceDownRate": "0.1", // maximum sell price
              "sellPriceDownRate": "0.1", // the maximum sell price of the limit
              "maxEntrustNum": "100000", // the maximum number of orders (contracts)
              "maxConditionNum": "100000", // maximum number of condition orders (contracts)
              "filterType": "LIMIT_TRADING"
          },
          {
              "buyPriceUpRate": "0.1", // Buy cannot be higher than 10% of the marked (contract)/latest (spot) price
              "sellPriceDownRate": "0.1", // Sell cannot be less than 10% of the marked (contract)/latest (spot) price
              "filterType": "MARKET_TRADING"
          },
          {
              "noAllowMarketStartTime": "0", // Market order start time is not allowed 
              "noAllowMarketEndTime": "0", // Do not allow the market order end time
              "limitOrderStartTime": "0", // the start time of a limit order
              "limitOrderEndTime": "0", // Limit order end time
              "limitMinPrice": "0", // the minimum price of a limit order
              "limitMaxPrice": "0", // the maximum price of the limit order
              "filterType": "OPEN_QUOTE"
          }
      ], 
      "exchangeId": "301",
      "symbol": "BTC-SWAP",
      "symbolName": "BTC-SWAP",
      "status": "TRADING",
      "baseAsset": "BTC-SWAP",
      "baseAssetPrecision": "1",
      "quoteAsset": "USDT",
      "quoteAssetPrecision": "0.1",
      "icebergAllowed": false,
      "inverse": true,
      "index": "BTCUSDT",
      "marginToken": "BTC",
      "marginPrecision": "0.00000001",
      "contractMultiplier": "1.0",
      "underlying": "BTC",
      "riskLimits": [
        {
          "riskLimitId": "200000137",
          "quantity": "1000000.0",
          "initialMargin": "0.01",
          "maintMargin": "0.005"
        },
        {
          "riskLimitId": "200000138",
          "quantity": "2000000.0",
          "initialMargin": "0.02",
          "maintMargin": "0.01"
        },
        {
          "riskLimitId": "200000139",
          "quantity": "3000000.0",
          "initialMargin": "0.03",
          "maintMargin": "0.015"
        },
        {
          "riskLimitId": "200000140",
          "quantity": "4000000.0",
          "initialMargin": "0.04",
          "maintMargin": "0.02"
        }
      ],
      "categories": ["New", "TradFi"] // Contract categories, English names; empty array when no category, multiple when belongs to multiple categories
    }
  ],
  "coins": [
    {
      "orgId": "9001",
      "coinId": "ETH",
      "coinName": "ETH",
      "coinFullName (tokenFullName)": "Ethereum",
      "allowWithdraw": true,
      "allowDeposit": true,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "USDT",
      "coinName": "USDT",
      "coinFullName (tokenFullName)": "TetherUS",
      "allowWithdraw": true,
      "allowDeposit": true,
      "chainTypes": [
        {
          "chainType": "ERC20",
          "withdrawFee": "0.1",
          "minWithdrawQuantity": "10",
          "maxWithdrawQuantity": "1000",
          "minDepositQuantity": "1",
          "allowDeposit": true,
          "allowWithdraw": true
        },
        {
          "chainType": "TRC20",
          "withdrawFee": "0.1",
          "minWithdrawQuantity": "10",
          "maxWithdrawQuantity": "1000",
          "allowDeposit": true,
          "allowWithdraw": true
        },
        {
          "chainType": "OMNI",
          "withdrawFee": "0.1",
          "minWithdrawQuantity": "10",
          "maxWithdrawQuantity": "1000",
          "allowDeposit": true,
          "allowWithdraw": true
        }
      ]
    },
    {
      "orgId": "9001",
      "coinId": "BTC",
      "coinName": "BTC",
      "coinFullName": "Bitcoin",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "UNI",
      "coinName": "UNI",
      "coinFullName": "uniswap",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "XRP",
      "coinName": "XRP",
      "coinFullName (tokenFullName)": "XRP",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "EOS",
      "coinName": "EOS1",
      "coinFullName (tokenFullName)": "EOS",
      "allowWithdraw": true,
      "allowDeposit": true,
      "chainTypes": []
    },
    {
      "orgId": "9001",
      "coinId": "JET",
      "coinName": "JET",
      "coinFullName (tokenFullName)": "JET",
      "allowWithdraw": false,
      "allowDeposit": false,
      "chainTypes": []
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358

status Field Description:

For spot trading pairs (pairs in the symbols array), possible values of status:

Status Value	Description
TRADING	Trading
ONLINE	Online (not tradable)
OFFLINE	Offline (trading pair has been delisted)
API_TRADE_FORBIDDEN	API trading forbidden (trading via API is prohibited)

For contract trading pairs (pairs in the contracts array), possible values of status:

Status Value	Description
TRADING	Trading
ONLINE	Online (not tradable)
API_TRADE_FORBIDDEN	API trading forbidden (trading via API is prohibited)
OPEN_FORBIDDEN	Opening forbidden (opening positions is forbidden, but closing is allowed)
CLOSE_FORBIDDEN	Closing forbidden (closing positions is forbidden, but opening is allowed)

Order Book

GET /quote/v1/depth

Weight:

Adjusted based on the limit:

Limit	Weight
5, 10, 20, 50, 100	1
500	5
1000	10

json

{
  "t": 1768300458706,//Matching time
  "b": [
    [
      "3.90000000",   // price
      "431.00000000"  // quantity
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "a": [
    [
      "4.00000200",  // price
      "12.00000000"  // quantity
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ]
}

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
limit	INT	NO	Default 100;

Notes：If limit=0 is set, a lot of data will be returned.

Merge Depth

GET /quote/v1/depth/merged

Merged deep interface.

Weight：1

json

{
    "t": 1672035413265,//time
    "b": [//Buy Depth High to Low
        [
            "16851.95",//price
            "0.003321"//quantity
        ],
        [
            "16851.87",
            "0.005456"
        ],
        [
            "16851.47",
            "0.002219"
        ]
    ],
    "a": [//Sell Depth Low to High
        [
            "16870.19",
            "0.003838"
        ],
        [
            "16873.05",
            "0.00361"
        ],
        [
            "16873.06",
            "0.002623"
        ]
    ]
}

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
scale	INT	NO	Gears: `0`,`1`,`2`,`3`,`4`,`5` For example: `0`means gear `1`, `1` means gear `2`
limit	INT	NO

Recent Trades List

GET /quote/v1/trades

Get recent market trades

Weight：1

json

[
  {
    "p": "4.00000100",
    "q": "12.00000000",
    "t": 1499865549590,
    "ibm": true  // Transaction direction isBuyerMaker
  }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
limit	INT	NO	Default 60; Max 60

Kline/Candlestick Data

GET /quote/v1/klines

Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.

Weight：1

json

[
  [
    1499040000000,      // Open time
    "0.01634790",       // Open price
    "0.80000000",       // High price
    "0.01575800",       // Low price
    "0.01577100",       // Close price
    "148976.11427815",  // Volume
    1499644799999,      // Close time
    "2434.19055334",    // Quote asset volume
    308,                //  Number of trades
    "1756.87402397",    // Taker buy base asset volume
    "28.46694368"       // Taker buy quote asset volume
  ]
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
interval	ENUM	YES	interval
startTime	LONG	NO	start timestamp
endTime	LONG	NO	en d timestamp
limit	INT	NO	Default 1000; Max 1000

Notes: If startTime and endTime are not sent, only the latest K line will be returned.

Index Price Kline/Candlestick Data

GET /quote/v1/index/klines

Kline/candlestick bars for the index price of a pair.

json

{
    "code": 200,
    "data": [
        {
            "t": 1669155300000,//time
            "s": "BTCUSDT",// symbol
            "sn": "BTCUSDT",//symbol name
            "c": "1127.1",//Close price
            "h": "1130.81",//High price
            "l": "1126.17",//Low price
            "o": "1130.8",//Open price
            "v": "0",//Volume
            "st": 1669156800000 //interface response time
        },
        {
            "t": 1669156200000,
            "s": "ETHUSDT",
            "sn": "ETHUSDT",
            "c": "1129.44",
            "h": "1129.54",
            "l": "1127.1",
            "o": "1127.1",
            "v": "0",
            "st": 1669156800000
        }
  ]
}

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
interval	ENUM	YES	interval
from	LONG	YES	start timestamp
to	LONG	YES	end timestamp
limit	INT	NO	limit, DEFAULT:2000 MAX:2000

Get Index Price Components

GET /quote/v1/indexPriceComponents

get the index components of one symbol

json

{
  "index": "91429.02891304", //Last price of the index
  "edp": "91408.35002101", //last 10 minutes average index price
  "components": [
    {
      "exchange": "BITGET", //Name of the exchange
      "spotPair": "BTCUSDT",//Spot trading pair on the exchange (e.g., BTCUSDT)
      "weight": "1.0" //Weight in the index calculation
    },
    {
      "exchange": "KUCOIN",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "COINBASE",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "MEXC",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "BYBIT",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "OKEX",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    },
    {
      "exchange": "BINANCE",
      "spotPair": "BTCUSDT",
      "weight": "1.0"
    }
  ],
  "time": 1768277194000 //Timestamp of the last update in milliseconds
}

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	Index name, like BTCUSDT

Mark Price Kline/Candlestick Data

GET /quote/v1/markPrice/klines

Kline/candlestick bars for the mark price of a symbol.

json

{
    "code": 200,
    "data": [
        {
            "symbol": "BTC-SWAP-USDT",// Symbol
            "time": 1670157900000,// time
            "low": "16991.14096",//Low price
            "open": "16991.78288",//Open price
            "high": "16996.30641",// High prce
            "close": "16996.30641",// Close price
            "volume": "0",// Volume
            "curId": 1670157900000,
            "klineType": "1m", // kline type,such as 1m,5m....
            "change": "0.0008" //(index price-mark price)/mark price
        }
    ]
}

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
interval	ENUM	YES	interval
from	LONG	YES	start timestamp
to	LONG	YES	end timestamp
limit	INT	NO	limit,DEFAULT 2000 MAX 2000

Mark Price

GET /quote/v1/markPrice

Returns the mark price. With symbol, the response is a single JSON object for that symbol. Without symbol, the response is a JSON array of all currently available mark prices.

Rate limit: up to 5 requests per second.

json

{
  "exchangeId": 301,
  "symbolId": "BTC-SWAP-USDT",
  "price": "17042.54471",
  "time": 1670897454000
}

json

[
  {
    "exchangeId": 301,
    "symbolId": "BTC-SWAP-USDT",
    "price": "17042.54471",
    "time": 1670897454000
  }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	NO	Symbol; omit to return the full list

Funding Rate

GET /api/v1/futures/fundingRate

json

[
    {
        "symbol": "BTC-SWAP-USDT",
        "rate": "0.0018099173553719",
        "period": "8H",
        "nextFundingTime": "1668427200000",
        "interest": "0.0001",
        "fundingRateCap": "0.003",
        "fundingRateFloor": "-0.003"
    }
]

Field	Type	Description
symbol	STRING	Symbol
rate	STRING	Current funding rate
period	STRING	Funding settlement period (e.g. `8H`)
nextFundingTime	STRING	Next funding settlement time (ms timestamp)
interest	STRING	Interest rate (base)
fundingRateCap	STRING	Current funding rate cap
fundingRateFloor	STRING	Current funding rate floor

Parameters

Name	Type	Mandatory	Description
symbol	STRING	NO	symbol

Get Funding Rate History

GET /api/v1/futures/historyFundingRate

json

[
  { 
    "id": "3434343434343",
    "symbol": "BTC-SWAP-USDT", // Symbol
    "settleTime": "1570708800000", // Funding rate settlement time
    "settleRate": "0.00321", // Funding rate
    "period": "8H" // Funding rate settlement period
  }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
fromId	LONG	NO	start id
endId	LONG	NO	end id
limit	INT	NO	Default `20` Min `1` Max `1000`

Get Open Interest

GET /quote/v1/openInterest

Get the total positions of a certain trading pair on the platform

json

{
  "openInterestList": [
    {
      "size": "88059.96", //Total open interest of the platform Specific coins, eg.: ETH in ETHUSDT
      "symbol": "ETH-SWAP-USDT" //Trading pair name
    }
  ]
}

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol

Long/Short Ratio

GET /quote/v1/globalLongShortAccountRatio

Query symbol Long/Short Ratio

json

[
  {
    "symbol": "BTC-SWAP-USDT",
    "timeStamp": 1768271400000,
    "longShortRatio": "2.7432", // long/short account num ratio of all traders
    "longAccount": "0.7329", //long account num ratio of all traders
    "shortAccount": "0.2671" // short account num ratio of all traders
  }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	symbol
period	STRING	YES	"5m","15m","30m","1h","2h","4h","6h","12h","1d"
limit	LONG	NO	default 30, max 500
startTime	LONG	NO
endTime	LONG	NO

note：If startTime and endTime are not sent, the most recent data is returned. Only the data of the latest 30 days is availab

Get Insurance fund

GET /api/v1/futures/insuranceBySymbol

query the insurance fund balance of a certain trading pair

json

{
  "list": [
    {
      "coin": "USDT", //Coin
      "symbol": "BTC-SWAP-USDT", //contracts symbol
      "value": "4271010.26212436", //USD value
      "updateTime": "1768262400000" //Data updated time (ms)
    },
    {
      "coin": "USDT",
      "symbol": "BTC-SWAP-USDT",
      "value": "4271013.74008353",
      "updateTime": "1768176000000"
    }
  ]
}

Data updated time (ms)

Name	Type	Mandatory	Description
symbolId	STRING	YES	symbol

note：The system returns 14 days of data by default, updated daily at 00:00 UTC.

Get All Risk Limit Configuration List

GET /api/v1/futures/riskLimits

Get all risk limit configuration list for the specified trading pair (only returns non-whitelist risk limits).

Weight：1

json

[
  {
    "level": 1, // Risk level, sorted by quantity, starting level is 1
    "quantity": "1000000.0", // Quantity
    "maintainMargin": "0.005", // Maintenance margin rate
    "initialMargin": "0.01", // Initial margin rate
    "maxLeverage": 100 // Maximum leverage
  },
  {
    "level": 2,
    "quantity": "2000000.0",
    "maintainMargin": "0.01",
    "initialMargin": "0.02",
    "maxLeverage": 50
  }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	YES	Trading pair

24hr Ticker Price Change Statistics

GET /quote/v1/contract/ticker/24hr

24 hour rolling window price change statistics. Careful when accessing this with no symbol.

Weight：

1 for a single symbol; 40 when the symbol parameter is omitted

json

[
    {
        "t": 1538725500422,   // time
        "a": "1.10000000",    // highest selling price
        "b": "1.00000000",    // highest bid
        "s": "BTC-SWAP-USDT", // symbol 
        "c": "4.00000200",    // latest transaction price
        "o": "99.00000000",   // open price
        "h": "100.00000000",  // high price 
        "l": "0.10000000",    // low price
        "v": "8913.30000000", // Base asset volume
        "qv": "15.30000000",   // otal trade volume (in quote asset)
        "pc": "15.30000000",   // priceChange
        "pcp": "15.30000000"   // priceChangePercent
    }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	NO	symbol
realtimeInterval	ENUM	NO	`24h`,`1d`,`1d+8`

If the symbol is not sent, tickers for all symbols will be returned in an array.

Symbol Price Ticker

GET /quote/v1/contract/ticker/price

Latest price for a symbol or symbols.

Weight：1

json

[
  {
    "s": "BTC-SWAP-USDT",  // Symbol
    "p": "4.00000200"  // Latest price
  }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	NO	symbol

If the symbol is not sent, tickers for all symbols will be returned in an array.

Symbol Index Price

GET /quote/v1/index

Index price for a symbol or symbols.

Weight：1

json

{
    "index":{
        "BTCUSDT":"42999.21"  // index price
    },
    "edp":{
        "BTCUSDT":"43031.36006" // Average of indices over 10 minutes
    }
}

Parameters

Name	Type	Mandatory	Description
symbol	STRING	NO	symbol

If the symbol is not sent, tickers for all symbols will be returned in an array.

Symbol Order Book Ticker

GET /quote/v1/contract/ticker/bookTicker

Best price/qty on the order book for a symbol or symbols.

Weight：1

json

[
  {
      "t": 1535975085052,     // Time
      "s": "BTC-SWAP-USDT",     // Symbol         
      "b": "4.00000000",        // bidPrice
      "bq": "431.00000000",     // bidQty
      "a": "4.00000200",        // askPrice
      "aq": "9.00000000"        // askQty
  }
]

Parameters

Name	Type	Mandatory	Description
symbol	STRING	NO	symbol

If the symbol is not sent, bookTickers for all symbols will be returned in an array.

Market Data Endpoints ​

Check Server Time ​

Weight: 1 ​

Parameters: ​

Exchange Information ​

Weight：1 ​

Parameters： ​

Order Book ​

Weight: ​

Parameters ​

Merge Depth ​

Weight：1 ​

Parameters ​

Recent Trades List ​

Weight：1 ​

Parameters ​

Kline/Candlestick Data ​

Weight：1 ​

Parameters ​

Index Price Kline/Candlestick Data ​

Parameters ​

Get Index Price Components ​

Parameters ​

Mark Price Kline/Candlestick Data ​

Parameters ​

Mark Price ​

Parameters ​

Funding Rate ​

Parameters ​

Get Funding Rate History ​

Parameters ​

Get Open Interest ​

Parameters ​

Long/Short Ratio ​

Parameters ​

Get Insurance fund ​

Data updated time (ms) ​

Get All Risk Limit Configuration List ​

Weight：1 ​

Parameters ​

24hr Ticker Price Change Statistics ​

Weight： ​

Parameters ​

Symbol Price Ticker ​

Weight：1 ​

Parameters ​

Symbol Index Price ​

Weight：1 ​

Parameters ​

Symbol Order Book Ticker ​

Weight：1 ​

Parameters ​

Market Data Endpoints

Check Server Time

Weight: 1

Parameters:

Exchange Information

Weight：1

Parameters：

Order Book

Weight:

Parameters

Merge Depth

Weight：1

Parameters

Recent Trades List

Weight：1

Parameters

Kline/Candlestick Data

Weight：1

Parameters

Index Price Kline/Candlestick Data

Parameters

Get Index Price Components

Parameters

Mark Price Kline/Candlestick Data

Parameters

Mark Price

Parameters

Funding Rate

Parameters

Get Funding Rate History

Parameters

Get Open Interest

Parameters

Long/Short Ratio

Parameters

Get Insurance fund

Data updated time (ms)

Get All Risk Limit Configuration List

Weight：1

Parameters

24hr Ticker Price Change Statistics

Weight：

Parameters

Symbol Price Ticker

Weight：1

Parameters

Symbol Index Price

Weight：1

Parameters

Symbol Order Book Ticker

Weight：1

Parameters