Skip to main content
POST
/
api
/
v4
/
trade-account
/
order
/
history
Query executed orders
curl --request POST \
  --url https://whitebit.com/api/v4/trade-account/order/history \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --header 'X-TXC-PAYLOAD: <api-key>' \
  --header 'X-TXC-SIGNATURE: <api-key>' \
  --data '
{
  "market": "BTC_USDT",
  "offset": 0,
  "limit": 50,
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
{
  "BTC_USDT": [
    {
      "amount": "0.0009",
      "price": "40000",
      "type": "limit",
      "id": 4986126152,
      "client_order_id": "customId11",
      "side": "sell",
      "ctime": 1597486960.311311,
      "takerFee": "0.001",
      "ftime": 1597486960.311332,
      "makerFee": "0.001",
      "deal_fee": "0.041258268",
      "deal_stock": "0.0009",
      "deal_money": "41.258268",
      "postOnly": false,
      "ioc": false,
      "status": "CANCELED",
      "feeAsset": "USDT",
      "stp": "no",
      "rpi": false,
      "reduceOnly": false
    }
  ]
}
The reduceOnly response field documented on this page is coming soon. The documentation is published in advance for integration planning. The field is not yet returned by the API. See Reduce-only orders for details.

Authorizations

​
X-TXC-APIKEY
string
header
required

The public WhiteBIT API key.

​
X-TXC-PAYLOAD
string
header
required

Base64-encoded JSON request body.

​
X-TXC-SIGNATURE
string
header
required

HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).

Body

application/json
​
market
string

Trading pair to filter by. Format: BASE_QUOTE (e.g., BTC_USDT). Omit to retrieve orders across all markets.

Example:

"BTC_USDT"

​
offset
integer
default:0

Number of records to skip. Default: 0.

Required range: x >= 0
Example:

0

​
limit
integer
default:50

Maximum number of records to return. Default: 50. Minimum: 1. Maximum: 500.

Required range: 1 <= x <= 500
Example:

50

​
request
string
Example:

"{{request}}"

​
nonce
string
Example:

"{{nonce}}"

Response

Successful response - returns order history grouped by market. Empty response if order is not yours.

Object with market names as keys, each containing an array of orders

​
{key}
object[]