Create a Venue key
Install the back office, connect it to trdrs, and create a Venue key on its API keys page.
Create a Trading API key
Sign in and create a Trading API key for your own accounts in API access.
Agent prompts
Copy a prompt for your first request, a venue, trading, market data, Connect or a public provider.
Sandbox API contract
Read the OpenAPI document the sandbox engine serves, every route and model in one file.
Documentation index
Give the agent a list of every guide, so it reads the right ones before writing code.
Keep keys out of the prompt
Put the key in your backend’s secret environment, and tell the agent the variable’s name, never its value. Don’t put a key in a prompt, commit it, or ship it in browser or mobile code. The prompts on Agent prompts useTRDRS_TRADING_API_KEY, TRDRS_VENUE_KEY,
TRDRS_API_KEY for a Connect app’s API key, and TRDRS_PRE_REGISTRATION_KEY.
Make one working request
Before the agent builds anything, have it prove the key and the base URL with one read that changes nothing.- Follow Choose your quickstart to create the key your job needs. Venue keys come from the back office’s API keys page, Trading API keys from your trdrs profile, and Connect API keys from the Connect dashboard.
- Store it on your server and set
TRDRS_API_BASE_URL=https://sandbox.trdrs.co. - With a Trading API key, call
GET /api/instruments. With a Venue key, callGET /api/venues/{venueId}/instruments/active, where a new venue’s empty list is still a success. With a Connect app’s API key, callGET /api/account/listnaming a trader your app has never linked inx-trdrs-trader, where404trader_not_foundis the success. - Expect
200for the Trading API key and Venue key reads. For a new Connect trader, the expected404trader_not_foundconfirms that the key works. For a Trading API key, select Check request status in API access to confirm that its first request arrived.
Pick the key for the job
A Venue key runs one venue from your backend, its setup and its accounts. A Connect app’s API key
creates Connect links and, naming a trader on each request, reads that trader’s accounts and routes
their orders. A Trading API key reaches only its owner’s accounts. Core concepts
explains venues, groups, providers and the paper book, and it’s the first page an agent should
read.
Give the agent one job
Give each job its own prompt, and tell the agent not to invent routes the contract doesn’t list.- Issue evaluation accounts on the paper book: Run a venue, then Venue accounts.
- Pre-register traders at a built-in provider: Connect pre-registration, for accounts that already exist at a built-in provider.
- Build your own trading interface on Connect: the Connect prompt, with the Connect quickstart, the Connect SDK and Route your traders’ orders.
- Build a trading app: Build a front end and its charting guide. Keep every key on the backend.
- Write a public provider: Provider conformance.
Check what the agent built
Run the conformance prompt against your integration, then a conformance run in the sandbox. It drives your own client through retries, deliberate errors and stream reconnects, and records the result. Use dedicated test accounts, because the run injects errors and places sandbox orders. A Connect app runs its own ruleset instead: Pass Connect conformance. A passing conformance run proves the behavior it measures. It doesn’t make a venue Listed or prove every business rule.Next steps
Agent prompts
Copy the starting instructions and the prompt for your job.
Choose your quickstart
Find the walkthrough and key for your integration, and make your first request by hand.