Skip to main content
POST
/
api
/
v4
/
trade-account
/
executed-history
Query executed order history
curl --request POST \
  --url https://whitebit.com/api/v4/trade-account/executed-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",
  "client_order_id": "customId11",
  "startDate": 1593233939,
  "endDate": 1593233939,
  "offset": 0,
  "limit": 50,
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
[
  {
    "id": 123,
    "client_order_id": "<string>",
    "time": 123,
    "side": "buy",
    "role": 123,
    "amount": "<string>",
    "price": "<string>",
    "deal": "<string>",
    "fee": "<string>",
    "order_id": 123,
    "feeAsset": "<string>"
  }
]

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

Requested market. Example: BTC_USDT

Example:

"BTC_USDT"

​
client_order_id
string

Filter by custom order identifier

Example:

"customId11"

​
startDate
integer

Start date in Unix-time format

Example:

1593233939

​
endDate
integer

End date in Unix-time format

Example:

1593233939

​
offset
integer
default:0

Starting line index (OFFSET). Default: 0, Min: 0

Example:

0

​
limit
integer
default:50

LIMIT is a special clause used to limit records a particular query can return. Default: 50, Min: 1, Max: 500

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

50

​
request
string
Example:

"{{request}}"

​
nonce
string
Example:

"{{nonce}}"

Response

Executed order history. Response shape depends on whether the market filter is provided: with market filter returns a flat array; without market filter returns an object keyed by market name.

​
id
integer

Deal ID

​
client_order_id
string

Custom order ID (empty if not specified)

​
time
number

Timestamp of executed deal

​
side
enum<string>
Available options:
buy,
sell
​
role
integer

1 - maker, 2 - taker

​
amount
string

Amount in stock (quote) currency. Always expressed in the stock/asset side of the market pair regardless of order direction.

​
price
string
​
deal
string

Amount in money currency

​
fee
string

Paid fee

​
order_id
integer
​
feeAsset
string