跳至主要内容

V5

2024-04-15​

REST API​

2024-04-11​

REST API​

2024-04-03​

REST API​

2024-04-01​

REST API​

Websocket API​

2024-03-28​

Websocket API​

2024-03-22​

  • 接入指南 [更新]

    • 為了合規, 對於荷蘭用戶以及香港用戶分別新增了對應的域名

  • 劃轉 (單帳號內) [更新]

    • 接口頻率從20次/分提升至60次/分

2024-03-21​

  • Order Book (深度) [更新]
    • 期貨支持到500檔位, limit可以支持到500
    • 期貨, 響應字段 u與推送ob的500檔對齊

2024-03-13​

REST API​

  • 設置充值帳戶 [更新]

    • 經典帳戶: OPTION(USDC合約錢包) 不再支持被設置為入金錢包

  • 查詢公告 [更新]

    • 新增響應字段 publishTime

2024-03-12​

REST API​

  • 設置風險限額 [廢棄]
    • 由於自動設置risk limit功能已上線, 該接口被廢棄

2024-03-11​

REST API​

  • 查詢歷史訂單 [更新]
    • UTA(現貨, 正向合約以及期權)在查詢完全取消單時, 僅支持查詢過去24小時的紀錄

2024-03-06​

REST API​

2024-03-05​

REST API​

  • 查詢持倉 (實時) [更新]
    • USDC合約: 新增響應字段 sessionAvgPrice for USDC contracts
    • 永續、交割以及期權: 新增響應字段 curRealisedPnl
    • 期權: cumRealisedPnl該字段廢棄, 總是""
    • 期權: 新增響應字段 delta, vega, theta, gamma

Websocket API​

  • 持倉 [UPDATE]
    • USDC合約: 新增響應字段 sessionAvgPrice for USDC contracts
    • 永續、交割以及期權: 新增響應字段 curRealisedPnl
    • 期權: cumRealisedPnl該字段廢棄, 總是""
    • 期權: 新增響應字段 delta, vega, theta, gamma

2024-03-04​

REST API​

Websocket API​

2024-03-01​

REST API​

2024-02-29​

REST API​

  • 查詢利息記錄 [更新]

    • 單次查詢時, startTime & endTime被限制為30天時間長度
    • 支持最多2年的數據查詢

  • 查詢交割紀錄 [更新]

    • 新增查詢參數 startTime & endTime, 並且單次查詢時，以30天為時間長度
    • 支持最多2年的數據查詢

  • 查詢USDC結算紀錄 [更新]

    • 新增查詢參數 startTime & endTime, 並且單次查詢時，以30天為時間長度
    • 支持最多2年的數據查詢

  • Order Book (深度) [更新]

    • 期貨和現貨新增響應字段seq

2024-02-28​

REST API​

2024-02-21​

REST API​

2024-02-06​

REST API​

2024-02-05​

REST API​

  • 查詢歷史訂單 [更新]
    • 統一帳戶(linear, spot, option)不再支持查詢活動態訂單
    • 新增錯誤碼, "181017, OrderStatus must be final status"

2024-01-18​

REST API​

2024-01-16​

REST API​

2024-01-15​

REST API​

  • 創建委託單 [更新]

    • 統一帳戶現貨交易能夠使用takeProfit, stopLoss, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType 給限價單設置止盈止損

  • 修改委託單 [更新]

    • 統一帳戶現貨交易支持修改takeProfit, stopLoss, tpLimitPrice, slLimitPrice如果原始訂單上有相關屬性

  • 撤銷所有訂單 [更新]

    • orderFilter字段新增枚舉值"OcoOrder", "BidirectionalTpslOrder". 對於"BidirectionalTpslOrder", 您只能撤銷全部Untriggered狀態的雙向止盈止損訂單

  • 查詢實時委託單 [更新]

    • orderFilter字段新增枚舉值"BidirectionalTpslOrder"
    • stopOrderType字段新增枚舉值"BidirectionalTpslOrder"

  • 查詢歷史訂單 [更新]

    • orderFilter字段新增枚舉值"BidirectionalTpslOrder"
    • stopOrderType字段新增枚舉值"BidirectionalTpslOrder"

Websocket API​

  • 訂單 [更新]
    • stopOrderType字段新增枚舉值"BidirectionalTpslOrder"

2024-01-11​

REST API​

  • 交易日誌 [更新]
    • 新增交易類型FLEXIBLE_STAKING_SUBSCRIPTION, FLEXIBLE_STAKING_REDEMPTION, FIXED_STAKING_SUBSCRIPTION

