For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api.md.

API reference

Every endpoint of every True Markets API. Requests and responses are JSON, and authenticated calls carry a bearer token.

Trading, Accounts, Authentication and Market Data share one host, api.truemarkets.co. Exchange REST, for firms with direct exchange access, has its own host, api.truex.co.

How the reference is organized

Each API has its own section below, with its base URL and every endpoint. The REST sections are generated from our OpenAPI specs, and the WebSocket sections from our AsyncAPI specs. Each endpoint page lists every field, response and error code, and a Try in Playground button.

The reference tells you what each endpoint accepts. For which calls to make and in what order, follow the guides for Gateway or the Trading API.

Authentication

Mint a token from your API key with POST /v1/auth/api-key/token, then send it in Authorization: Bearer. When you act for one of your users on Gateway, the request also carries TM-On-Behalf-Of. Authentication has the flow, and API keys explains the keys.

Exchange REST takes the same token, on its own host, plus an x-truex-auth-timestamp header. Trade over REST has the headers. Direct access guides start at About Institutional.

An authenticated request
curl https://api.truemarkets.co/v1/gateway/balances \
  -H "Authorization: Bearer $TOKEN"

Errors

Every error returns the same body. type sets the HTTP status, code names the specific condition, and request_id identifies the request when you write to support. Errors has the full table and what to retry.

Trading REST

Quotes, orders, transfers, balances and transactions, for your own account or for a user you act for.

Open reference

Base URL

https://api.truemarkets.co/v1/gateway

Endpoints

Market Data REST

Prices, candles and history across venues, without a token.

Open reference

Base URL

https://api.truemarkets.co

Endpoints

WebSocket

Exchange REST

Order entry, balances and market data on the CeFi venue, for firms with direct access.

Open reference

Base URL

https://api.truex.co

Endpoints

WebSocket

Exchange FIX

Order entry, drop copy and market data over FIX 5.0 SP2 sessions, for firms with direct exchange access.

Open reference

Pages

Was this page helpful?YesNo