History of Huobi Coin-margined Swaps API Version – 도움센터

API Access:https://huobiglobal.zendesk.com/hc/en-us/articles/360000188382

1.1.2 2020-12-02 【Modified “Order details acquisition” interface (When querying cancelation data of orders that have not been partially filled, if “created_at” and “order_type” parameters are not uploaded, the data that can be queried reduced from last 12 hours to last 2 hours.); modified “Query history orders” interface (When querying cancelation data of orders that have not been partially filled, the data that can be retained reduced from last 24 hours to last 2 hours.); modified “Query history orders via multiple fields” interface (When querying cancelation data of orders that have not been partially filled, the data that can be retained reduced from last 24 hours to last 2 hours.)】

1、Modified “Order details acquisition” interface (When querying cancelation data of orders that have not been partially filled, if “created_at” and “order_type” parameters are not uploaded, the data that can be queried reduced from last 12 hours to last 2 hours.)

Interface Name：Order details acquisition
Interface Type：private
Interface URL：swap-api/v1/swap_order_detail

2、modified “Query history orders” interface (When querying cancelation data of orders that have not been partially filled, the data that can be retained reduced from last 24 hours to last 2 hours.)

Interface Name：Get History Orders
Interface Type：private
Interface URL：swap-api/v1/swap_hisorders

3、modified “Query history orders via multiple fields” interface (When querying cancelation data of orders that have not been partially filled, the data that can be retained reduced from last 24 hours to last 2 hours.)

Interface Name：Query history orders via multiple fields
Interface Type：private
Interface URL：swap-api/v1/swap_hisorders_exact

1.1.1 2020-11-24 【 Added: Query historical settlement records of the platform interface. Modified: Added fields of return parameter for "Query Liquidation Orders" interface and "Subscribe Liquidation Order Data" interface】

1、Added “Query historical settlement records of the platform” interface

Interface Name: Query historical settlement records of the platform
Interface Type: public
Interface URL: swap-api/v1/swap_settlement_records

2、Added fields of return parameter for "Query Liquidation Orders" interface（“amount” are added for return parameter “data". "amount" represents the liquidation amount (token);）

Interface Name: Query Liquidation Orders
Interface Type: public
Interface URL: swap-api/v1/swap_liquidation_orders

3、Added fields of return parameter for "Subscribe Liquidation Order Data" interface（“amount” are added for return parameter “data". "amount" represents the liquidation amount (token);）

Interface Name: Subscribe Liquidation Order Data
Interface Type: public
Subscription topic: public.$contract_code.liquidation_orders

1.1.0 2020-10-28 【Newly added：Query financial records via multiple fields, Query history orders via multiple fields,Query history transactions via multiple fields.】

1、Query history transactions via multiple fields

Interface Name：Query history transactions via multiple fields
Interface Type：private
Interface URL：swap-api/v1/swap_matchresults_exact

2、Query history orders via multiple fields

Interface Name：Query history orders via multiple fields
Interface Type：private
Interface URL：swap-api/v1/swap_hisorders_exact

3、Query financial records via multiple fields

Interface Name：Query financial records via multiple fields
Interface Type：private
Interface URL：swap-api/v1/swap_financial_record_exact

1.0.9 2020-10-15 【Newly added：Added switch leverage interface; Updated: websocket messages of account topic will be pushed when leverage switch succeeds; websocket messages of position topic will be pushed when leverage switch succeeds; new response fields are added on websocket topic of match orders; the interface(swap_order_info) supports query of 4-hour order cancellation data (previously only support to query 24-hour data).】

1、Added switch leverage interface

Interface Name：Switch Leverage
Interface Type：private
Interface URL：swap-api/v1/swap_switch_lever_rate

2、Subscribe Account Equity Updates Data（Return parameters added “switch_lever_rate” event type to represent switching leverages. When the leverage is successfully switched, a latest information on assets will be pushed with event“switch_lever_rate".）

