核心功能概述
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 配置文件；生产环境交易脚本应增加额外的风控校验层。