公共频道

平台成交详情频道

描述

平台成交频道(taker订单)

实时推送

推送逻辑调整

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


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

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作, subscribe unsubscribe
args	List<Object>	是	请求订阅的频道列表
> instType	String	是	产品类型 `USDT-FUTURES` U本位合约 `COIN-FUTURES` 币本位合约 `USDC-FUTURES` USDC合约
> channel	String	是	频道名
> instId	String	是	产品ID 如：ETHUSDT


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

返回参数

返回字段	参数类型	字段说明
event	String	事件
arg	Object	订阅的频道
> instType	String	产品类型 `USDT-FUTURES` U本位合约 `COIN-FUTURES` 币本位合约 `USDC-FUTURES` USDC合约
> channel	String	频道名
> instId	String	产品ID 如：ETHUSDT
code	String	错误码
msg	String	错误消息


Code
{
    "action": "update",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "trade",
        "instId": "BTCUSDT"
    },
    "data": [
        {
            "ts": "1695716760565",
            "price": "27000.5",
            "size": "0.001",
            "side": "buy",
            "tradeId": "1111111111"
        },
        {
            "ts": "1695716759514",
            "price": "27000.0",
            "size": "0.001",
            "side": "sell",
            "tradeId": "1111111111"
        }
    ],
    "ts": 1695716761589
}

推送数据参数

返回字段	参数类型	字段说明
action	String	推送动作推送逻辑调整生效后，仅推送 `update`
arg	Object	订阅成功的频道
> instType	String	产品类型 `USDT-FUTURES` U本位合约 `COIN-FUTURES` 币本位合约 `USDC-FUTURES` USDC合约
> channel	String	频道名
> instId	String	产品ID, 如：ETHUSDT
data	List<Object>	订阅的数据
> ts	String	成交时间，Unix时间戳的毫秒数格式，如 1597026383085
> price	String	成交价格
> size	String	成交数量
> side	String	成交方向, sell/buy
> tradeId	String	成交id
ts	String	数据推送时间

深度频道账户频道

参数名

参数类型

是否必须

描述

String

是

操作, subscribe unsubscribe

args

List<Object>

是

请求订阅的频道列表

> instType

String

是

产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

> channel

String

是

频道名

> instId

String

是

产品ID
如：ETHUSDT

返回字段

参数类型

字段说明

event

String

事件

arg

Object

订阅的频道

> instType

String

产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

> channel

String

频道名

> instId

String

产品ID
如：ETHUSDT

code

String

错误码

msg

String

错误消息

{
    "action": "update",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "trade",
        "instId": "BTCUSDT"
    },
    "data": [
        {
            "ts": "1695716760565",
            "price": "27000.5",
            "size": "0.001",
            "side": "buy",
            "tradeId": "1111111111"
        },
        {
            "ts": "1695716759514",
            "price": "27000.0",
            "size": "0.001",
            "side": "sell",
            "tradeId": "1111111111"
        }
    ],
    "ts": 1695716761589
}

返回字段

参数类型

字段说明

action

String

推送动作
推送逻辑调整生效后，仅推送 update

arg

Object

订阅成功的频道

> instType

String

产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

> channel

String

频道名

> instId

String

产品ID, 如：ETHUSDT

data

List<Object>

订阅的数据

> ts

String

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

> price

String

成交价格

> size

String

成交数量

> side

String

成交方向, sell/buy

> tradeId

String

成交id

String

数据推送时间