Hyperliquid allCandles WebSocket API

Use allCandles when you want one live stream of candle changes across every active Hyperliquid market for a single interval. The stream is sparse: each data frame contains only markets that emitted a candle update for that batch.

If you need one specific market, use candles.

BillingCopy Anchor Link

Sparse markets that do not emit a candle object in a frame do not add to the response count. Subscription acknowledgements and other control messages establish the stream but do not add candle responses.

EndpointCopy Anchor Link

wss://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY

If your client expects an explicit WebSocket path, this compatible form also works:

wss://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/ws

Subscribe MessageCopy Anchor Link

Send a subscribe message with subscription.type set to allCandles. Unlike the single-market stream, this subscription does not include market.

{
  "method": "subscribe",
  "subscription": {
    "type": "allCandles",
    "interval": "1m"
  }
}

Supported intervals are 1s, 1m, and 5m.

Subscription ParametersCopy Anchor Link

{
  "method": "subscribe",
  "subscription": {
    "type": "allCandles",
    "interval": "1m"
  }
}

Example FlowCopy Anchor Link

Client sends:

{
  "method": "subscribe",
  "subscription": {
    "type": "allCandles",
    "interval": "1m"
  }
}

Server acknowledges:

{
  "type": "subscribed",
  "interval": "1m",
  "subscriptionType": "allCandles"
}

Then sends allCandles events. Each event contains a data array of candle objects:

{
  "type": "allCandles",
  "seq": 12,
  "cursor": "1775601060000",
  "data": [
    {
      "s": "BTC",
      "i": "1m",
      "t": 1775601060000,
      "T": 1775601119999,
      "o": "71564",
      "h": "71578",
      "l": "71563",
      "c": "71577",
      "v": "0.21291",
      "q": "15238.32632",
      "n": 57,
      "x": false
    },
    {
      "s": "ETH",
      "i": "1m",
      "t": 1775601060000,
      "T": 1775601119999,
      "o": "3864.2",
      "h": "3865.1",
      "l": "3863.9",
      "c": "3864.8",
      "v": "14.893",
      "q": "57555.8064",
      "n": 31,
      "x": false
    }
  ]
}

Response Field ReferenceCopy Anchor Link

BehaviorCopy Anchor Link

• subscription is keyed by interval
• the stream emits arrays of changed candle snapshots across active markets
• each frame contains only markets with a candle update in that batch
• seq is per-subscription ordering and starts at 1 for the first allCandles event
• cursor is the candle open time encoded as a Unix millisecond timestamp string
• candle payloads use the same s i t T o h l c v q n x schema as REST, JSON-RPC, and the single-market WebSocket stream
• x=false means the candle is still open, and x=true means it is finalized

AuthenticationCopy Anchor Link

• include your Dwellir API key in the WebSocket path: wss://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY
• wss://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/ws is also accepted for clients that expect an explicit WebSocket path
• both forms connect to the same live allCandles stream

When to Use allCandlesCopy Anchor Link

• full-market dashboards
• alerting systems that scan every active market
• analytics pipelines that need one interval-wide stream instead of one WebSocket subscription per market