Bulk limit order

The endpoint creates bulk limit trading orders.

Limit: From 1 to 20 orders per request.

• RPI orders do not appear in public order book feeds (depth, bookTicker). RPI orders are visible only in private active orders and in the exchange UI order book (web/mobile).
• RPI orders are post-only by design and cannot be used with the IOC flag. The API returns error code 37 when both rpi=true and ioc=true are used.

Error Codes

• 30 - default validation error code
• 31 - market validation failed
• 32 - amount validation failed
• 33 - price validation failed
• 36 - client_order_id validation failed
• 37 - ioc=true cannot be used with postOnly=true or rpi=true

Errors

{
  "code": 30,
  "message": "Validation failed",
  "errors": {
    "orders": ["The orders must be an array."]
  }
}

Individual order errors (in multiply response):

{
  "code": 30,
  "message": "Validation failed",
  "errors": {
    "amount": ["Amount field is required."],
    "market": ["Market field is required."],
    "price": ["Price field is required."],
    "side": ["Side field is required."]
  }
}

{
  "code": 30,
  "message": "Validation failed",
  "errors": {
    "side": ["Side field should contain only 'buy' or 'sell' values."]
  }
}

{
  "code": 32,
  "message": "Validation failed",
  "errors": {
    "amount": ["Amount field should be numeric string or number."]
  }
}

{
  "code": 33,
  "message": "Validation failed",
  "errors": {
    "price": ["Price field should be numeric string or number."]
  }
}

POST /api/v4/order/bulk

Bulk limit order

cURL

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,
      "client_order_id": "",
      "rpi": true
    },
    {
      "side": "sell",
      "amount": "0.0001",
      "price": "41000",
      "market": "BTC_USDT",
      "postOnly": false,
      "ioc": false,
      "client_order_id": "",
      "rpi": true
    },
    {
      "side": "sell",
      "amount": "0.02",
      "price": "41000",
      "market": "BTC_USDT",
      "postOnly": false,
      "ioc": false,
      "client_order_id": "",
      "rpi": true
    }
  ]
}
'

200

[
  {
    "result": {
      "order_id": 4180284841,
      "client_order_id": "order1987111",
      "market": "BTC_USDT",
      "side": "buy",
      "type": "limit",
      "timestamp": 1595792396.165973,
      "deal_money": "0",
      "deal_stock": "0",
      "amount": "0.01",
      "left": "0.001",
      "deal_fee": "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

Show child attributes

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

200

application/json

Orders created

result · object

Show child attributes

error · object

Show child attributes