For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/account/true-markets-account-api.md.
Accounts REST
Account API for the True Markets platform — organization users, agreements and how a user is set up to trade.
Base URLs
| Environment | Base URL |
|---|---|
| Production | https://api.truemarkets.co/v1/account |
| UAT (sandbox) | https://api.uat.truemarkets.co/v1/account |
UAT is the testing environment. It may require VPN/allowlist access for some integrations — contact [email protected] if requests time out from a public network.
Authentication
All endpoints require a JWT access token in the Authorization: Bearer <token> header.
Getting credentials
There are two ways in, and each uses its own keys.
Gateway (an organization trading for its users). Create an organization and an API key in the dashboard, then mint a token with POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token, so mint a new one before it expires. Act for a user with TM-On-Behalf-Of: <user_id>, and sign that user's payloads with their signer key, not the organization API key.
Trading API (your own account).
- Create an account at https://www.truemarkets.co (passkey, email, magic link, or Sign in with Apple).
- Register an API key in your account's API Keys settings page. Generate an EC P-256 key pair locally and submit only the public key — the private key never leaves your machine. You'll receive a
key_id(UUID). The same key signs you in and signs your payloads. - Mint JWTs by calling
POST /v1/auth/api-key/tokenwithkey_id, a currenttimestamp(Unix seconds, within ±30s of server UTC time), andsignature— an ES256 (ECDSA P-256 + SHA-256) signature of the message{key_id}.{timestamp}, base64url-encoded. The response returnsaccess_tokenandrefresh_token. - Call the Account API with
Authorization: Bearer <access_token>. - Refresh expired access tokens via
POST /v1/auth/token/refreshwith therefresh_token— no re-signing required.
Quick start
# Mint a JWT
curl -X POST https://api.truemarkets.co/v1/auth/api-key/token \
-H "Content-Type: application/json" \
-d '{"key_id":"<UUID>","timestamp":<UNIX_SECONDS>,"signature":"<BASE64URL_ES256_SIG>"}'
# List your crypto deposit addresses
curl https://api.truemarkets.co/v1/account/deposits/addresses \
-H "Authorization: Bearer <ACCESS_TOKEN>"Support
Organizations
- List the users your organization trades for:
GET /organizations/{organization_id}/users - Create a user your organization trades for:
POST /organizations/{organization_id}/users - Get a user your organization trades for:
GET /organizations/{organization_id}/users/{user_id}
Trading Setup
- Get the user's trading setup:
GET /me/trading
Operations
- Get the user's trading setup:
GET /me/trading - List the users your organization trades for:
GET /organizations/{organization_id}/users - Create a user your organization trades for:
POST /organizations/{organization_id}/users - Get a user your organization trades for:
GET /organizations/{organization_id}/users/{user_id}
- Need help? Ask us on Discord, or email [email protected].
- See what changed in the changelog
List open positions GET
Returns a read-only list of the authenticated user's open positions. Data is fetched on demand from the venue; nothing is persisted.
List the users your organization trades for GET
Returns your organization's users, newest first. Page with the opaque cursor from pagination.next_cursor. Supply external_ref_id instead to look up a single user by the reference you created them with; a reference matching nothing is an empty page.