2024-01-09​

REST API​

2024-01-08​

REST API​

  • 查詢成交紀錄 [更新]
    • 新增響應字段feeCurrency, 用於統一帳戶現貨交易的手續費幣種

2024-01-02​

REST API​

新錯誤碼消息
131231Transfers into this account are not supported 限制劃入這個帳戶
131232Transfers out this account are not supported 限制劃出這個帳戶

2023-12-28​

REST API​

2023-12-22​

REST API​

  • 創建委託單 [更新]

    • 新增請求參數marketUnit, 值可以是baseCoin, quoteCoin. 它用於在創建現貨市價單時, 選擇qty的單位(僅限統一帳戶)

  • 查詢實時委託單 [更新]

    • 新增響應參數 marketUnit

  • 查詢歷史訂單 [更新]

    • 新增響應參數 marketUnit

Websocket API​

  • 訂單 [更新]
    • 新增響應參數 marketUnit

2023-12-20​

REST API​

2023-12-14​

Websocket API​

  • 深度 [更新]
    • 新增字段cts

2023-12-12​

REST API​

Websocket API​

  • 訂單 [更新]

    • 新增響應字段 createType

  • 個人成交 [更新]

    • 新增響應字段 createType

2023-12-07​

REST API​

  • 一鍵還款 [新增]
    • 新增接口用於一鍵償還統一帳戶下的欠款

2023-12-04​

REST API​

2023-11-16​

REST API​

Websocket API​

  • 錢包 [更新]
    • 新增響應字段 spotHedgingQty

2023-11-14​

REST API​

  • 提現 [更新]
    • 接口頻率從10次/分鐘變更為1次/秒

2023-11-09​

REST API​

2023-11-08​

REST API​

  • 綁定/解綁UID [新增]
    • 新增接口, 用於自行綁定或解綁場外借貸產品的UID

2023-11-02​

REST API​

2023-11-01​

REST API​

2023-10-26​

REST API​

  • 查詢成交紀錄 [更新]

    • 統一帳戶 現貨: stopOrderType, "" 表示普通訂單, tpslOrder 表示止盈止損單, Stop 表示條件單, OcoOrder 表示OCO訂單

  • 查詢實時委託單 [更新]

    • 統一帳戶 現貨: 新增響應字段 ocoTriggerBy, 並且它的值可以是 OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl
  • 查詢歷史訂單 [更新]
    • 統一帳戶 現貨: 新增響應字段 ocoTriggerBy, 並且它的值可以是 OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl

Websocket API​

  • 訂單 [更新]
    • 統一帳戶 現貨: 新增響應字段 ocoTriggerBy, 並且它的值可以是 OcoTriggerByUnknown, OcoTriggerByTp, OcoTriggerBySl

2023-10-25​

REST API​

  • 查詢持倉 (實時) [更新]

    • 新增響應字段 isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

  • 確認新的風險限額 [新增]

    • 新增接口, 用於在主動調整完風險水位後, 觸發接口來讓系統移除只減倉限制

Websocket API​

  • 持倉 [更新]
    • 新增響應字段 isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

2023-10-17​

REST API​

2023-10-09​

Websocket API​

  • 深度 [現貨]
    • 新增200檔位的深度數據, 推送頻率為200ms

2023-09-28​

REST API​

2023-09-25​

REST API​

  • 查詢實時委託單 [更新]

    • stopOrderType新增枚舉值 OcoOrder, 用於表示現貨OCO訂單 (僅統一帳戶)

  • 查詢歷史訂單 [更新]

    • stopOrderType新增枚舉值 OcoOrder, 用於表示現貨OCO訂單 (僅統一帳戶)

  • 查詢成交紀錄 [更新]

    • execType新增枚舉值 MovePosition, 用於表示移動倉位時的成交 (僅統一帳戶)

  • 交易日誌 [更新]

    • type新增枚舉值TRANSFER_IN_INS_LOAN, TRANSFER_OUT_INS_LOAN (僅統一帳戶)

  • 交易日誌 [更新]

    • type新增枚舉值SPOT_REPAYMENT_SELL, SPOT_REPAYMENT_BUY (僅統一帳戶)

Websocket API​

  • 訂單 [更新]
    • stopOrderType新增枚舉值 OcoOrder, 用於表示現貨OCO訂單 (僅統一帳戶)

2023-09-21​

