const res = await fetch('https://app.trdrs.co/api/trading/order', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_API_KEY}`,
},
body: JSON.stringify({
"instrument": "ESU6",
"side": "buy",
"qty": 2,
"clientOrderId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"orderType": "limit",
"limitPrice": 6480.5,
"exits": {
"unit": "ticks",
"takeProfits": [
{
"share": 50,
"distance": 20
}
],
"stopLosses": [
{
"share": 100,
"distance": 12,
"breakeven": {
"trigger": 8,
"plus": 0
},
"trail": [
{
"trigger": 16,
"distance": 8,
"frequencyTicks": 2
}
]
}
]
},
"tif": "day"
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/trading/order' \
-H "Authorization: Bearer $TRDRS_API_KEY" \
-H 'content-type: application/json' \
-d '{"instrument":"ESU6","side":"buy","qty":2,"clientOrderId":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","orderType":"limit","limitPrice":6480.5,"exits":{"unit":"ticks","takeProfits":[{"share":50,"distance":20}],"stopLosses":[{"share":100,"distance":12,"breakeven":{"trigger":8,"plus":0},"trail":[{"trigger":16,"distance":8,"frequencyTicks":2}]}]},"tif":"day"}'import requests
url = "https://app.trdrs.co/api/trading/order"
payload = {
"instrument": "ESU6",
"side": "buy",
"qty": 2,
"clientOrderId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"orderType": "limit",
"limitPrice": 6480.5,
"exits": {
"unit": "ticks",
"takeProfits": [
{
"share": 50,
"distance": 20
}
],
"stopLosses": [
{
"share": 100,
"distance": 12,
"breakeven": {
"trigger": 8,
"plus": 0
},
"trail": [
{
"trigger": 16,
"distance": 8,
"frequencyTicks": 2
}
]
}
]
},
"tif": "day"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trdrs.co/api/trading/order",
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([
'instrument' => 'ESU6',
'side' => 'buy',
'qty' => 2,
'clientOrderId' => 'a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
'orderType' => 'limit',
'limitPrice' => 6480.5,
'exits' => [
'unit' => 'ticks',
'takeProfits' => [
[
'share' => 50,
'distance' => 20
]
],
'stopLosses' => [
[
'share' => 100,
'distance' => 12,
'breakeven' => [
'trigger' => 8,
'plus' => 0
],
'trail' => [
[
'trigger' => 16,
'distance' => 8,
'frequencyTicks' => 2
]
]
]
]
],
'tif' => 'day'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.trdrs.co/api/trading/order"
payload := strings.NewReader("{\n \"instrument\": \"ESU6\",\n \"side\": \"buy\",\n \"qty\": 2,\n \"clientOrderId\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"orderType\": \"limit\",\n \"limitPrice\": 6480.5,\n \"exits\": {\n \"unit\": \"ticks\",\n \"takeProfits\": [\n {\n \"share\": 50,\n \"distance\": 20\n }\n ],\n \"stopLosses\": [\n {\n \"share\": 100,\n \"distance\": 12,\n \"breakeven\": {\n \"trigger\": 8,\n \"plus\": 0\n },\n \"trail\": [\n {\n \"trigger\": 16,\n \"distance\": 8,\n \"frequencyTicks\": 2\n }\n ]\n }\n ]\n },\n \"tif\": \"day\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://app.trdrs.co/api/trading/order")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"instrument\": \"ESU6\",\n \"side\": \"buy\",\n \"qty\": 2,\n \"clientOrderId\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"orderType\": \"limit\",\n \"limitPrice\": 6480.5,\n \"exits\": {\n \"unit\": \"ticks\",\n \"takeProfits\": [\n {\n \"share\": 50,\n \"distance\": 20\n }\n ],\n \"stopLosses\": [\n {\n \"share\": 100,\n \"distance\": 12,\n \"breakeven\": {\n \"trigger\": 8,\n \"plus\": 0\n },\n \"trail\": [\n {\n \"trigger\": 16,\n \"distance\": 8,\n \"frequencyTicks\": 2\n }\n ]\n }\n ]\n },\n \"tif\": \"day\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/trading/order")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"instrument\": \"ESU6\",\n \"side\": \"buy\",\n \"qty\": 2,\n \"clientOrderId\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"orderType\": \"limit\",\n \"limitPrice\": 6480.5,\n \"exits\": {\n \"unit\": \"ticks\",\n \"takeProfits\": [\n {\n \"share\": 50,\n \"distance\": 20\n }\n ],\n \"stopLosses\": [\n {\n \"share\": 100,\n \"distance\": 12,\n \"breakeven\": {\n \"trigger\": 8,\n \"plus\": 0\n },\n \"trail\": [\n {\n \"trigger\": 16,\n \"distance\": 8,\n \"frequencyTicks\": 2\n }\n ]\n }\n ]\n },\n \"tif\": \"day\"\n}"
response = http.request(request)
puts response.read_body{
"providerOrderId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"filledQty": 0,
"avgFillPrice": 0,
"bracket": {
"id": "b41e7d2a-9c58-4f03-a6b1-2e8d5c7f0a94",
"state": "pending_entry",
"attached": true
}
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}Place an order
Places a market, limit, stop or stop-limit order, optionally with a bracket: up to three take profits and three stop losses, written as exits. trdrs lays the bracket out as pairs along the position, nearest the entry first, each pair’s take profit and stop loss cancelling each other. It records the bracket before it sends the entry, then rests each pair once the part of the position the pair protects has filled, or hands the pairs to the provider with the entry where the provider holds them (bracket.attached). A stop loss that moves itself, to breakeven or trailing, is moved by trdrs on every provider that holds a bracket.
clientOrderId is the idempotency key, so retry an order with the same id and it is never placed twice. Call GET /api/trading/actions first to learn whether the order would be refused, and why. On the paper book an order waits, at most 5 seconds, for a price of its instrument that has not arrived yet, for that price to reach the account’s risk check on an instrument the account does not hold yet, and for the risk check to process the account’s latest change, so the answer can take that long. A reduce-only order carries no exits: it opens no position for them to protect, and is refused with 400.
Required key: Trading API key. A Connect app’s backend can also send it with the app’s API key, and a venue’s backend with its Venue key, which carries trader:trade, each naming one of its own traders in x-trdrs-trader: it then runs on that trader’s own accounts.
const res = await fetch('https://app.trdrs.co/api/trading/order', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_API_KEY}`,
},
body: JSON.stringify({
"instrument": "ESU6",
"side": "buy",
"qty": 2,
"clientOrderId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"orderType": "limit",
"limitPrice": 6480.5,
"exits": {
"unit": "ticks",
"takeProfits": [
{
"share": 50,
"distance": 20
}
],
"stopLosses": [
{
"share": 100,
"distance": 12,
"breakeven": {
"trigger": 8,
"plus": 0
},
"trail": [
{
"trigger": 16,
"distance": 8,
"frequencyTicks": 2
}
]
}
]
},
"tif": "day"
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/trading/order' \
-H "Authorization: Bearer $TRDRS_API_KEY" \
-H 'content-type: application/json' \
-d '{"instrument":"ESU6","side":"buy","qty":2,"clientOrderId":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","orderType":"limit","limitPrice":6480.5,"exits":{"unit":"ticks","takeProfits":[{"share":50,"distance":20}],"stopLosses":[{"share":100,"distance":12,"breakeven":{"trigger":8,"plus":0},"trail":[{"trigger":16,"distance":8,"frequencyTicks":2}]}]},"tif":"day"}'import requests
url = "https://app.trdrs.co/api/trading/order"
payload = {
"instrument": "ESU6",
"side": "buy",
"qty": 2,
"clientOrderId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"orderType": "limit",
"limitPrice": 6480.5,
"exits": {
"unit": "ticks",
"takeProfits": [
{
"share": 50,
"distance": 20
}
],
"stopLosses": [
{
"share": 100,
"distance": 12,
"breakeven": {
"trigger": 8,
"plus": 0
},
"trail": [
{
"trigger": 16,
"distance": 8,
"frequencyTicks": 2
}
]
}
]
},
"tif": "day"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trdrs.co/api/trading/order",
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([
'instrument' => 'ESU6',
'side' => 'buy',
'qty' => 2,
'clientOrderId' => 'a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d',
'orderType' => 'limit',
'limitPrice' => 6480.5,
'exits' => [
'unit' => 'ticks',
'takeProfits' => [
[
'share' => 50,
'distance' => 20
]
],
'stopLosses' => [
[
'share' => 100,
'distance' => 12,
'breakeven' => [
'trigger' => 8,
'plus' => 0
],
'trail' => [
[
'trigger' => 16,
'distance' => 8,
'frequencyTicks' => 2
]
]
]
]
],
'tif' => 'day'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://app.trdrs.co/api/trading/order"
payload := strings.NewReader("{\n \"instrument\": \"ESU6\",\n \"side\": \"buy\",\n \"qty\": 2,\n \"clientOrderId\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"orderType\": \"limit\",\n \"limitPrice\": 6480.5,\n \"exits\": {\n \"unit\": \"ticks\",\n \"takeProfits\": [\n {\n \"share\": 50,\n \"distance\": 20\n }\n ],\n \"stopLosses\": [\n {\n \"share\": 100,\n \"distance\": 12,\n \"breakeven\": {\n \"trigger\": 8,\n \"plus\": 0\n },\n \"trail\": [\n {\n \"trigger\": 16,\n \"distance\": 8,\n \"frequencyTicks\": 2\n }\n ]\n }\n ]\n },\n \"tif\": \"day\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://app.trdrs.co/api/trading/order")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"instrument\": \"ESU6\",\n \"side\": \"buy\",\n \"qty\": 2,\n \"clientOrderId\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"orderType\": \"limit\",\n \"limitPrice\": 6480.5,\n \"exits\": {\n \"unit\": \"ticks\",\n \"takeProfits\": [\n {\n \"share\": 50,\n \"distance\": 20\n }\n ],\n \"stopLosses\": [\n {\n \"share\": 100,\n \"distance\": 12,\n \"breakeven\": {\n \"trigger\": 8,\n \"plus\": 0\n },\n \"trail\": [\n {\n \"trigger\": 16,\n \"distance\": 8,\n \"frequencyTicks\": 2\n }\n ]\n }\n ]\n },\n \"tif\": \"day\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/trading/order")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"instrument\": \"ESU6\",\n \"side\": \"buy\",\n \"qty\": 2,\n \"clientOrderId\": \"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n \"orderType\": \"limit\",\n \"limitPrice\": 6480.5,\n \"exits\": {\n \"unit\": \"ticks\",\n \"takeProfits\": [\n {\n \"share\": 50,\n \"distance\": 20\n }\n ],\n \"stopLosses\": [\n {\n \"share\": 100,\n \"distance\": 12,\n \"breakeven\": {\n \"trigger\": 8,\n \"plus\": 0\n },\n \"trail\": [\n {\n \"trigger\": 16,\n \"distance\": 8,\n \"frequencyTicks\": 2\n }\n ]\n }\n ]\n },\n \"tif\": \"day\"\n}"
response = http.request(request)
puts response.read_body{
"providerOrderId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"filledQty": 0,
"avgFillPrice": 0,
"bracket": {
"id": "b41e7d2a-9c58-4f03-a6b1-2e8d5c7f0a94",
"state": "pending_entry",
"attached": true
}
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}Authorizations
The Trading API key (trdrs_sk_…), for market data, orders and account state on the accounts its owner holds. Use it server-to-server, and keep it on your server. Its scope is named trading in the API.
Query Parameters
The provider the account is at. Omit it to use your default provider.
The account number at that provider. It must be one of your own accounts.
Body
The order to place. Send a new clientOrderId for each order you mean to place, and the same one when you retry it.
The instrument, as GET /api/account/markets names it, or any other symbol of the same market.
Buy or sell.
buy, sell The quantity, positive.
Your own id for this order, and its idempotency key. Keep it the same across retries of one order.
The order type. Omit it for a market order.
market, limit, stop, stop_limit The limit price, for a limit order.
The trigger price, for a stop or stop-limit order.
The limit price a stop-limit order rests at once its trigger is hit.
The take profits and stop losses to place with the order. Distances are measured from the entry's own price, or the market's for a market order.
Show child attributes
Show child attributes
{
"takeProfits": [{ "quantity": 1, "price": 6485.5 }],
"stopLosses": [{ "quantity": 2, "price": 6477.5 }]
}
The time in force.
day, gtc Close only: the order can shrink the position and never open or add to it. It carries no exits.
Response
The order is placed. bracket is the bracket placed with it, or null. The account stream carries the whole bracket at the same revision, with its ladders and the orders resting for it.
The order you placed.
The order id at the provider.
How much filled at once.
The average fill price of what filled at once.
The bracket placed with the order, or null for an order placed without one.
Show child attributes
Show child attributes
{
"id": "b41e7d2a-9c58-4f03-a6b1-2e8d5c7f0a94",
"state": "pending_entry",
"attached": true
}