TypeScript
const res = await fetch('https://app.trdrs.co/api/venues/{venueId}/conditions/profiles', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_VENUE_KEY}`,
"Idempotency-Key": "example-request-1",
},
body: JSON.stringify({
"name": "Standard",
"profile": {
"margin": null,
"commission": {
"kind": "perUnit",
"timing": "fill",
"direction": "both",
"unit": "quantity",
"amount": "2.50",
"currency": "USD",
"orderMinimum": null
},
"markup": {
"buyMarkupTicks": 0,
"sellMarkupTicks": 0
},
"risk": {
"maxOrderQuantity": "10",
"maxPositionQuantity": null,
"maxPositionNotional": null,
"instrumentAllowlist": null,
"dailyLossLimit": null,
"entryHalted": false
}
}
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/venues/{venueId}/conditions/profiles' \
-H "Authorization: Bearer $TRDRS_VENUE_KEY" \
-H 'Idempotency-Key: example-request-1' \
-H 'content-type: application/json' \
-d '{"name":"Standard","profile":{"margin":null,"commission":{"kind":"perUnit","timing":"fill","direction":"both","unit":"quantity","amount":"2.50","currency":"USD","orderMinimum":null},"markup":{"buyMarkupTicks":0,"sellMarkupTicks":0},"risk":{"maxOrderQuantity":"10","maxPositionQuantity":null,"maxPositionNotional":null,"instrumentAllowlist":null,"dailyLossLimit":null,"entryHalted":false}}}'import requests
url = "https://app.trdrs.co/api/venues/{venueId}/conditions/profiles"
payload = {
"name": "Standard",
"profile": {
"margin": None,
"commission": {
"kind": "perUnit",
"timing": "fill",
"direction": "both",
"unit": "quantity",
"amount": "2.50",
"currency": "USD",
"orderMinimum": None
},
"markup": {
"buyMarkupTicks": 0,
"sellMarkupTicks": 0
},
"risk": {
"maxOrderQuantity": "10",
"maxPositionQuantity": None,
"maxPositionNotional": None,
"instrumentAllowlist": None,
"dailyLossLimit": None,
"entryHalted": False
}
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"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/venues/{venueId}/conditions/profiles",
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([
'name' => 'Standard',
'profile' => [
'margin' => null,
'commission' => [
'kind' => 'perUnit',
'timing' => 'fill',
'direction' => 'both',
'unit' => 'quantity',
'amount' => '2.50',
'currency' => 'USD',
'orderMinimum' => null
],
'markup' => [
'buyMarkupTicks' => 0,
'sellMarkupTicks' => 0
],
'risk' => [
'maxOrderQuantity' => '10',
'maxPositionQuantity' => null,
'maxPositionNotional' => null,
'instrumentAllowlist' => null,
'dailyLossLimit' => null,
'entryHalted' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-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://app.trdrs.co/api/venues/{venueId}/conditions/profiles"
payload := strings.NewReader("{\n \"name\": \"Standard\",\n \"profile\": {\n \"margin\": null,\n \"commission\": {\n \"kind\": \"perUnit\",\n \"timing\": \"fill\",\n \"direction\": \"both\",\n \"unit\": \"quantity\",\n \"amount\": \"2.50\",\n \"currency\": \"USD\",\n \"orderMinimum\": null\n },\n \"markup\": {\n \"buyMarkupTicks\": 0,\n \"sellMarkupTicks\": 0\n },\n \"risk\": {\n \"maxOrderQuantity\": \"10\",\n \"maxPositionQuantity\": null,\n \"maxPositionNotional\": null,\n \"instrumentAllowlist\": null,\n \"dailyLossLimit\": null,\n \"entryHalted\": false\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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/venues/{venueId}/conditions/profiles")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Standard\",\n \"profile\": {\n \"margin\": null,\n \"commission\": {\n \"kind\": \"perUnit\",\n \"timing\": \"fill\",\n \"direction\": \"both\",\n \"unit\": \"quantity\",\n \"amount\": \"2.50\",\n \"currency\": \"USD\",\n \"orderMinimum\": null\n },\n \"markup\": {\n \"buyMarkupTicks\": 0,\n \"sellMarkupTicks\": 0\n },\n \"risk\": {\n \"maxOrderQuantity\": \"10\",\n \"maxPositionQuantity\": null,\n \"maxPositionNotional\": null,\n \"instrumentAllowlist\": null,\n \"dailyLossLimit\": null,\n \"entryHalted\": false\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/venues/{venueId}/conditions/profiles")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Standard\",\n \"profile\": {\n \"margin\": null,\n \"commission\": {\n \"kind\": \"perUnit\",\n \"timing\": \"fill\",\n \"direction\": \"both\",\n \"unit\": \"quantity\",\n \"amount\": \"2.50\",\n \"currency\": \"USD\",\n \"orderMinimum\": null\n },\n \"markup\": {\n \"buyMarkupTicks\": 0,\n \"sellMarkupTicks\": 0\n },\n \"risk\": {\n \"maxOrderQuantity\": \"10\",\n \"maxPositionQuantity\": null,\n \"maxPositionNotional\": null,\n \"instrumentAllowlist\": null,\n \"dailyLossLimit\": null,\n \"entryHalted\": false\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"profile": {
"id": "00000000-0000-0000-0000-000000000001",
"venueId": "00000000-0000-0000-0000-000000000001",
"environment": "sandbox",
"name": "Standard",
"profile": {
"margin": null,
"commission": {
"kind": "perUnit",
"timing": "fill",
"direction": "both",
"unit": "quantity",
"amount": "2.50",
"currency": "USD",
"orderMinimum": null
},
"markup": {
"buyMarkupTicks": 0,
"sellMarkupTicks": 0
},
"risk": {
"maxOrderQuantity": "10",
"maxPositionQuantity": null,
"maxPositionNotional": null,
"instrumentAllowlist": null,
"dailyLossLimit": null,
"entryHalted": false
}
},
"contentHash": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
"createdAt": "2026-09-14T12:00:00.000Z",
"state": "published",
"inForce": false
}
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}Conditions and groups
Publish a condition profile
Publishes a complete condition profile for the venue: its commission, its markup and its safety limits. The profile must state every policy explicitly, because the venue layer is the base every group and account narrows. Publishing applies nothing, so apply the profile separately, and the response is the stored profile. Required scope: venue:configure. Preview: served on the sandbox to every venue, and production availability is arranged when a venue qualifies. Trading API keys and pre-registration keys do not authorize these routes.
POST
/
api
/
venues
/
{venueId}
/
conditions
/
profiles
TypeScript
const res = await fetch('https://app.trdrs.co/api/venues/{venueId}/conditions/profiles', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_VENUE_KEY}`,
"Idempotency-Key": "example-request-1",
},
body: JSON.stringify({
"name": "Standard",
"profile": {
"margin": null,
"commission": {
"kind": "perUnit",
"timing": "fill",
"direction": "both",
"unit": "quantity",
"amount": "2.50",
"currency": "USD",
"orderMinimum": null
},
"markup": {
"buyMarkupTicks": 0,
"sellMarkupTicks": 0
},
"risk": {
"maxOrderQuantity": "10",
"maxPositionQuantity": null,
"maxPositionNotional": null,
"instrumentAllowlist": null,
"dailyLossLimit": null,
"entryHalted": false
}
}
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/venues/{venueId}/conditions/profiles' \
-H "Authorization: Bearer $TRDRS_VENUE_KEY" \
-H 'Idempotency-Key: example-request-1' \
-H 'content-type: application/json' \
-d '{"name":"Standard","profile":{"margin":null,"commission":{"kind":"perUnit","timing":"fill","direction":"both","unit":"quantity","amount":"2.50","currency":"USD","orderMinimum":null},"markup":{"buyMarkupTicks":0,"sellMarkupTicks":0},"risk":{"maxOrderQuantity":"10","maxPositionQuantity":null,"maxPositionNotional":null,"instrumentAllowlist":null,"dailyLossLimit":null,"entryHalted":false}}}'import requests
url = "https://app.trdrs.co/api/venues/{venueId}/conditions/profiles"
payload = {
"name": "Standard",
"profile": {
"margin": None,
"commission": {
"kind": "perUnit",
"timing": "fill",
"direction": "both",
"unit": "quantity",
"amount": "2.50",
"currency": "USD",
"orderMinimum": None
},
"markup": {
"buyMarkupTicks": 0,
"sellMarkupTicks": 0
},
"risk": {
"maxOrderQuantity": "10",
"maxPositionQuantity": None,
"maxPositionNotional": None,
"instrumentAllowlist": None,
"dailyLossLimit": None,
"entryHalted": False
}
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"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/venues/{venueId}/conditions/profiles",
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([
'name' => 'Standard',
'profile' => [
'margin' => null,
'commission' => [
'kind' => 'perUnit',
'timing' => 'fill',
'direction' => 'both',
'unit' => 'quantity',
'amount' => '2.50',
'currency' => 'USD',
'orderMinimum' => null
],
'markup' => [
'buyMarkupTicks' => 0,
'sellMarkupTicks' => 0
],
'risk' => [
'maxOrderQuantity' => '10',
'maxPositionQuantity' => null,
'maxPositionNotional' => null,
'instrumentAllowlist' => null,
'dailyLossLimit' => null,
'entryHalted' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-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://app.trdrs.co/api/venues/{venueId}/conditions/profiles"
payload := strings.NewReader("{\n \"name\": \"Standard\",\n \"profile\": {\n \"margin\": null,\n \"commission\": {\n \"kind\": \"perUnit\",\n \"timing\": \"fill\",\n \"direction\": \"both\",\n \"unit\": \"quantity\",\n \"amount\": \"2.50\",\n \"currency\": \"USD\",\n \"orderMinimum\": null\n },\n \"markup\": {\n \"buyMarkupTicks\": 0,\n \"sellMarkupTicks\": 0\n },\n \"risk\": {\n \"maxOrderQuantity\": \"10\",\n \"maxPositionQuantity\": null,\n \"maxPositionNotional\": null,\n \"instrumentAllowlist\": null,\n \"dailyLossLimit\": null,\n \"entryHalted\": false\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
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/venues/{venueId}/conditions/profiles")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Standard\",\n \"profile\": {\n \"margin\": null,\n \"commission\": {\n \"kind\": \"perUnit\",\n \"timing\": \"fill\",\n \"direction\": \"both\",\n \"unit\": \"quantity\",\n \"amount\": \"2.50\",\n \"currency\": \"USD\",\n \"orderMinimum\": null\n },\n \"markup\": {\n \"buyMarkupTicks\": 0,\n \"sellMarkupTicks\": 0\n },\n \"risk\": {\n \"maxOrderQuantity\": \"10\",\n \"maxPositionQuantity\": null,\n \"maxPositionNotional\": null,\n \"instrumentAllowlist\": null,\n \"dailyLossLimit\": null,\n \"entryHalted\": false\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/venues/{venueId}/conditions/profiles")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Standard\",\n \"profile\": {\n \"margin\": null,\n \"commission\": {\n \"kind\": \"perUnit\",\n \"timing\": \"fill\",\n \"direction\": \"both\",\n \"unit\": \"quantity\",\n \"amount\": \"2.50\",\n \"currency\": \"USD\",\n \"orderMinimum\": null\n },\n \"markup\": {\n \"buyMarkupTicks\": 0,\n \"sellMarkupTicks\": 0\n },\n \"risk\": {\n \"maxOrderQuantity\": \"10\",\n \"maxPositionQuantity\": null,\n \"maxPositionNotional\": null,\n \"instrumentAllowlist\": null,\n \"dailyLossLimit\": null,\n \"entryHalted\": false\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"profile": {
"id": "00000000-0000-0000-0000-000000000001",
"venueId": "00000000-0000-0000-0000-000000000001",
"environment": "sandbox",
"name": "Standard",
"profile": {
"margin": null,
"commission": {
"kind": "perUnit",
"timing": "fill",
"direction": "both",
"unit": "quantity",
"amount": "2.50",
"currency": "USD",
"orderMinimum": null
},
"markup": {
"buyMarkupTicks": 0,
"sellMarkupTicks": 0
},
"risk": {
"maxOrderQuantity": "10",
"maxPositionQuantity": null,
"maxPositionNotional": null,
"instrumentAllowlist": null,
"dailyLossLimit": null,
"entryHalted": false
}
},
"contentHash": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
"createdAt": "2026-09-14T12:00:00.000Z",
"state": "published",
"inForce": false
}
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}Authorizations
The Venue key (trdrs_vk_sandbox_… or trdrs_vk_production_…), in preview. It belongs to one venue in one environment and carries the scopes it was created with. The venue's verified owner creates it while signed in. It works on the /api/venues/{venueId} routes and, with trader:read or trader:trade, on the account, market and trading routes, reading the venue's own traders' accounts and routing their orders, each request naming its trader in x-trdrs-trader. A trdrs_sk_… key can't be used in its place. It reaches its venue's routes and its venue's own traders, and the owner manages keys from a signed-in session. Keep it on your server.
Headers
A key you choose, 1 to 128 characters, that identifies this write. Send the same key when you retry it, so the write is never applied twice.
Required string length:
1 - 128Path Parameters
Body
application/json
What the venue charges and allows: commission, markup, safety limits and position holding. A liquidityBps commission (PREVIEW) charges by the liquidity a fill meets. A zero commission is a real choice, and a group inherits fields it leaves out. Margin is always null and there is no financing here: your published risk policy states both, so financing here is refused with financing_superseded.
Show child attributes
Show child attributes
Response
Success. The response is sent with Cache-Control: no-store, so don't cache it.
Show child attributes
Show child attributes