const res = await fetch('https://app.trdrs.co/api/market/symbol-info?symbol=ESU6', {
headers: { Authorization: `Bearer ${process.env.TRDRS_API_KEY}` },
})
const data = await res.json()curl 'https://app.trdrs.co/api/market/symbol-info?symbol=ESU6' \
-H "Authorization: Bearer $TRDRS_API_KEY"import requests
url = "https://app.trdrs.co/api/market/symbol-info"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trdrs.co/api/market/symbol-info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.trdrs.co/api/market/symbol-info"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.trdrs.co/api/market/symbol-info")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/market/symbol-info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"symbol": "ESU6",
"name": "E-mini S&P 500 Sep 2026",
"ticker": "ESU6",
"description": "E-mini S&P 500 Sep 2026",
"exchange": "CME",
"listedExchange": "CME",
"type": "future",
"supportedResolutions": [],
"timezone": "America/Chicago",
"session": "1700-1600:23456",
"sessionHolidays": "20261225,20270101",
"corrections": "1700-1200:20261126;1700-1215:20261127,20261224",
"subsessions": [
{
"id": "regular",
"session": "0830-1515:23456",
"sessionCorrections": "0830-1200:20261126;0830-1215:20261127,20261224"
},
{
"id": "extended",
"session": "1700-1600:23456",
"sessionCorrections": "1700-1200:20261126;1700-1215:20261127,20261224"
},
{
"id": "premarket",
"session": "1700-0830:23456"
},
{
"id": "postmarket",
"session": "1515-1600:23456"
}
],
"dataStatus": "streaming",
"currencyCode": "USD",
"volumePrecision": 0,
"format": {
"pricescale": 100,
"minmov": 25
},
"provider": "rithmic",
"tick": 0.25,
"quotes": true,
"sessionClass": "futures",
"sessionCalendar": {
"holidays": {
"2026-12-25": []
},
"coverageThrough": "2027-06-30"
},
"multiplier": 50,
"market": "CME:ESU2026"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}{
"error": "invalid_instrument"
}Get symbol details
Returns what you need to display and chart one symbol: its names, how its prices are written, its tick size and multiplier, and its sessions and holiday calendar. Fetch it once per symbol and keep it for the session, so your charts and order tickets never hard-code exchange conventions. It answers even when no feed is set up for the symbol.
A futures root, a continuous symbol such as ES1! or ES2!, and a dated contract such as CME:ESZ2026 or ESZ6 share their product’s details, and each is named for what it is: E-mini S&P 500, E-mini S&P 500 continuous front month, E-mini S&P 500 Dec 2026.
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:read or 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/market/symbol-info?symbol=ESU6', {
headers: { Authorization: `Bearer ${process.env.TRDRS_API_KEY}` },
})
const data = await res.json()curl 'https://app.trdrs.co/api/market/symbol-info?symbol=ESU6' \
-H "Authorization: Bearer $TRDRS_API_KEY"import requests
url = "https://app.trdrs.co/api/market/symbol-info"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.trdrs.co/api/market/symbol-info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.trdrs.co/api/market/symbol-info"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.trdrs.co/api/market/symbol-info")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.trdrs.co/api/market/symbol-info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"symbol": "ESU6",
"name": "E-mini S&P 500 Sep 2026",
"ticker": "ESU6",
"description": "E-mini S&P 500 Sep 2026",
"exchange": "CME",
"listedExchange": "CME",
"type": "future",
"supportedResolutions": [],
"timezone": "America/Chicago",
"session": "1700-1600:23456",
"sessionHolidays": "20261225,20270101",
"corrections": "1700-1200:20261126;1700-1215:20261127,20261224",
"subsessions": [
{
"id": "regular",
"session": "0830-1515:23456",
"sessionCorrections": "0830-1200:20261126;0830-1215:20261127,20261224"
},
{
"id": "extended",
"session": "1700-1600:23456",
"sessionCorrections": "1700-1200:20261126;1700-1215:20261127,20261224"
},
{
"id": "premarket",
"session": "1700-0830:23456"
},
{
"id": "postmarket",
"session": "1515-1600:23456"
}
],
"dataStatus": "streaming",
"currencyCode": "USD",
"volumePrecision": 0,
"format": {
"pricescale": 100,
"minmov": 25
},
"provider": "rithmic",
"tick": 0.25,
"quotes": true,
"sessionClass": "futures",
"sessionCalendar": {
"holidays": {
"2026-12-25": []
},
"coverageThrough": "2027-06-30"
},
"multiplier": 50,
"market": "CME:ESU2026"
}{
"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 symbol, or a spread expression as /api/market/history accepts. A spread resolves as type spread, with no tick and no quotes. A string that exactly matches a catalog symbol is always that symbol, never arithmetic.
Response
The symbol's details. A known symbol with no feed set up still resolves, with provider null.
Everything you need to display and chart one symbol: its identity, how its prices are written, and its trading sessions and holidays.
The symbol as you asked for it.
The short display name.
The symbol id to use in every later call, to resolve or subscribe.
The long display name.
The exchange the symbol trades on.
The exchange that lists the symbol.
The kind of instrument, as symbol search writes it in each row's type. A spread expression resolves as spread.
The timeframes this symbol's feed serves. Empty means the feed serves any timeframe the format from /api/market/config accepts, rather than a short list that would promise less than it serves.
The IANA time zone of the exchange session, such as America/Chicago.
The weekly session in exchange time, as HHMM-HHMM. A trading-day suffix (1 is Sunday through 7 is Saturday) marks a session that opens on the previous calendar day, and 24x7 marks a market that never closes.
How live the data is for you. streaming means a real-time feed serves the symbol. delayed_streaming means your feed sends prices the exchange has delayed: show them as delayed, because they never count as real time. endofday means no feed serves it.
streaming, endofday, delayed_streaming How many decimal places to show for volume: 0 for a market that trades whole units, otherwise the provider's size step.
How to write the symbol's prices.
Show child attributes
Show child attributes
The provider that publishes the data, or null when no feed is set up for the symbol.
rithmic, null The smallest price move, or null when the symbol has none, as a spread expression doesn't.
True when the feed serves real top-of-book quotes for the symbol.
The trading-session model the symbol follows. trdrs states it, so you never have to guess it.
equity, futures, fx, crypto What a price move of 1.0 is worth per unit, in dollars, or null until known.
The market key the symbol names: the one name of the market an order trades, whichever feed or provider names the symbol. A perpetual is its registered symbol (HYPERLIQUID:BTC), a dated future its contract (CME:ESZ2026, from ESZ6, ESZ2026 or CME_MINI:ESZ2026), a continuous future its product and position (CME:ES1!, and CME:ES2!; a root such as ES names position 1), and a CFD its contract. An account's markets are matched by it, so two symbols with the same key are the same market. Null for a symbol that names no market: a venue's published data series, a spread, or a futures root trdrs holds no contract specification for. It is data only, and no account trades it.
The ticker a builder-deployed Hyperliquid market is read by, as symbol search writes it in each row's displaySymbol. Present only for builder-deployed markets.
The exchange a builder-deployed Hyperliquid market is read by, as symbol search writes it in each row's displayExchange. Present where that row's is.
The full name of the builder-deployed perp dex that lists the market, as symbol search writes it in each row's dex. Present only for builder-deployed markets.
The days the market is fully closed, as comma-separated YYYYMMDD dates in order. Present only when sessionCalendar is.
The trading days whose hours differ from the weekly session, as semicolon-separated hours:dates entries. The hours use the same format as session, without a trading-day suffix: a start later than the end opens on the previous calendar day, and hours that run to midnight end at 0000. The dates are an ordered, comma-separated YYYYMMDD list. Full closures are never listed here, because they are in sessionHolidays. Present only when the served calendar holds a shortened trading day.
"1700-1200:20261126;1700-1215:20261127,20261224"
The named sessions of a market that keeps extended hours: regular, extended, premarket and postmarket. For a stock, the regular entry has the same hours as session, and the extended hours appear only here. For a future, the extended entry has the same hours as session, and the regular entry states the regular trading hours inside it. Read pre-market and post-market status and extended-hours shading from here. Present for stocks and futures, and absent for FX, crypto and spreads, which have one session with no named parts.
Show child attributes
Show child attributes
[ { "id": "regular", "session": "0930-1600", "sessionCorrections": "0930-1300:20261127,20261224" }, { "id": "extended", "session": "0400-2000", "sessionCorrections": "0400-1700:20261127,20261224" }, { "id": "premarket", "session": "0400-0930" }, { "id": "postmarket", "session": "1600-2000", "sessionCorrections": "1300-1700:20261127,20261224" } ]
The quote currency: an ISO 4217 code for a market quoted in money, or the quote asset the provider declares for a perpetual margined in a stablecoin. Absent when the instrument declares none.
The unit a symbol that isn't quoted in a currency is quoted in.
The holiday calendar for the symbol's session model, for futures and stocks. It is absent for FX and crypto. Dates are exchange-local YYYY-MM-DD, an empty list of stretches is a full closure, and a date that isn't listed follows the weekday rules. trdrs keeps this calendar up to date every year, so your client never ships its own calendar updates.
Show child attributes
Show child attributes