帳戶活動

查詢目前認證帳戶的事件市場持倉、成交和相關帳戶活動。

Broker API 根據 X-User-Wallet-Address 指定的使用者，查詢其持倉與成交記錄。這些私有介面需要 Broker API Key。簽名規則見 Broker API Key 與簽名。

生產環境 Base URL：

https://api.dexbuilder.com

​

查詢持倉

cURL

curl -G "https://api.dexbuilder.com/api/v4/broker/prediction/positions" \
  -H "KEY: ${BROKER_API_KEY}" \
  -H "SIGN: ${SIGN}" \
  -H "Timestamp: ${TIMESTAMP}" \
  -H "X-User-Wallet-Address: ${USER_WALLET}" \
  --data-urlencode "event_id=<event_id>" \
  --data-urlencode "condition_id=<condition_id>" \
  --data-urlencode "settlement_status=OPEN" \
  --data-urlencode "limit=20"

常見回傳欄位包括：

欄位	說明
position_id	持倉 ID
event_id	事件 ID
token_id	結果代幣 ID
outcome	對應結果
size	總持倉數量
available_size	可用數量
locked_size	鎖定數量
avg_open_price	平均開倉價格
position_value	目前持倉價值
settlement_status	結算狀態
won	市場結算後是否獲勝
updated_at	最後更新時間

使用回傳的 next_cursor 作為下一頁請求的 cursor。

​

查詢單個持倉

cURL

curl "https://api.dexbuilder.com/api/v4/broker/prediction/positions/<position_id>" \
  -H "KEY: ${BROKER_API_KEY}" \
  -H "SIGN: ${SIGN}" \
  -H "Timestamp: ${TIMESTAMP}" \
  -H "X-User-Wallet-Address: ${USER_WALLET}"

​

查詢個人成交

cURL

curl -G "https://api.dexbuilder.com/api/v4/broker/prediction/usertrades" \
  -H "KEY: ${BROKER_API_KEY}" \
  -H "SIGN: ${SIGN}" \
  -H "Timestamp: ${TIMESTAMP}" \
  -H "X-User-Wallet-Address: ${USER_WALLET}" \
  --data-urlencode "condition_id=<condition_id>" \
  --data-urlencode "token_id=<token_id>" \
  --data-urlencode "limit=20"

個人成交記錄通常包含 trade_id、order_id、condition_id、token_id、price、size、side、role 和 fee_rate 等欄位。

​

查詢範圍

目前介面主要圍繞已認證帳戶提供資料，包括：

• 持倉；
• 個人成交；
• 訂單；
• 帳戶資產和資金流水；
• 結算與領取記錄。

帳戶類介面用於查詢目前認證使用者的資料，不建議將其理解為任意錢包位址的公開鏈上查詢介面。