longbridge

核心功能概述

longbridge-cli 是长桥证券（Longbridge）官方 OpenAPI 的 Python CLI 封装工具，为港股、美股投资者提供一站式的命令行交易与行情分析能力。该工具覆盖四大核心模块：实时行情查询（报价、K线、盘口、逐笔成交）、账户资产管理（余额、持仓、基金）、订单生命周期管理（下单、撤单、历史查询）以及市场宏观数据（市场温度、资金流向、期权链）。

显著优点

1. 官方生态整合：直接对接长桥 OpenAPI，数据来源可靠，延迟低，适合量化交易者与程序化投资需求
2. 跨平台支持：原生支持 macOS (darwin) 与 Linux 系统，Python 3 环境即可运行
3. 防误操作设计：所有交易类命令（buy/sell/cancel）内置二次确认机制，降低操作风险
4. 机器友好输出：全命令支持 --json 参数，便于 AI 代理、自动化脚本解析与处理
5. 多市场覆盖：同时支持港股（.HK）、美股（.US）、A股（.CN）、新加坡（.SG）四大市场

局限性与风险提示

• 权限管控严格：交易功能需显式开启 LONGBRIDGE_TRADE_ENABLED，默认只读模式限制了策略自动化执行
• 安装依赖较新：使用 uv 工具链安装，对传统 pip 用户存在一定学习成本
• 仅限长桥用户：必须持有长桥证券账户并完成 OpenAPI 密钥申请，非通用行情工具
• 资金风险：虽有点击确认，但命令行环境仍可能因脚本错误、环境变量配置失误导致非预期交易
• 合规边界：高频程序化交易可能触发券商风控，需自行了解长桥 API 速率限制与使用条款

适用人群

• 长桥证券存量用户中的技术型投资者
• 偏好终端操作、需要快速查询持仓/行情的效率型交易者
• 搭建个人量化系统、需 JSON 结构化数据输入的开发者
• 多账户管理需求的专业投资人

安全建议

建议将 API 密钥存储于系统密钥管理工具（如 macOS Keychain），避免明文写入 shell 配置文件；生产环境交易脚本应增加额外的风控校验层。

核心用法

本 Skill 是长桥 OpenAPI CLI 工具（longbridge-cli）的文档封装，为 Agent 提供完整的证券交易能力调用接口。用户可通过自然语言指令完成四大核心操作：行情查询（实时报价、盘口深度、K 线数据、逐笔成交）、账户管理（余额查询、股票/基金持仓）、订单执行（限价买卖、撤单）以及市场数据获取（市场温度、资金流向、期权链）。所有命令均支持 --json 输出格式，便于 AI 解析结构化数据。

显著优点

官方 API 背书：直接对接长桥证券官方 OpenAPI，数据来源权威可靠，覆盖港股、美股、A 股、新加坡市场。 功能完整性：从行情查看到实盘交易形成闭环，支持 1 分钟至年线多周期 K 线、Level-2 盘口、资金流向等专业级数据。 安全设计：默认只读模式，交易功能需显式开启环境变量；下单/撤单均含二次确认，防止误操作。 零代码侵入：纯 Markdown 文档型 Skill，无嵌入可执行代码，依赖系统已安装的 CLI 工具，透明可审计。 AI 友好：全命令 JSON 输出支持，天然适配 Agent 自动化处理流程。

潜在缺点与局限性

环境依赖较重：需预先安装 Python3、uv 包管理器及 longbridge-cli 工具，并配置 APP_KEY/SECRET/TOKEN 三重凭证，新手入门门槛较高。 仅支持长桥生态：功能强绑定长桥证券账户，无法跨券商使用，用户迁移成本高。 实时性受限：行情数据经 CLI 中转，延迟高于直接 API 调用，高频量化场景可能不适用。 功能边界模糊：Skill 本身仅为文档封装，实际执行依赖外部 CLI 工具版本，存在功能不同步风险。 权限管理粗放：交易权限通过单一环境变量控制，缺乏细粒度角色权限体系。

适合的目标群体

个人量化投资者：需快速验证交易策略、自动化盯盘下单的散户投资者。 多账户管理者：持有港股美股仓位，需要统一视图监控持仓与资金的进阶用户。 AI 交易实验者：探索自然语言驱动交易执行的技术爱好者与开发者。 教育研究场景：金融数据分析、算法交易教学的演示工具。

使用风险

凭证泄露风险：APP_SECRET 与 ACCESS_TOKEN 需以环境变量形式配置，若写入 Shell 配置文件（.zshrc/.bashrc）可能被意外提交至代码仓库；建议改用 .env 文件并加入 .gitignore。 交易误操作风险：尽管存在确认提示，但 Agent 自动化执行场景下仍需警惕指令解析错误导致的非预期下单。 CLI 工具依赖风险：外部工具版本更新可能引入破坏性变更，建议锁定版本并定期验证功能一致性。 合规与税务风险：自动化交易可能触发券商风控规则，跨境证券交易需自行处理税务申报义务。 网络稳定性风险：行情与交易依赖长桥服务器可用性，无本地缓存机制，断网即失效。