复星财富 OpenAPI 技能集
本目录包含与复星财富 OpenAPI 相关的所有技能,统一管理港股、美股、A 股(港股通)的 SDK 配置与交易操作。
子技能一览
1. fosun-sdk-setup — SDK 初始化与凭证管理
路径: fosun-sdk-setup/SKILL.md
用途: 安装、验证和配置 Fosun OpenAPI SDK(fsopenapi),通过 fosun.env 管理 API 凭证。
核心功能:
- SDK 安装: 检测并安装
fsopenapi到.venv-fosun虚拟环境(支持本地源码或 GitHub 下载) - 开通引导: 首次使用时引导用户生成客户端密钥对、获取出口 IP、申请 API 权限
- 凭证管理: 通过对话交互式收集并写入
fosun.env(含服务端公钥、客户端私钥、API Key) - 凭证更新: 支持切换账号、更换 API Key、鉴权失败时重新配置
适用场景: 首次设置 SDK、修复安装/导入/鉴权问题、轮换 API Key 或切换账号、其他 fosun-* 技能的前置依赖。
2. fosun-trading — 证券交易工具集
路径: fosun-trading/SKILL.md
用途: 通过命令行脚本完成行情查询、资金管理和交易操作。
核心功能:
| 功能 | 脚本 | 说明 |
|---|---|---|
| 行情查询 | query_price.py | 报价、盘口、K线、分时、逐笔成交、经纪商队列 |
| 买卖信息查询 | query_bidask.py | 每手股数(lotSize)、可买/可卖数量、购买力 |
| 资金/持仓查询 | query_funds.py | 资金汇总、持仓列表、账户列表 |
| 资金流水查询 | query_cashflows.py | 按日期/类型查询资金进出明细 |
| 下单 | place_order.py | 限价/增强限价/特别限价/竞价/市价单 |
| 订单查询 | list_orders.py | 按状态/日期/方向/市场筛选订单 |
| 撤单 | cancel_order.py | 撤销未成交订单 |
适用场景: 查询股票行情、查看账户余额与持仓、查询资金流水、买卖股票、管理订单。
支持的市场
| 市场代码 | 说明 | 行情级别 | 币种 |
|---|---|---|---|
hk | 港股 | L2(含盘口、经纪商队列) | HKD |
us | 美股 | L1(盘前/盘中/盘后) | USD |
sh | 上交所(港股通) | L1 | CNH |
sz | 深交所(港股通) | L1 | CNH |
标的代码格式: 市场代码 + 股票代码,如 hk00700(腾讯)、usAAPL(苹果)、sh600519(茅台)、sz000001(平安银行)。
环境要求
- Python 虚拟环境:
{workspace_root}/.venv-fosun - 凭证文件:
{workspace_root}/fosun.env - 禁止擅自创建新虚拟环境或使用系统 Python
- 统一使用虚拟环境内的绝对路径解释器执行所有脚本