---
title: "About Market data"
url: https://docs.truemarkets.co/market-data/overview
description: "Read prices, candles and order books over REST and WebSocket, with no account and no token."
---

Docs index: https://docs.truemarkets.co/llms.txt

# 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](https://docs.truemarkets.co/trading-api/what-you-can-trade) shows how to list the catalog and find it.

Hourly candles for the last day

```bash
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

```json
{
  "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](https://docs.truemarkets.co/api/market-data/market-data-service-api): every endpoint, schema and error code.
-   [Get OHLC candles for a symbol](https://docs.truemarkets.co/api/market-data/get-candles): the candles call above.
-   [Get price candles by symbol](https://docs.truemarkets.co/api/market-data/get-prices)
-   [Get CeFi instrument price history](https://docs.truemarkets.co/api/market-data/get-cefi-price-history)

**WebSocket**

-   [Market data WebSocket](https://docs.truemarkets.co/api/websocket/market-data): streams for `defi` assets.
-   [CeFi direct WebSocket](https://docs.truemarkets.co/api/websocket/institutional): order book and trade streams from the exchange. Public channels need only a current timestamp and publish batched updates, typically every second.