合约行情接口

获取服务端时间

限速规则：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

获取某个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

获取成交数据

限速规则：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分钟

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

最低价格

收盘价格

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

可开张数

Previous快速入门 Next合约账户接口

Last updated 2 years ago