Create batch orders, this endpoint support to create up to 10 limit or market orders at a time.
After initiating an order, you can utilize the WebSocket streams for both open orders and order history to continuously receive updated information about your orders in real-time.
Rate Limit: Allow 90 requests per minute per IP & UID.
POST /orders/batch
Headers:
You can find how to create payload and signature from authentication document.
| Header | Path | Query | Type | Required | Description | Default | Range | Example |
|---|---|---|---|---|---|---|---|---|
| X-BITOPRO-APIKEY | string | Yes | API Key | |||||
| X-BITOPRO-PAYLOAD | string | Yes | Payload | |||||
| X-BITOPRO-SIGNATURE | string | Yes | Signature | |||||
Parameters:
| Field | Type | Required | Description | Default | Range | Example |
|---|---|---|---|---|---|---|
| pair | string | Yes | The trading pair in format {BASE}_{QUOTE}, Please follow the link to check the pair list. | bito_eth | ||
| action | string | Yes | The action type of the order, should only be BUY or SELL. |
BUY or SELL |
BUY |
|
| amount | string | Yes | The base amount of the order for the trading pair. However, when executing a market buy order, this field represents the order's quote value. Please check this doc for limitation. | > 0 | 100 | |
| price | string | Yes | The price of the order for the trading pair. | > 0 | 10 | |
| timestamp | int64 | Yes | The client timestamp in millisecond. | 1504262258000 | ||
| type | string | Yes | The order type, should only be LIMIT, MARKET. |
|||
| timeInForce | string | No | Time in force condition for orders. If type is MARKET, this will always be GTC. |
GTC |
GTC, POST_ONLY |
POST_ONLY |
| clientId | uint64 | No | This information help users distinguish their orders. | 1 ~ 2147483647 | 12345 |
Request Example:
[
{
pair: "BTC_TWD",
action: "BUY",
type: "LIMIT",
price: "210000",
amount: "1",
timestamp: 1504262258000,
timeInForce: "GTC",
clientId: 123
},
{
pair: "BTC_TWD",
action: "SELL",
type: "MARKET",
amount: "2",
timestamp: 1504262258000
}
]Response Example:
{
"data": [{
"orderId": 1234567890,
"action": "BUY",
"price": "210000",
"amount": "1",
"timestamp": 1504262258000,
"timeInForce": "GTC",
"clientId": 123
}, {
"orderId": 3234567891,
"action": "SELL",
"amount": "2",
"timestamp": 1504262258000,
"timeInForce": "GTC"
}]
}