获取聚合行情

/sapi/v1/market/detail/merged

请求类型: GET

是否验签: 否

接口权限: 读取

限频: 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线，获取基差数据、获取市场最近成交记录： （1） restful接口：同一个IP, 所有业务（交割合约、币本位永续合约和U本位合约）总共1秒最多800个请求

接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract_code支持交割合约代码，格式为BTC-USDT-210625；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。

请求地址

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	true	合约代码 或 合约标识	永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）

响应参数

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.$contract_code.detail.merged
status	string	true	请求处理结果	ok , "error"
<tick>	object	true	开盘价和收盘价（从当天零点(UTC+8)开始）
id	long	true	K线ID,也就是K线时间戳
amount	string	true	成交量(币), 即 (成交量(张) * 单张合约面值)（最近24（当前时间-24小时）小时成交量币）。 值是买卖双边之和
ask	array	true	[卖1价,卖1量(张)]
bid	array	true	[买1价,买1量(张)]
open	string	true	开盘价
close	string	true	收盘价,当K线为最晚的一根时，是最新成交价
count	decimal	true	成交笔数（当前时间-24小时）小时成交笔数）。 值是买卖双边之和
high	string	true	最高价
low	string	true	最低价
vol	string	true	成交量（张）（最近24（当前时间-24小时）小时成交量张）。 值是买卖双边之和
trade_turnover	string	true	成交额，即 sum（每一笔成交张数 * 合约面值 * 成交价格）（当前时间-24小时）小时成交额）。 值是买卖双边之和
ts	long	true	时间戳
</tick>		false
ts	long	true	响应生成时间点，单位：毫秒

请求示例

curl "https://api.sunx.io/sapi/v1/market/detail/merged?contract_code=BTC-USDT"

响应示例

{
  "ch": "market.BTC-USDT.detail.merged",
  "status": "ok",
  "tick": {
    "amount": "12.526",
    "ask": [
      13084.2,
      131
    ],
    "bid": [
      13082.9,
      38
    ],
    "close": "13076.8",
    "count": 2920,
    "high": "13205.3",
    "id": 1603695162,
    "low": "12877.5",
    "open": "12916.2",
    "trade_turnover": "163247.3982",
    "ts": 1603695162580,
    "vol": "12526"
  },
  "ts": 1603695162580
}