REST API​

  • 查詢成交紀錄 [更新]
    • 新增響應字段 seq
  • 查詢持倉 (實時) [更新]
    • 新增響應字段 seq
  • 查詢抵押品信息 [更新]
    • 新增freeBorrowAmount字段, 表示借款總額中免息部分的借款金額
    • 新增freeBorrowingLimit字段, 表示免息借款額上限。若未結虧損部分超過該上限，則將全額計息。
    • 廢棄freeBorrowingAmount字段：字段值已遷移到freeBorrowingLimit

WebSocket API​

  • 持倉 [更新]
    • 新增響應字段 seq
    • 能夠訂閱指定業務線
  • 個人成交 [更新]
    • 新增響應字段 seq
    • 能夠訂閱指定業務線
  • 訂單 [更新]
    • 能夠訂閱指定業務線

2023-09-18​

REST API​

  • 新建子帳戶的API Key [更新]
    • 請求參數ips字段實際上是字符串類型, 但原有的數組類型依然可以使用.
    • 請求參數Derivatives字段已經廢棄, 系統會自動識別帳戶類型來決定是否添加統一帳戶權限
  • 修改母帳戶的API Key設置 [更新]
    • 請求參數ips字段實際上是字符串類型, 但原有的數組類型依然可以使用.
    • 請求參數Derivatives字段已經廢棄, 系統會自動識別帳戶類型來決定是否添加統一帳戶權限
  • 修改子帳戶的API Key設置 [更新]
    • 新增請求字段apikey, 用於母帳戶管理子帳戶的key
    • 請求參數ips字段實際上是字符串類型, 但原有的數組類型依然可以使用.
    • 請求參數Derivatives字段已經廢棄, 系統會自動識別帳戶類型來決定是否添加統一帳戶權限
  • 刪除子帳戶的API Key [更新]
    • 新增請求字段apikey, 用於母帳戶刪除子帳戶的key

2023-09-14​

REST API​

  • 查詢產品信息 [更新]
    • 新增響應字段 spotMarginTrading
    • 可以使用api key和secret來查詢該接口, 如果符合資格, 則會查詢到私有數據
  • 查詢保證金幣種信息 [更新]
    • 可以使用api key和secret來查詢該接口, 如果符合資格, 則會查詢到私有數據
  • 查詢借貸訂單信息 [更新]
    • 新增響應字段 spotMarginTrading
    • parentUid的業務含義發生變化. 現在表示綁定了場外借貸產品的uid
  • 查詢風險率 [更新]
    • parentUid的業務含義發生變化. 現在表示綁定了場外借貸產品的uid

2023-09-07​

REST API​

  • 查詢實時委託單 [更新]
    • 支持僅category=inverse查詢, /v5/order/realtime?category=inverse, 獲取反向合約所有活動單
  • 查詢持倉 (實時) [更新]
    • 支持僅category=inverse查詢, /v5/position/list?category=inverse, 獲取反向合約所有持有倉位
    • symbol參數支持傳入多個反向合約幣對

2023-09-04​

REST API​

2023-08-31​

REST API​

  • 撤銷所有訂單 [更新]
    • 新增可選請求參數 stopOrderType
    • 字段orderFilter的枚舉值 Order 和 StopOrder 支持linear和inverse的產品類型
  • 查詢充值紀錄 (鏈上) [更新]
    • 新增響應字段depositType, 表示該筆充值的類型, 如觸發了每日充值限額或者充值異常, 可以在網站上處理那些無法充值成功的資產
  • 查詢子帳號的充值紀錄 (鏈上) [更新]
    • 新增響應字段depositType, 表示該筆充值的類型, 如觸發了每日充值限額或者充值異常, 可以在網站上處理那些無法充值成功的資產

2023-08-30​

REST API​

2023-08-25​

REST API​

2023-08-24​

REST API​

舊錯誤碼新錯誤碼消息
110075182021Cannot enable spot margin while in isolated margin mode. Please switch to cross margin mode or portfolio margin mode to trade spot with margin.

2023-08-22​

REST API​

  • 交易日誌 [更新]
    • 新增響應字段id, 表示每條交易日誌的唯一id
  • 查詢開關狀態和倍數 [新增]
    • 新增接口查詢統一帳戶下槓桿交易的開關狀態和當前槓桿倍數

2023-08-17​

REST API​

2023-08-15​

REST API​

2023-08-11​

