行情频道

描述

获取产品的最新成交价、买一价、卖一价和24小时交易量等信息，有变化（成交、买一卖一发）时：100ms 至 300ms

请求示例

{
    "op": "subscribe",
    "args": [
        {
            "instType": "USDT-FUTURES",
            "channel": "ticker",
            "instId": "BTCUSDT"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作, subscribe unsubscribe
args	List<Object>	是	请求订阅的频道列表
> instType	String	是	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
> channel	String	是	频道名
> instId	String	是	产品ID 如：ETHUSDT

订阅返回示例

{
    "event": "subscribe",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "ticker",
        "instId": "BTCUSDT"
    }
}

返回参数

返回字段	参数类型	字段说明
event	String	事件
arg	Object	订阅的频道
> instType	String	产品类型
> channel	String	频道名
> instId	String	产品ID 如：ETHUSDT
code	String	错误码
msg	String	错误消息

推送返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "ticker",
        "instId": "BTCUSDT"
    },
    "data": [
        {
            "instId": "BTCUSDT",
            "lastPr": "27000.5",
            "bidPr": "27000",
            "askPr": "27000.5",
            "bidSz": "2.71",
            "askSz": "8.76",
            "open24h": "27000.5",
            "high24h": "30668.5",
            "low24h": "26999.0",
            "change24h": "-0.00002",
            "fundingRate": "0.000010",
            "nextFundingTime": "1695722400000",
            "markPrice": "27000.0",
            "indexPrice": "25702.4",
            "holdingAmount": "929.502",
            "baseVolume": "368.900",
            "quoteVolume": "10152429.961",
            "openUtc": "27000.5",
            "symbolType": 1,
            "symbol": "BTCUSDT",
            "deliveryPrice": "0",
            "ts": "1695715383021"
        }
    ],
    "ts": 1695715383039
}

推送数据参数

返回字段	参数类型	字段说明
arg	Object	订阅成功的频道
> instType	String	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
> channel	String	频道名
> instId	String	产品ID
action	String	推送数据动作，增量推送数据还是全量推送数据
data	List	订阅的数据
>instId	String	产品ID
>lastPr	String	最新成交价
>askPr	String	卖一价
>bidPr	String	买一价
>high24h	String	24小时最高价
>low24h	String	24小时最低价
>change24h	String	24小时涨跌幅
>fundingRate	String	资金费率
>nextFundingTime	String	下次资金费率结算时间， Unix时间戳的毫秒数格式，如 1597026383085
>ts	String	系统时间， 当前数据时间戳 Unix时间戳的毫秒数格式，如 1597026383085
>markPrice	String	标记价格
>indexPrice	String	指数价格
>holdingAmount	String	持仓量
>baseVolume	String	交易币交易量
>quoteVolume	String	计价币交易额
>openUtc	String	UTC 00:00时刻价格
>symbolType	Integer	SymbolType：1->永续 2->交割
>symbol	String	交易对
>deliveryPrice	String	交割合约交割价，symbolType=1（永续）时为0 交割合约前一小时推送该字段
>bidSz	String	买一量
>askSz	String	卖一量
>open24h	String	开盘价 24小时。 开盘时间为24小时相对比，即：现在为2号19点，那么开盘时间对应为1号19点。