复星财富 OpenAPI:交易与 SDK 管理 - Openclaw Skills

作者:互联网

2026-04-18

AI教程

什么是 复星财富 OpenAPI Skills?

复星财富 OpenAPI 技能集合是专为开发人员和交易者设计的强大工具集,旨在与金融市场实现无缝交互。该套件提供了一个统一的界面,用于处理 SDK 配置并在香港、美国和沪深市场执行复杂的交易操作。通过将这些 Openclaw Skills 集成到您的工作流程中,您可以在不离开开发环境的情况下自动执行账户管理、实时市场数据获取和订单执行。

该软件包专门弥合了原始 API 端点与可执行终端命令之间的鸿沟。它处理了身份验证、虚拟环境(virtual environments)中的环境隔离以及特定市场的格式化数据等复杂细节,确保为算法交易或手动辅助交易提供专业级的体验。

下载入口:https://github.com/openclaw/skills/tree/main/skills/2023andrewyang/fw-trading

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install fw-trading

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 fw-trading。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

复星财富 OpenAPI Skills 应用场景

  • 首次设置和配置复星 OpenAPI SDK,并进行自动化环境检查。
  • 自动获取港股和美股的实时报价、K 线和经纪席位队列。
  • 监控多币种的实时账户余额、股票持仓和详细的现金流历史。
  • 以编程方式执行复杂的订单类型,包括限价单、增强限价单和市价单。
  • 管理活跃订单的生命周期,包括状态筛选和待成交订单的批量撤单。
复星财富 OpenAPI Skills 工作原理
  1. 技能会验证 .venv-fosun 虚拟环境是否存在,并确保已正确安装 fsopenapi SDK。
  2. 启动设置工作流以生成客户端 RSA 密钥,并提供用于 API 门户注册所需的公钥。
  3. 通过安全的交互式提示收集 API 密钥和私钥等敏感凭据,并将其存储在本地的 fosun.env 文件中。
  4. 通过使用环境解释器的绝对路径调用专门的 Python 脚本来执行交易操作,以确保稳定性。
  5. 从 API 解析市场数据和交易响应,并以结构化格式呈现,以便立即分析或进一步自动化。

复星财富 OpenAPI Skills 配置指南

技能会自动管理设置过程,但底层步骤包括:

# 1. 创建专用环境
python3 -m venv .venv-fosun

# 2. 安装核心 SDK
# 技能可以从本地源或 GitHub 安装
pip install fsopenapi

# 3. 配置环境文件
# 在工作区根目录创建一个包含以下内容的 fosun.env:
# FOSUN_API_KEY=your_key
# FOSUN_PRIVATE_KEY_PATH=path_to_key

复星财富 OpenAPI Skills 数据架构与分类体系

该技能通过结构化环境和特定的命名约定来组织其操作:

组件 详情
工作区根目录 包含 fosun.env 配置文件和 .venv-fosun 目录。
市场标识符 hk (港股), us (美股), sh (沪股通), sz (深股通)。
代码格式 市场前缀 + 股票代码 (例如:hk00700 代表腾讯, usAAPL 代表 Apple)。
凭据 通过 RSA 密钥对(客户端私钥/服务器公钥)和 API 密钥进行管理。
name: fosun-skills
description: Fosun Wealth OpenAPI 技能集合,包含 SDK 环境初始化与证券交易两大模块。涵盖 SDK 安装配置、凭证管理、行情查询、资金/持仓查询、资金流水查询、下单/撤单及订单管理,支持港股(L2)、美股(L1)、A股港股通(L1)市场。

复星财富 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
  • 统一使用虚拟环境内的绝对路径解释器执行所有脚本

相关推荐