REST API​

  • 查詢錢包餘額 [更新]
    • availableToBorrow 總是返回"" 因為母子共享借貸上限
  • 查詢抵押品信息 [更新]
    • 新增響應字段 borrowUsageRate
    • availableToBorrow展示的是母子共享借貸下的剩餘可借餘額

Websocket API​

  • 錢包 [更新]
    • availableToBorrow 總是返回"" 因為母子共享借貸上限

2023-08-10​

REST API​

  • 設置抵押品幣種 [新增]
    • 新增接口用於統一帳戶內選擇開啟或者關閉抵押幣種
  • 查詢賬戶配置 [更新]
    • 新增響應字段 isMasterTrader來說明該帳戶是否為帶單帳戶

2023-08-08​

REST API​

2023-08-07​

REST API​

  • 創建委託單 [更新]
    • 現貨支持條件單, orderFilter新增枚舉值 StopOrder, 用於下單
  • 撤銷委託單 [更新]
    • 現貨支持條件單, orderFilter新增枚舉值 StopOrder, 用於撤單
  • 撤銷所有訂單 [更新]
    • 現貨支持條件單, orderFilter新增枚舉值 StopOrder
  • 查詢實時委託單 [更新]
    • 現貨支持條件單, orderFilter新增枚舉值 StopOrder, stopOrderType字段復用Stop, 同時表示現貨條件單類型
  • 查詢歷史訂單 [更新]
    • 現貨支持條件單, orderFilter新增枚舉值 StopOrder, stopOrderType字段復用Stop, 同時表示現貨條件單類型

Websocket API​

  • 訂單 [更新]
    • stopOrderType字段復用Stop, 同時表示現貨條件單類型
    • 新增響應字段feeCurrency, 用於表示現貨交易的手續費幣種
    • 經典帳戶下的現貨交易, updatedTime不再是空字符串

2023-07-31​

REST API​

WebSocket API​

2023-07-24​

REST API​

  • 查詢產品信息
    • 新增響應字段USDTPerpetualOpenLine, USDCContractOpenLine, USDCOptionsOpenLine, USDTPerpetualCloseLine, USDCContractCloseLine, USDCOptionsCloseLine, USDCContractSymbols, USDCOptionsSymbols, marginLeverage, USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • 查詢借貸訂單信息
    • 新增響應字段USDTPerpetualOpenLine, USDCContractOpenLine, USDCOptionsOpenLine, USDTPerpetualCloseLine, USDCContractCloseLine, USDCOptionsCloseLine, USDCContractSymbols, USDCOptionsSymbols, marginLeverage, USDTPerpetualLeverage, symbol, leverage, USDCContractLeverage
  • 查詢賬戶單個幣種余額
    • 新增請求參數: toAccountType, toMemberId, withLtvTransferSafeAmount
    • 新增響應字段: ltvTransferSafeAmount
  • 新增錯誤碼適配UTA帳戶支持場外借貸的交易限制場景
新增錯誤碼描述
30133USDT永續: 當交易對不在白名單內
30134USDT合約: 當交易對不在白名單內
30135USDT永續: 當設置的槓桿大於機構借貸規定的
30136USDC合約: 當設置的槓桿大於機構借貸規定的
3200316期權: 限制交易
3200317期權: 限制買入
170709現貨: 當交易對不在白名單內
170215現貨: 限制買入
170216現貨: 全倉槓桿倍數超過機構借貸規定的
170220現貨: 限制交易

2023-07-13​

REST API​

2023-07-04​

REST API​

2023-06-29​

WebSocket API​

2023-06-26​

WebSocket API​

  • 深度 [現貨]
    • 將50檔位的頻率從100ms提升到20ms

2023-06-24​

REST API​

2023-06-15​

REST API​

2023-06-14​

REST API​

2023-06-08​

REST API​

2023-06-07​

REST API​

  • 提現 [更新]
    • 新增請求參數 feeType, 支持選擇手續費內扣還是外扣

2023-06-02​

REST API​

2023-06-01​

REST API​

WebSocket API​

  • 持倉 [更新]
    • 新增響應參數字段 positionBalance

2023-05-30​

REST API​

2023-05-23​

REST API​

  • 創建委託單 [更新]
    • 針對新版止盈止損, 新增請求參數 tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType
  • 修改委託單 [更新]
    • 針對新版止盈止損, 新增請求參數 tpLimitPrice, slLimitPrice
  • 查詢實時委託單 [更新]
    • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice
  • 查詢歷史訂單 [更新]
    • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice
  • 查詢持倉 (實時) [更新]
    • tpslMode 字段從倉位數據中廢棄
  • 設置止盈止損 [更新]
    • 針對新版止盈止損, 新增請求參數 tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType

