Skip to content
APIs
/
/Quotes

True Markets Gateway API (1.0.0)

Gateway API for the True Markets trading platform - order orchestration, quotes, and balance management

Download OpenAPI description
v1.json
v1.yaml
Languages
Servers
Mock server

https://docs.truemarkets.co/_mock/apis/gateway/v1/

Production

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

Quotes

Request real-time market quotes for trading pairs without creating an order.

Operations

Compute market quote

Request

Returns a quote for a market order without creating an order

Bodyapplication/jsonrequired
base_assetstringrequired

Base asset identifier (e.g. BTC, ETH, SOL)

Example: "BTC"
quote_assetstringrequired

Quote asset identifier (e.g. USD, USDC)

Example: "USD"
qtystringrequired

Quantity as a positive decimal string

Example: "0.5"
qty_unitstringrequired

Unit of the quantity.

  • base — Quantity is denominated in the base asset (e.g. 0.5 BTC).
  • quote — Quantity is denominated in the quote asset (e.g. 1000 USD).
Enum"base""quote"
Example: "quote"
sidestring(OrderSide)required

The side of the order.

  • buy — Purchase the base asset using the quote asset.
  • sell — Sell the base asset in exchange for the quote asset.
Enum"buy""sell"
curl -i -X POST \
  https://docs.truemarkets.co/_mock/apis/gateway/v1/quotes \
  -H 'Content-Type: application/json' \
  -d '{
    "base_asset": "BTC",
    "quote_asset": "USD",
    "qty": "0.5",
    "qty_unit": "quote",
    "side": "buy"
  }'

Responses

Quote computed successfully

Bodyapplication/json
qtystring

Expected output quantity as a decimal string. For a buy order this is the amount of base asset received; for a sell order it is the amount of quote asset received.

Example: "0.01485"
pricestring

Effective execution price per unit of base asset as a decimal string

Example: "67340.25"
Response
application/json
{
  "qty": "0.01485",
  "price": "67340.25"
}

Orders

Create, execute, cancel, and monitor orders across CeFi and DeFi.

Operations

Balances

Query account balances for the authenticated user.

Operations

List balances

Request

Returns unified balances across CeFi and DeFi for the authenticated user

Security
bearerAuth
curl -i -X GET \
  https://docs.truemarkets.co/_mock/apis/gateway/v1/balances/unified \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Balances retrieved successfully

Bodyapplication/json
dataArray of objects(BalanceItem)

List of asset balances

Response
application/json
{
  "data": [
    { … }
  ]
}