---
title: "Market Data REST"
url: https://docs.truemarkets.co/api/market-data/market-data-service-api
description: "Prices, candles and history across venues, without a token."
---

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

# Market Data REST

Real-time and historical market data for True Markets: price candles, windowed
and point-in-time price history, technical indicators, market capitalization,
and trending and surging asset rankings.

## Base URLs

| Environment   | Base URL                         |
| ------------- | -------------------------------- |
| Production    | `https://api.truemarkets.co`     |
| UAT (sandbox) | `https://api.uat.truemarkets.co` |

Real-time streaming (price candles, trending assets, surging assets, reference
prices) is documented separately in the [Market Data WebSocket AsyncAPI spec](./asyncapi.yaml).

## Authentication

Every endpoint in this API is public; no token is needed.

## Endpoints

- **Prices** — current candles, windowed and point-in-time history, batched lookups across multiple symbols, and min/max ranges.
- **Market Cap** — latest market capitalization for a single asset or for the top assets ranked by market cap.
- **Market Feed** — assets ranked by trending ratio or by the size of their recent price move.
- **Streams** — server-sent quote streams.
- **Assets**: price, volume, liquidity and candles for any asset by address, listed or not.

## Errors

Every failure returns the shared envelope: a closed `type` fixing the HTTP
status, a human-readable `message`, and the `request_id` to quote in a
support request. Branch on `type`, never on `message`.

## Time Window & Resolution

History endpoints accept a `window` (lookback period) and a `resolution` (gap
between data points). Both use the format `{value}{unit}`:

- `window` units — `m` minutes, `h` hours, `d` days, `M` months. Examples: `1h`, `7d`, `1M`.
- `resolution` units — `s` seconds, `m` minutes, `h` hours, `d` days. Examples: `5s`, `1m`, `1h`.

## Numeric Precision

Prices, market caps, and other numeric values are returned as strings to
preserve full decimal precision and avoid floating-point rounding.

## Support

- 📧 [support@truemarkets.co](mailto:support@truemarkets.co)

## Prices

