SWAP:永續合約API版本歷史記錄_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接口。

數據：PEPE 永續合約資金利率仍為負，空頭頭寸占主導地位:5月4日消息，據加密衍生品數據分析平臺 Laevitas 數據，Meme coin PEPE 自推出后短短兩周內市值飆升至超過 5 億美元，但其與代幣掛鉤的永續合約的資金利率仍然為負，表明永續合約市場中空頭頭寸占主導地位，大多數投資者預計價格會下跌。[2023/5/4 14:42:48]

接口名稱：獲取基差數據接口接口類型：公開接口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接口新增定期推送

火幣將于明日14點上線CHZ、UMA、SKL、BLZ品種USDT本位永續合約:據火幣合約官方公告，火幣合約將于新加坡時間3月12日上線CHZ、UMA、SKL和BLZ品種USDT本位永續合約，11點開啟資金劃轉，14點開放對外交易，支持1x-75x倍數。此前，火幣USDT本位永續合約已涵蓋了BTC、ETH、SUSHI、UNI等在內的71大主流品種。

新上線的CHZ、UMA、SKL和BLZ品種USDT本位永續合約是正向合約，即穩定幣合約，采用穩定幣（USDT）作為擔保資產，無交割日期，合約標的為其對應數字資產的現貨USDT指數，且每8小時結算一次，結算時間戳分別為0:00、08:00和16:00（GMT+8），用戶已實現盈利在結算后可立即提取。[2021/3/11 18:36:04]

接口名稱：訂閱資產變動數據接口方法：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(成交總數量)。獲取訂單信息接口

火幣USDT本位永續合約上線全倉擔保資產功能和實時結算功能:據火幣合約官網公告，火幣USDT本位永續合約全倉擔保資產功能已于12月11日18:00上線，現用戶可通過WEB、API端使用該功能進行交易。

據悉，全倉模式下，全倉賬戶中的USDT會為每個品種合約的倉位提供擔保，即全倉下所有品種合約的倉位共享一個賬戶權益，賬戶中的盈虧、占用擔保資產、擔保資產率等數據合并計算；逐倉模式下，USDT永續合約各品種合約單獨核算擔保資產，各倉位的風險與收益獨立。

火幣合約USDT本位永續合約支持全倉和逐倉同時使用,用戶可切換全倉模式或逐倉模式進行交易,切換不影響用戶的已有倉位。例如：用戶可以同時持有BTC/USDT（全倉）和BTC/USDT（逐倉）。

目前，火幣USDT永續合約全倉模式支持BTC、ETH、LINK、LTC和XRP，且僅支持Web和API端，APP端暫時無法查看全倉賬戶的資產和持倉，同時也無法通過APP端進行支持全倉幣種的開平倉操作。

此外這5個品種，全倉和逐倉模式下都支持實時結算功能，用戶已實現的盈利部分可以隨時提取（扣除掉浮動虧損和占用保證金等），無需等至每日0:00、8:00、16:00(GMT+8)結算。[2020/12/11 14:57:23]

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

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

Gate.io永續合約24小時交易量1.689億美元:據Gate.io官網行情顯示，截止到今日17:00，Gate.io永續合約24H交易量為1.689億美元，其中BTC/USDT永續合約24小時成交量為549,900,194美元，現報111693.45美元；BTC/USD合約24小時成交量為15,655,331美元，現報11697.69美元。[2020/9/2]

接口名稱：訂閱成交訂單推送，訂閱資產變動推送，訂閱持倉變動推送，訂閱訂單撮合推送接口方法：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、新增合約計劃委托全部撤單接口

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

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

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

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

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

ETH永續合約賬戶中，多頭平均持倉比例為17.21%、空頭平均持倉比例為15.12%，多頭暫時領先，領先數量（凈頭寸數量）為1.49萬個ETH。[2020/8/25]

接口名稱：獲取計劃委托當前委托接口接口類型：私有接口接口方法：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?

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：SWAPAPITRAORDGenieSwapPitquidity CapitalGTraXLORD價格

Polygon