Version: 0.0.2 True Markets Market Data WebSocket

Overview

This API streams real-time market data over a single WebSocket connection. Clients subscribe to one or more topics and receive batched price candles, trending assets, surging assets, and weighted reference prices as they update.

Topics

Subscribe to specific topics, or to the all wildcard alias to receive every stream:

• price_candles — OHLC price candles
• trending_assets — trending assets
• surging_assets — surging assets
• reference_prices — weighted reference prices
• all — wildcard alias; receive all of the above

all is a subscription convenience, not a stream of its own. Every pushed message carries the concrete topic it belongs to in topics (e.g. ["price_candles"]), even when delivered to an all subscriber. Because all is a wildcard, unsubscribing an individual topic while subscribed to all has no effect — to drop a single topic, subscribe to explicit topics and unsubscribe them individually.

Authentication

All channels are public — no API key, signature, or other credentials are required.

Numeric Precision

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

Links

• 📧 Support: [email protected]

Change Log

Version	Date	Notes
v0.0.1	2026-05-07	Initial release.
v0.0.2	2026-06-26	Topic-based subscriptions; stream messages carry the concrete topic.

/v1/defi/market

channel

subscribe

send

Message sent to server indicating which topics the client wants to subscribe to or unsubscribe from.

subscriptionResponse

receive

Acknowledgement sent from server in response to a subscribe or unsubscribe request.

priceCandles

receive

Batch of OHLC price candles for tracked assets across the standard intervals.

trendingAssets

receive

Batch of trending assets ranked by recent vs. historical trading volume.

surgingAssets

receive

Batch of assets with significant price movement over 1h, 4h, and 24h windows.

referencePrices

receive

Batch of weighted reference prices computed from multiple exchange BBOs.

error

receive

Server-side error message describing why a request was rejected.

Servers

Server	Host	Description
production	wss://api.truemarkets.co	Production
uat	wss://api.uat.truemarkets.co	UAT (sandbox)