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
| 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.
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}:
windowunits —mminutes,hhours,ddays,Mmonths. Examples:1h,7d,1M.resolutionunits —sseconds,mminutes,hhours,ddays. 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
- Get price candles by symbol:
GET /v1/defi/market/prices - Get price history for a symbol:
GET /v1/defi/market/prices/history - Get price at a point in time:
GET /v1/defi/market/prices/history/point - Get price history for multiple symbols:
GET /v1/defi/market/prices/history/batch - Get a technical indicator series:
GET /v1/defi/market/prices/indicators - Get min/max price over a window:
GET /v1/defi/market/prices/range - Get OHLC candles for a symbol:
GET /v1/defi/market/prices/candles - Get price history for an asset:
GET /v1/assets/prices/history - Get the min and max price for an asset:
GET /v1/assets/prices/range - Get technical indicator lines for an asset:
GET /v1/assets/prices/indicators
Market Cap
- Get market cap by symbol:
GET /v1/defi/market/market-data/market-cap - List top assets by market cap:
GET /v1/defi/market/market-data/market-caps - Get reported market-cap history:
GET /v1/defi/market/market-data/market-cap/history
Market Feed
- Get perp funding rate and open interest history:
GET /v1/defi/market/market-data/perp/history - Get reported 24h volume history:
GET /v1/defi/market/market-data/volume/history - Get a market ranking at every bucket of a window:
GET /v1/defi/market/market-data/scans/history - List trending assets:
GET /v1/defi/market/market-data/trending - List surging assets:
GET /v1/defi/market/market-data/surging
Streams
- Stream BBO quotes:
GET /v1/defi/market/stream/bbo - Probe the BBO stream:
HEAD /v1/defi/market/stream/bbo
Assets
- Find an asset by address:
GET /v1/defi/market/assets - Get OHLC candles for an asset by chain and address:
GET /v1/defi/market/assets/candles
CeFi
- Get CeFi instrument price history:
GET /v1/cefi/market/prices/history - Get a technical indicator series for a CeFi instrument:
GET /v1/cefi/market/prices/indicators - Get CeFi min/max price over a window:
GET /v1/cefi/market/prices/range
Venue History
- Get one venue's price or funding series for an asset:
GET /v1/marketdata/venue-history
Operations
- Get price candles by symbol:
GET /v1/defi/market/prices - Get price history for a symbol:
GET /v1/defi/market/prices/history - Get price at a point in time:
GET /v1/defi/market/prices/history/point - Get price history for multiple symbols:
GET /v1/defi/market/prices/history/batch - Get a technical indicator series:
GET /v1/defi/market/prices/indicators - Get min/max price over a window:
GET /v1/defi/market/prices/range - Get OHLC candles for a symbol:
GET /v1/defi/market/prices/candles - Get market cap by symbol:
GET /v1/defi/market/market-data/market-cap - List top assets by market cap:
GET /v1/defi/market/market-data/market-caps - Get perp funding rate and open interest history:
GET /v1/defi/market/market-data/perp/history - Get reported 24h volume history:
GET /v1/defi/market/market-data/volume/history - Get a market ranking at every bucket of a window:
GET /v1/defi/market/market-data/scans/history - Get reported market-cap history:
GET /v1/defi/market/market-data/market-cap/history - Find an asset by address:
GET /v1/defi/market/assets - Get OHLC candles for an asset by chain and address:
GET /v1/defi/market/assets/candles - List trending assets:
GET /v1/defi/market/market-data/trending - List surging assets:
GET /v1/defi/market/market-data/surging - Stream BBO quotes:
GET /v1/defi/market/stream/bbo - Probe the BBO stream:
HEAD /v1/defi/market/stream/bbo - Get price history for an asset:
GET /v1/assets/prices/history - Get the min and max price for an asset:
GET /v1/assets/prices/range - Get technical indicator lines for an asset:
GET /v1/assets/prices/indicators - Get CeFi instrument price history:
GET /v1/cefi/market/prices/history - Get a technical indicator series for a CeFi instrument:
GET /v1/cefi/market/prices/indicators - Get CeFi min/max price over a window:
GET /v1/cefi/market/prices/range - Get one venue's price or funding series for an asset:
GET /v1/marketdata/venue-history
- Need help? Ask us on Discord, or email [email protected].
- See what changed in the changelog