# Candlesticks Subscription

`WS` `push · cmd 105`

> **Quote Permission Required · Free**
> US stocks: US LV1 real-time quotes included free by default.
> HK stocks: LV1 real-time quotes included by default.
> Candlestick push requires the same permission as quote subscription.
> _OpenAPI quote perms are separate from App/Web perms_

Real-time candlestick (K-line) data push for subscribed securities. The callback fires whenever the current candlestick updates (Realtime mode) or when a candlestick period closes (Confirmed mode).

:::tip
This page covers the **push** API (`subscribe_candlesticks`). To pull historical candlestick data on demand, see [Candlestick - Pull](/quote/stocks/candlestick).
:::

```protobuf
message PushCandlestick {
  string symbol = 1;
  Period period = 2;
  Candlestick candlestick = 3;
}
```

## Push Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | Security code, for example: AAPL.US |
| `period` | int32 | No | Candlestick period, see Period |
| `candlestick` | object | No | Candlestick data |
| `└ close` | string | No | Close price |
| `└ open` | string | No | Open price |
| `└ high` | string | No | High price |
| `└ low` | string | No | Low price |
| `└ volume` | int64 | No | Volume |
| `└ turnover` | string | No | Turnover |
| `└ timestamp` | int64 | No | Candlestick time (Unix timestamp) |
| `└ trade_session` | int32 | No | Trade session, see TradeSession |

## Response JSON Example

```json
{
  "symbol": "700.HK",
  "period": 1,
  "candlestick": {
    "close": "162.500",
    "open": "160.000",
    "high": "163.000",
    "low": "159.800",
    "volume": 123456,
    "turnover": "19987654.000",
    "timestamp": 1651103700,
    "trade_session": 0
  }
}
```
