Market Data Endpoints
Check Server Time
GET /api/v1/time
Test connectivity to the Rest API and get the current server time.
Weight:1
Response
json
{
"serverTime": 1538323200000
}Parameters
NONE
Exchange Information
GET /api/v1/exchangeInfo
Current exchange trading rules and symbol information
Weight:1
Response
json
{
"timezone": "UTC",
"serverTime": "1668407511495",
"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"
}
],
"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": [
{
"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"
}
],
"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"
}
]
},
{
"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"
}
],
"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"
}
]
}
],
"coins": [
{
"coinId": "ETH",
"coinName": "ETH",
"coinFullName": "Ethereum",
"allowWithdraw": true,
"allowDeposit": true,
"chainTypes": []
},
{
"coinId": "USDT",
"coinName": "USDT",
"coinFullName": "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
}
]
},
{
"coinId": "BTC",
"coinName": "BTC",
"coinFullName": "Bitcoin",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
},
{
"coinId": "UNI",
"coinName": "UNI",
"coinFullName": "uniswap",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
},
{
"coinId": "XRP",
"coinName": "XRP",
"coinFullName": "XRP",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
},
{
"coinId": "EOS",
"coinName": "EOS1",
"coinFullName": "EOS",
"allowWithdraw": true,
"allowDeposit": true,
"chainTypes": []
},
{
"coinId": "JET",
"coinName": "JET",
"coinFullName": "JET",
"allowWithdraw": false,
"allowDeposit": false,
"chainTypes": []
}
]
}Parameters
NONE
Order Book
GET /quote/v1/depth
权重：
Response
json
{
"t": 1672035413265,//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 you set limit=0, a lot of data will be returned.
Recent Trades List
GET /quote/v1/trades
Get recent trades.
Weight: 1
Response
json
[
{
"p": "4.00000100",
"q": "12.00000000",
"t": 1499865549590,
"ibm": true // Transaction direction isBuyerMaker
}
]Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| symbol | STRING | YES | |
| 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
Response
json
[
[
1499040000000, // Kline open time
"0.01634790", // Open price
"0.80000000", // High price
"0.01575800", // Low price
"0.01577100", // Close price
"148976.11427815", // Volume
1499644799999, // Kline 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 | end timestamp |
| limit | INT | NO | Default 1000; Max 1000. |
- If
startTimeandendTimeare not sent, only the latest K line will be returned.
24hr Ticker Price Change Statistics
GET /quote/v1/ticker/24hr
24 hour rolling window price change statistics. Careful when accessing this with no symbol.
Weight:
1 if only one symbol was sent; 40 if no symbol was sent.
Response
json
[
{
"t": 1538725500422, // time
"a": "1.10000000", // highest selling price
"b": "1.00000000", // highest bid
"s": "ETHUSDT", // symbol
"c": "4.00000200", // latest transaction price
"o": "99.00000000", // opening price
"h": "100.00000000", // highest price
"l": "0.10000000", // lowest price
"v": "8913.30000000", // Total trade volume (in base asset)
"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 |
- If the symbol is not sent, all symbol data will be returned.
Symbol Price Ticker
GET /quote/v1/ticker/price
Latest price for a symbol or symbols.
Weight:1
Response
json
[
{
"s": "LTCBTC", // symbol
"p": "4.00000200" // price
}
]Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| symbol | STRING | NO | symbol |
- If the symbol is not sent, all symbol data will be returned.
Symbol Order Book Ticker
GET /quote/v1/ticker/bookTicker
Best price/qty on the order book for a symbol or symbols.
Weight:1
Response
json
[
{
"t": 1672035413265, // time
"s": "LTCBTC", // 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, the best order book price for all symbols will be returned.
Merge Depth
GET /quote/v1/depth/merged
Weight: 1
Response
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: 0means gear 1, 1 means gear 2 |
| limit | INT | NO | limit |