Prices

Bidirectional. The server sends connected immediately after the upgrade. The client then sends subscribe with one or more { symbol, timeframe } channels and receives subscription_confirmed followed by a candle_update whenever a subscribed candle changes (the service polls its store every 250 ms, so updates arrive at most four times a second per channel).

Keepalive is mandatory: the server sends ping every 30 s and closes any socket that has not answered with pong before the next ping. A client may also send ping and will receive pong.

WSS

Messages

{
  "type": "candle_update",
  "symbol": "BTC",
  "timeframe": "1m",
  "candle": {
    "symbol": "BTC",
    "timeframe": "1m",
    "openTime": "2026-09-09T14:03:00.000Z",
    "closeTime": "2026-09-09T14:04:00.000Z",
    "open": "113801.12",
    "high": "113877.50",
    "low": "113790.00",
    "close": "113842.31"
  }
}

Connected

type:object

Sent once, immediately after the upgrade

Subscription confirmed

type:object

Echoes the channels from the subscribe that was applied

Unsubscription confirmed

type:object

Echoes the channels from the unsubscribe that was applied

Candle update

type:object

The current state of one subscribed candle after a change

Server ping

type:object

Keepalive every 30 s; answer with pong before the next one

Server pong

type:object

Reply to a client ping

Error

type:object

A rejected client frame; the socket stays open

type:object

Start receiving candle updates for one or more symbol/timeframe channels

Unsubscribe

type:object

Stop receiving candle updates for the listed channels

Client ping

type:object

Optional client-initiated keepalive; the server answers with pong

Client pong

type:object

Mandatory reply to the server's ping; a socket that misses one is closed

Messages

{
  "type": "candle_update",
  "symbol": "BTC",
  "timeframe": "1m",
  "candle": {
    "symbol": "BTC",
    "timeframe": "1m",
    "openTime": "2026-09-09T14:03:00.000Z",
    "closeTime": "2026-09-09T14:04:00.000Z",
    "open": "113801.12",
    "high": "113877.50",
    "low": "113790.00",
    "close": "113842.31"
  }
}

Builders

REST API

WebSocket API

Prices