# allCandles stream

> HyperCore private-preview documentation.

> For the complete documentation index, see [llms.txt](/docs/llms.txt).

<Callout intent="info">
  This API is in private preview. Target September 2026; timing is subject to change.
</Callout>


# allCandles stream

Streams candles for the requested markets and intervals.

## Subscribe

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

## Acknowledgement
```json
{
  "channel": "subscriptionResponse",
  "data": {
    "subscriptionId": "sub_01",
    "type": "allCandles"
  }
}
```

## Event envelope

```json
{
  "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
      }
    ]
  }
}
```

## Payload fields

| Field | Type | Description |
| --- | --- | --- |
| interval | string | Candle interval. |
| candles | array | Candle records. |
| candles[] | object | Candle records. |
| candles[].s | string | Market symbol for the candle. |
| candles[].t | integer | Start time of the candle interval, in milliseconds. |
| candles[].T | integer | End time of the candle interval, in milliseconds. |
| candles[].o | string | Opening price for the candle interval. |
| candles[].h | string | Highest traded price in the candle interval. |
| candles[].l | string | Lowest traded price in the candle interval. |
| candles[].c | string | Closing price for the candle interval. |
| candles[].v | string | Volume traded in the base asset during the candle interval. |
| candles[].x | boolean | Whether the candle is final. |
## Unsubscribe
```json
{
  "method": "unsubscribe",
  "subscription": {
    "type": "allCandles",
    "intervals": [
      "1m"
    ],
    "coins": [
      "BTC"
    ]
  }
}
```
## Resume

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.