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",
"startDate": 1697000000,
"endDate": 1699000000,
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": "{{nonce}}"
}
'import requests
url = "https://whitebit.com/api/v4/trade-account/order/history"
payload = {
"market": "BTC_USDT",
"startDate": 1697000000,
"endDate": 1699000000,
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": "{{nonce}}"
}
headers = {
"X-TXC-APIKEY": "<api-key>",
"X-TXC-PAYLOAD": "<api-key>",
"X-TXC-SIGNATURE": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-TXC-APIKEY': '<api-key>',
'X-TXC-PAYLOAD': '<api-key>',
'X-TXC-SIGNATURE': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
market: 'BTC_USDT',
startDate: 1697000000,
endDate: 1699000000,
offset: 0,
limit: 50,
request: '{{request}}',
nonce: '{{nonce}}'
})
};
fetch('https://whitebit.com/api/v4/trade-account/order/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://whitebit.com/api/v4/trade-account/order/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'market' => 'BTC_USDT',
'startDate' => 1697000000,
'endDate' => 1699000000,
'offset' => 0,
'limit' => 50,
'request' => '{{request}}',
'nonce' => '{{nonce}}'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-TXC-APIKEY: <api-key>",
"X-TXC-PAYLOAD: <api-key>",
"X-TXC-SIGNATURE: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://whitebit.com/api/v4/trade-account/order/history"
payload := strings.NewReader("{\n \"market\": \"BTC_USDT\",\n \"startDate\": 1697000000,\n \"endDate\": 1699000000,\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-TXC-APIKEY", "<api-key>")
req.Header.Add("X-TXC-PAYLOAD", "<api-key>")
req.Header.Add("X-TXC-SIGNATURE", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://whitebit.com/api/v4/trade-account/order/history")
.header("X-TXC-APIKEY", "<api-key>")
.header("X-TXC-PAYLOAD", "<api-key>")
.header("X-TXC-SIGNATURE", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"market\": \"BTC_USDT\",\n \"startDate\": 1697000000,\n \"endDate\": 1699000000,\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/trade-account/order/history")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-TXC-APIKEY"] = '<api-key>'
request["X-TXC-PAYLOAD"] = '<api-key>'
request["X-TXC-SIGNATURE"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"market\": \"BTC_USDT\",\n \"startDate\": 1697000000,\n \"endDate\": 1699000000,\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}"
response = http.request(request)
puts response.read_body{
"BTC_USDT": [
{
"amount": "0.0009",
"price": "40000",
"type": "limit",
"id": 4986126152,
"clientOrderId": "customId11",
"side": "sell",
"ctime": 1597486960.311311,
"takerFee": "0.001",
"ftime": 1597486960.311332,
"makerFee": "0.001",
"dealFee": "0.041258268",
"dealStock": "0.0009",
"dealMoney": "41.258268",
"postOnly": false,
"ioc": false,
"status": "CANCELED",
"feeAsset": "USDT",
"stp": "no",
"rpi": false,
"reduceOnly": false
}
]
}{
"code": 30,
"message": "Validation failed",
"errors": {}
}{
"code": 30,
"message": "Validation failed",
"errors": {}
}Query executed orders
Query recently executed spot orders with optional filtering by market via the WhiteBIT V4 API.
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",
"startDate": 1697000000,
"endDate": 1699000000,
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": "{{nonce}}"
}
'import requests
url = "https://whitebit.com/api/v4/trade-account/order/history"
payload = {
"market": "BTC_USDT",
"startDate": 1697000000,
"endDate": 1699000000,
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": "{{nonce}}"
}
headers = {
"X-TXC-APIKEY": "<api-key>",
"X-TXC-PAYLOAD": "<api-key>",
"X-TXC-SIGNATURE": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-TXC-APIKEY': '<api-key>',
'X-TXC-PAYLOAD': '<api-key>',
'X-TXC-SIGNATURE': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
market: 'BTC_USDT',
startDate: 1697000000,
endDate: 1699000000,
offset: 0,
limit: 50,
request: '{{request}}',
nonce: '{{nonce}}'
})
};
fetch('https://whitebit.com/api/v4/trade-account/order/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://whitebit.com/api/v4/trade-account/order/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'market' => 'BTC_USDT',
'startDate' => 1697000000,
'endDate' => 1699000000,
'offset' => 0,
'limit' => 50,
'request' => '{{request}}',
'nonce' => '{{nonce}}'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-TXC-APIKEY: <api-key>",
"X-TXC-PAYLOAD: <api-key>",
"X-TXC-SIGNATURE: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://whitebit.com/api/v4/trade-account/order/history"
payload := strings.NewReader("{\n \"market\": \"BTC_USDT\",\n \"startDate\": 1697000000,\n \"endDate\": 1699000000,\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-TXC-APIKEY", "<api-key>")
req.Header.Add("X-TXC-PAYLOAD", "<api-key>")
req.Header.Add("X-TXC-SIGNATURE", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://whitebit.com/api/v4/trade-account/order/history")
.header("X-TXC-APIKEY", "<api-key>")
.header("X-TXC-PAYLOAD", "<api-key>")
.header("X-TXC-SIGNATURE", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"market\": \"BTC_USDT\",\n \"startDate\": 1697000000,\n \"endDate\": 1699000000,\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/trade-account/order/history")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-TXC-APIKEY"] = '<api-key>'
request["X-TXC-PAYLOAD"] = '<api-key>'
request["X-TXC-SIGNATURE"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"market\": \"BTC_USDT\",\n \"startDate\": 1697000000,\n \"endDate\": 1699000000,\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}"
response = http.request(request)
puts response.read_body{
"BTC_USDT": [
{
"amount": "0.0009",
"price": "40000",
"type": "limit",
"id": 4986126152,
"clientOrderId": "customId11",
"side": "sell",
"ctime": 1597486960.311311,
"takerFee": "0.001",
"ftime": 1597486960.311332,
"makerFee": "0.001",
"dealFee": "0.041258268",
"dealStock": "0.0009",
"dealMoney": "41.258268",
"postOnly": false,
"ioc": false,
"status": "CANCELED",
"feeAsset": "USDT",
"stp": "no",
"rpi": false,
"reduceOnly": false
}
]
}{
"code": 30,
"message": "Validation failed",
"errors": {}
}{
"code": 30,
"message": "Validation failed",
"errors": {}
}Authorizations
The public WhiteBIT API key.
Base64-encoded JSON request body.
HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).
Body
Trading pair to filter by. Format: BASE_QUOTE (e.g., BTC_USDT). Omit to retrieve orders across all markets.
"BTC_USDT"
Start of the query window as a Unix timestamp in seconds. Default: now - 1 month. The earliest reachable date is 6 months ago (00:00 UTC) — requests with an older startDate are rejected with a validation error.
1697000000
End of the query window as a Unix timestamp in seconds. Default: now. Values greater than the current time are silently clamped to now. The maximum span between startDate and endDate is 31 days.
1699000000
Number of records to skip. Default: 0.
x >= 00
Maximum number of records to return. Default: 50. Minimum: 1. Maximum: 500.
1 <= x <= 50050
"{{request}}"
"{{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
Show child attributes
Show child attributes
Was this page helpful?