# 經紀隊列

`WS` `request · cmd 15`

> **行情權限要求 · 僅港股 · LV2 高級行情**
> 港股特有數據，提供前 40 個買賣盤經紀隊列。
> 預設無權限，需到行情商店購買「LV2 高級行情 - Plus (OpenAPI)」行情卡。
> _OpenAPI 行情權限獨立於 App/Web 行情權限_

:::warning 僅支援 Longbridge 香港 / 新加坡賬戶
此方法僅支援 Longbridge 香港 / 新加坡賬戶，可查詢任意標的，包括美股。
:::

該接口用於獲取標的的實時經紀隊列數據。

```protobuf
message SecurityRequest {
  string symbol = 1;
}

message SecurityBrokersResponse {
  string symbol = 1;
  repeated Brokers ask_brokers = 2;
  repeated Brokers bid_brokers = 3;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 標的代碼，使用 ticker.region 格式，例如：700.HK |

## Response Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | 標的代碼 |
| `ask_brokers` | object[] | No | 賣盤經紀隊列 |
| `└ position` | int32 | No | 檔位 |
| `└ broker_ids` | int32[] | No | 券商席位 ID，通過獲取券商席位 ID 接口獲取 |
| `bid_brokers` | object[] | No | 買盤經紀隊列 |
| `└ position` | int32 | No | 檔位 |
| `└ broker_ids` | int32[] | No | 券商席位 ID，通過獲取券商席位 ID 接口獲取 |

## Response JSON Example

```json
{
  "symbol": "700.HK",
  "ask_brokers": [
    {
      "position": 1,
      "broker_ids": [
        7358,
        9057,
        9028,
        7364
      ]
    }
  ],
  "bid_brokers": [
    {
      "position": 1,
      "broker_ids": [
        6996,
        5465,
        8026,
        8304,
        4978
      ]
    }
  ]
}
```
