公共频道

交易频道

描述

获取最近的成交数据(taker订单)，有成交数据就推送，实时推送

推送逻辑调整

模拟盘自 2026 年 11 月 4 日起生效，实盘预计 2026 年 11 月 17 日生效：订阅成功后，本频道不再推送快照数据（action=snapshot），仅推送实时增量数据（action=update）。调整生效前，订阅后首次推送为最近数据的快照。如需获取历史数据，请使用对应的 REST 接口。


Code
{
    "op": "subscribe",
    "args": [
        {
            "instType": "SPOT",
            "channel": "trade",
            "instId": "BTCUSDT"
        }
    ]
}

请求参数

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


Code
{
    "event": "subscribe",
    "arg": {
        "instType": "SPOT",
        "channel": "trade",
        "instId": "BTCUSDT"
    }
}

返回参数

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


Code
{
    "action": "update",
    "arg": {
        "instType": "SPOT",
        "channel": "trade",
        "instId": "BTCUSDT"
    },
    "data": [
        {
            "ts": "1695709835822",
            "price": "26293.4",
            "size": "0.0013",
            "side": "buy",
            "tradeId": "1000000000"
        }
    ],
    "ts": 1695711090682
}

推送数据参数

返回字段	参数类型	字段说明
arg	Object	订阅成功的频道
> instType	String	产品类型, `SPOT`
> channel	String	频道名,`trade`
> instId	String	产品id 例如：ETHUSDT
action	String	推送数据动作, `snapshot` or `update` 推送逻辑调整生效后，仅推送 `update`
data	List<Object>	订阅的数据
> tradeId	String	成交ID
> ts	String	成交时间，Unix时间戳的毫秒数格式，如 1597026383085
> price	String	成交价格
> size	String	成交数量
> side	String	成交方向

集合竞价信息频道账户频道

参数名

参数类型

是否必须

描述

String

是

操作，subscribe unsubscribe

args

List<Object>

是

请求订阅的频道列表

> instType

String

是

产品线类型, SPOT

> channel

String

是

频道名,trade

> instId

String

是

产品id 例如：ETHUSDT

返回字段

参数类型

字段说明

event

String

事件，subscribe unsubscribe error

arg

Object

订阅的频道

> instType

String

产品类型, SPOT

> channel

String

频道名, trade

> instId

String

是
产品id 例如：ETHUSDT

code

String

错误码，错误时才会返回

msg

String

错误消息

{
    "action": "update",
    "arg": {
        "instType": "SPOT",
        "channel": "trade",
        "instId": "BTCUSDT"
    },
    "data": [
        {
            "ts": "1695709835822",
            "price": "26293.4",
            "size": "0.0013",
            "side": "buy",
            "tradeId": "1000000000"
        }
    ],
    "ts": 1695711090682
}

返回字段

参数类型

字段说明

arg

Object

订阅成功的频道

> instType

String

产品类型, SPOT

> channel

String

频道名,trade

> instId

String

产品id 例如：ETHUSDT

action

String

推送数据动作, snapshot or update
推送逻辑调整生效后，仅推送 update

data

List<Object>

订阅的数据

> tradeId

String

成交ID

> ts

String

成交时间，Unix时间戳的毫秒数格式，如 1597026383085

> price

String

成交价格

> size

String

成交数量

> side

String

成交方向