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. CeFi direct REST, which institutional clients use to trade on the exchange, 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 has a Try it panel.

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 a Gateway client acts for one of its users, the request also carries TM-On-Behalf-Of. Authentication has the flow, and API keys explains the keys.

CeFi direct REST signs each request with HMAC instead. Its reference has the recipe.

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.

Authentication REST

Exchange an API key signature for a token, and refresh it.

Open reference

Base URL

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

Endpoints

Authentication

POST/token/refreshRefresh access tokenPOST/api-key/tokenExchange API key for tokens

OAuth

GET/oauth/authorizeStart an authorization requestPOST/oauth/consentRecord a consent decisionPOST/oauth/tokenExchange a grant for tokensGET/.well-known/oauth-resource-jwks.jsonOAuth resource token key setGET/oauth/authorize/detailsDescribe an authorization requestGET/oauth/consentsList connected appsDELETE/oauth/consents/{client_id}Revoke a connected appPOST/oauth/registerRegister an OAuth clientGET/.well-known/oauth-authorization-serverAuthorization server metadata

Accounts REST

Create the users your organization trades for, with their wallets, and read deposit details.

Open reference

Base URL

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

Endpoints

Deposits

POST/deposits/addressesCreate deposit addressGET/deposits/addressesList deposit addressesPOST/deposits/wire-instructionsCreate wire instructionsGET/deposits/wire-instructionsList wire instructions

Organizations

POST/organizations/{organization_id}/usersCreate a user your organization trades forGET/organizations/{organization_id}/usersList the users your organization trades forGET/organizations/{organization_id}/users/{user_id}Get a user your organization trades for

Trading Setup

GET/me/tradingGet the user's trading setup

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

Quotes

POST/quotesCompute market quote (CeFi only)

Orders

POST/ordersCreate new orderGET/ordersList user ordersPOST/orders/{id}/executeExecute pending orderPOST/orders/all/cancelCancel all open orders on a venuePOST/orders/{id}/cancelCancel a limit or TP/SL order (CeFi or DeFi)POST/orders/{id}/cancel/executeExecute a resting DeFi order cancellationGET/orders/{id}Get a single orderPATCH/orders/{id}Modify an active limit orderGET/orders/{id}/statusGet order status

Transfers

POST/transfersCreate new transferGET/transfersList user transfersPOST/transfers/{id}/executeExecute pending transferGET/transfers/{id}Get transfer by ID

Ramps

POST/rampsCreate a rampGET/rampsList user rampsGET/ramps/{id}Get ramp by IDPOST/ramps/{id}/bridge/executeExecute a ramp's bridge planPOST/ramps/{id}/preparePrepare a ramp's on-chain transferPOST/ramps/{id}/executeExecute a ramp's on-chain transfer

Custody

GET/custody/allocationsList allocationsPOST/custody/allocationsAllocate funds to CeFiGET/custody/allocations/{id}Get allocationGET/custody/releasesList releasesPOST/custody/releasesRelease funds from CeFiGET/custody/releases/{id}Get release

Paper Trading

POST/paper/depositsAdd test funds (paper trading only)POST/paper/withdrawalsRemove test funds (paper trading only)

Transactions

GET/transactionsList user transactionsGET/organizations/{organization_id}/transactionsList organization transactions

Assets

GET/assets/availabilityGet asset availability for the caller's countryGET/assetsList tradeable assetsGET/assets/{chain}/{address}Get one asset by chain and address

Balances

GET/balances/unifiedList balancesGET/balancesGet user balancesGET/portfolioGet the authenticated user's portfolio

Positions

GET/positionsList open positions

CeFi direct 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

Service

GET/v1/cefi/healthGet service healthGET/v1/cefi/versionsGet supported API versions

Assets

GET/v1/cefi/assetsGet assets

Instruments

GET/v1/cefi/instrumentsGet instruments

Market Data

GET/v1/cefi/market/quoteGet marketsGET/v1/cefi/market/auctionGet auction state and indicativePOST/v1/cefi/markets/quoteCompute market quote

