For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/market-data/market-data-service-api.md.

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

EnvironmentBase URL
Productionhttps://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.

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

Prices

Market Cap

Market Feed

Streams

Assets

CeFi

Venue History

Operations

Was this page helpful?YesNo