更新日誌

2026-09-07

• 重要提示：即使不啟用雙向持倉，以下不相容改動也可能需要調整
  • 取得合約市場設定和修改合約市場設定不再回傳或接受settle_switch
  • 取得部位自動結算歷史記錄已下線
  • 取得倉位資金費用歷史記錄回應中不再包含margin_mode
  • 取得合約帳戶餘額和合約帳戶餘額訂閱中available、margin、transferrable 的意義和計算口徑已調整
  • 在傳回倉位資訊的相關介面中，margin_avbl、liq_price、bkr_price、cml_position_value 和max_position_value 的意義或計算口徑已調整
• 启用双向持仓：通过修改合约市场设置将 position_mode 设置为 hedge，可通过获取合约市场设置查询当前模式
  • 下单接口：下委托单、下批量委托单、下计划委托单和下批量计划委托单新增 position_side
  • 仓位操作接口：调整仓位杠杆、调整仓位保证金、平仓、设置仓位止盈、设置仓位止损、修改仓位止盈、修改仓位止损、撤销仓位止盈和撤销仓位止损新增 position_side
  • 合約撤單、改單、訂單查詢、成交查詢及用戶成交、委託、計畫委託WS 訂閱均新增或回傳position_side
• 與雙向持倉無關的介面更新
  • 下單介面新增is_reduce_only，用於建立只減倉委託
  • 傳回倉位資訊的相關介面及用戶倉位訂閱新增risk_rate

2026-06-18

• 更新介面權限要求：
  • 子帳號間資產劃轉 需要交易權限

2026-06-17

• 更新介面權限要求：
  • 子帳號間資產劃轉 需提現權限
  • 取消申請提領 需提領權限
  • 资产划转、修改账户设置、创建子账号、冻结子账号、解冻子账号、创建子账号 APIKEY、编辑子账号 APIKEY、删除子账号 APIKEY、更新充值地址、添加 AMM 账户流动性、减少 AMM 账户流动性 需要交易权限
• API Key 的secret_key 僅在建立時傳回；取得子帳號APIKEY 詳情 和編輯子帳號APIKEY 的回應中不再回傳

2026-04-15

• 新增合約溢價指數訂閱

2025-12-18

• 合約止盈停損功能升級，支援同一倉位設定多個停盈停損單（最多20個）
• 新增合約修改停損單
• 新增合約修改止盈單
• 新增合約撤銷停損單
• 新增合約撤銷止盈單
• 更新合約設定部位停損，新增stop_loss_amount 參數
• 更新合約設定部位止盈，新增take_profit_amount 參數
• 更新返回倉位資料的相關接口，回應中新增stop_loss_list 和take_profit_list 字段
• 更新合約使用者倉位訂閱，推送資料中新增stop_loss_list 和take_profit_list 字段

2025-11-13

• 新增推薦返傭取得直客邀請清單
• 新增推薦返傭取得直客返傭記錄
• 新增推薦返傭取得直客返傭明細
• 新增推薦返傭取得代理商邀請清單
• 新增推薦返傭取得代理返傭記錄
• 新增推薦返傭取得代理返傭明細

2025-10-30

• 新增取得子帳號餘額

2025-08-14

• 新增現貨大量修改委託單
• 新增合約批量修改委託單

2025-04-16

• 新增取得AMM 流動性池
• 新增取得AMM 收益記錄

2025-01-09

• 將批次下單和批次撤單分組中的部分介面分別調整至對應的下單和撤單分組
• 對應的批次請求不再按其請求次數進行限頻，而是按請求中包含的子請求數進行限頻
• 具體的改動請參考限頻規則

2024-09-25

• 下線v1 版本的API 服務

2024-09-12

• 修正合約市場狀態訂閱介面回應中latest_funding_time和next_funding_time欄位的精確度問題，修正後統一為毫秒時間戳

2024-09-05

• 新增取得現貨帳戶交易流水

2024-8-22

• 最佳化改單邏輯，新的改單邏輯不會再撤銷原有訂單，而是直接修改原有訂單(修改計畫單邏輯暫未修改)
  • 現貨用戶委託單訂閱 新增modify 推播事件
  • 合約使用者委託單訂閱 新增modify 推播事件
• 修正現貨下批次委託單介面回應結構與文件不符的問題，正確結構請參考文件範例

2024-07-18

• 新增stp_mode，在下委託單的相關的介面中可以使用這個參數來阻止自成交，例如下列介面
  • 下委託單
  • 下批次委託單

2024-07-08

• 新增取得幣種資料

2024-06-27

• 新增取得市場溢價指數歷史記錄

2024-04-18

• 變更認證 中步驟二：產生認證參數 部份，主要包括以下內容：
  • request_path 的組成去除secret_key 部份
  • SHA256簽章方法更換為HMAC-SHA256簽名，其中以secret_key 作為key
  • 新特性暫時相容於舊的簽章方法，請盡快遷移使用新的簽章方法，舊的簽章方法將擇期棄用

2024-01-25

• 新版API 文件發布，主要包括以下內容：
  • 大部分HTTP、WS 介面請求路徑、請求參數和請求回應的調整
  • 簽章演算法統一，現在現貨、合約兩個模組的簽章演算法一致了
  • API 限頻策略的調整，詳細見限頻規則
  • 其他的改動詳細請見API簡介