Version: 0.17.0

Market Data Service API

Real-time and historical market data for True Markets. The service exposes price candles, windowed and point-in-time price history, market capitalization, and prediction-market prices.

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

Authentication

Price, market feed, and streaming endpoints are public. Live activity preferences and the operator endpoints take a bearer JWT.

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.
• Live Activity — iOS Live Activity push tokens, per-user signal preferences, and the public event stream.
• Streams — server-sent quote streams.

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

• 📧 [email protected]

Authentication

HTTP: Bearer Auth

Security Scheme Type:	http
HTTP Authorization Scheme:	bearer
Bearer format:	JWT