行情接口概览
标的代码说明
标的代码使用 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 → 我的 → 我的行情 → 行情商城。