About Market data

Market data lets you read prices, candles and order books for the assets True Markets lists. The calls on this page need no account and no token, so you can make them before you build anything else. Gateway, the Trading API and institutional clients all read the same data.

Base URL

REST calls go to https://api.truemarkets.co with no Authorization header.

Get candles

A candle is the open, high, low and close price for one time bucket. Ask for an asset's candles over a lookback window, one candle per resolution. Both take the form {value}{unit}: window accepts m, h, d and M, and resolution accepts s, m, h and d.

asset_id is the asset's id in the asset catalog. What you can trade shows how to list the catalog and find it.

Hourly candles for the last day

curl -s -G \
  https://api.truemarkets.co/v1/defi/market/prices/candles \
  -d asset_id=a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d \
  -d window=1d \
  -d resolution=1h

200: candles come back oldest first, prices as strings

{
  "asset_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "symbol": "SOL",
  "window": "1d",
  "resolution": "1h",
  "candles": [
    { "t": "2026-09-28T16:00:00Z", "open": "195.10", "high": "196.02", "low": "194.80", "close": "195.31" }
  ]
}

Prices are strings, so you keep full decimal precision.

Candles need an asset priced from trade-by-trade data. An asset priced another way returns 400, and an unknown asset or one with no price data returns 404. Every error body has a type to branch on and a request_id to include when you contact support.

REST and WebSocket

Use REST to read current and historical prices on demand. Use WebSocket to receive updates as they happen, without polling.

Market data covers both venues. A venue is where an asset trades: defi assets trade on-chain, and cefi assets trade on the True Markets exchange.

REST

• Market data REST: every endpoint, schema and error code.
• Get OHLC candles for a symbol: the candles call above.
• Get price candles by symbol
• Get CeFi instrument price history

WebSocket

• Market data WebSocket: streams for defi assets.
• CeFi direct WebSocket: order book and trade streams from the exchange. Public channels need only a current timestamp and publish batched updates, typically every second.