帳戶活動

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

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/event_contracts/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、event_id、token_id、outcome、size、available_size、locked_size、avg_open_price、position_value、settlement_status、won 和 updated_at。

​

查詢已結算持倉

cURL

curl -G "https://api.dexbuilder.com/api/v4/broker/event_contracts/positions/settled" \
  -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/event_contracts/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 等欄位。

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