# Quotes

`WS` `request · cmd 11`

> **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_

This API is used to obtain the real-time quotes of securities, and supports all types of securities. To view these real-time data streams aggregated into live indices, sector heatmaps, and macro market overviews, you can reference the [Longbridge Global Markets](https://longbridge.com/en/markets).

```protobuf
message MultiSecurityRequest {
  repeated string symbol = 1;
}

message SecurityQuoteResponse {
  repeated SecurityQuote secu_quote = 1;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string[] | Yes | Security code list, in ticker.region format; max 500 symbols per request |

## Response Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `secu_quote` | object[] | No | Securities quote |
| `└ symbol` | string | No | Security code |
| `└ last_done` | string | No | Latest price |
| `└ prev_close` | string | No | Yesterday's close |
| `└ 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 |
| `└ pre_market_quote` | object | No | Quote of US pre market |
| ` └ last_done` | string | No | Latest price |
| ` └ timestamp` | int64 | No | Time of latest price |
| ` └ volume` | int64 | No | Volume |
| ` └ turnover` | string | No | Turnover |
| ` └ high` | string | No | High |
| ` └ low` | string | No | Low |
| ` └ prev_close` | string | No | Close of the last trade session |
| `└ post_market_quote` | object | No | Quote of US post market |
| ` └ last_done` | string | No | Latest price |
| ` └ timestamp` | int64 | No | Time of latest price |
| ` └ volume` | int64 | No | Volume |
| ` └ turnover` | string | No | Turnover |
| ` └ high` | string | No | High |
| ` └ low` | string | No | Low |
| ` └ prev_close` | string | No | Close of the last trade session |
| `└ over_night_quote` | object | No | Quote of US overnight market; requires enable_overnight, returns null otherwise (US stocks only) |
| ` └ last_done` | string | No | Latest price |
| ` └ timestamp` | int64 | No | Time of latest price |
| ` └ volume` | int64 | No | Volume |
| ` └ turnover` | string | No | Turnover |
| ` └ high` | string | No | High |
| ` └ low` | string | No | Low |
| ` └ prev_close` | string | No | Close of the last trade session |

## Response JSON Example

```json
{
  "secu_quote": [
    {
      "symbol": "700.HK",
      "last_done": "338.000",
      "prev_close": "334.800",
      "open": "340.600",
      "high": "340.600",
      "low": "333.000",
      "timestamp": 1651115955,
      "volume": 7310881,
      "turnover": "2461463161.000"
    }
  ]
}
```
