Order failed, exceeded the holding limit of this currency, Order cancellation failed, this order is already cancelled, Order cancellation failed, this order is already executed, Order cancellation failed, this order does not exist, Order cancellation failed, the system is busy now, please try again later, Login is required for creating an API key. Parent user cancels a previously created withdrawal request by its transfer id.
Next query "start-time" (in response of "direct" = prev), Next query "end-time" (in response of "direct" = next). Add clarification on the value range for start-date in documents, Correct the documents error. Search by orderOrigTime
Rate Limit (NEW): 100times/2s. - The topic will send creation update for taker's order before it being filled. Rate Limit (NEW): 1 time /5s, Below is the error code and the description returend by ETP APIs, "https://status.huobigroup.com/api/v2/summary.json", "We will be undergoing scheduled maintenance during this time. The API request may be tampered during internet, therefore all private API must be signed by your API Key (Secrete Key). Below is the error code and description for Isolated margin loan APIs, Below is the error code and description for Cross margin loan APIs (including general margin).
Error description of withdrawal failure, only returned when the type is "withdraw" and the state is "reject", "wallet-reject" and "failed".
The trading symbol to trade, e.g. Note:
The first three fields indicate the general status, the business data is is under data field. The role in the transaction: taker or maker. endTime valid range: Unlimited Encode signature by URL encoding and append in the URL with parameter name "Signature".
By comparing with the existing stop limit order, the newly introduced conditional order does have following major differences: 1) Although the newly introduced conditional order is also triggered by stop price, before it being triggered, the Exchange will not lock order margin for this order. Expand the limit of API key creation per user; Expand the limit of IP binding to each API key. GET\n To unsubscribe, you need to send below message, { While repaying the loan, loan interest will be paid first if there is no appointed transactId. the close time of call auction phase 1, total milliseconds since January 1, 1970 0:0:0:00ms UTC, not mandatory.
Signature: The value after signed, it is guarantee the signature is valid and the request is not be tempered. The small amount will exceed the deposit-min-amount and then be credited 2. Via this endpoint parent user is able to query account list of sub user by specifying a UID. the number of milliseconds that have elapsed since 00:00:00 UTC on 1 January 1970. API Key PermissionRead Among them, the status of the completed order includes partially canceled, canceled, and fully executed.
AUser has to include the address into the pre-defined address table on Huobi official website before withdrawing through API.
No parameter is available for this endpoint. Account abnormality, failed to transferPlease try again later. If the order price is less than the lowest selling price in the market, the order will be accepted. When type=buy, exchangeAmount is the HUSD amount the client need to pay; When type=sell, exchangeAmount is the HUSD amount client can gain. All trade balance can be transferred out if transfer-out-available balance is -1, Actual interest rate post deduction (if deduction is inapplicable or disabled, return basic daily interest rate), created, accrual (loaned), cleared (paid), invalid, If not specified, returns loan order list of current logged in user, If not specified, returns account balance of current logged in user, account state: working, fl-sys, fl-end, fl-negative, account type: trade, frozen, loan, interest, transfer-out-available, loan-available, account ID (default value: all accounts), borrowing/lending currency (default value: all currencies), start time (unix time in millisecond; range: [(endTime x D), endTime]; default value: (endTime x D), end time (unix time in millisecondrange: [(present time y D), present time]; default value: present time), sort direction (value: asc, desc; default value: desc), max return items per page (range: [1-100]; default value: 50), search ID from the start (only available when searching for the next page), repayment transaction time (unix time in millisecond), ID list of original loan transactions (arranged by order of repaymen time), search the start ID in the next page (return only when there is data in the next page), account-transfer-balance-insufficient-error, Request exceeds number limit, try again later, The registered country is forbidden to apply for margin, Your IP is not allowed, require ID verification, Margin account state is abnormal (liquidation), Account is explosion and transfer is prohibited, Operation is not allowed for current user, Start date cannot be greater than end date, Sub account for this currency does not exist, Network error for User Center, try again later, All supported trading symbol, e.g. Parameters: Each API Method has a group of parameters, you can refer to detailed document for each of them.
'order-id': the previously returned order id when loan order was created. UID (not linked to any rebate program in any accounts), Screenshot of trading volume in other transaction platform (such as trading volume within 30 days, or VIP status), A brief description of your market-making strategy, Contact customer support from Help Center or send email to. API Key PermissionRead
It may be empty as some API doesn't have data stream, The UTC timestamp when API respond, the unit is millisecond, basic information of huobi spot status page.
2.Transfer asset from sub users spot account to another sub users spot account that is under the same parent user; Features now supported for sub user include: Other errors, please refer to err-msg list below for details. - Stop limit order's type is no longer as "buy-stop-limit" or "sell-stop-limit", but changing to "buy-limit" or "sell-limit". API Key Permission: Read Please contact customer service.
It is suggested to use AWS Japan to access API for lower latency. The number of crypto asset transfered in its minimum unit, The state of this transfer (see below for details).
The valid value range of trailing rate is between 0.1% and 5%. 7.The message body doesn't need URL encoded if you are using WebSocket for authentication.
For completed orders, clientOrderId will be valid for 2 hours since the order creation (it is still valid for 8 hours concerning other orders).
Rate Limit (NEW): 2times/2s. If this is a "fast withdraw", then it is not on-chain transfer, and this value is empty.
(Trailing stop order only supports market order type.)
This topic sends the latest market stats with 24h summary. Group ID of termless points is 0. This endpoint transfers specific asset from spot trading account to cross margin account. Please check whether you follow below rules: 1.The parameter in signature text should be ordered by ASCII, for example below is the original parameters: 2.The signature text should be URL encoded, for example. They won't exist at the same time. buy-market, sell-market, buy-limit, sell-limit, buy-ioc, sell-ioc, buy-stop-limit, sell-stop-limit, buy-limit-fok, sell-limit-fok, buy-stop-limit-fok, sell-stop-limit-fok, The number of cancel request sent successfully, the next order id that can be cancelled, -1 indicates no open orders, The order ids to cancel (Either order-ids or client-order-ids can be filled in one batch request). Sub-account doesn't own the permissions to transfer in. Due to the Nginx setting, the request path is case sensitive, please follow the path definition in document. "signature": "4F65x5A2bLyMWVQj3Aqp+B4w+ivaA7n5Oi2SuYtCJ9o="
transactFeeRateWithdraw : The withdraw fee rate per request (only applicable when withdrawFeeType=ratio). 2.Transfer asset from sub users spot account to parent users spot account; Other transfer functions will be gradually launched later, please take note on API announcement in near future. }, {
Currency of transaction fee or transaction fee rebate (transaction fee of buy order is based on base currency, transaction fee of sell order is based on quote currency; transaction fee rebate of buy order is based on quote currency, transaction fee rebate of sell order is based on base currency), the role in the transaction: taker or maker, deduction amount (unit: in ht or hbpoint). } The request method should be "GET", to URL "/ws/v2". See the table below: If leaving the field empty, default target chain is ERC20, or you can explicitly set the chain to usdterc20. 3) As database record ID, "nextId" and "fromId" are for recurring query purpose and the ID itself does not have any business implication. This endpoint transfers specific asset from cross margin account to spot trading account. If filled with 1, it implicates to subscribe both trade and cancellation events.
Pre-signed text (mandatory for authentication issue), 1. Please subscribe to our announcements so that you can get the latest updates. You can't transfer in for the time being. The small amount will not be accumulated and will never be credited to the account. See "new version rate limit rule" sector of this document. not mandatory. If user willing to receive order updates in exact same sequence with the original happening, it is recommended to subscribe order update channel orders#${symbol}.
", "Minimum withdrawal amount: 160298 NFT(HECO). Only when latest market price breaks stop price, and continues to go up (or down), and then reverts back for a certain percentage which exceeding the pre-defined "trailing rate", this order can be triggered.
Enumeration values: "ca_1", "ca_2", not mandatory. 1) Be aware of that, some items within the query window were not returned due to the page size limitation.
Please check the transaction record to confirm the repayment status.
When 'from' is not specified, the default value would be 1 if 'direct' is 'prev' with the response in ascending order, the default value would be the ID of latest record if 'direct' is 'next' with the response in descending order. The receipt of transactId doesnt implicate the success of creation. For GET request, all the parameters must be signed. Via this endpoint parent user is able to query a full list of sub user's UID as well as their status. Each user could create up to 200 sub users, and each sub user could create 20 API Keys, each API key can be granted with 2 permissions: read and trade. INVALID, all(PRO and HADAX), pro, hadax, support sites. Problem description
Conditional order can be only placed via this endpoint instead of any endpoint in "Trading" section. "params": { This endpoint places an order to apply for a margin loan.
Note 3: You can't transfer out for the time being. The query window can be within the last 180 days, which means, by adjusting "startTime" & "endTime" accordingly, the records in last 180 days are queriable.
After you subscribe, the button will be changed to "Following". - Stop limit order's type is no longer as "buy-stop-limit" or "sell-stop-limit", but changing to "buy-limit" or "sell-limit".
This feature is not open to users in your country. please refer to note 3.
But 5-level/20-level incremental channel wont disseminate any update in such a case. Enumeration values: "ca_1", "ca_2". GET request: All parameters are included in URL, and do not carry body(content-length>0), in otherwise will return 403 error code.
Parent user is able to set tradable market for a batch of sub users through this endpoint. To request pull style data, you send below message, { 5) Once received a new price level from incremental message, that price level should be inserted into appropriate position of existing MBP book; Search by orderOrigTime By default, the asset transfer from sub users spot account to parent users spot account is allowed. By default, sub users trading permission in spot market is activated.
2) In order to get these items from Huobi server, adopt the "nextId" as "fromId" and submit another request, with other request parameters no change. 1Not specifying "mode": If deduction is inapplicable or disabled, return basic fee rate.
It is suggested not to subscribe too many topics in a single websocket connection, it may generate more notifications and cause network latency and disconnection.
Sub user management APIs provide sub user account management (creation, query, permission, transfer), sub user API key management (creation, update, query, deletion), sub user address (deposit, withdraw) query and balance query.
Fill the value according to required JSON schema, The value in JSON doesn't require URL encode, margin: Isolated margin account, the detailed currency type is defined in, super-margin / cross-margin: Cross-margin account, Order interface is limited by API Key: no more than 10 times within 1 sec, Market data interface is limited by IP: no more than 10 times within 1 sec. 3) "nextId" and "fromId" are for recurring query purpose and the ID itself does not have any business implication. 2. The maximum window size is 10-day. It is very welcome for market maker who has good market making strategy and large trading volume.
Raw JSON request (if any) For example, if a taker's order got matched with 3 maker's orders at the same time, it generates 3 trade IDs but only one match ID.
The query window can be shifted within 120 days.
Parent user could transfer point between parent user and sub user in two ways. It is strongly suggested to bind your IP with your API Key to ensure that your API Key can only be used in your machine. (to retrieve candlesticks for ETP NAV, symbol = ETP trading symbol + suffix 'nav'for example: btc3lusdtnav), UNIX epoch timestamp in second as response id, Aggregated trading volume during the interval (in base currency), Aggregated trading value during the interval (in quote currency), Data belonged channelFormatmarket.$symbol.ticker, Data belonged channelFormatmarket.$symbol.depth.$type, Number of price levels (Valid value: 5,20,150,400).
The account-id defines the identity for different account type under one user, it can be retrieved from API /v1/account/accounts , where the account-type is the account types. If your Huobi Spot account or Contract account has at least 10 BTC, you can send your email to: If you have any other questions on API, you can contact us by below ways: If you encounter API errors, please use below template in your feedback: 1. ), error code. Notes:
"timestamp": "2019-09-01T18:16:16", The request Method (GET or POST, WebSocket use GET), append line break "\n", 2.
JAVA signature example | C++ signature example | Python signature example. Start date is a future date; or start date is earlier than 61 days ago. Only when this conditional order being successfully triggered, its order margin will be locked. Callable by sub user.
"symbol": "btcusdt", Problem description: API authentication error Redemption failed due to no availablity, Order cancelled. The maximum size of the query window is 1 hour. It is full-duplex between client and server.
2017-05-11T16:22:06. 'withdraw-id': the id returned when previously created a withdraw request. only those closed orders (state = canceled) created within 8 hours can be returned. !>_
UID, Account Id and Order Id (if related with account and order) You can't transfer out for the time being. The maximum query window size set by "startTime" & "endTime" is 10-day, which mean a maximum of 10-day records are queriable per request.
1) Subscribe to incremental updates and start to cache them; While disseminating the current static value of individual accounts, inside the message, field value of "changeType" and "changeTime" is null.
2. This endpoint returns the balance of the margin loan account.
Abnormal contracts status. This topic sends the latest market by price order book in snapshot mode at 1-second interval.
Below is the content for Spot API document. You can click Here to view the announcements. Amount of HUSD to exchange in or out.
- Order creation (eventType=creation) This endpoint returns the balance of an account specified by account id.
This Explorer encapsulates a shared API Key, and will show the signature calcuation steps and request parameters when it invokes API. Both account-id and symbol are required, The size parameter value range changes from [1-1000] to [1-2000], Added buy-limit-maker and sell-limit-maker order types, Transfer Asset from Spot Trading Account to Cross Margin Account, Transfer Asset from Cross Margin Account to Spot Trading Account, Get the Balance of the Margin Loan Account, Common interface, including currency, currency pair, timestamp, etc, Market data interface, including trading, depth, quotation, etc, Account interface, including account information, sub-user ,etc, Order interface, including order creation, cancellation, query, etc, Margin interface, including debit, payment, query, etc, Cross margin interface, including debit, payment, query, etc, The data stream.