Clients

GET/v1/cefi/clientsGet clientsPATCH/v1/cefi/clientsUpdate settingsGET/v1/cefi/clients/feesGet client fees

Orders

GET/v1/cefi/ordersGet ordersPOST/v1/cefi/ordersCreate orderPATCH/v1/cefi/ordersModify orderDELETE/v1/cefi/orders/{ref_id}Cancel orderDELETE/v1/cefi/orders/allCancel all ordersGET/v1/cefi/orders/activeActive ordersGET/v1/cefi/orders/tradeAll order tradesGET/v1/cefi/orders/activityAll order activityGET/v1/cefi/orders/status/{ref_id}Status order

Balances

GET/v1/cefi/balancesGet balanceGET/v1/cefi/balances/activityGet balance activity

Transfers

GET/v1/cefi/transfersGet transferPOST/v1/cefi/transfersInitiate transferGET/v1/cefi/transfers/activeGet Active transfers

WebSocket

CeFi direct WebSocket Order book, trades, auction and drop-copy streams from the CeFi venue.

/v1/cefi/marketsend subscribereceive welcomereceive heartbeatreceive confirmationreceive instrumentreceive tradereceive ebboreceive depthreceive auctionreceive dropcopy

CeFi direct FIX

Order entry, drop copy and market data over FIX 5.0 SP2 sessions, for Institutional clients.

Open reference

Pages

FIXOverviewSession model, versions and the TrueX_FIX50SP2.xml specFIXAdministrativeLogon, heartbeat, test request, logoutFIXCommon componentsHeader, trailer and shared groupsFIXOrder entryNew order, cancel, replace, execution reportsFIXDrop copyExecution report copies for a sessionFIXMarket dataSnapshots and incremental refreshFIXChange logWhat changed in the FIX spec

Market data REST

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

Open reference

Base URL

https://api.truemarkets.co

Endpoints

Prices

GET/v1/defi/market/pricesGet price candles by symbolGET/v1/defi/market/prices/historyGet price history for a symbolGET/v1/defi/market/prices/history/pointGet price at a point in timeGET/v1/defi/market/prices/history/batchGet price history for multiple symbolsGET/v1/defi/market/prices/indicatorsGet a technical indicator seriesGET/v1/defi/market/prices/rangeGet min/max price over a windowGET/v1/defi/market/prices/candlesGet OHLC candles for a symbolGET/v1/assets/prices/historyGet price history for an assetGET/v1/assets/prices/rangeGet the min and max price for an assetGET/v1/assets/prices/indicatorsGet technical indicator lines for an asset

Market Cap

GET/v1/defi/market/market-data/market-capGet market cap by symbolGET/v1/defi/market/market-data/market-capsList top assets by market capGET/v1/defi/market/market-data/market-cap/historyGet reported market-cap history

Market Feed

GET/v1/defi/market/market-data/perp/historyGet perp funding rate and open interest historyGET/v1/defi/market/market-data/volume/historyGet reported 24h volume historyGET/v1/defi/market/market-data/scans/historyGet a market ranking at every bucket of a windowGET/v1/defi/market/market-data/trendingList trending assetsGET/v1/defi/market/market-data/surgingList surging assets

Streams

GET/v1/defi/market/stream/bboStream BBO quotesHEAD/v1/defi/market/stream/bboProbe the BBO stream

CeFi

GET/v1/cefi/market/prices/historyGet CeFi instrument price historyGET/v1/cefi/market/prices/indicatorsGet a technical indicator series for a CeFi instrumentGET/v1/cefi/market/prices/rangeGet CeFi min/max price over a window

WebSocket

Market data WebSocket Batched candles, trending and surging assets, and reference prices as they update.

/v1/defi/marketsend subscribereceive subscriptionResponsereceive priceCandlesreceive trendingAssetsreceive surgingAssetsreceive referencePricesreceive orderbookreceive error