前言¶
做策略验证或 Agent 交易类功能时,常见的做法是自己对接券商或行情服务的下单、持仓、资金接口,A 股和港股往往要各写一套。另一条路径是用现成的模拟交易 Skill,把账户、订单、持仓、资金流水这些能力交给 Agent 直接调用。下面介绍 finxdata-simtrading,一个封装 FinXData 模拟交易能力的通用 SKILL.md Skill。
这个 Skill 定位在「让 Agent 管理模拟账户和模拟订单」,不涉及实盘。适合需要在一个对话或任务流里完成创建账户、提交模拟订单、查持仓与成交、看资金流水与收益、必要时撤单或重置账户的开发者。
这是什么¶
Skill 名称是「股票模拟交易」,坐标 @user_8ef78c30/finxdata-simtrading,版本 1.0.1。
来源归属需要说清楚:SkillHub 页面上它的来源标记为 community,发布者是 user_8ef78c30。底层调用的是 FinXData 的 A 股与港股模拟交易能力,但这个 Skill 本身不是 FinXData 官方发布的,维护责任在发布者。
分类为 professional,标签里带 requires_api_key=true,即调用需要凭证。
核心功能¶
按官方简介,能力分四块:
- A 股模拟账户:创建、查询、重置账户。
- A 股模拟交易:提交订单、查询订单、撤单,以及查看持仓、成交、资金流水、资产与收益。
- 自选股管理:A 股和港股都可以管理。
- 港股模拟交易:接口为预留状态,尚未开放。
这里有一个明确的边界:当前只有 A 股的账户与交易是开放的,港股只开放了自选股管理。简介里直接写明「未开放前不要提交港股订单」。
安装与启用¶
需要说明的是,已抓取资料中没有给出具体的安装命令、目录结构或配置文件字段。官方页面(https://api.skillhub.cn/user_8ef78c30/finxdata-simtrading 与 https://www.skillhub.cn/skills/user_8ef78c30/finxdata-simtrading)在本次核实时均无法抓取成功,因此本文不给出未经核实的安装步骤。
可以确认的是凭证相关的事实:标签为 requires_api_key=true,简介中说明使用专用的 X-FINXDATA-TRADING-KEY 来调用 FinXData 的模拟交易能力。启用前需要准备好这个 Key,具体注入方式请以官方页面为准。
该 Skill 基于通用 SKILL.md 格式,理论上可被支持该格式的 Agent 客户端加载,但各客户端的实际接入差异本次未能核实,这里不做分别说明。
典型用法¶
官方资料未提供可复现的调用示例,下面是一个基于能力清单整理的使用流程,供参考。接口名称与参数请以官方页面为准。
- 建账户:让 Agent 创建 A 股模拟账户,拿到账户标识后再进行后续操作。
- 加自选股:把要观察的 A 股或港股代码加入自选股,这一步两个市场都支持。
- 提交模拟订单:用
X-FINXDATA-TRADING-KEY调用 A 股下单接口,只提交 A 股订单。 - 查结果:查询订单状态、持仓、成交记录,以及资金流水、资产与收益。
- 需要调整时撤单,或在想重新开始时重置账户。
整个流程的价值在于不用自己拼装多个接口,Agent 在一个任务里就能走完从建账户到看收益的链路。
适用场景与注意¶
适合的场景:自研 Agent 需要模拟交易能力来做策略验证、功能演示或流程联调,且希望避免自建账户与订单状态管理。
需要注意的几点:
- 凭证必填,无 Key 无法调用。
- 不要提交港股订单,该接口目前只是预留。
- 来源是 community,由个人发布者维护,稳定性与接口变更节奏取决于发布者。
- 页面上的下载量为 2396,安装量为 0。这个组合说明它的下载量尚可但实际安装数据还没起来,选型时建议自己先跑一遍验证。
结尾¶
这个 Skill 的价值在于把 A 股模拟账户、订单、持仓、资金流水这些分散的能力收进一套接口里,同时统一了 A 股与港股的自选股管理,省掉自建账户体系和状态同步的工作。当前港股交易还未开放,接入时按 A 股来做规划即可。
官方地址:https://api.skillhub.cn/user_8ef78c30/finxdata-simtrading