Interface Name：Subscribe Account Equity Updates Data
Interface Type：private
Subscribe topic：$contract_code

3、Subscribe Position Updates（Return parameters added “switch_lever_rate” event type to represent switching leverages. When the leverage is successfully switched, a latest information on positions will be pushed with event“switch_lever_rate" (the information will not be pushed when the user's position is 0).）

Interface Name：Subscribe Position Updates
Interface Type：private
Subscribe topic：$contract_code

4、Subscribe Match Order Data （Added the following fields in return parameters: direction (buy/sell direction), offset (open/close direction), lever_rate (leverages), price (order price), created_at (creation time), order_source (order source), order_price_type (order quotation type).）

Interface Name：Subscribe Match Order Data
Interface Type：private
Subscribe topic：$contract_code

5、The interface(swap_order_info) supports query of 4-hour order cancellation data (previously only support to query 24-hour data).

Interface Name：Get Information of an Order
Interface Type：private
Interface URL：swap-api/v1/swap_order_info

1.0.8 2020-10-10【Newly added: Added WS interface for subscribing system status updates push】

1、Added WS interface for subscribing system status updates push

Interface name: subscribe system status updates
Interface type: public
Subscription topic：public.$service.heartbeat

1.0.7 2020-08-06 【Added interfaces：Subscribe market BBO data push； Query user’s available leverage；Query user’s settlement records；Subscribe trigger orders updates 】

1、Subscribe Market BBO Data

Interface Name：Subscribe market BBO data push
Interface Type：public
Subscribe topic：market.$contract_code.bbo

2、 Query user’s available leverage

Interface Name： Query user’s available leverage
Interface Type：private
Interface URL：swap-api/v1/swap_available_level_rate

3、Query user’s settlement records

Interface Name：Query user’s settlement records
Interface Type：private
Interface URL：swap-api/v1/swap_user_settlement_records

4、Subscribe trigger orders updates

Interface Name：Subscribe trigger orders updates
Interface Type：private
Subscribe topic：trigger_order.$contract_code

1.0.6 2020-6-19 【 Updated: added client_order_id in outer return parameter 】

1、Modified perpetual swaps subscribe match order data interface: added client_order_id in outer return parameter

Interface name: subscribe match order data
Interface type: private
Subscription topic: matchOrders.$contract_code

1.0.5 2020-06-14 【 Add interfaces: Premium index Kline data(websocket, restful); Estimated funding rate Kline data(restful, websocket); Basis data (restful, websocket);Update interfaces: add average premium index of querying historical funding rates; add four depth level of subscribing market depth; etc】

1、Add an interface: Query Premium Index Kline Data

Interface Name: Query Premium Index Kline Data
Interface Type: public interface
Interface URL: /index/market/history/swap_premium_index_kline

Interface Name: Subscribe Premium index Kline data
Interface Method: public interface
Subscribe Topic: market.$contract_code.premium_index.$period

Interface Name: Request Premium index Kline data
Interface Method: public interface
Request Topic: market.$contract_code.premium_index.$period

4、Add an interface: Query Estimated Funding Rate Kline Data

Interface Name: Query Estimated funding rate Kline
Interface Type: public interface
Interface URL: /index/market/history/swap_estimated_rate_kline

Interface Name: Subscribe Estimated Funding Rate Kline
Interface Type: public interface
Subscribe Topic: market.$contract_code.estimated_rate.$period

6、Add an interface: Request Estimated Funding Rate Kline Data

Interface Name: Request estimated funding rate k line
Interface Type: public interface
Request Topic: market.$contract_code.estimated_rate.$period

7、Add an interface: Query Swap Basis Data

Interface Name: Get basis data
Interface Type: public interface
Interface URL: /index/market/history/swap_basis

Interface Name: Subscribe basis data
Interface Type: public interface
Subscribe Topic: market.$contract_code.basis.$period.$basis_ price_type

9、Add an interface: Request Swap Basis data

