Skip to main content

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.

/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.

orderbook​

receive

Full order-book depth snapshot for a subscribed orderbook.{venue}.{pair} topic.

error​

receive

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

Servers​

ServerHostDescription
productionwss://api.truemarkets.coProduction
uatwss://api.uat.truemarkets.coUAT (sandbox)