行情频道

描述

获取产品的最新成交价、买一价、卖一价和24小时交易量等信息。定时推送频率：100ms 至 300ms

请求示例

{
    "op": "subscribe",
    "args": [
        {
            "instType": "SPOT",
            "channel": "ticker",
            "instId": "ETHUSDT"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作，subscribe unsubscribe
args	Array	List<Object>	是 请求订阅的频道列表
> instType	String	是	产品线类型, SPOT
> channel	String	是	频道名, ticker
> instId	String	是	产品id 例如：ETHUSDT

订阅返回示例

{
    "event": "subscribe",
    "arg": {
        "instType": "SPOT",
        "channel": "ticker",
        "instId": "ETHUSDT"
    }
}

返回参数

返回字段	参数类型	字段说明
event	String	事件
arg	Object	订阅的频道
> instType	String	产品类型, SPOT
> channel	String	频道名, ticker
> instId	String	产品id 例如：ETHUSDT
code	String	错误码，错误时才会返回
msg	String	错误消息

推送返回示例

{
    "action": "snapshot",
    "arg": {
        "instType": "SPOT",
        "channel": "ticker",
        "instId": "ETHUSDT"
    },
    "data": [
        {
            "instId": "ETHUSDT",
            "lastPr": "2200.10",
            "open24h": "0.00",
            "high24h": "0.00",
            "low24h": "0.00",
            "change24h": "0.00",
            "bidPr": "1792",
            "askPr": "2200.1",
            "bidSz": "0.0084",
            "askSz": "19740.8811",
            "baseVolume": "0.0000",
            "quoteVolume": "0.0000",
            "openUtc": "0.00",
            "changeUtc24h": "0",
            "ts": "1695702438018"
        }
    ],
    "ts": 1695702438029
}

推送数据参数

返回字段	参数类型	字段说明
arg	Object	订阅成功的频道
> instType	String	产品类型, SPOT
> channel	String	频道名, ticker
> instId	String	产品id 例如：ETHUSDT
action	String	推送数据动作: snapshot
data	List<Object>	订阅的数据
> instId	String	产品id 例如：ETHUSDT
>lastPr	String	最新成交价
>askPr	String	卖一价
>bidPr	String	买一价
> open24h	String	24小时开盘价
> high24h	String	24小时最高价
> low24h	String	24小时最低价
> baseVolume	String	24小时成交量，以左币为单位
> quoteVolume	String	24小时成交量，以右币为单位
> ts	String	数据产生时间，Unix时间戳的毫秒数格式，如 1597026383085
openUtc	String	零时区 开盘价
changeUtc24h	String	UTC0时涨跌幅, 0.01表示1%
>bidSz	String	买一量
>askSz	String	卖一量
>change24h	String	24小时涨跌幅, 0.01表示1%