curl --request POST \
--url https://whitebit.com/api/v4/order/collateral/trigger-market \
--header 'Content-Type: application/json' \
--header 'X-TXC-APIKEY: <api-key>' \
--data '
{
"market": "BTC_USDT",
"side": "buy",
"amount": "0.01",
"activation_price": "40000",
"client_order_id": "order1987111",
"request": "{{request}}",
"nonce": "{{nonce}}"
}
'import requests
url = "https://whitebit.com/api/v4/order/collateral/trigger-market"
payload = {
"market": "BTC_USDT",
"side": "buy",
"amount": "0.01",
"activation_price": "40000",
"client_order_id": "order1987111",
"request": "{{request}}",
"nonce": "{{nonce}}"
}
headers = {
"X-TXC-APIKEY": "<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>', 'Content-Type': 'application/json'},
body: JSON.stringify({
market: 'BTC_USDT',
side: 'buy',
amount: '0.01',
activation_price: '40000',
client_order_id: 'order1987111',
request: '{{request}}',
nonce: '{{nonce}}'
})
};
fetch('https://whitebit.com/api/v4/order/collateral/trigger-market', 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/order/collateral/trigger-market",
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',
'side' => 'buy',
'amount' => '0.01',
'activation_price' => '40000',
'client_order_id' => 'order1987111',
'request' => '{{request}}',
'nonce' => '{{nonce}}'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-TXC-APIKEY: <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/order/collateral/trigger-market"
payload := strings.NewReader("{\n \"market\": \"BTC_USDT\",\n \"side\": \"buy\",\n \"amount\": \"0.01\",\n \"activation_price\": \"40000\",\n \"client_order_id\": \"order1987111\",\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-TXC-APIKEY", "<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/order/collateral/trigger-market")
.header("X-TXC-APIKEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"market\": \"BTC_USDT\",\n \"side\": \"buy\",\n \"amount\": \"0.01\",\n \"activation_price\": \"40000\",\n \"client_order_id\": \"order1987111\",\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/order/collateral/trigger-market")
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["Content-Type"] = 'application/json'
request.body = "{\n \"market\": \"BTC_USDT\",\n \"side\": \"buy\",\n \"amount\": \"0.01\",\n \"activation_price\": \"40000\",\n \"client_order_id\": \"order1987111\",\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}"
response = http.request(request)
puts response.read_body{
"order_id": 4180284841,
"client_order_id": "order1987111",
"market": "BTC_USDT",
"side": "sell",
"type": "stop market",
"timestamp": 1595792396.165973,
"deal_money": "0",
"deal_stock": "0",
"amount": "0.001",
"left": "0.001",
"deal_fee": "0",
"activation_price": "40000",
"status": "FILLED",
"stp": "no",
"oto": {
"otoId": 29457221,
"stopLoss": "50000",
"takeProfit": "30000"
},
"positionSide": "LONG"
}{
"code": 30,
"message": "Validation failed",
"errors": {}
}Collateral Trigger Market Order
Place a collateral trigger market order that executes at market price when the trigger is reached.
curl --request POST \
--url https://whitebit.com/api/v4/order/collateral/trigger-market \
--header 'Content-Type: application/json' \
--header 'X-TXC-APIKEY: <api-key>' \
--data '
{
"market": "BTC_USDT",
"side": "buy",
"amount": "0.01",
"activation_price": "40000",
"client_order_id": "order1987111",
"request": "{{request}}",
"nonce": "{{nonce}}"
}
'import requests
url = "https://whitebit.com/api/v4/order/collateral/trigger-market"
payload = {
"market": "BTC_USDT",
"side": "buy",
"amount": "0.01",
"activation_price": "40000",
"client_order_id": "order1987111",
"request": "{{request}}",
"nonce": "{{nonce}}"
}
headers = {
"X-TXC-APIKEY": "<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>', 'Content-Type': 'application/json'},
body: JSON.stringify({
market: 'BTC_USDT',
side: 'buy',
amount: '0.01',
activation_price: '40000',
client_order_id: 'order1987111',
request: '{{request}}',
nonce: '{{nonce}}'
})
};
fetch('https://whitebit.com/api/v4/order/collateral/trigger-market', 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/order/collateral/trigger-market",
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',
'side' => 'buy',
'amount' => '0.01',
'activation_price' => '40000',
'client_order_id' => 'order1987111',
'request' => '{{request}}',
'nonce' => '{{nonce}}'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-TXC-APIKEY: <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/order/collateral/trigger-market"
payload := strings.NewReader("{\n \"market\": \"BTC_USDT\",\n \"side\": \"buy\",\n \"amount\": \"0.01\",\n \"activation_price\": \"40000\",\n \"client_order_id\": \"order1987111\",\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-TXC-APIKEY", "<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/order/collateral/trigger-market")
.header("X-TXC-APIKEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"market\": \"BTC_USDT\",\n \"side\": \"buy\",\n \"amount\": \"0.01\",\n \"activation_price\": \"40000\",\n \"client_order_id\": \"order1987111\",\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/order/collateral/trigger-market")
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["Content-Type"] = 'application/json'
request.body = "{\n \"market\": \"BTC_USDT\",\n \"side\": \"buy\",\n \"amount\": \"0.01\",\n \"activation_price\": \"40000\",\n \"client_order_id\": \"order1987111\",\n \"request\": \"{{request}}\",\n \"nonce\": \"{{nonce}}\"\n}"
response = http.request(request)
puts response.read_body{
"order_id": 4180284841,
"client_order_id": "order1987111",
"market": "BTC_USDT",
"side": "sell",
"type": "stop market",
"timestamp": 1595792396.165973,
"deal_money": "0",
"deal_stock": "0",
"amount": "0.001",
"left": "0.001",
"deal_fee": "0",
"activation_price": "40000",
"status": "FILLED",
"stp": "no",
"oto": {
"otoId": 29457221,
"stopLoss": "50000",
"takeProfit": "30000"
},
"positionSide": "LONG"
}{
"code": 30,
"message": "Validation failed",
"errors": {}
}Authorizations
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
"BTC_USDT"
buy, sell "buy"
"0.01"
"40000"
"{{request}}"
"{{nonce}}"
"order1987111"
"50000"
"30000"
LONG, SHORT, BOTH "LONG"
Response
Successful response - trigger market order created
Unique order identifier
4180284841
Custom client order identifier. Empty string if not specified
"order1987111"
Market name
"BTC_USDT"
Order side
buy, sell "sell"
Order type
"stop market"
Timestamp of order creation in Unix format
1595792396.165973
Amount in money currency that is finished
"0"
Amount in stock currency that is finished
"0"
Order amount
"0.001"
Remaining amount that must be finished
"0.001"
Fee in money that is paid when order is finished
"0"
Price at which the stop market order activates
"40000"
Order status
NEW, FILLED, PARTIALLY_FILLED, CANCELLED "FILLED"
Self trade prevention mode
"no"
OTO order data when stopLoss or takeProfit is specified
Show child attributes
Show child attributes
Position side
LONG, SHORT, BOTH "LONG"
Was this page helpful?