Dear API user,
Since the effective day of this notification, Huobi Global will support a new endpoint (POST /v1/order/batch-orders) in REST API which allows user to place orders in batch mode. And also, the existing endpoint (POST /v1/order/orders/batchcancel) for batch-cancelling orders will allow user to cancel orders in batch mode based on client order IDs.
POST /v1/order/batch-orders
Request Parameters
Field Name | Data Type | Mandatory | Description |
[{ price | string | false | Order price (not required for market order) |
amount | string | true | Order size |
type | string | true | Order type, including: buy-market, sell-market, buy-limit, sell-limit, buy-ioc, sell-ioc, buy-limit-maker, sell-limit-maker, buy-stop-limit, sell-stop-limit |
client-order-id | string | false | Client order ID (maximum 64-character) |
stop-price | string | false | Trigger price (for stop limit order only) |
operator | string | false | Operation character (for stop limit order only. gte – greater than and equal (>=), lte – less than and equal (<=)) |
symbol | string | true | Trading symbol |
account-id }] | string | true | Account ID |
Example:
[
{
"account-id": "123456",
"price": "7801",
"amount": "0.001",
"symbol": "btcusdt",
"type": "sell-limit",
"client-order-id": "c1"
},
{
"account-id": "123456",
"price": "7802",
"amount": "0.001",
"symbol": "btcusdt",
"type": "sell-limit",
"client-order-id": "d2"
}
]
Response
Field Name | Data Type | Mandatory | Description |
status | string | true | Status code |
err-code | string | false | Error code |
err-msg | string | false | Error message |
data | object | true | In same order of the request |
[{ order-id | long | false | Order ID (if rejected, this field is unavailable) |
client-order-id | string | false | Client order ID (if any) |
err-code | string | false | Error code for rejected order only |
err-msg }] | string | false | Error message for rejected order only |
Example:
{
"status": "ok",
"data": [
{
"order-id": 61713400772,
"client-order-id": "c1"
},
{
"order-id": 61713400940,
"client-order-id": "d2"
}
]
}
POST /v1/order/orders/batchcancel
Request Parameters (Maximum number of orders to be cancelled in one batch request is 50)
Field Name | Data Type | Mandatory | Description |
order-ids | string[] | false | Order ID list (Either order-ids or client-order-ids can be filled in one batch request. No more than 50 orders allowed.) |
client-order-ids | string[] | false | Client Order ID list (Either order-ids or client-order-ids can be filled in one batch request. No more than 50 orders allowed.) |
Example:
{
"client-order-ids": [
"5983466", "5722939", "5721027","5719487"
]
}
Response
Field Name | Data Type | Mandatory | Description |
status | string | true | Status code |
err-code | string | false | Error code |
err-msg |
string |
false |
Error message |
data |
object |
true |
|
{ success |
string[] |
false |
Cancelled order list (Can be order ID list or client order list, upon the request.) |
failed } |
string[] |
false |
Failed order list (Can be order ID list or client order list, upon the request.) |
Failed order list:
Field Name | Data Type | Mandatory | Description |
[{ order-id | long | false | Order ID (Return order ID if the request is based order-id.) |
client-order-id | string | false | Client order ID (Return client order ID if the request is based on client-order-id) |
err-code | string | false | Error code (Only applicable for rejected orders) |
err-msg | string | false | Error message (Only applicable for rejected orders) |
order-state }] | string | false | Current order state (if any) |
Example:
{
"status": "ok",
"data": {
"success": [
"5983466"
],
"failed": [
{
"err-msg": "Incorrect order state",
"order-id":"",
"client-order-id": "5722939",
"err-code": "order-orderstate-error"
},
{
"err-msg": "Incorrect order state",
"order-id":"",
"client-order-id": "5721027",
"err-code": "order-orderstate-error"
},
{
"err-msg": "Incorrect order state",
"order-id":"",
"client-order-id": "5719487",
"err-code": "order-orderstate-error"
}
]
}
}
Effective Date: December 27, 2019 (GMT+8)
All the changes will be updated on https://huobiapi.github.io/docs/spot/v1/en/
Huobi Global
December 29, 2019
Comments
0 comments
Article is closed for comments.