> ## 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 頻道即時接收訂單、成交、持倉和結算狀態變化。

使用私有頻道 `pred.orders` 和 `pred.usertrades` 追蹤訂單生命週期與成交，使用 `pred.positions` 和 `pred.settlements` 追蹤帳戶狀態。

## 連線位址

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

## 訂閱

請使用 Broker API Key 簽名，並在 `auth.wallet_address` 傳入目標使用者的錢包地址。詳見 [Broker WebSocket 認證](https://dexbuilder.mintlify.site/zh-TW/event-markets/websocket/authentication.md)：

```json theme={null}
{"t":1720000000123,"id":"orders-1","op":"subscribe","ch":"pred.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 更新。

錢包地址須與產生簽名時使用的地址一致。


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