Interface Name: Request basis data
Interface Type: public interface
Request Topic: market.$contract_code.basis.$period.$basis_ price_type

10、Add average premuim index field of querying historical funding rate

Interface Name: Query historical funding rate
Interface Type: public interface
Interface URL: /swap-api/v1/swap_historical_funding_rate

11、Add Four depth level of subscribing Market Depth: step12,step13,step14,step15

Interface Name: Suscribe Market Depth
Interface Type: public interface
Interface URL: market.$contract_code.depth.$type

12、Add periodical push of websocket subscription of account: every 5s

Interface Name: Subscribe Account
Interface Type: private interface
Interface URL: accounts.$contract_code

13、Add periodical push of websocket subscription of position: every 5s

Interface Name: Subscribe Position
Interface Type: private interface
Interface URL: positions.$contract_code

14.1 Add fields: order_id, order_id_str, client_order_id, order_type, status, trade_avg_price, trade_turnover, trade_volume

Interface Name: Query Order Detail
Interface Type: private interface
Interface URL: swap-api/v1/swap_order_detail

14.2、Add fields: liquidation_type，canceled_at

Interface Name: Query Order Information
Interface Type: private interface
Interface URL: swap-api/v1/swap_order_info

14.3、Add fields: canceled_at, fee_asset

Interface Name: Subcribe Orders
Interface Type: private interface
Subscribe Topic: orders.$contract_code

15、Add a field returned by websocket subscription of private topics: uid

Interface Name: Subscribe Orders
Interface Type: private interface
Subscribe Topic: orders.$contract_code
Interface Name: Subscribe Accounts
Interface Type: private interface
Subscribe Topic: accounts.$contract_code
Interface Name: Subscribe Positions
Interface Type: private interface
Subscribe Topic: positions.$contract_code
Interface Name: Subscribe match Orders
Interface Type: private interface
Subscribe Topic: matchOrders.$contract_code

16、Add an interface: place a trigger order

Interface Name: Place a trigger order
Interface Type: private interface
Interface URL: /swap-api/v1/swap_trigger_order

17、Add an interface: Cancel trigger order

Interface Name: Cancel all trigger orders
Interface Type: private interface
Interface URL: /swap-api/v1/swap_trigger_cancel

18、Add an interface: Cancel all trigger orders

Interface Name: Cancel all trigger orders
Interface Type: private interface
Interface URL: /swap-api/v1/swap_trigger_cancelall

19、Add an interface: Query open trigger orders

Interface Name: Query open trigger orders
Interface Type: private interface
Interface URL: /swap-api/v1/swap_trigger_openorders

20、Add an interface: Query historical trigger orders

Interface Name: Query historical trigger orders
Interface Type: private interface
Interface URL: /swap-api/v1/swap_trigger_hisorders

Interface Name: Subscribe Match Orders
Interface Type: private interface
Subscribe Topic: matchOrders.$contract_code

1.0.4 2020-5-27 【 Add an interface: websocket subscription of contract info 】

1、Add an interface: websocket subscription of contract info event

Interface Name: websocket subscription of contract info event
Interface Type: public interface.
Subscription topic: public.$contract_code.contract_info

1.0.3 2020-05-07 【 Add an interface: query assets and position info】

1、Add an interface: query assets and position info

Interface Name: query assets and position info
Interface Type: Private interface.
Interface URL： /swap-api/v1/swap_account_position_info

1.0.2 2020-04-09 [Add an interface: perpetual swaps funding rate WS push without authentication;2. Add an interface: perpetual swaps liquidation order WS push without authentication]

1、Add an interface: perpetual swaps funding rate WS push without authentication.

Interface name: Subscribe funding rate (no authentication)
Interface type: public interface.
Subscribe topic: public.$contract_code.funding_rate

2、 Add an interface: perpetual swaps liquidation order WS push without authentication

Interface name: Subscribe liquidation orders (no authentication)
Interface type: public interface.
Subscribe topic: public.$contract_code.liquidation_orders

1.0.1 2020-03-20

