核心功能与用法
Longbridge OpenAPI Skill 是长桥证券官方推出的 AI 技能包，通过自然语言交互实现港股、美股、A 股的完整证券交易链路。核心功能覆盖三大模块：
行情数据：支持实时行情订阅（quote/depth/broker/trade）、多周期 K 线数据（分钟/日/周/月/年）获取、股票静态信息查询。用户可直接询问"腾讯最新股价"或"获取苹果近7日日线"，系统自动调用对应工具返回结构化数据。
交易执行：支持限价单（LO）、市价单（MO）、增强限价单（ELO）等多种订单类型，以及 Day/GTC/GTD 等时效设置。自然语言指令如"以320港元买入100股腾讯"会触发订单确认流程，经用户确认后执行下单、改单、撤单操作。
账户管理：实时查询多币种账户余额（HKD/USD/CNY 等）、购买力、净资产，以及当前持仓的成本价、市值、盈亏情况。
显著优点
1. 官方背书：长桥证券为香港持牌券商（中央编号 BJ933），API 直接对接交易所级行情与交易通道，数据实时性与执行可靠性高于第三方聚合接口
2. 多市场覆盖：单一技能同时支持港股（XXX.HK）、美股（XXX.US）、A股（XXX.SH/SZ）三大市场，适合跨境资产配置用户
3. 自然语言交互：将专业证券交易术语封装为对话式指令，大幅降低量化交易门槛
4. 完整订单生命周期：从订阅行情到下单、改单、撤单、查询成交的全链路闭环
潜在局限与风险
1. 资质门槛：需拥有长桥证券账户并完成 API 权限申请，非完全开放接口
2. 资金风险：直接涉及真实资金划转，误操作或指令歧义可能导致意外成交
3. 市场时效限制：依赖交易所交易时间，非交易时段的下单可能进入预委托或失败
4. 合规声明限制：官方明确标注"仅供技术学习研究，不构成投资建议"，智能体无法提供投研分析
适合人群
- 已有长桥证券账户的活跃交易者，希望通过自然语言快速查询持仓或执行常规交易
- 量化入门学习者，需要真实市场数据验证策略但暂不具备复杂 SDK 开发能力
- 多市场资产配置者，需要在一个界面统一管理港股、美股、A股头寸
常规风险提示
- API 密钥安全：App Key、App Secret、Access Token 直接关联账户资金，泄露将导致资金损失，需严格避免硬编码或上传至代码仓库
- 模拟盘先行：官方提供 demo 账户，建议充分测试后再切换实盘
- 订单二次确认：涉及资金变动的操作应强制人工确认，避免自然语言歧义导致的误下单
- 权限最小化：建议为 API 密钥配置仅必要的行情订阅与交易权限，定期轮换密钥
技术架构
用户指令 → OpenClaw 解析 → Longbridge Skill 层 → Python SDK (longbridge ≥0.2.77) → REST API/WebSocket → 长桥证券核心系统