Notice: Only return data for activated contract sub-account i. Notice: Only query account information for activated contract sub-account i. Send symbol to cancel all the contracts of that kind of symbol, e. If yes, the maker order will placed on the orderbook, if not, the maker order will be cancelled. For each account, contracts of the same underlying coin only need to subscribe one WS order push, e. Request address of method, i. Please note that, in terms of "Get" requests, it needs to do Signature calculation for all the original parameters in each method ; In terms of "Post" requests, no need to do Signature calculation for the original parameters in each method, which means only four parameters need to do Signature calculation in "Post" requests, i.
Signature: The result of Signature calculation which is used to verify if signature is valid and not tampered. Normative request for Signature calculation Different contents will get totally different results when use HMAC to calculate Signature, therefore, please normalize the requests before doing Signature calculation.
Take the request of inquering order details as an example:. Encoding the Hash value with base code, the result will be the digital Signature of this request. Add the digital Signature encoded with URL code into the path parameters with the parameter name of "Signature". Please note that, for both public interface and private interface, there are rate limits, more details are as below:.
Generally, the private interface rate limit of API key is at most 72 times every 3 seconds for each UID Trade Interface: at most 36 times every 3 seconds. Read Interface: at most 36 times every 3 seconds this rate limit is shared by all the altcoins contracts delivered by different date. API Interface List. For public interface used to get information of index, price limit, settlement, delivery, open positions and so on, the rate limit is times every 3 seconds at most for each IP this times every 3 seconds public interface rate limit is shared by all the requests from that IP of non-marketing information, like above.
Both read and trade interfaces will return the ratelimit info. You can refer to the following fields of "header" from api response. Please note that our system calculates order cancellation ratio according to UID and therefore, the master account UID and sub-accounts UIDs will be counted separately. Every 10 minutes is a cycle. In order to ensure stability and transaction performance of API, please try to reduce order cancellation rate and cancellation amount during peak periods to avoid frequent triggering of API restriction mechanism.
Suggestions of reducing order cancellation rate are as below:. Besides the above two rest interfaces, for getting the infomation that system maintenance with service suspended, could by subscribing system status updates websocket interface.
Users can You can click here to subscribe. The subscription function depends on Google services. Before you subscribe, please ensure that you can access Google services normally. You are kindly suggested to query one-day data at a time. Querying performance will be improved when accurate time stamps are entered. For instance, subscribing 20 steps data. You can create API using the following link. It seems that most of the abnormal websocket issues such as disconnect, websocket close websocket: close abnormal closure are caused by different network environment.
The following measures can effectively reduce websocket issues. It would be better if the server is located in 1c area of AWS Tokyo with url api. Both market heartbeat and order heartbeat should response with Pong with different format, following Websocket market heartbeat and account heartbeat requirement.
The api. Actually ,colo corresponds to a vpc node, which directly connects to private network of huobi's future, so it will reduce the latency between the client and the Huobi future server bypassing the CDN. Note : Colo needs to use api. The signature process of future is similar to huobi Spot. In addition to the following precautions,please refer to the swap or spot demo to verify whether the signature is successful. Please check your own signature code after demo verification is successful.
The coin margined swap code demo is here. The future code demo is here. If the reason for signature failure has not been found through the above methods.
And you can confirm that by this demo which is specially explaining the signature. The master and sub accounts are separately ratelimited and don't affect each other. There is an open source asynchronous quantization framework which integrates Huobi future and Huobi swap: here. If you have any quetsions, please open a ticket in github issues.
The snapshot orderbook subscription market. If there is an update,it will be pushed. It will be pushed at least 1 second. The incremental orderbook subscription is checked once every 30MS. If there is no update, it will not be pushed. And the qty of data records cannot be exceeding in each time. The historical trade data can be obtained by subscribing the websocket topic: market. But also, you can download that data using The demo of downloading historical market data.
You can refer to TradingView and other websites to calculate them. The timestamp in the document refers to the total number of seconds or total milliseconds from Greenwich Mean Time, January 1, , Beijing Time, January 1, , to the present. The Subscription of MBP data: market. Subscription of position event: "positions. The latest position is pushed,including the volumes, available volumes, frozen volumes. If there is no update,it will not be pushed.
It will not be pushed if only unrealized profit is updated. It will be pushed only when position event is updated. Market Detail market. It will be checked every 0. Trade Detail market. The inner ts is the timestamp when the orderbook is checked. Snapshot MBP data is checked every ms,pushed at least every 1s. Incremental MBP data is checked every 30ms. It will not be pushed,if MBP has no update. You have to remove the same price of local MBP data;.
The pushed data of these two interfaces are different. If any transaction is completed, it will push every ms. If not, it will push according to the subscribe period. Check the stability and speed of the network between procedure and the servers please replace api. If you run the above command multiple times in a row, and the results obtained each time are very different, you can: a.
Select an appropriate Huobi domain name, b. Optimize or reselect the network where the program is located. Inquiry about funds and positions during settlement or delivery will return an error code. Error code "" indicates that "the fund query of current perpetual swap trading pair failed during the settlement"; Error code "" indicates that "the fund query of part of perpetual swap trading pairs failed during the settlement"; Error code "" indicates that "the position query of current perpetual swap trading pair failed during the settlement"; Error code "" indicates that "the position query of part of perpetual swap trading pairs failed during the settlement"; You are recommended to read the status code from the returned message.
If the above four types of status code appear, the returned data is not accurate and couldn't be used as reference. We notice that the system is sometimes overloaded when the market suddenly turns to be highly volatile. If the system is busy recently or the following prompts appear:. In the meanwhile, it is recommended to place and cancel orders through Web and APP.
At present,it normally takes about ms from placing the order to getting the status of the order. Most of the network connectivity problems , such as Connection reset or network timeout are caused by network instability , you can use the server in AWS Tokyo C area with api.
When subscribing private accounts, orders and positions, the heartbeat should also be maintained regularly ,which is different from the market heartbeat format. Please refer to the "websocket Heartbeat and Authentication Interface". Status 1 is the preparation for submission. Status 3 indicated that the order has been already submitted to market. The success return of order cancellation or placement only represents that the command is excuted successfully and doesn't mean that the order has been cancelled.
The order cancellation command generally takes several tens of ms. How to judge whether the system is suspended for maintenance or not? At present, Huobi Futures does not support market price when placing an order. The system will obtain the optimal N price at that moment and place the order. In this way, it will directly query the database, so the query results will be more timely.
When the order book cannot meet with the corresponding conditions, the system will cancel the orders automatically:. IOC order: If the order cannot be filled immediately, the unfilled part will be cancelled at once;. FOK order: If the order cannot be filled in its entirety, it will be wholly cancelled. No partial fulfillments are allowed.
However, this exceeds the maximum limit Therefore, the system will return []. In general, API upgrade will partly influence the ws disconnection. To avoid this, you can set up a ws-reconnect mechanism in advance; Please subscribe to the upgrade announcements for more details:.
Please try again later. Check whether the amount cont of position-closing order exceeds the limit? When there is limit order for closing a position, the quantity that available to be closed will be occupied; hence we kindly remind you to cancel these orders and try again. The coin margined swap, future and USDT margined swap limit the rate separately. Please check the ratelimit in the api ratelimit instructions, and you can print the current ratelimit in the header of the API response to check whether the ratelimit is exceeded.
It is recommended to increase the request interval delay to avoid exceeding the ratelimit. When you report an API error, you need to attach your request URL, the original complete body of the request and the complete request URL parameters, and the original complete log of the server's response.
If it is a websocket subscription, you need to provide the address of the subscription, the topic of the subscription, and the original complete log pushed by the server. If not any parameter is filled, the interface returns the price limitation data of all currently available contracts.
Only return data for activated contract sub-account i. Only query account information for activated contract sub-account i. Post-Only orders are limit orders that will never take liquidity also called maker-only order. If you need a new leverage to place an order, you should switch the leverage of current positions first by using the Switch Leverage interface. The take profit trigger price is a required field for setting a take profit order, and the stop loss trigger price is a required field for setting a stop loss order; if the trigger price field is not filled in, the corresponding take profit order or stop loss order will not be set.
Because the Json. The return data from Cancel An Order Interface only means that order cancelation designation is executed successfully. To check cancelation result, please check your order status at Get Information Of An Order interface. Response: result of multiple order withdraws successful withdrew order ID, failed withdrew order ID. You can fill in only one of direction and offset to cancel the orders. Response:result of multiple order withdrawls successful withdrew order ID, failed withdrew order ID.
Only if a user has positions of a single token and has no open orders, the leverage is available to be switched flexibly. When getting information on order cancellation via get order information interface, users can only query last 4-hour data. After daily settlement or delivery on Friday, the orders in the end state 5:partially filled orders have been cancelled, 6:all filled orders, 7:have been cancelled will be deleted.
All via API interface submited price limit orders that had been cancelled will only be kept for 2 hours. Transferring margin between Spot account and Future account Interface, sets 8 decimal places for transferring amount of all coins. If you have further queries about Huobi Future order push subscription, please refer to Demo. For public interfaces used to get information of non-market data such as request information of index, price limit, delivery and settlement, positions, etc.
The user under this UID only need to subscribe one WS order push for the contracts of the same underlying coins. WebSocket API supports two-way heartbeat. Both Server and Client can send ping message, which the opposite side can return with pong message. Note: Once the WebSocket Client and WebSocket Server get connected, the server will send a heartbeat every 5 seconds the frequency might change.
The connection will get disconnected automatically if the WebSocket Client ignores the heartbeat message for 5 times. Clients have to decompress them for further use. During making connection and authentication, server will disconnect connection automatically when error occurs.
Before disconnecting, server will send notification below,. After authentication, if clients encountered internal error or request data out from Operator List, WebSocket server will return error message. But server will remain connection. By clicking on it, the user is taken to a page with a form for entering personal information. Here you will need to specify your citizenship, email address, and create and confirm a password.
If you have an invitation code, you will also need to enter it. Next, you will receive an email with a special link to activate your account. Verification is available on the Huobi platform, which users can complete at their own request. It can be useful for increasing the amount of cryptocurrency that is withdrawn from the exchange.
Verification will also significantly increase the level of account protection. Then you will go to the desired form. You need to upload a photo or scan of your ID card in the lowest field. It will take a little time to check it automatically. This is your email address and password.
Account protection using only a password and email binding is not reliable enough. Therefore, there are two additional ways to increase the security level on the exchange:. Set SMS authorization. After activating this feature, you will not be able to log in without the code sent in an SMS.
To Use Google Authenticator. This method provides the highest level of protection. Main sections of the Huobi platform interface. It will not be difficult to understand the site even for those who are just learning how to trade cryptocurrency. On the left side of the main page, you can see the following sections:. On the right side of the site, you can see menu items such as:. At the bottom of the site, you can find the following useful sections:. On one page, the user can get access to the necessary information and functions necessary for trading.
Working with the exchange is available on several platforms, depending on your preferred device:. The Deposit and withdrawal of funds. For the beginning of active trading you need to credit your personal account. By clicking on this item, the user will be taken to a page where there is a list of available cryptocurrencies.
All assets that are traded on the exchange are available for replenishment. Therefore, a trader can make a Deposit in the cryptocurrency that they have available. For this purpose, the unique address of the cryptographic wallet is used. You can copy it to the clipboard or save it by scanning the QR code. The minimum Deposit amount for a particular currency is indicated at the bottom of the page. In the case of PTS, this is 0.
For other currencies, the minimum Deposit amount differs and depends on their market value. As a result, you need to complete the following steps to top up your account:. Withdrawal of digital money is carried out using the same section. The sequence of actions is as follows:. After completing these steps, you must wait until the required number of confirmations is received in the network.
When this stage is completed, the cryptocurrency will appear on the account. Daily withdrawal limits depend on the coin that was selected. An example is Ripple. Its withdrawal limit for 24 hours is XPR. These figures are relevant for users who have not passed verification.
And after passing the identification process, the maximum limits significantly increase, while the minimum limits remain at the same level. On the screen, you can see commissions for withdrawing different coins. For example, a value of 0. Trade commission. A large number of currency pairs are available on the Huobi exchange. There are also different types of trading. But regardless of the type of activity the trader is engaged in, they will pay a fixed trading Commission for the trades.
For both the seller and the buyer, it is 0. Huobi Token owners also have the opportunity to join the VIP club, which involves five levels of participation. You can work with the market on the Huobi exchange through a convenient terminal. The terminal window is visually divided into several sectors:. They are on the left. If desired, you can switch the display of the digital money exchange rate to the ruble.
The glasses of the trades that display bids for the purchase and sale of digital money. Located on the right side of the terminal. The asset price movement chart is located in the center of the screen. It contains the necessary tools for trading empty lines, Japanese candlesticks, etc.
In the same part of the window, you can change the screen type from the standard version to the full version. The last step is necessary for in-depth analysis of the market.
Digital value of the asset price change. You can see it above the graph. This part of the terminal displays the cryptocurrency exchange rate, the percentage change in price, volumes for 24 hours, as well as the highest and lowest points of movement for the day.
Form for buying and selling an asset. Placed under the chart. Green button — buy, red-sell. Order history. Located at the very bottom of the terminal. To buy or sell an asset, the user must first select the market in which they will trade. Then you will need to determine the appropriate currency pair. After that, you need to select the order type.
This can be one of three options:. The order is executed immediately, at the best market price available at the moment. The trader himself specifies the appropriate price. The order is executed only when it is reached. Stop limit. Allows you to specify the opening price after the chart bounces from a certain level.
If necessary, enter the purchase price. Then the amount of the asset that the trader intends to purchase is indicated. Then the order is sent to the trading glass, which is located on the right side of the screen. When these actions are completed, you will have to wait until a buyer or seller is found if a limit order was selected.
In General, the trading algorithm on the Huobi exchange can be called standard. Therefore, users with minimal experience in trading will find their way quickly. The last token is a full analog of the us dollar. If you want, you can also trade via the mobile app. With its help, the client will be able to monitor the status of open orders, as well as track the latest news regarding cryptocurrencies and view statistics on digital assets.
Margin trading. Borrowed funds are available both for long-term trading to increase the asset price and in short to reduce the cost. In the case of margin trading, you need to understand that this is a pendulum that makes an equally strong movement both in the direction of profit and in the direction of loss of funds. Borrowed funds allow you to buy more cryptocurrencies for trading.
But if there is an error in the forecasts, the losses will also be significant. If you work illiterate with the market, using the margin, you can quickly lose a significant amount. When closing an order in plus, the trader returns the money borrowed to the exchange, and keeps the net earnings for himself. Technical support. If you encounter any problems while trading on the Huobi exchange, users can contact the support service.
But there is one difficulty: the specialists of this service conduct a dialogue only in English or Chinese. To contact the technical support staff, you can:. According to the reviews of exchange users, technical support works well — employees are really eager to help, communicate tactfully, and respond quickly.
Advantages of the Huobi platform. There are a lot of advantages to working on the Huobi exchange. These include the following features:. Huobi exchange is one of the top crypto platforms. In terms of total trading volume, it is in the top 5 in the world ranking. Platform developers are constantly testing new technologies and adding modern trading tools. A large selection of assets is available to the trader — almost digital assets.
There are new cryptocurrencies with good growth prospects. You can start trading without verification. A convenient platform with a large selection of functions.
Independent and professional system for assessment of blockchain assets. Margin trading is available.
An increased level of security through the use of a distributed system of protection from DDoS-attacks. Referral system. Availability of loyalty programs that allow you to reduce commissions. Convenient and user-friendly interface. Availability of mobile apps with full functionality on all popular platforms.
0コメント