# Quote

`WS` `push · cmd 101`

> **Quote Permission Required · Free**
> US stocks: US LV1 included free by default, covering pre-market, regular, after-hours, and overnight sessions. To receive overnight data, enable it via LONGBRIDGE_ENABLE_OVERNIGHT=true (see Q6 & Q7 in the Broker FAQ).
> HK stocks: LV1 real-time quotes included by default.
> US options: no permission by default — purchase "OPRA US Options Quotes (OpenAPI)" in the Quote Store.
> _OpenAPI quote perms are separate from App/Web perms_

Real-time quote push of the subscribed security. In the pushed data structure, only the fields that have changed will be filled with data.

```protobuf
message PushQuote {
  string symbol = 1;
  int64 sequence = 2;
  string last_done = 3;
  string open = 4;
  string high = 5;
  string low = 6;
  int64 timestamp = 7;
  int64 volume = 8;
  string turnover = 9;
  TradeStatus trade_status = 10;
  TradeSession trade_session = 11;
}
```

## Push Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | Security code, for example: AAPL.US |
| `sequence` | int64 | No | Sequence number |
| `last_done` | string | No | Latest price |
| `open` | string | No | Open |
| `high` | string | No | High |
| `low` | string | No | Low |
| `timestamp` | int64 | No | Time of latest price |
| `volume` | int64 | No | Volume |
| `turnover` | string | No | Turnover |
| `trade_status` | int32 | No | Security trading status, see TradeStatus |
| `trade_session` | int32 | No | Trade session, see TradeSession |
| `current_volume` | int32 | No | Increase volume between pushes |
| `current_turnover` | string | No | Increase turnover between pushes |
| `tag` | int32 | No | Price tag: 0 real-time quote, 1 revised data after market close |

## Response JSON Example

```json
{
  "symbol": "AAPL.US",
  "sequence": 160808750000000,
  "last_done": "156.570",
  "open": "155.910",
  "high": "159.790",
  "low": "155.380",
  "timestamp": 1651089600,
  "volume": 88063191,
  "turnover": "13865092584.000",
  "trade_status": 0,
  "trade_session": 0
}
```
