curl --request POST \
--url https://whitebit.com/api/v4/orders \
--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",
"orderId": 3134995325,
"clientOrderId": "customId11",
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": 1594297865000
}
'import requests
url = "https://whitebit.com/api/v4/orders"
payload = {
"market": "BTC_USDT",
"orderId": 3134995325,
"clientOrderId": "customId11",
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": 1594297865000
}
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',
orderId: 3134995325,
clientOrderId: 'customId11',
offset: 0,
limit: 50,
request: '{{request}}',
nonce: 1594297865000
})
};
fetch('https://whitebit.com/api/v4/orders', 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/orders",
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',
'orderId' => 3134995325,
'clientOrderId' => 'customId11',
'offset' => 0,
'limit' => 50,
'request' => '{{request}}',
'nonce' => 1594297865000
]),
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/orders"
payload := strings.NewReader("{\n \"market\": \"BTC_USDT\",\n \"orderId\": 3134995325,\n \"clientOrderId\": \"customId11\",\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\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/orders")
.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 \"orderId\": 3134995325,\n \"clientOrderId\": \"customId11\",\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/orders")
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 \"orderId\": 3134995325,\n \"clientOrderId\": \"customId11\",\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}"
response = http.request(request)
puts response.read_bodyQuery unexecuted orders
The endpoint retrieves active orders (orders not yet executed) across spot, margin, and futures markets. The response includes limit, stop-limit, and stop-market orders that remain open on the order book. Use the market parameter to filter by trading pair, or omit the parameter to retrieve orders across all markets. The endpoint supports pagination with limit and offset parameters.
Rate limit: 12000 requests/10 sec.
Search across all markets is available only if clientOrderId and orderId are not provided.
This endpoint supports pagination. Use limit (default: 50, max: 100) and offset (default: 0, max: 4294967295) to page through results. The response does not include a total field — detect the last page when fewer than limit orders are returned. An empty array means you have paged past the end; receiving exactly limit orders does not guarantee that another page exists.
curl --request POST \
--url https://whitebit.com/api/v4/orders \
--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",
"orderId": 3134995325,
"clientOrderId": "customId11",
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": 1594297865000
}
'import requests
url = "https://whitebit.com/api/v4/orders"
payload = {
"market": "BTC_USDT",
"orderId": 3134995325,
"clientOrderId": "customId11",
"offset": 0,
"limit": 50,
"request": "{{request}}",
"nonce": 1594297865000
}
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',
orderId: 3134995325,
clientOrderId: 'customId11',
offset: 0,
limit: 50,
request: '{{request}}',
nonce: 1594297865000
})
};
fetch('https://whitebit.com/api/v4/orders', 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/orders",
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',
'orderId' => 3134995325,
'clientOrderId' => 'customId11',
'offset' => 0,
'limit' => 50,
'request' => '{{request}}',
'nonce' => 1594297865000
]),
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/orders"
payload := strings.NewReader("{\n \"market\": \"BTC_USDT\",\n \"orderId\": 3134995325,\n \"clientOrderId\": \"customId11\",\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\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/orders")
.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 \"orderId\": 3134995325,\n \"clientOrderId\": \"customId11\",\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/orders")
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 \"orderId\": 3134995325,\n \"clientOrderId\": \"customId11\",\n \"offset\": 0,\n \"limit\": 50,\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}"
response = http.request(request)
puts response.read_bodyUsed in these guides
- Copy Trading — mirror a lead trader’s orders into followers’ own accounts via OAuth-issued keys.
Authorizations
Body
Response
List of active orders
Order lifecycle status. FILLED — fully executed. CANCELED — canceled before execution. PARTIALLY_FILLED — partially executed, remainder still active. CANCELED_TAKER_BAND — partially filled up to the taker band limit, remainder canceled to protect against excessive order book slippage. AUTO_CANCELED_REDUCE_ONLY — pending reduce-only order auto-canceled because the associated position was closed. AUTO_CANCELED_LIQUIDATION — pending order auto-canceled because the associated position was force-liquidated. CANCELED_STP — order canceled by Self-Trade Prevention. REST returns the single-L spelling throughout; NEW and PARTIAL_FILLED are not REST values (NEW is WebSocket-only; the partially-filled state is PARTIALLY_FILLED).
"FILLED"
OTO order data. Present only when the order belongs to an OTO group — returned on the cancel, active-orders list, and modify responses.
Show child attributes
Show child attributes
Retail-source taker flag. The field is present only when the order was placed with retail=true. See Retail flag.
true
Reduce-only flag. When true, the order can only reduce or close an existing position. Returned on the cancel, active-orders list, and modify responses; spot order-creation responses do not include the field. See reduce-only.
false
Trigger condition for the stop order. Response-only — not accepted in the request body, and cannot be overridden. Derived from side:
side = buy→gte. The order activates when the market price rises to or aboveactivation_price.side = sell→lte. The order activates when the market price falls to or belowactivation_price.
lte, gte "lte"
Was this page helpful?