SWAP:永續合約API版本歷史記錄

1.0.52020年6月12日

1、新增溢價指數K線的restful接口。

接口名稱：獲取溢價指數K線數據接口接口類型：公開接口restful請求：GET請求swap-api/v1/swap_premium_index_kline。2、新增溢價指數K線的ws請求接口。

接口名稱：獲取溢價指數K線數據ws請求接口接口類型：公開接口ws請求接口：reqmarket.$contract_code.premium_index.$period。3、新增溢價指數K線的ws訂閱推送接口。

接口名稱：訂閱溢價指數K線數據接口接口類型：公開接口ws訂閱接口：submarket.$contract_code.premium_index.$period。4、新增預測資金費率K線的restful接口。

接口名稱：獲取預測資金費率K線數據接口接口類型：公開接口restful請求：GET請求swap-api/v1/swap_estimated_rate_kline。5、新增預測資金費率K線的ws請求接口。

接口名稱：獲取預測資金費率K線數據ws請求接口接口類型：公開接口ws請求接口：reqmarket.$contract_code.estimated_rate.$period。6、新增預測資金費率K線的ws訂閱推送接口。

接口名稱：訂閱預測資金費率K線數據推送接口接口類型：公開接口ws訂閱接口：submarket.$contract_code.estimated_rate.$period。7、新增獲取基差數據的restful接口。

FTX上線OXY永續合約:據官方公告消息，FTX已上線OXY永續合約。[2021/3/17 18:50:53]

接口名稱：獲取基差數據接口接口類型：公開接口restful請求：GET請求/index/market/history/swap_basis。8、新增獲取基差數據的ws請求接口。

接口名稱：獲取基差數據ws接口接口類型：公開接口ws請求接口：reqmarket.$contract_code.basis.$period.$basis_price_type。9、新增獲取基差數據的ws訂閱推送接口。

接口名稱：訂閱基差數據推送接口接口類型：公開接口ws訂閱接口：submarket.$contract_code.basis.$period.$basis_price_type。10、獲取合約的歷史資金費率接口新增“平均溢價指數”字段

接口名稱：獲取合約的歷史資金費率接口URL：swap-api/v1/swap_historical_funding_rate修改內容：新增avg_premium_index字段，表示平均溢價指數。11、訂閱MarketDepth接口新增4個深度類型可選值

接口名稱：ws訂閱MarketDepth數據接口方法：market.$contract_code.depth.$type修改內容：請求參數type深度類型新增4個可選值:step12(表示合并精度1的20檔深度數據，表示整數位的個位)、step13(表示合并精度10的20檔深度數據，表示整數位的十位)、step14(表示合并精度1的150檔深度數據，表示整數位的個位)、step15(表示合并精度10的150檔深度數據，表示整數位的十位)。12、資產變動的WS接口新增定期推送

Gate.io已上線BADGER永續合約實盤交易（USDT結算）:據官方公告，Gate.io已上線BADGER/USDT永續合約實盤交易（USDT結算），支持1-20倍做多和做空操作，杠桿率可以在下單時自行選擇。Gate.io永續合約是全球最活躍的區塊鏈資產合約市場之一，日交易量高達8億美金，結算類型分為“BTC結算永續合約”和“USDT結算永續合約”兩種。Gate.io提示：請用戶務必在完全了解風險并能承擔風險的情況下參與，Gate.io平臺不對投資行為承擔擔保、賠償等責任。詳情見原文鏈接。[2021/1/22 16:45:54]

接口名稱：訂閱資產變動數據接口方法：accounts.$contract_code修改內容：推送接口新增定期推送邏輯，每5秒進行一次定期推送，由定期推送觸發的數據中event參數值為“snapshot”，表示由系統定期推送觸發。如果5秒內已經觸發過推送，則跳過該次定期推送。13、持倉變動的WS接口新增定期推送

接口名稱：訂閱持倉變動數據接口方法：positions.$contract_code修改內容：推送接口新增定期推送邏輯，每5秒進行一次定期推送，由定期推送觸發的數據中event參數值為“snapshot”，表示由系統定期推送觸發。如果5秒內已經觸發過推送，則跳過該次定期推送。14、優化查詢訂單相關接口的返回參數

獲取訂單明細信息接口

接口名稱：獲取訂單明細信息接口URL：swap-api/v1/swap_order_detail修改內容：在返回參數的數組"data"中，增加8個字段:order_id(訂單id)、order_id_str(string格式的訂單id)、client_order_id(客戶訂單id)、order_type(訂單類型)、status(訂單狀態)、trade_avg_price(成交均價)、trade_turnover(成交總金額)、trade_volume(成交總數量)。獲取訂單信息接口