- [Get price candles by symbol](https://docs.truemarkets.co/api/market-data/get-prices): `GET /v1/defi/market/prices`
- [Get price history for a symbol](https://docs.truemarkets.co/api/market-data/get-price-history): `GET /v1/defi/market/prices/history`
- [Get price at a point in time](https://docs.truemarkets.co/api/market-data/get-price-at-time): `GET /v1/defi/market/prices/history/point`
- [Get price history for multiple symbols](https://docs.truemarkets.co/api/market-data/get-price-history-batch): `GET /v1/defi/market/prices/history/batch`
- [Get a technical indicator series](https://docs.truemarkets.co/api/market-data/get-price-indicators): `GET /v1/defi/market/prices/indicators`
- [Get min/max price over a window](https://docs.truemarkets.co/api/market-data/get-price-range): `GET /v1/defi/market/prices/range`
- [Get OHLC candles for a symbol](https://docs.truemarkets.co/api/market-data/get-candles): `GET /v1/defi/market/prices/candles`
- [Get price history for an asset](https://docs.truemarkets.co/api/market-data/get-asset-price-history): `GET /v1/assets/prices/history`
- [Get the min and max price for an asset](https://docs.truemarkets.co/api/market-data/get-asset-price-range): `GET /v1/assets/prices/range`
- [Get technical indicator lines for an asset](https://docs.truemarkets.co/api/market-data/get-asset-price-indicators): `GET /v1/assets/prices/indicators`

## Market Cap

- [Get market cap by symbol](https://docs.truemarkets.co/api/market-data/get-market-cap): `GET /v1/defi/market/market-data/market-cap`
- [List top assets by market cap](https://docs.truemarkets.co/api/market-data/list-market-caps): `GET /v1/defi/market/market-data/market-caps`
- [Get reported market-cap history](https://docs.truemarkets.co/api/market-data/get-market-cap-history): `GET /v1/defi/market/market-data/market-cap/history`

## Market Feed

- [Get perp funding rate and open interest history](https://docs.truemarkets.co/api/market-data/get-perp-market-history): `GET /v1/defi/market/market-data/perp/history`
- [Get reported 24h volume history](https://docs.truemarkets.co/api/market-data/get-volume-history): `GET /v1/defi/market/market-data/volume/history`
- [Get a market ranking at every bucket of a window](https://docs.truemarkets.co/api/market-data/get-scan-history): `GET /v1/defi/market/market-data/scans/history`
- [List trending assets](https://docs.truemarkets.co/api/market-data/list-trending-assets): `GET /v1/defi/market/market-data/trending`
- [List surging assets](https://docs.truemarkets.co/api/market-data/list-surging-assets): `GET /v1/defi/market/market-data/surging`

## Streams

- [Stream BBO quotes](https://docs.truemarkets.co/api/market-data/stream-bbo-quotes): `GET /v1/defi/market/stream/bbo`
- [Probe the BBO stream](https://docs.truemarkets.co/api/market-data/probe-bbo-stream): `HEAD /v1/defi/market/stream/bbo`

## Assets

- [Find an asset by address](https://docs.truemarkets.co/api/market-data/list-assets): `GET /v1/defi/market/assets`
- [Get OHLC candles for an asset by chain and address](https://docs.truemarkets.co/api/market-data/get-asset-candles): `GET /v1/defi/market/assets/candles`

## CeFi

- [Get CeFi instrument price history](https://docs.truemarkets.co/api/market-data/get-cefi-price-history): `GET /v1/cefi/market/prices/history`
- [Get a technical indicator series for a CeFi instrument](https://docs.truemarkets.co/api/market-data/get-cefi-price-indicators): `GET /v1/cefi/market/prices/indicators`
- [Get CeFi min/max price over a window](https://docs.truemarkets.co/api/market-data/get-cefi-price-range): `GET /v1/cefi/market/prices/range`

## Venue History

- [Get one venue's price or funding series for an asset](https://docs.truemarkets.co/api/market-data/get-venue-history): `GET /v1/marketdata/venue-history`

## Operations

- [Get price candles by symbol](https://docs.truemarkets.co/api/market-data/get-prices): `GET /v1/defi/market/prices`
- [Get price history for a symbol](https://docs.truemarkets.co/api/market-data/get-price-history): `GET /v1/defi/market/prices/history`
- [Get price at a point in time](https://docs.truemarkets.co/api/market-data/get-price-at-time): `GET /v1/defi/market/prices/history/point`
- [Get price history for multiple symbols](https://docs.truemarkets.co/api/market-data/get-price-history-batch): `GET /v1/defi/market/prices/history/batch`
- [Get a technical indicator series](https://docs.truemarkets.co/api/market-data/get-price-indicators): `GET /v1/defi/market/prices/indicators`
- [Get min/max price over a window](https://docs.truemarkets.co/api/market-data/get-price-range): `GET /v1/defi/market/prices/range`
- [Get OHLC candles for a symbol](https://docs.truemarkets.co/api/market-data/get-candles): `GET /v1/defi/market/prices/candles`
- [Get market cap by symbol](https://docs.truemarkets.co/api/market-data/get-market-cap): `GET /v1/defi/market/market-data/market-cap`
- [List top assets by market cap](https://docs.truemarkets.co/api/market-data/list-market-caps): `GET /v1/defi/market/market-data/market-caps`
- [Get perp funding rate and open interest history](https://docs.truemarkets.co/api/market-data/get-perp-market-history): `GET /v1/defi/market/market-data/perp/history`
- [Get reported 24h volume history](https://docs.truemarkets.co/api/market-data/get-volume-history): `GET /v1/defi/market/market-data/volume/history`
- [Get a market ranking at every bucket of a window](https://docs.truemarkets.co/api/market-data/get-scan-history): `GET /v1/defi/market/market-data/scans/history`
- [Get reported market-cap history](https://docs.truemarkets.co/api/market-data/get-market-cap-history): `GET /v1/defi/market/market-data/market-cap/history`
- [Find an asset by address](https://docs.truemarkets.co/api/market-data/list-assets): `GET /v1/defi/market/assets`
- [Get OHLC candles for an asset by chain and address](https://docs.truemarkets.co/api/market-data/get-asset-candles): `GET /v1/defi/market/assets/candles`
- [List trending assets](https://docs.truemarkets.co/api/market-data/list-trending-assets): `GET /v1/defi/market/market-data/trending`
- [List surging assets](https://docs.truemarkets.co/api/market-data/list-surging-assets): `GET /v1/defi/market/market-data/surging`
- [Stream BBO quotes](https://docs.truemarkets.co/api/market-data/stream-bbo-quotes): `GET /v1/defi/market/stream/bbo`
- [Probe the BBO stream](https://docs.truemarkets.co/api/market-data/probe-bbo-stream): `HEAD /v1/defi/market/stream/bbo`
- [Get price history for an asset](https://docs.truemarkets.co/api/market-data/get-asset-price-history): `GET /v1/assets/prices/history`
- [Get the min and max price for an asset](https://docs.truemarkets.co/api/market-data/get-asset-price-range): `GET /v1/assets/prices/range`
- [Get technical indicator lines for an asset](https://docs.truemarkets.co/api/market-data/get-asset-price-indicators): `GET /v1/assets/prices/indicators`
- [Get CeFi instrument price history](https://docs.truemarkets.co/api/market-data/get-cefi-price-history): `GET /v1/cefi/market/prices/history`
- [Get a technical indicator series for a CeFi instrument](https://docs.truemarkets.co/api/market-data/get-cefi-price-indicators): `GET /v1/cefi/market/prices/indicators`
- [Get CeFi min/max price over a window](https://docs.truemarkets.co/api/market-data/get-cefi-price-range): `GET /v1/cefi/market/prices/range`
- [Get one venue's price or funding series for an asset](https://docs.truemarkets.co/api/market-data/get-venue-history): `GET /v1/marketdata/venue-history`