Skip to content
Alchemy Logo

allCandles stream

This API is in private preview. Target September 2026; timing is subject to change.

Streams candles for the requested markets and intervals.

{
  "method": "subscribe",
  "subscription": {
    "type": "allCandles",
    "intervals": [
      "1m"
    ],
    "coins": [
      "BTC"
    ]
  }
}

{
  "channel": "subscriptionResponse",
  "data": {
    "subscriptionId": "sub_01",
    "type": "allCandles"
  }
}

{
  "channel": "allCandles",
  "subscriptionId": "sub_01",
  "blockHeight": 123456,
  "blockTime": 1780000000000,
  "cursor": "<opaque cursor>",
  "data": {
    "interval": "1m",
    "candles": [
      {
        "s": "BTC",
        "t": 1780000000000,
        "T": 1780000059999,
        "o": "100000.0",
        "h": "100010.0",
        "l": "99995.0",
        "c": "100005.0",
        "v": "12.4",
        "x": false
      }
    ]
  }
}

FieldTypeDescription
intervalstringCandle interval.
candlesarrayCandle records.
candles[]objectCandle records.
candles[].sstringMarket symbol for the candle.
candles[].tintegerStart time of the candle interval, in milliseconds.
candles[].TintegerEnd time of the candle interval, in milliseconds.
candles[].ostringOpening price for the candle interval.
candles[].hstringHighest traded price in the candle interval.
candles[].lstringLowest traded price in the candle interval.
candles[].cstringClosing price for the candle interval.
candles[].vstringVolume traded in the base asset during the candle interval.
candles[].xbooleanWhether the candle is final.

{
  "method": "unsubscribe",
  "subscription": {
    "type": "allCandles",
    "intervals": [
      "1m"
    ],
    "coins": [
      "BTC"
    ]
  }
}

To resume a stream, supply cursor in the subscription object. The cursor is opaque: clients store and return it unmodified, and its format may change.

Was this page helpful?