IOST等DeFi生態幣種上線火幣永續合約:據火幣官方公告，火幣平臺于今日上線了IOST等DeFi生態幣種的永續合約。據悉，IOST作為安全、高效的全品類DeFi平臺，此前成立了百萬美金DeFi專項基金，用于支持優秀DeFi團隊與孵化優質DeFi項目，專注于IOST的DeFi生態構建。[2020/8/19]

接口名稱：獲取訂單信息接口接口URL：swap-api/v1/swap_order_info修改內容：在返回參數的數組"data"中，增加2個字段:liquidation_type(強平類型)、canceled_at(撤單時間)。訂閱成交訂單推送接口

接口名稱：訂閱成交訂單推送接口URL：orders.$contract_code修改內容：在返回參數的外層，增加2個字段:canceled_at(撤單時間)、fee_asset(手續費幣種)。15、私有推送接口新增返回參數'uid'

接口名稱：訂閱成交訂單推送，訂閱資產變動推送，訂閱持倉變動推送，訂閱訂單撮合推送接口方法：orders.$contract_code，accounts.$contract_code，positions.$contract_code，matchOrders.$contract_code修改內容：在返回參數增加uid字段，表示用戶uid。16、新增新增合約計劃委托下單接口

接口名稱：合約計劃委托下單接口接口類型：私有接口接口方法：swap-api/v1/swap_trigger_order17、新增合約計劃委托撤單接口

接口名稱：合約計劃委托撤單接口接口類型：私有接口接口方法：swap-api/v1/swap-api/v1/swap_trigger_cancel18、新增合約計劃委托全部撤單接口

58COIN永續合約大戶持倉情況20:00播報:截至20:00，據58COIN官方永續合約數據，大戶持倉情況如下：

BTC永續合約賬戶中，多頭平均持倉比例為19.11%、空頭平均持倉比例為18.19%，多頭暫時領先，領先數量（凈頭寸數量）為0.07萬個BTC。

EOS永續合約賬戶中，多頭平均持倉比例為18.29%、空頭平均持倉比例為19.87%，空頭暫時領先，領先數量（凈頭寸數量）為119.52萬個EOS。

ETH永續合約賬戶中，多頭平均持倉比例為17.94%、空頭平均持倉比例為16.41%，多頭暫時領先，領先數量（凈頭寸數量）為1.19萬個ETH。[2020/7/9]

接口名稱：合約計劃委托全部撤單接口接口類型：私有接口接口方法：swap-api/v1/swap-api/v1/swap_trigger_cancelall19、新增獲取計劃委托當前委托接口

接口名稱：獲取計劃委托當前委托接口接口類型：私有接口接口方法：swap-api/v1/swap-api/v1/swap_trigger_openorders20、新增獲取計劃委托歷史委托接口

接口名稱：獲取計劃委托當前委托接口接口類型：私有接口接口方法：swap-api/v1/swap-api/v1/swap_trigger_hisorders21、新增訂單撮合數據WS推送

接口名稱：訂閱訂單撮合數據接口接口類型：私有接口接口方法：matchOrders.$contract_code1.0.42020年5月27日

1、增加合約信息變動ws推送接口

接口名稱：增加合約信息變動ws推送接口接口類型：公開接口訂閱主題：public.$contract_code.contract_info?

MXC抹茶6月15日18:00上線BCHUSDT、LTCUSDT永續合約:官方公告，MXC抹茶6月15日18:00上線BCHUSDT、LTCUSDT永續合約。合約配置為BCH/USDT、LTC/USDT永續合約交易對，支持1-100倍自由調節。用戶可根據交易習慣選擇全倉或逐倉模式進行開倉。MXC抹茶新版合約對盤口價差和交易深度進行了大幅優化，目前BTC盤口價差穩定在0.5 USDT，ETH穩定在0.05 USDT，BCH穩定在0.05 USDT，LTC穩定在0.01 USDT。詳情請閱讀相關公告。[2020/6/15]

1.0.32020年5月7日

1、增加查詢用戶賬戶和持倉信息

接口名稱：查詢用戶賬戶和持倉信息接口類型：私有接口接口URL：/swap-api/v1/swap_account_position_info?

1.0.22020年4月9日

1、增加免鑒權的資金費率WS推送接口

接口名稱：訂閱資金費率推送(免鑒權)接口類型：公開接口訂閱主題：public.$contract_code.funding_rate2、增加免鑒權的強平訂單WS推送接口

