Skip to main content
POST
/
api
/
v4
/
order
/
bulk
Bulk limit order
curl --request POST \
  --url https://whitebit.com/api/v4/order/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "orders": [
    {
      "side": "buy",
      "amount": "0.02",
      "price": "40000",
      "market": "BTC_USDT",
      "postOnly": false,
      "ioc": false,
      "clientOrderId": "",
      "rpi": true
    },
    {
      "side": "sell",
      "amount": "0.0001",
      "price": "41000",
      "market": "BTC_USDT",
      "postOnly": false,
      "ioc": false,
      "clientOrderId": "",
      "rpi": true
    },
    {
      "side": "sell",
      "amount": "0.02",
      "price": "41000",
      "market": "BTC_USDT",
      "postOnly": false,
      "ioc": false,
      "clientOrderId": "",
      "rpi": true
    }
  ]
}
'
[
  {
    "result": {
      "orderId": 4180284841,
      "clientOrderId": "order1987111",
      "market": "BTC_USDT",
      "side": "buy",
      "type": "limit",
      "timestamp": 1595792396.165973,
      "dealMoney": "0",
      "dealStock": "0",
      "amount": "0.01",
      "left": "0.001",
      "dealFee": "0",
      "price": "40000",
      "postOnly": false,
      "ioc": false,
      "status": "FILLED",
      "stp": "no",
      "positionSide": "LONG",
      "rpi": true
    },
    "error": {
      "code": 30,
      "message": "Validation failed",
      "errors": {}
    }
  }
]

Authorizations

X-TXC-APIKEY
string
header
required

API Key authentication for private endpoints.

Required headers:

  • X-TXC-APIKEY: API key
  • X-TXC-PAYLOAD: Base64 encoded JSON payload
  • X-TXC-SIGNATURE: HMAC SHA512 signature

Body

application/json
orders
object[]

Array of limit orders

stopOnFail
boolean
default:false

Controls how the bulk order processor handles failures.

When true: Processing stops at the first order that fails validation or execution. Only orders up to (but not including) the failed order are processed.

When false (default): All orders in the bulk request are processed regardless of individual failures. Each order result is returned in the response array.

Example:

true

request
string
Example:

"{{request}}"

nonce
string
Example:

"{{nonce}}"

Response

Orders created

result
object
error
object