> ## Documentation Index
> Fetch the complete documentation index at: https://dexbuilder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 实时订单更新

> 通过私有 WebSocket 频道实时接收订单、成交、持仓和结算状态变化。

> [!NOTE]
>
> 使用 `broker_api_key` 和已绑定的钱包地址；WebSocket 签名包含 URL 编码后的钱包地址。详见[WebSocket 认证](https://dexbuilder.mintlify.site/zh/event-contracts/websocket/authentication.md)。

使用私有 `ec.orders` 和 `ec.usertrades` 跟踪订单生命周期和成交，使用 `ec.positions` 和 `ec.settlements` 跟踪账户状态。

## 连接地址

```text theme={null}
wss://broker.dexbuilder.com/ws/dex-builder/event-contracts
```

## 订阅

使用 API Key 签名认证：

```json theme={null}
{
  "t": 1720000000123,
  "id": "orders-1",
  "op": "subscribe",
  "ch": "ec.orders",
  "payload": {
    "all": true
  },
  "auth": {
    "method": "broker_api_key",
    "key": "YOUR_BROKER_API_KEY",
    "sign": "HEX_SIGNATURE",
    "wallet_address": "<USER_WALLET>"
  }
}
```

## 推送内容

订单包含标识、方向、价格、数量、状态和时间戳；用户成交包含成交、订单、角色、费率、成交价格、数量和确认状态；仓位包含数量、平均价格、结算状态、可用数量、锁定数量和可领取金额。文档不描述标记价格字段。

## 状态恢复

WebSocket 是事件推送，不能替代 REST 查询。连接或重连后：

1. 订阅需要的私有频道。
2. 通过对应 REST 接口查询订单、成交、仓位和账户当前状态。
3. 使用标识和时间戳应用后续 WebSocket 更新。

客户端请求中不要暴露内部用户 Header 或 broker 账户标识。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.