WebSocket API​

  • 持倉 [更新]
    • tpslMode 字段從倉位數據中廢棄
  • 訂單 [更新]
    • 針對新版止盈止損, 新增響應參數 tpslMode, tpLimitPrice, slLimitPrice

2023-05-10​

REST API​

老錯誤碼新錯誤碼消息
10001110075RiskId is not modified

2023-05-05​

REST API​

2023-05-04​

REST API​

  • 查詢成交紀錄 [更新]
    • 對於普通帳戶查詢期貨時，symbol 不再是必傳字段
  • 查詢平倉盈虧 [更新]
    • 對於普通帳戶查詢期貨時，symbol 不再是必傳字段

2023-04-20​

REST API​

  • 創建委託單 [更新]
    • 新增請求參數 smpType 來選擇自成交執行類型
  • 查詢實時委託單 [更新]
    • 新增響應參數 smpType, smpOrderId, smpGroup
    • 新增cancelType枚舉cancelBySmp
  • 查詢歷史訂單 [更新]
    • 新增響應參數 smpType, smpOrderId, smpGroup
    • 新增cancelType枚舉cancelBySmp
  • 查詢賬戶配置 [更新]
    • 新增響應參數 dcpStatus, timeWindow, smpGroup

WebSocket API​

  • 訂單 [更新]
    • 新增響應參數 smpType, smpOrderId, smpGroup
    • 新增cancelType枚舉cancelBySmp

2023-04-06​

REST API​

2023-04-04​

REST API​

WebSocket API​

  • 持倉 [更新]
    • 新增響應字段adlRankIndicator
    • UTA帳戶的推送新增字段category
  • 訂單 [更新]
    • 新增響應字段 placeType, 供期權訂單使用
  • 個人成交 [更新]
    • 新增響應字段 closedSize

2023-03-24​

REST API​

2023-03-23​

REST API​

WebSocket API​

  • 錢包 [更新]
    • 新增返回字段 accountLTV

2023-03-22​

REST API​

2023-03-15​

REST API​

2023-03-10​

REST API​

  • 查詢可交易產品的規格信息 [更新]
    • 統一現貨、期貨和期權的交易對狀態枚舉值。統一使用Trading, Closed, Settling, PreLaunch, Deliverying
    • 移除期權響應體中多餘的字段category
  • 查詢手續費率 [更新]
    • 支持查詢期權的手續費率

2023-03-09​

REST API​

  • 全倉槓桿設置 [更新]
    • UTA用戶支持10倍全倉槓桿交易
  • 查詢錢包餘額 [更新]
    • 更新前: 普通帳戶調用接口, accountType=UNIFIED時, 返回錯誤碼和錯誤信息.
      更新後: 普通帳戶調用接口, accountType=UNIFIED時, 返回http code 400

2023-02-28​

REST API​

WebSocket API​

  • 錢包 [更新]
    • 新增推送字段 bonus

2023-02-20​

REST API​

2023-02-15​

REST API​

  • 用戶 [新增]
    • 增加一組用戶API Key管理的接口

2023-02-14​

REST API​

入参是否必需類型說明
accountTypefalsestring設置出金帳戶.
  • SPOT：走現貨錢包出金 (默認)
  • FUND：走資金錢包出金

2023-02-09​

REST API​

2023-01-19​

REST API​

WebSocket API​

  • 持倉
    • 組合保證金模式下, positionIM, positionMM, leverage, riskLimitValue 返回 "", riskId 返回 0
  • 錢包
    • 組合保證金模式下, totalOrderIM, totalPositionIM, totoalPositionMM 返回 ""

2023-01-16​

REST API​

  • 查詢最新行情信息 [現貨]
    • usdIndexPrice 已經添加到響應體中. 該字段表示為USD指數價格, 可以為空。

WebSocket API​

  • 行情 [現貨]
    • usdIndexPrice 已經添加到推送中. 該字段表示為USD指數價格, 可以為空。
  • 深度 [正向合約以及反向合約]
    • 增加500檔的推送，頻率為100ms

2023-01-09​

WebSocket API​

  • 行情 [正向合約以及反向合約]
    - `nextFundingTime` 從日期 `2023-01-05T08:00:00Z` 變動為UTC時間戳(毫秒) `1672905600000`
    - `predicatedFundingRate` 從消息中移除
    ��