公有频道

端点

下载Schema

行情频道

推送交易对 24 小时行情统计数据，包括最新成交价、涨跌幅、加权均价以及买一卖一信息。行情发生变化时（通常 100~300 ms 内）会实时推送。

WSS

{symbol}@ticker

wss://ws-spot.weex.com/v3/ws/public

行情频道 › 流参数

symbol

string · required

交易对。用于订阅消息 params 中的主题，不附加到 WebSocket 连接地址。

Example: BTCUSDT

行情频道 › 请求参数

method

string · required

SUBSCRIBE 表示订阅，UNSUBSCRIBE 表示取消订阅。

Example: SUBSCRIBE

params

string[] · required

流名称格式为 @ticker，例如 BTCUSDT@ticker。

Example: ["BTCUSDT@ticker"]

id

number

客户端自定义标识，在回执中原样返回。

Example: 1

行情频道 › 响应

行情频道

e

string

事件类型，固定为 24hrTicker。

E

number

事件时间（毫秒）。

s

string

交易对（大写），例如 BTCUSDT。

object

24 小时统计信息。

最优报价频道

推送交易对的买一/卖一及对应挂单量，一旦盘口顶部发生变化即实时推送。

WSS

{symbol}@bookTicker

wss://ws-spot.weex.com/v3/ws/public

最优报价频道 › 流参数

symbol

string · required

交易对。用于订阅消息 params 中的主题，不附加到 WebSocket 连接地址。

Example: BTCUSDT

最优报价频道 › 请求参数

method

string · required

SUBSCRIBE 订阅，UNSUBSCRIBE 取消订阅。

Example: SUBSCRIBE

params

string[] · required

流名称格式 @bookTicker，例如 BTCUSDT@bookTicker。

Example: ["BTCUSDT@bookTicker"]

id

number

客户端自定义标识，在回执中原样返回。

Example: 1

最优报价频道 › 响应

最优报价频道

e

string

事件类型，bookTicker。

E

number

事件时间（毫秒）。

s

string

交易对（大写）。

object

最优盘口信息。

深度频道

推送指定交易对在指定档位的订单簿变更（depth）。订阅成功后会先下发一次快照（SNAPSHOT），随后推送增量更新（CHANGED）。

WSS

{symbol}@depth{level}

wss://ws-spot.weex.com/v3/ws/public

深度频道 › 流参数

symbol

string · required

交易对。用于订阅消息 params 中的主题，不附加到 WebSocket 连接地址。

Example: BTCUSDT

level

integer · enum · required

推送的深度档位。

Enum values:

200

Example: 15

深度频道 › 请求参数

method

string · required

SUBSCRIBE 订阅，UNSUBSCRIBE 取消订阅。

Example: SUBSCRIBE

params

string[] · required

@depth{level}，支持档位：15、200，例如 BTCUSDT@depth15。

Example: ["BTCUSDT@depth15"]

id

number

客户端自定义标识，在回执中原样返回。

Example: 2

深度频道 › 响应

深度频道

e

string

事件类型，depth。

E

number

事件时间（毫秒）。

s

string

交易对（大写）。

U

number

本消息中的首个更新 ID。

u

number

本消息中的最后一个更新 ID。

l

number

深度档位（15 或 200）。

d

string

深度类型，SNAPSHOT 或 CHANGED。

array[]

买盘更新，格式 [价格, 数量]。

array[]

卖盘更新，格式 [价格, 数量]。

f

string

合并深度因子（仅在开启合并时返回）。

K 线频道

推送指定交易对在特定周期和价格类型下的 K 线数据。每次推送包含最新一根（正在生成）的 K 线。

WSS

{symbol}@kline_{interval}_{priceType}

wss://ws-spot.weex.com/v3/ws/public

K 线频道 › 流参数

symbol

string · required

交易对。用于订阅消息 params 中的主题，不附加到 WebSocket 连接地址。

Example: ETHUSDT

interval

string · enum · required

K 线周期，区分大小写。

Enum values:

15m

30m

Example: 1m

priceType

string · enum · required

K 线价格类型。

Enum values:

LAST_PRICE

MARK_PRICE

Example: LAST_PRICE

K 线频道 › 请求参数

method

string · required

SUBSCRIBE 订阅，UNSUBSCRIBE 退订。

Example: SUBSCRIBE

params

string[] · required

@kline__，如 ETHUSDT@kline_1m_LAST_PRICE。

Example: ["ETHUSDT@kline_1m_LAST_PRICE"]

id

number

客户端自定义标识，在回执中原样返回。

Example: 4

K 线频道 › 响应

K 线频道

e

string

事件类型，kline。

E

number

事件时间（毫秒）。

s

string

交易对。

p

string

价格类型（LAST_PRICE、MARK_PRICE）。

object[]

K 线明细列表。

成交频道

推送订阅交易对的最新成交（trade）。每条推送可能包含一条或多条新成交。

WSS

{symbol}@trade

wss://ws-spot.weex.com/v3/ws/public

成交频道 › 流参数

symbol

string · required

交易对。用于订阅消息 params 中的主题，不附加到 WebSocket 连接地址。

Example: BTCUSDT

成交频道 › 请求参数

method

string · required

SUBSCRIBE 订阅，UNSUBSCRIBE 退订。

Example: SUBSCRIBE

params

string[] · required

@trade，例如 BTCUSDT@trade。

Example: ["BTCUSDT@trade"]

id

number

客户端自定义标识，在回执中原样返回。

Example: 3

成交频道 › 响应

成交频道

e

string

事件类型，trade。

E

number

事件时间（毫秒）。

s

string

交易对。

object[]

成交列表。

私有频道