API 概覽

事件合約 API 的基礎位址、存取模型、分頁、時間與錯誤約定。

​

Base URL

https://api.dexbuilder.com

公開行情 REST 介面使用 /api/v4/event_contracts，無需認證。私有交易、持倉與帳戶介面使用 /api/v4/broker/event_contracts。請以 Broker API Key 簽名，並在 X-User-Wallet-Address 傳入目標使用者錢包地址。詳見 Broker API Key 與簽名 和 代表使用者存取。私有 WebSocket 頻道使用獨立的 Broker WebSocket 認證 流程。

​

介面存取模型

介面類型	是否需要認證	典型能力
市場發現	否	事件、市場、標籤
市場資料	否	價格、Ticker、訂單簿、歷史資料、K 線
交易	是	下單、查詢訂單、撤單
帳戶	是	持倉、資產、餘額、費率、個人成交
結算	是	平倉、領取、資金處理

​

分頁

清單介面使用游標分頁，回傳 items 與 next_cursor。下一頁請求直接使用上一頁回傳的 next_cursor，不要自行解析或修改游標。

​

時間與數值約定

• 事件與市場日期欄位通常使用 Unix 秒；
• from、to 等範圍參數通常使用 Unix 毫秒；
• 加密貨幣 K 線的 start_ts、end_ts 和 history[].t 使用 Unix 秒；
• 價格、數量、成交額、餘額、手續費等金額類欄位通常以字串回傳，建議使用 Decimal 精度處理。

​

標準錯誤

錯誤回應包含 label 和 message。公開行情介面的參數錯誤使用 INVALID_PARAM_VALUE，行情來源不可用使用 QUOTE_UNAVAILABLE；Broker 私有業務介面的參數錯誤可能使用 INVALID_ARGUMENT。請以各介面的錯誤定義為準。

常見 HTTP 狀態包括 400、401、404 和 503。