合约行情接口

获取服务端时间

限速规则：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线的时间单位,粒度（取值参考如下列表)

描述	granularity
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	可开张数