const res = await fetch('https://app.trdrs.co/api/trading/close', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_API_KEY}`,
},
body: JSON.stringify({
"instrument": "ESU6",
"qty": 1,
"clientOrderId": "close-esu6-1787582700"
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/trading/close' \
-H "Authorization: Bearer $TRDRS_API_KEY" \
-H 'content-type: application/json' \
-d '{"instrument":"ESU6","qty":1,"clientOrderId":"close-esu6-1787582700"}'import requests
url = "https://app.trdrs.co/api/trading/close"
payload = {
"instrument": "ESU6",
"qty": 1,
"clientOrderId": "close-esu6-1787582700"
}
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/close",
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',
'qty' => 1,
'clientOrderId' => 'close-esu6-1787582700'
]),
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/close"
payload := strings.NewReader("{\n \"instrument\": \"ESU6\",\n \"qty\": 1,\n \"clientOrderId\": \"close-esu6-1787582700\"\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/close")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"instrument\": \"ESU6\",\n \"qty\": 1,\n \"clientOrderId\": \"close-esu6-1787582700\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/trading/close")
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 \"qty\": 1,\n \"clientOrderId\": \"close-esu6-1787582700\"\n}"
response = http.request(request)
puts response.read_body{
"providerOrderId": "234993011",
"filledQty": 1,
"avgFillPrice": 6482.25,
"requestedQty": 1
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}Close part of a position
Closes part of a position at market, under your clientOrderId. A qty larger than the position is refused rather than cut down, because that would turn “close 3” into “close everything” if the position moved; use /api/trading/flatten to close it all. Send positionId to close one position alone and never past flat, which is how you close a ticket on an account that holds separate tickets. On the paper book, a close larger than the largest market order the instrument takes is placed as several market orders, none larger than that and none smaller than its smallest order, all at one instant and one price, with or without positionId.
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/close', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_API_KEY}`,
},
body: JSON.stringify({
"instrument": "ESU6",
"qty": 1,
"clientOrderId": "close-esu6-1787582700"
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/trading/close' \
-H "Authorization: Bearer $TRDRS_API_KEY" \
-H 'content-type: application/json' \
-d '{"instrument":"ESU6","qty":1,"clientOrderId":"close-esu6-1787582700"}'import requests
url = "https://app.trdrs.co/api/trading/close"
payload = {
"instrument": "ESU6",
"qty": 1,
"clientOrderId": "close-esu6-1787582700"
}
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/close",
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',
'qty' => 1,
'clientOrderId' => 'close-esu6-1787582700'
]),
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/close"
payload := strings.NewReader("{\n \"instrument\": \"ESU6\",\n \"qty\": 1,\n \"clientOrderId\": \"close-esu6-1787582700\"\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/close")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"instrument\": \"ESU6\",\n \"qty\": 1,\n \"clientOrderId\": \"close-esu6-1787582700\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/trading/close")
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 \"qty\": 1,\n \"clientOrderId\": \"close-esu6-1787582700\"\n}"
response = http.request(request)
puts response.read_body{
"providerOrderId": "234993011",
"filledQty": 1,
"avgFillPrice": 6482.25,
"requestedQty": 1
}{
"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, such as rithmic or paper. Omit it to use your default provider. An unknown value is refused with 400, never replaced with another provider.
The account number at that provider. It must be one of your own accounts, or the call is refused with 400.
Body
The position to close part of, and how much.
The instrument.
How much to close, positive.
Your own id for this close, and its idempotency key.
The one position to act on, by the id the account snapshot gives it: a ticket on an account that holds separate tickets, or the net position. Only where the provider names its positions. Anywhere else the request is refused, rather than applied to the instrument.
The position revision you saw. If the position has changed since, the request is refused with position_revision_stale. Only with positionId.
x >= 1Response
The close is accepted. The response is the order that closes it.
The market order that closes part of the position.
The order id at the provider.
How much filled, or null when the provider hasn't reported it.
The average fill price, or null when the provider hasn't reported it.
The quantity you asked to close.
Present when the paper book closed more than the largest market order the instrument takes as several market orders and refused one after the first: why, with filledQty what the orders before it closed. Read the account to see what remains.
Show child attributes
Show child attributes
{ "error": "invalid_instrument" }