1、Log in with your master account on Web to sign the High Leverage Agreement if you use high leverage (>20x) for the first time. Afterwards, you can place order by API with high leverage (>20x).

2、The authentication path of the websocket subscription of order and user data is changed from '/notification' to '/swap-notification'.

Interface name: All interfaces under the websocket subscription of order and user data.
Interface type: User private interface.
Authentication path: /swap-notification.

3、Added incremental websocket subscription of orderbook data.orderbook event will be checked every 30ms.If there is no orderbook event, you will not receive any orderbook data.

Interface Name: Subscribe Incremental Market Depth Data.
Interface type: public interface.
Subscribe Topic: market.$contract_code.depth.size_${size}.high_freq.

4、Added API interface of querying user's API indicator disable information

Interface name: Query user's API indicator disable information
Interface type: User private interface
URL: /swap-api/v1/swap_api_trading_status

5、 Added websocket subscription of funding rate.It will be pushed once the funding rate is updated.

Interface name: Subscribe funding rate
Interface type: User private interface
Subscribe Topic: funding_rate.$contract_code

6、Modified on the interface of querying contract information on order limit: added 10 order price types including 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

Interface name: Query contract information on order limit
Interface type: User private interface
URL: POST /swap-api/v1/swap_order_limit

7、Modified on the interface of placing an order: added 8 order price types, including opponent_ioc, optimal_5_ioc, optimal_10_ioc, optimal_20_ioc, opponent_fok,optimal_5_fok, optimal_10_fok, optimal_20_fok.

Interface name: Place an order
Interface type: User private interface
URL: /swap-api/v1/swap_order

8、Modified on the interface of placing a batch of orders: added 8 order price types, including opponent_ioc, optimal_5_ioc, optimal_10_ioc, optimal_20_ioc, opponent_fok, optimal_5_fok, optimal_10_fok, optimal_20_fok。

Interface name: Place a batch of orders
Interface type: User private interface
URL: /swap-api/v1/swap_batchorder

9、Modified on the interface of placing lightning close order interface: added string "order_price_type", including values: lightning_ioc, lightning_fok, lightning

Interface name: Place lightning close order
Interface type: User private interface
URL: /swap-api/v1/swap_lightning_close_position

10、Modified on the interface of querying trade details for an order: added string "liquidation_type".

Interface name: Get trade details of an order
Interface type: User private interface
URL: POST /swap-api/v1/swap_order_detail

11、Modified "trade_type" and "orders" in the interface of querying history orders. Added "reduce positions to close long" and "reduce positions to close short" types in request parameter "trade_type"; Added string "liquidation_type" in orders array of returning parameter.

Interface name: Query history orders interface.
Interface type: User private interface
URL: POST /swap-api/v1/swap_hisorders

12、Added string "liquidation_type" in order transaction push in WebSocket Subscription.

Interface name: Match result on order push in WebSocket subscription
Interface type: User private interface
Subscribe Topic: orders.$symbol

13、Added an interface: transfer between master account and sub-accounts, the rate limit between the master account and each subaccount is 10 times/ minute.Interface name: Transfer between master account and sub-accounts.

Interface name: transfer between master account and sub-accounts
Interface type: User private interface
URL：/swap-api/v1/swap_master_sub_transfer

14、Added a parameter: transfer permission between master account and sub-accounts. Added strings: "master_transfer_sub" and "sub_transfer_master" in returning parameter data array.

Interface name: Query information on system status
Interface type: Public
URL：/swap-api/v1/swap_api_state

15、Added an interface: query transfer records of master account and sub-accounts.

Interface name: Query transfer records of master account and sub-accounts.
Interface type: User private interface
URL: /swap-api/v1/swap_master_sub_transfer_record

16、Added four kinds of transfer statements between master account and sub-accounts in returning financial record interface.

Interface name: Query contract financial record
Interface type: User private interface
URL: /swap-api/v1/swap_financial_record

이 섹션의 문서