Skip to content
Alchemy Logo

candles stream

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

The values below illustrate the intended request shape.

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

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

{
  "channel": "candles",
  "subscriptionId": "sub_01",
  "blockHeight": 123456,
  "blockTime": 1780000000000,
  "cursor": "<opaque cursor>",
  "data": {
    "coin": "BTC",
    "interval": "1m",
    "openTime": 1780000000000,
    "closeTime": 1780000059999,
    "open": "100000.0",
    "high": "100010.0",
    "low": "99990.0",
    "close": "100005.0",
    "volume": "12.4",
    "isFinal": false
  }
}

FieldTypeDescription
coinstringMarket symbol for the candle.
intervalstringCandle interval.
openTimeintegerStart time of the candle interval, in milliseconds.
closeTimeintegerEnd time of the candle interval, in milliseconds.
openstringOpening price for the candle interval.
highstringHighest price during the candle interval.
lowstringLowest price during the candle interval.
closestringClosing price for the candle interval.
volumestringVolume traded in the base asset during the candle interval.
isFinalbooleanFinality indicator.

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

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?