技能介绍

它解决什么问题

在量化回测之外，很多研发和业务同学还需要一个能贴近 A 股/港股自选股流程的模拟交易环境：既要维护自选股，又要查看模拟账户、资金、持仓、成交和收益，还不能把模拟结果误当成真实持仓。该 Skill 把 FinXData 模拟交易能力封装成 Python 客户端，统一处理鉴权、请求签名和 JSON 输出，避免每个脚本自己拼参数。

技能如何工作

核心能力围绕自选股和模拟交易展开。A 股支持自选股、模拟账户、下单、订单、持仓、成交、资金、资产和收益查询；港股目前只支持已进入证券主数据的自选股，模拟账户、交易规则、费用和下单接口尚未开放。

运行入口是 scripts/finxdata_simtrading.py，脚本输出 JSON；接口或配置出错时以非零状态退出。客户端会使用稳定的 FinXData Agent User-Agent，减少 Python urllib 默认签名被 Cloudflare 拦截的问题。

关键执行步骤包括：

写操作前先读取当前自选股、账户、持仓或订单状态。
只有用户明确要求时才添加或删除自选股。
下单前确认证券市场；当前只提交 A 股订单。
下单前复述账户、市场、证券代码、方向、订单类型、数量和限价。
首次请求前生成稳定的 client_order_id；超时或断线重试时复用原值。
说明成交为模拟结果，可能与真实交易所不同。

边界与注意点

专用 Trading Key 拥有全部模拟交易权限，与普通数据 API Key 及套餐额度相互独立。配置写入 FINXDATA_TRADING_KEY；如需切换服务地址，可设置 FINXDATA_BASE_URL，默认 https://api.finxdata.ai。不要打印、记录或复述完整 Key；鉴权失败时，请用户在系统外创建或轮换 Trading Key。

收到 401 时，让用户创建或轮换 FINXDATA_TRADING_KEY；收到 429 时等待模拟交易独立写限流恢复，不要改用 X-API-Key 或登录 JWT。重置账户会归档历史账户并创建替代账户，必须确认明确意图并传入 --confirm RESET。需要精确参数、响应字段、市场范围、额度行为或业务错误码时，读取 references/api.md；脚本也可作为 FinXDataSimTradingClient 导入直接调用。