获取标记价格的K线数据

/sapi/v1/index/market/history/linear_swap_mark_price_kline

请求类型: 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（次季合约标识）
period	string	true	K线类型	1min, 5min, 15min, 30min, 60min,4hour,1day, 1week,1mon
size	int	true	K线获取数量	[1,2000]

备注: 最多一次2000条数据 入参大小写不敏感，均支持

响应参数

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.period
<data>	object array	true
id	long	true	k线id
vol	string	true	成交量(张)，数值为0
count	string	true	成交笔数，数值为0
open	string	true	开盘值
close	string	true	收盘值
low	string	true	最低值
high	string	true	最高值
amount	string	true	成交量(币), 数值为0
trade_turnover	string	true	成交额, 数值为0
</data>		false
status	string	true	请求处理结果	ok , "error"
ts	long	true	响应生成时间点，单位：毫秒

请求示例

curl "https://api.sunx.io/sapi/v1/index/market/history/linear_swap_mark_price_kline?contract_code=BTC-USDT&period=5min&size=100"

响应示例

{
  "ch": "market.BTC-USDT.mark_price.5min",
  "data": [
    {
      "amount": "0",
      "close": "31078.68",
      "count": "0",
      "high": "31078.68",
      "id": 1611105300,
      "low": "31078.68",
      "open": "31078.68",
      "trade_turnover": "0",
      "vol": "0"
    },
    {
      "amount": "0",
      "close": "31078.68",
      "count": "0",
      "high": "31078.68",
      "id": 1611105600,
      "low": "31078.68",
      "open": "31078.68",
      "trade_turnover": "0",
      "vol": "0"
    }
  ],
  "status": "ok",
  "ts": 1611106791703
}