跳到主要内容

行情频道

描述

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

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

请求参数

参数名参数类型是否必须描述
opString操作,subscribe unsubscribe
argsArrayList<Object>
请求订阅的频道列表
> instTypeString产品线类型, SPOT
> channelString频道名, ticker
> instIdString产品id 例如:ETHUSDT
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "SPOT",
"channel": "ticker",
"instId": "ETHUSDT"
}
}

返回参数

返回字段参数类型字段说明
eventString事件
argObject订阅的频道
> instTypeString产品类型, SPOT
> channelString频道名, ticker
> instIdString产品id 例如:ETHUSDT
codeString错误码,错误时才会返回
msgString错误消息
推送返回示例
{
"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
}

推送数据参数

返回字段参数类型字段说明
argObject订阅成功的频道
> instTypeString产品类型, SPOT
> channelString频道名, ticker
> instIdString产品id 例如:ETHUSDT
actionString推送数据动作: snapshot
dataList<Object>订阅的数据
> instIdString产品id 例如:ETHUSDT
>lastPrString最新成交价
>askPrString卖一价
>bidPrString买一价
> open24hString24小时开盘价
> high24hString24小时最高价
> low24hString24小时最低价
> baseVolumeString24小时成交量,以左币为单位
> quoteVolumeString24小时成交量,以右币为单位
> tsString数据产生时间,Unix时间戳的毫秒数格式,如 1597026383085
openUtcString零时区 开盘价
changeUtc24hStringUTC0时涨跌幅, 0.01表示1%
>bidSzString买一量
>askSzString卖一量
>change24hString24小时涨跌幅, 0.01表示1%

您的阅读体验如何?