核心功能
长桥 LongPort OpenAPI CLI 是一款面向专业投资者的股票交易工具,提供四大核心模块:
行情模块:实时报价、盘口深度(买五卖五)、逐笔成交、多周期 K 线(1分钟至年线)及标的静态信息查询,支持多标的批量查询。
账户模块:账户余额与净资产展示、股票持仓、基金持仓查询,支持 JSON 格式化输出便于程序化解析。
订单模块:今日/历史订单查询(只读);限价买入、卖出及撤单(需显式开启交易权限)。所有交易命令内置确认提示,AI 程序化调用可跳过。
市场数据模块:市场温度指标(美/港/中/新)、资金流向追踪、资金分布(大/中/小单)、期权链到期日查询。
显著优点
- 官方背书:直接调用长桥 OpenAPI,数据来源权威实时
- 多市场覆盖:统一支持美股(.US)、港股(.HK)等主流市场
- 安全设计:交易命令强制确认,防止误操作;环境变量隔离敏感凭证
- 灵活配置:支持多账户切换(paper/live)、JSON 机器可读输出
- 零 GUI 依赖:纯 CLI 设计,适合服务器部署与自动化脚本
局限性与风险
前置门槛:需注册长桥开发者账号,申请 App Key/Secret/Access Token,对非技术用户门槛较高。
权限风险:LONGBRIDGE_TRADE_ENABLED 环境变量控制交易开关,若配置不当或误设 --yes 可能导致非预期下单。
地域限制:行情与交易权限受长桥业务区域及用户账户类型约束,部分市场数据可能需订阅。
依赖稳定性:依赖长桥 API 服务可用性,极端行情下可能出现延迟或限流。
适合人群
- 量化交易者与算法工程师
- 需要自动化盯盘、下单的活跃投资者
- 多账户管理需求的机构/专业个人投资者
- 偏好终端操作、追求效率的技术型用户
常规风险提示
> ⚠️ 金融交易风险:股票投资存在本金损失风险,API 程序化交易可能因网络延迟、参数错误导致意外成交。
>
> ⚠️ 密钥安全:LONGBRIDGE_APP_SECRET 与 ACCESS_TOKEN 需严格保密,避免提交至代码仓库。
>
> ⚠️ 合规确认:使用前请确保符合当地监管要求及长桥平台服务条款。