合约行情接口
获取服务端时间
限速规则：20次/2s
HTTP请求 返回服务器的时间
GET /api/swap/v3/market/time
返回数据:
{
"epoch":"1591099099.896", //Unix时间戳的秒数
"iso":"2020-06-02T11:58:19.896Z", //ISO8601标准的时间格式
"timestamp":1591099099896 //Unix时间戳的毫秒数
}返回值说明
epoch
Unix时间戳的秒数
iso
ISO8601标准的时间格式
timestamp
Unix时间戳的毫秒数
获取合约信息
限速规则：20次/2s
HTTP请求 获取所有合约的信息
GET /api/swap/v3/market/contracts
返回数据:
[
{
"symbol":"cmt_btcusdt", //合约名称
"coin":"USDT", //保证金币种
"contract_val":"0.0001", //合约面值
"delivery":[ //结算时间
"07:00:00",
"15:00:00",
"23:00:00"
],
"forwardContractFlag":true, //是否是正向合约
"priceEndStep":5, //价格最后一位步长
"quote_currency":"USDT", //计价币种
"size_increment":"0", //数量精度
"tick_size":"1", //价格精度
"underlying_index":"BTC" //合约币种
"minLeverage":1 // 最小杠杆
"maxLeverage":100 //最大杠杆
}
]返回值说明
symbol
合约名称
coin
保证金币种
contract_val
合约面值
delivery
结算时间
forwardContractFlag
是否是正向合约
priceEndStep
价格最后一位步长
quote_currency
计价币种
size_increment
数量精度
tick_size
价格精度
underlying_index
合约币种
minLeverage
最小杠杆
maxLeverage
最大杠杆
获取深度数据
限速规则：20次/2s
HTTP请求 获取深度数据
GET /api/swap/v3/market/depth
请求参数
symbol
String
是
合约名称
limit
Integer
是
深度大小 范围在(1-200)之间
返回数据:
{
"asks":[
[
"8858.0", //价格
"19299"//数量
]
],
"bids":[
[
"7466.0", //价格
"499" //数量
],
[
"4995.0",
"12500"
]
],
"timestamp":"1591237821479"
}返回值说明
asks
买方深度
bids
卖方深度
timestamp
时间戳
获取全部ticker信息
限速规则：20次/2s
HTTP请求 获取全部ticker信息
GET /api/swap/v3/market/tickers
返回数据:
[
{
"symbol":"cmt_bchusdt", //合约名称
"best_ask":"332.00", //卖一价
"best_bid":"203.00", //买一价
"high_24h":"394", //24小时最高价
"last":"332", //最新成交价
"low_24h":"332", //24小时最低价
"timestamp":"1591240033936", //系统时间戳
"volume_24h":"0", //24小时成交量,单位张数
"priceChangePercent": "-0.63", //24小时价格变动百分比
"base_volume":"15722.59", //24小时成交量 单位币
}
]返回值说明
symbol
合约名称
best_ask
卖一价
best_bid
买一价
high_24h
24小时最高价
last
最新成交价
low_24h
24小时最低价
timestamp
系统时间戳
volume_24h
24小时成交量,张数
priceChangePercent
24小时价格变动百分比
base_volume
24小时成交量,按币统计
获取某个ticker信息
限速规则：20次/2s
HTTP请求 获取某个ticker信息
GET /api/swap/v3/market/ticker
请求参数
symbol
String
是
合约名称
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"best_ask":"8858.0", //卖一价
"best_bid":"7466.0", //买一价
"high_24h":"8858", //24小时最高价
"last":"8858", //最新成交价
"low_24h":"8858", //24小时最低价
"timestamp":"1591252726275", //系统时间戳
"volume_24h":"0", //24小时成交量,单位张数
"priceChangePercent": "-0.63", //24小时价格变动百分比
"base_volume":"15722.59", //24小时成交量 单位币
}返回值说明
symbol
合约名称
best_ask
卖一价
best_bid
买一价
high_24h
24小时最高价
last
最新成交价
low_24h
24小时最低价
timestamp
系统时间戳
volume_24h
24小时成交量,张数
priceChangePercent
24小时价格变动百分比
base_volume
24小时成交量,按币统计
获取成交数据
限速规则：20次/2s
HTTP请求
获取成交数据
GET /api/swap/v3/market/trades
请求参数
symbol
String
是
合约名称
limit
String
是
数据的size大小,范围在(1-100)
返回数据:
[
{
"symbol":"cmt_btcusdt", //合约名称
"price":"7844.00", //成交价格
"side":"buy", //成交方向：sell或者buy
"size":"48", //成交数量
"timestamp":"1591111746879", //成交时间戳
"trade_id":"651735392382353615" //成交id
}
]返回值说明
symbol
合约名称
price
成交价格
side
成交方向：sell，buy
size
成交数量
timestamp
成交时间戳
trade_id
成交id
获取K线数据
限速规则：20次/2s
HTTP请求 获取K线数据
GET /api/swap/v3/market/candles
请求参数
symbol
String
是
合约名称
start
String
是
开始时间 （UTC时间，格式为：yyyy-MM-dd'T'HH:mm:ss.SSS'Z' 标注废弃
end
String
是
结束时间 （UTC时间，格式为：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'） 标注废弃
startTime
Long
是
开始时间(时间戳)
endTime
Long
是
结束时间(时间戳)
granularity
String
是
K线的时间单位,粒度（取值参考如下列表)
1分钟
60
5分钟
300
15分钟
900
30分钟
1800
1小时
3600
4小时
14400
12小时
43200
1天
86400
7天
604800
返回数据:
[
"1556687460000", //系统时间戳
"5315.5", //开盘价格
"5315.5", //最高价格
"5315.5", //最低价格
"5315.5", //收盘价格
"342", //交易量(按张折算)
"0.064340137494" //交易量（按币折算)
]返回值说明
timestamp
系统时间戳
open
开盘价格
high
最高价格
low
最低价格
close
收盘价格
volume
交易量(按张折算)
currency_volume
交易量（按币折算)
获取币种指数
限速规则：20次/2s
HTTP请求 获取币种指数
GET /api/swap/v3/market/index
请求参数
symbol
String
是
合约名称
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"index":"9654.1", //现货指数价格
"timestamp":"1591256590003" //系统时间戳
}返回值说明
symbol
合约名称
index
现货指数价格
timestamp
系统时间戳
获取平台总持仓量
限速规则：20次/2s
HTTP请求 获取平台总持仓量
GET /api/swap/v3/market/open_interest
请求参数
symbol
String
是
合约名称
返回数据:
{
"symbol": "cmt_btcusdt",//合约名称
"amount": "4097696",//总持仓量,张数
"base_volume": "4097.696",//总持仓量,左币量
"target_volume": "47124323.5392",//总持仓量,右币量
"timestamp": "1603109860796",// 系统时间戳
"forwardContractFlag": true //是否是正向合约
}返回值说明
symbol
合约名称
amount
总持仓量，张数
forwardContractFlag
是否是正向合约
timestamp
系统时间戳
base_volume
左币量
target_volume
右币量
获取合约最高限价和最低限价
限速规则：20次/2s
HTTP请求 获取合约最高限价和最低限价
GET /api/swap/v3/market/price_limit
请求参数
symbol
String
是
合约名称
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"forwardContractFlag":true, //是否是正向合约
"highest":"14474.5", //最高买价
"lowest":"4824.5", //最低卖价
"timestamp":"1591257126461" //系统时间戳
}返回值说明
symbol
合约名称
forwardContractFlag
是否是正向合约
highest
最高买价
lowest
最低卖价
timestamp
系统时间戳
获取合约下一次结算时间
限速规则：20次/2s
HTTP请求 获取合约下一次结算时间
GET /api/swap/v3/market/funding_time
请求参数
symbol
String
是
合约名称
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"forwardContractFlag":false, //是否是正向合约
"funding_time":"1591282800000" //下一次的结算时间
}返回值说明
symbol
合约名称
forwardContractFlag
是否是正向合约
funding_time
下一次的结算时间
获取合约历史资金费率
限速规则：20次/2s
HTTP请求 获取合约历史资金费率
GET /api/swap/v3/market/historyFundRate
请求参数
symbol
String
是
合约名称
pageIndex
String
是
页码，为空默认第一页，从1开始
pageSize
String
是
每页数据的条数
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"funding_rate":"0.001", //资金费率
"funding_time":"19238271212" //结算时间
}返回值说明
symbol
合约名称
funding_rate
资金费率
funding_time
结算时间
获取合约标记价格
限速规则：20次/2s
HTTP请求 获取合约标记价格
GET /api/swap/v3/market/mark_price
请求参数
symbol
String
是
合约名称
返回数据:
{
"symbol":"cmt_btcusdt", //合约名称
"mark_price":"8047.87", //标记价格
"timestamp":"1591264230941" //系统时间戳
}返回值说明
symbol
合约名称
mark_price
标记价格
timestamp
系统时间戳
获取可开张数
限速规则：20次/2s
HTTP请求 获取可开张数
GET /api/swap/v3/market/open_count
请求参数
symbol
String
是
合约名称
amount
BigDecimal
是
开仓的总的金额
openPrice
BigDecimal
是
开仓价格
leverage
BigDecimal
否
杠杆默认20倍
返回数据:
"199999" //可开张数返回值说明
openCount
可开张数
Last updated