Skip to main content
WSS
/
ws
Messages
Candlestick Query
type:object

Request historical candlestick data for a market pair

Subscribe to Candlesticks
type:object

Subscribe to periodic candlestick updates

Unsubscribe from Candlesticks
type:object

Stop receiving candlestick updates

Candlestick Response
type:object

Array of historical candlestick data

Subscribe Response
type:object

Subscription confirmation

Candlestick Update
type:object

Periodic candlestick update (every 0.5 seconds)

Interval Constraints

The requested interval must meet specific mathematical conditions to ensure proper candle alignment:

Rules by Interval Size

  • 60 must be divisible by your interval without remainder
  • Valid examples: 1s, 2s, 3s, 4s, 5s, 6s, 10s, 12s, 15s, 20s, 30s
  • Invalid examples: 7s, 11s, 13s, 17s
  • Interval must be divisible by 60 without remainder
  • 3600 must be divisible by your interval without remainder
  • Valid examples: 1m (60s), 2m (120s), 3m (180s), 5m (300s), 15m (900s), 30m (1800s)
  • Invalid examples: 7m (420s), 11m (660s)
  • Interval must be divisible by 3600 without remainder
  • 86400 must be divisible by your interval without remainder
  • Valid examples: 1h (3600s), 2h (7200s), 4h (14400s), 6h (21600s), 12h (43200s)
  • Invalid examples: 5h (18000s), 7h (25200s)
  • Interval must be divisible by 86400 without remainder
  • Valid examples: 1d (86400s), 2d (172800s), 3d (259200s)
  • 1 week: 604800 seconds (86400 × 7)
  • 1 month: 2592000 seconds (86400 × 30)
These constraints ensure candles align with natural time boundaries (minutes, hours, days) for consistent charting.