TypeScript
const res = await fetch('https://app.trdrs.co/api/venues/{venueId}/instruments', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_VENUE_KEY}`,
"Idempotency-Key": "example-request-1",
},
body: JSON.stringify({
"specification": {
"instrumentId": "BTCUSD",
"version": "v1",
"venueId": "00000000-0000-0000-0000-000000000001",
"symbol": "BTCUSD",
"name": "Bitcoin / USD",
"productModel": "linear_spot",
"quoteCurrency": "USD",
"settlementCurrency": "USD",
"negativePrices": false,
"quantity": {
"unit": "base_units",
"lotSize": "1",
"min": "0.001",
"max": "100",
"step": "0.001"
},
"contractMultiplier": "1",
"minNotional": "10",
"ticks": [
{
"from": "0",
"to": null,
"size": "0.01"
}
],
"orderTypes": [
"market",
"limit"
],
"timeInForce": [
"gtc"
],
"mappings": [],
"sessions": {
"timezone": "UTC",
"coverageFrom": "2026-01-01",
"coverageThrough": "2026-12-31",
"weekly": [
{
"day": 0,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 1,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 2,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 3,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 4,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 5,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 6,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
}
],
"holidays": []
},
"expiresAt": null,
"lastTradeAt": null,
"pricing": {
"sourceId": "example-feed",
"stopTrigger": "last",
"maxAgeMs": 1000
},
"entitlement": null,
"state": "enabled"
}
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/venues/{venueId}/instruments' \
-H "Authorization: Bearer $TRDRS_VENUE_KEY" \
-H 'Idempotency-Key: example-request-1' \
-H 'content-type: application/json' \
-d '{"specification":{"instrumentId":"BTCUSD","version":"v1","venueId":"00000000-0000-0000-0000-000000000001","symbol":"BTCUSD","name":"Bitcoin / USD","productModel":"linear_spot","quoteCurrency":"USD","settlementCurrency":"USD","negativePrices":false,"quantity":{"unit":"base_units","lotSize":"1","min":"0.001","max":"100","step":"0.001"},"contractMultiplier":"1","minNotional":"10","ticks":[{"from":"0","to":null,"size":"0.01"}],"orderTypes":["market","limit"],"timeInForce":["gtc"],"mappings":[],"sessions":{"timezone":"UTC","coverageFrom":"2026-01-01","coverageThrough":"2026-12-31","weekly":[{"day":0,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":1,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":2,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":3,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":4,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":5,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":6,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]}],"holidays":[]},"expiresAt":null,"lastTradeAt":null,"pricing":{"sourceId":"example-feed","stopTrigger":"last","maxAgeMs":1000},"entitlement":null,"state":"enabled"}}'import requests
url = "https://app.trdrs.co/api/venues/{venueId}/instruments"
payload = { "specification": {
"instrumentId": "BTCUSD",
"version": "v1",
"venueId": "00000000-0000-0000-0000-000000000001",
"symbol": "BTCUSD",
"name": "Bitcoin / USD",
"productModel": "linear_spot",
"quoteCurrency": "USD",
"settlementCurrency": "USD",
"negativePrices": False,
"quantity": {
"unit": "base_units",
"lotSize": "1",
"min": "0.001",
"max": "100",
"step": "0.001"
},
"contractMultiplier": "1",
"minNotional": "10",
"ticks": [
{
"from": "0",
"to": None,
"size": "0.01"
}
],
"orderTypes": ["market", "limit"],
"timeInForce": ["gtc"],
"mappings": [],
"sessions": {
"timezone": "UTC",
"coverageFrom": "2026-01-01",
"coverageThrough": "2026-12-31",
"weekly": [
{
"day": 0,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 1,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 2,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 3,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 4,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 5,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 6,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
}
],
"holidays": []
},
"expiresAt": None,
"lastTradeAt": None,
"pricing": {
"sourceId": "example-feed",
"stopTrigger": "last",
"maxAgeMs": 1000
},
"entitlement": None,
"state": "enabled"
} }
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}/instruments",
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([
'specification' => [
'instrumentId' => 'BTCUSD',
'version' => 'v1',
'venueId' => '00000000-0000-0000-0000-000000000001',
'symbol' => 'BTCUSD',
'name' => 'Bitcoin / USD',
'productModel' => 'linear_spot',
'quoteCurrency' => 'USD',
'settlementCurrency' => 'USD',
'negativePrices' => false,
'quantity' => [
'unit' => 'base_units',
'lotSize' => '1',
'min' => '0.001',
'max' => '100',
'step' => '0.001'
],
'contractMultiplier' => '1',
'minNotional' => '10',
'ticks' => [
[
'from' => '0',
'to' => null,
'size' => '0.01'
]
],
'orderTypes' => [
'market',
'limit'
],
'timeInForce' => [
'gtc'
],
'mappings' => [
],
'sessions' => [
'timezone' => 'UTC',
'coverageFrom' => '2026-01-01',
'coverageThrough' => '2026-12-31',
'weekly' => [
[
'day' => 0,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 1,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 2,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 3,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 4,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 5,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 6,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
]
],
'holidays' => [
]
],
'expiresAt' => null,
'lastTradeAt' => null,
'pricing' => [
'sourceId' => 'example-feed',
'stopTrigger' => 'last',
'maxAgeMs' => 1000
],
'entitlement' => null,
'state' => 'enabled'
]
]),
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}/instruments"
payload := strings.NewReader("{\n \"specification\": {\n \"instrumentId\": \"BTCUSD\",\n \"version\": \"v1\",\n \"venueId\": \"00000000-0000-0000-0000-000000000001\",\n \"symbol\": \"BTCUSD\",\n \"name\": \"Bitcoin / USD\",\n \"productModel\": \"linear_spot\",\n \"quoteCurrency\": \"USD\",\n \"settlementCurrency\": \"USD\",\n \"negativePrices\": false,\n \"quantity\": {\n \"unit\": \"base_units\",\n \"lotSize\": \"1\",\n \"min\": \"0.001\",\n \"max\": \"100\",\n \"step\": \"0.001\"\n },\n \"contractMultiplier\": \"1\",\n \"minNotional\": \"10\",\n \"ticks\": [\n {\n \"from\": \"0\",\n \"to\": null,\n \"size\": \"0.01\"\n }\n ],\n \"orderTypes\": [\n \"market\",\n \"limit\"\n ],\n \"timeInForce\": [\n \"gtc\"\n ],\n \"mappings\": [],\n \"sessions\": {\n \"timezone\": \"UTC\",\n \"coverageFrom\": \"2026-01-01\",\n \"coverageThrough\": \"2026-12-31\",\n \"weekly\": [\n {\n \"day\": 0,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 1,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 2,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 3,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 4,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 5,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 6,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n }\n ],\n \"holidays\": []\n },\n \"expiresAt\": null,\n \"lastTradeAt\": null,\n \"pricing\": {\n \"sourceId\": \"example-feed\",\n \"stopTrigger\": \"last\",\n \"maxAgeMs\": 1000\n },\n \"entitlement\": null,\n \"state\": \"enabled\"\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}/instruments")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"specification\": {\n \"instrumentId\": \"BTCUSD\",\n \"version\": \"v1\",\n \"venueId\": \"00000000-0000-0000-0000-000000000001\",\n \"symbol\": \"BTCUSD\",\n \"name\": \"Bitcoin / USD\",\n \"productModel\": \"linear_spot\",\n \"quoteCurrency\": \"USD\",\n \"settlementCurrency\": \"USD\",\n \"negativePrices\": false,\n \"quantity\": {\n \"unit\": \"base_units\",\n \"lotSize\": \"1\",\n \"min\": \"0.001\",\n \"max\": \"100\",\n \"step\": \"0.001\"\n },\n \"contractMultiplier\": \"1\",\n \"minNotional\": \"10\",\n \"ticks\": [\n {\n \"from\": \"0\",\n \"to\": null,\n \"size\": \"0.01\"\n }\n ],\n \"orderTypes\": [\n \"market\",\n \"limit\"\n ],\n \"timeInForce\": [\n \"gtc\"\n ],\n \"mappings\": [],\n \"sessions\": {\n \"timezone\": \"UTC\",\n \"coverageFrom\": \"2026-01-01\",\n \"coverageThrough\": \"2026-12-31\",\n \"weekly\": [\n {\n \"day\": 0,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 1,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 2,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 3,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 4,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 5,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 6,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n }\n ],\n \"holidays\": []\n },\n \"expiresAt\": null,\n \"lastTradeAt\": null,\n \"pricing\": {\n \"sourceId\": \"example-feed\",\n \"stopTrigger\": \"last\",\n \"maxAgeMs\": 1000\n },\n \"entitlement\": null,\n \"state\": \"enabled\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/venues/{venueId}/instruments")
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 \"specification\": {\n \"instrumentId\": \"BTCUSD\",\n \"version\": \"v1\",\n \"venueId\": \"00000000-0000-0000-0000-000000000001\",\n \"symbol\": \"BTCUSD\",\n \"name\": \"Bitcoin / USD\",\n \"productModel\": \"linear_spot\",\n \"quoteCurrency\": \"USD\",\n \"settlementCurrency\": \"USD\",\n \"negativePrices\": false,\n \"quantity\": {\n \"unit\": \"base_units\",\n \"lotSize\": \"1\",\n \"min\": \"0.001\",\n \"max\": \"100\",\n \"step\": \"0.001\"\n },\n \"contractMultiplier\": \"1\",\n \"minNotional\": \"10\",\n \"ticks\": [\n {\n \"from\": \"0\",\n \"to\": null,\n \"size\": \"0.01\"\n }\n ],\n \"orderTypes\": [\n \"market\",\n \"limit\"\n ],\n \"timeInForce\": [\n \"gtc\"\n ],\n \"mappings\": [],\n \"sessions\": {\n \"timezone\": \"UTC\",\n \"coverageFrom\": \"2026-01-01\",\n \"coverageThrough\": \"2026-12-31\",\n \"weekly\": [\n {\n \"day\": 0,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 1,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 2,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 3,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 4,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 5,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 6,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n }\n ],\n \"holidays\": []\n },\n \"expiresAt\": null,\n \"lastTradeAt\": null,\n \"pricing\": {\n \"sourceId\": \"example-feed\",\n \"stopTrigger\": \"last\",\n \"maxAgeMs\": 1000\n },\n \"entitlement\": null,\n \"state\": \"enabled\"\n }\n}"
response = http.request(request)
puts response.read_body{
"instrument": {
"id": "00000000-0000-0000-0000-000000000001",
"venueId": "00000000-0000-0000-0000-000000000001",
"environment": "sandbox",
"specification": {
"instrumentId": "BTCUSD",
"version": "v1",
"venueId": "00000000-0000-0000-0000-000000000001",
"symbol": "BTCUSD",
"name": "Bitcoin / USD",
"productModel": "linear_spot",
"quoteCurrency": "USD",
"settlementCurrency": "USD",
"negativePrices": false,
"quantity": {
"unit": "base_units",
"lotSize": "1",
"min": "0.001",
"max": "100",
"step": "0.001"
},
"contractMultiplier": "1",
"minNotional": "10",
"ticks": [
{
"from": "0",
"to": null,
"size": "0.01"
}
],
"orderTypes": [
"market",
"limit"
],
"timeInForce": [
"gtc"
],
"mappings": [],
"sessions": {
"timezone": "UTC",
"coverageFrom": "2026-01-01",
"coverageThrough": "2026-12-31",
"weekly": [
{
"day": 0,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 1,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 2,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 3,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 4,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 5,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 6,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
}
],
"holidays": []
},
"expiresAt": null,
"lastTradeAt": null,
"pricing": {
"sourceId": "example-feed",
"stopTrigger": "last",
"maxAgeMs": 1000
},
"entitlement": null,
"state": "enabled"
},
"contentHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"createdAt": "2026-09-14T12:00:00.000Z",
"state": "candidate",
"tradingReady": 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"
}Instruments
Save an instrument candidate
Saves the definition of an instrument your accounts could trade: its product, quantity and price rules, sessions, pricing source and the provider symbols it maps to. Every rule is checked, and saving changes no account and no active catalog: activate the candidate to make it tradable. The response is the stored candidate. 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}
/
instruments
TypeScript
const res = await fetch('https://app.trdrs.co/api/venues/{venueId}/instruments', {
method: 'POST',
headers: {
'content-type': 'application/json',
Authorization: `Bearer ${process.env.TRDRS_VENUE_KEY}`,
"Idempotency-Key": "example-request-1",
},
body: JSON.stringify({
"specification": {
"instrumentId": "BTCUSD",
"version": "v1",
"venueId": "00000000-0000-0000-0000-000000000001",
"symbol": "BTCUSD",
"name": "Bitcoin / USD",
"productModel": "linear_spot",
"quoteCurrency": "USD",
"settlementCurrency": "USD",
"negativePrices": false,
"quantity": {
"unit": "base_units",
"lotSize": "1",
"min": "0.001",
"max": "100",
"step": "0.001"
},
"contractMultiplier": "1",
"minNotional": "10",
"ticks": [
{
"from": "0",
"to": null,
"size": "0.01"
}
],
"orderTypes": [
"market",
"limit"
],
"timeInForce": [
"gtc"
],
"mappings": [],
"sessions": {
"timezone": "UTC",
"coverageFrom": "2026-01-01",
"coverageThrough": "2026-12-31",
"weekly": [
{
"day": 0,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 1,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 2,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 3,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 4,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 5,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 6,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
}
],
"holidays": []
},
"expiresAt": null,
"lastTradeAt": null,
"pricing": {
"sourceId": "example-feed",
"stopTrigger": "last",
"maxAgeMs": 1000
},
"entitlement": null,
"state": "enabled"
}
}),
})
const data = await res.json()curl -X POST 'https://app.trdrs.co/api/venues/{venueId}/instruments' \
-H "Authorization: Bearer $TRDRS_VENUE_KEY" \
-H 'Idempotency-Key: example-request-1' \
-H 'content-type: application/json' \
-d '{"specification":{"instrumentId":"BTCUSD","version":"v1","venueId":"00000000-0000-0000-0000-000000000001","symbol":"BTCUSD","name":"Bitcoin / USD","productModel":"linear_spot","quoteCurrency":"USD","settlementCurrency":"USD","negativePrices":false,"quantity":{"unit":"base_units","lotSize":"1","min":"0.001","max":"100","step":"0.001"},"contractMultiplier":"1","minNotional":"10","ticks":[{"from":"0","to":null,"size":"0.01"}],"orderTypes":["market","limit"],"timeInForce":["gtc"],"mappings":[],"sessions":{"timezone":"UTC","coverageFrom":"2026-01-01","coverageThrough":"2026-12-31","weekly":[{"day":0,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":1,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":2,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":3,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":4,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":5,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]},{"day":6,"windows":[{"startMinute":0,"endMinute":0,"endDayOffset":1}]}],"holidays":[]},"expiresAt":null,"lastTradeAt":null,"pricing":{"sourceId":"example-feed","stopTrigger":"last","maxAgeMs":1000},"entitlement":null,"state":"enabled"}}'import requests
url = "https://app.trdrs.co/api/venues/{venueId}/instruments"
payload = { "specification": {
"instrumentId": "BTCUSD",
"version": "v1",
"venueId": "00000000-0000-0000-0000-000000000001",
"symbol": "BTCUSD",
"name": "Bitcoin / USD",
"productModel": "linear_spot",
"quoteCurrency": "USD",
"settlementCurrency": "USD",
"negativePrices": False,
"quantity": {
"unit": "base_units",
"lotSize": "1",
"min": "0.001",
"max": "100",
"step": "0.001"
},
"contractMultiplier": "1",
"minNotional": "10",
"ticks": [
{
"from": "0",
"to": None,
"size": "0.01"
}
],
"orderTypes": ["market", "limit"],
"timeInForce": ["gtc"],
"mappings": [],
"sessions": {
"timezone": "UTC",
"coverageFrom": "2026-01-01",
"coverageThrough": "2026-12-31",
"weekly": [
{
"day": 0,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 1,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 2,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 3,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 4,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 5,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 6,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
}
],
"holidays": []
},
"expiresAt": None,
"lastTradeAt": None,
"pricing": {
"sourceId": "example-feed",
"stopTrigger": "last",
"maxAgeMs": 1000
},
"entitlement": None,
"state": "enabled"
} }
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}/instruments",
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([
'specification' => [
'instrumentId' => 'BTCUSD',
'version' => 'v1',
'venueId' => '00000000-0000-0000-0000-000000000001',
'symbol' => 'BTCUSD',
'name' => 'Bitcoin / USD',
'productModel' => 'linear_spot',
'quoteCurrency' => 'USD',
'settlementCurrency' => 'USD',
'negativePrices' => false,
'quantity' => [
'unit' => 'base_units',
'lotSize' => '1',
'min' => '0.001',
'max' => '100',
'step' => '0.001'
],
'contractMultiplier' => '1',
'minNotional' => '10',
'ticks' => [
[
'from' => '0',
'to' => null,
'size' => '0.01'
]
],
'orderTypes' => [
'market',
'limit'
],
'timeInForce' => [
'gtc'
],
'mappings' => [
],
'sessions' => [
'timezone' => 'UTC',
'coverageFrom' => '2026-01-01',
'coverageThrough' => '2026-12-31',
'weekly' => [
[
'day' => 0,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 1,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 2,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 3,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 4,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 5,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
],
[
'day' => 6,
'windows' => [
[
'startMinute' => 0,
'endMinute' => 0,
'endDayOffset' => 1
]
]
]
],
'holidays' => [
]
],
'expiresAt' => null,
'lastTradeAt' => null,
'pricing' => [
'sourceId' => 'example-feed',
'stopTrigger' => 'last',
'maxAgeMs' => 1000
],
'entitlement' => null,
'state' => 'enabled'
]
]),
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}/instruments"
payload := strings.NewReader("{\n \"specification\": {\n \"instrumentId\": \"BTCUSD\",\n \"version\": \"v1\",\n \"venueId\": \"00000000-0000-0000-0000-000000000001\",\n \"symbol\": \"BTCUSD\",\n \"name\": \"Bitcoin / USD\",\n \"productModel\": \"linear_spot\",\n \"quoteCurrency\": \"USD\",\n \"settlementCurrency\": \"USD\",\n \"negativePrices\": false,\n \"quantity\": {\n \"unit\": \"base_units\",\n \"lotSize\": \"1\",\n \"min\": \"0.001\",\n \"max\": \"100\",\n \"step\": \"0.001\"\n },\n \"contractMultiplier\": \"1\",\n \"minNotional\": \"10\",\n \"ticks\": [\n {\n \"from\": \"0\",\n \"to\": null,\n \"size\": \"0.01\"\n }\n ],\n \"orderTypes\": [\n \"market\",\n \"limit\"\n ],\n \"timeInForce\": [\n \"gtc\"\n ],\n \"mappings\": [],\n \"sessions\": {\n \"timezone\": \"UTC\",\n \"coverageFrom\": \"2026-01-01\",\n \"coverageThrough\": \"2026-12-31\",\n \"weekly\": [\n {\n \"day\": 0,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 1,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 2,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 3,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 4,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 5,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 6,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n }\n ],\n \"holidays\": []\n },\n \"expiresAt\": null,\n \"lastTradeAt\": null,\n \"pricing\": {\n \"sourceId\": \"example-feed\",\n \"stopTrigger\": \"last\",\n \"maxAgeMs\": 1000\n },\n \"entitlement\": null,\n \"state\": \"enabled\"\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}/instruments")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"specification\": {\n \"instrumentId\": \"BTCUSD\",\n \"version\": \"v1\",\n \"venueId\": \"00000000-0000-0000-0000-000000000001\",\n \"symbol\": \"BTCUSD\",\n \"name\": \"Bitcoin / USD\",\n \"productModel\": \"linear_spot\",\n \"quoteCurrency\": \"USD\",\n \"settlementCurrency\": \"USD\",\n \"negativePrices\": false,\n \"quantity\": {\n \"unit\": \"base_units\",\n \"lotSize\": \"1\",\n \"min\": \"0.001\",\n \"max\": \"100\",\n \"step\": \"0.001\"\n },\n \"contractMultiplier\": \"1\",\n \"minNotional\": \"10\",\n \"ticks\": [\n {\n \"from\": \"0\",\n \"to\": null,\n \"size\": \"0.01\"\n }\n ],\n \"orderTypes\": [\n \"market\",\n \"limit\"\n ],\n \"timeInForce\": [\n \"gtc\"\n ],\n \"mappings\": [],\n \"sessions\": {\n \"timezone\": \"UTC\",\n \"coverageFrom\": \"2026-01-01\",\n \"coverageThrough\": \"2026-12-31\",\n \"weekly\": [\n {\n \"day\": 0,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 1,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 2,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 3,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 4,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 5,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 6,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n }\n ],\n \"holidays\": []\n },\n \"expiresAt\": null,\n \"lastTradeAt\": null,\n \"pricing\": {\n \"sourceId\": \"example-feed\",\n \"stopTrigger\": \"last\",\n \"maxAgeMs\": 1000\n },\n \"entitlement\": null,\n \"state\": \"enabled\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/venues/{venueId}/instruments")
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 \"specification\": {\n \"instrumentId\": \"BTCUSD\",\n \"version\": \"v1\",\n \"venueId\": \"00000000-0000-0000-0000-000000000001\",\n \"symbol\": \"BTCUSD\",\n \"name\": \"Bitcoin / USD\",\n \"productModel\": \"linear_spot\",\n \"quoteCurrency\": \"USD\",\n \"settlementCurrency\": \"USD\",\n \"negativePrices\": false,\n \"quantity\": {\n \"unit\": \"base_units\",\n \"lotSize\": \"1\",\n \"min\": \"0.001\",\n \"max\": \"100\",\n \"step\": \"0.001\"\n },\n \"contractMultiplier\": \"1\",\n \"minNotional\": \"10\",\n \"ticks\": [\n {\n \"from\": \"0\",\n \"to\": null,\n \"size\": \"0.01\"\n }\n ],\n \"orderTypes\": [\n \"market\",\n \"limit\"\n ],\n \"timeInForce\": [\n \"gtc\"\n ],\n \"mappings\": [],\n \"sessions\": {\n \"timezone\": \"UTC\",\n \"coverageFrom\": \"2026-01-01\",\n \"coverageThrough\": \"2026-12-31\",\n \"weekly\": [\n {\n \"day\": 0,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 1,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 2,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 3,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 4,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 5,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n },\n {\n \"day\": 6,\n \"windows\": [\n {\n \"startMinute\": 0,\n \"endMinute\": 0,\n \"endDayOffset\": 1\n }\n ]\n }\n ],\n \"holidays\": []\n },\n \"expiresAt\": null,\n \"lastTradeAt\": null,\n \"pricing\": {\n \"sourceId\": \"example-feed\",\n \"stopTrigger\": \"last\",\n \"maxAgeMs\": 1000\n },\n \"entitlement\": null,\n \"state\": \"enabled\"\n }\n}"
response = http.request(request)
puts response.read_body{
"instrument": {
"id": "00000000-0000-0000-0000-000000000001",
"venueId": "00000000-0000-0000-0000-000000000001",
"environment": "sandbox",
"specification": {
"instrumentId": "BTCUSD",
"version": "v1",
"venueId": "00000000-0000-0000-0000-000000000001",
"symbol": "BTCUSD",
"name": "Bitcoin / USD",
"productModel": "linear_spot",
"quoteCurrency": "USD",
"settlementCurrency": "USD",
"negativePrices": false,
"quantity": {
"unit": "base_units",
"lotSize": "1",
"min": "0.001",
"max": "100",
"step": "0.001"
},
"contractMultiplier": "1",
"minNotional": "10",
"ticks": [
{
"from": "0",
"to": null,
"size": "0.01"
}
],
"orderTypes": [
"market",
"limit"
],
"timeInForce": [
"gtc"
],
"mappings": [],
"sessions": {
"timezone": "UTC",
"coverageFrom": "2026-01-01",
"coverageThrough": "2026-12-31",
"weekly": [
{
"day": 0,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 1,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 2,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 3,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 4,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 5,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
},
{
"day": 6,
"windows": [
{
"startMinute": 0,
"endMinute": 0,
"endDayOffset": 1
}
]
}
],
"holidays": []
},
"expiresAt": null,
"lastTradeAt": null,
"pricing": {
"sourceId": "example-feed",
"stopTrigger": "last",
"maxAgeMs": 1000
},
"entitlement": null,
"state": "enabled"
},
"contentHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"createdAt": "2026-09-14T12:00:00.000Z",
"state": "candidate",
"tradingReady": 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
The definition of an instrument candidate. Saving it activates nothing and lets no order through. The rules checked across fields: quote and settlement currencies match unless a base-unit perpetual states the supported fixed one-to-one quanto payoff and matches its registered backing contract; a future counts contracts and states its expiry and last trade, and spot counts base units; quantity bounds sit on the step, lotSize is 1 unless the unit is lots, and the multiplier is 1 for base units and equals lotSize for lots. Price ranges in ticks run on from zero with no gap and cover every allowed price, a null bound meaning no end, and only a future may allow negative prices. An instrument that names an entitlement is priced from each trader's own feed, so its pricing.sourceId must be a source trdrs serves per trader (Rithmic today); any other is refused as entitled_source_unserved on instrument.pricing.sourceId, both here and when an older candidate is activated. The weekly calendar lists all seven days once, a holiday replaces the windows of its local opening date (overnight ones included), overlapping windows and daylight-saving times that are ambiguous or don't exist are refused, coverage dates are explicit, and every mapping belongs to this venue and environment.
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