Candles

The CANDLES channel streams OHLCV candlestick data for a market at a chosen interval. Use it for charts and historical-style series. Candles with no activity are not sent.

Send a SUBSCRIBE with a unique channelUuid, "channel": "CANDLES", the market symbol, and interval (candle length in minutes).

{
  "action": "SUBSCRIBE",
  "channel": "CANDLES",
  "channelUuid": "your-unique-uuid",
  "symbol": "ETH-USD",
  "interval": 60
}

Field	Type	Description
channelUuid	UUID	Unique id for this subscription
symbol	String	Market to receive candles for
interval	Long	Candle interval in minutes (e.g. 1, 60)

Response

There is no initial snapshot. After you subscribe, the server sends one message per candle when that interval has ended and there was activity. Intervals are aligned to the start of the day (UTC), or to the market day for 24h candles (market day start 6:30 AM PT).

Example message:

{
  "channelUuid": "61d3f4ec-75c9-4880-bc72-ccfd4e389a06",
  "date": "2023-12-13T20:00:00Z",
  "open": "2071.00",
  "close": "2072.00",
  "low": "2071.00",
  "high": "2073.00",
  "volume": "2.23",
  "marketId": "ETH-USD"
}

Field	Type	Description
channelUuid	UUID	Matches your subscription
date	String	Start of the candle interval (ISO 8601)
open	String	First price in the interval
close	String	Last price in the interval
low / high	String	Lowest / highest price in interval
volume	String	Quantity traded in the interval
marketId	String	Market identifier

Subscribe​

Response​

Subscribe

Response