接口名稱：訂閱強平訂單推送(免鑒權)接口類型：公開接口訂閱主題：public.$contract_code.liquidation_orders?

1.0.12020年3月20日

1、首次使用高倍杠桿(>20倍)，請使用主賬號登錄web端同意高倍杠桿協議。然后再使用API進行高杠桿倍數(>20倍)下單。

2、websocket訂單與用戶數據接口鑒權簽名路徑變更，簽名構建由原/notification變更為/swap-notification。

接口名稱：ws訂單與用戶數據下所有接口接口類型：私有接口鑒權路徑：/swap-notification3、增加websocket訂閱增量市場orderbook數據接口，分為20檔和150檔不合并數據，每30MS檢查一次更新，若有更新則推送。

接口名稱：訂閱MarketDepth增量數據接口類型：公開接口訂閱主題：market.$contract_code.depth.size_${size}.high_freq4、增加獲取用戶的API指標禁用信息的API接口。

接口名稱：獲取用戶的API指標禁用信息接口類型：私有接口接口URL：/swap-api/v1/swap_api_trading_status5、增加websocket訂閱資金費率接口，資金費率有更新時會推送信息。

接口名稱：訂閱資金費率接口類型：私有接口訂閱主題：funding_rate.$contract_code6、獲取下單量限制的接口增加10種訂單價格類型，包括：opponent_ioc，lightning_ioc，optimal_5_ioc，optimal_10_ioc，optimal_20_ioc，opponent_fok，lightning_fok，optimal_5_fok，optimal_10_fok，optimal_20_fok。

接口名稱：查詢用戶當前的下單量限制接口類型：私有接口接口URL：/swap-api/v1/swap_order_limit7、合約下單接口增加8種訂單價格類型，分別為：opponent_ioc，optimal_5_ioc，optimal_10_ioc，optimal_20_ioc，opponent_fok，optimal_5_fok，optimal_10_fok，optimal_20_fok。

接口名稱：合約下單接口類型：私有接口接口URL：/swap-api/v1/swap_order8、合約批量下單接口增加8種訂單價格類型，分別為：opponent_ioc，optimal_5_ioc，optimal_10_ioc，optimal_20_ioc，opponent_fok，optimal_5_fok，optimal_10_fok，optimal_20_fok。

接口名稱：合約批量下單接口類型：私有接口接口URL：/swap-api/v1/swap_batchorder9、閃電平倉下單接口請求參數增加字段order_price_type，值分別為：lightning_ioc，lightning_fok，lightning(閃電平倉-默認值）。

接口名稱：閃電平倉下單接口類型：私有接口接口URL：/swap-api/v1/swap_lightning_close_position10、獲取訂單明細信息返回的data字典中增加字段強平類型：liquidation_type，所有成交的手續費：fee，手續費幣種：fee_asset。

接口名稱：獲取訂單明細信息接口類型：私有接口接口URL：/swap-api/v1/swap_order_detail11、獲取合約歷史委托trade_type和orders修改，請求參數的trade_type中，增加類型：減倉平多，減倉平空；返回參數的orders數組元素增加字段"liquidation_type"。

接口名稱：獲取合約歷史委托接口類型：私有接口接口URL：/swap-api/v1/swap_hisorders12、WS訂單成交推送增加字段liquidation_type。

接口名稱：WS訂閱訂單成交推送接口類型：私有接口接口URL：orders.$symbol13、增加母子賬戶劃轉的API接口，母賬戶與每個子賬戶相互劃轉限頻10次/分鐘。

接口名稱：母子賬戶劃轉接口類型：私有接口接口URL：/swap-api/v1/swap_master_sub_transfer14、查詢系統狀態的接口增加母子劃轉權限參數，在返回參數的數組"data"中，增加兩個字段："master_transfer_sub"、"sub_transfer_master"。

接口名稱：查詢系統狀態接口類型：公共接口接口URL：/swap-api/v1/swap_api_state15、增加查詢母賬戶下的所有母子賬戶的劃轉記錄的功能。

接口名稱：獲取母賬戶下的所有母子賬戶劃轉記錄接口類型：私有接口接口URL：/swap-api/v1/swap_master_sub_transfer_record16、返回財務記錄的接口中，增加返回4種母子賬戶劃轉的流水。

接口名稱：查詢用戶財務記錄接口類型：私有接口接口URL：/swap-api/v1/swap_financial_record

Tags：SWAPAPITRAORDLMCSWAPHAPI幣TranscodiumWrapped Ordichains

抹茶交易所