行情接口概覽
標的代碼說明
標的代碼使用 ticker.region 格式，ticker 表示標的代碼，各個市場的標的代碼示例：
- 美股市場：
region為US，例如：AAPL.US - 港股市場：
region為HK，例如：700.HK - A 股市場：
region上交所為SH，深交所為SZ，例如：399001.SZ，600519.SH
新加坡市場（SG）： 新加坡市場的實時行情暫未通過 Longbridge Developers（API / CLI / MCP）開放，如需查詢新加坡股票行情，請使用 Longbridge 客戶端查詢。
接入方式
- 使用私有協議，長連接方式進行接入，接入方法請參考 二進制通信協議。
- 使用 SDK 進行接入，SDK 介紹及下載地址。
業務數據序列化方式
行情的請求、響應、推送數據作為業務數據，存放在私有協議的數據包 body 部分。 我們使用 Protobuf 協議對業務數據進行序列化，相較於常見的文本協議（如 JSON, XML 等），Protobuf 協議具有如下優點：
- 序列化時間快
- 數據包體積小
- 較強的版本前向後向兼容性
行情 Protobuf 協議文檔下載地址。
行情權限等級
所有行情接口均需要 OpenAPI 行情權限。OpenAPI 行情權限與手機客戶端/PC/網頁端權限完全獨立，需單獨開通。
| 權限等級 | 包含內容 | 獲取方式 |
|---|---|---|
| 基礎行情 | 美/A 股實時報價；港股 BMP（約 15 分鐘延遲，不支持推送） | 開通 OpenAPI 後自動獲得 |
| LV1 實時（港股） | 港股實時報價 + WebSocket 推送支持 | 通過行情商城購買「LV1 實時行情 (OpenAPI)」 |
| LV2 訂閱 | Level 2 買賣盤（depth）、港股經紀商隊列（brokers） | 通過行情商城購買 LV2 訂閱卡 |
| 盤前盤後（美股） | 美股盤前/盤後延伸時段數據 | 購買 LV1 卡 + 設置 LONGBRIDGE_ENABLE_OVERNIGHT=true |
查看當前權限：開發者中心。購買行情卡：Longbridge App → 我的 → 我的行情 → 行情商城。