SuperAPI AI 工具集

finhay-trading

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:通过 Finhay Securities 开放 API 只读访问交易数据,适合查询账户身份、交易账户、股票持仓、订单与盈亏等场景。

主要能力:提供账户摘要、资产摘要、订单列表、订单簿、投资组合、当日盈亏、用户权限及市场交易时段等接口。路径版本(v1、v2、v5)固定,须使用指定版本。

使用方式:所有接口使用签名 GET 请求。执行前必须完成预检,需要 FINHAY_API_KEY、FINHAY_API_SECRET、USER_ID 及相关 SUB_ACCOUNT_* 变量。若缺少 USER_ID 或 SUB_ACCOUNT_*,先运行一次 ./_shared/scripts/infer-sub-account.sh,将 USER_ID、SUB_ACCOUNT_NORMAL 和/或 SUB_ACCOUNT_MARGIN 写入 ~/.finhay/credentials/.env。请求统一使用 request.sh,调用前须解析全部路径变量,签名路径必须是最终完整路径。示例:source ~/.finhay/credentials/.env 后执行 ./_shared/scripts/request.sh GET "/trading/accounts/$SUB_ACCOUNT_NORMAL/summary"。

子账户选择:需要 {subAccountId} 时,先询问用户使用 NORMAL 还是 MARGIN,再替换为对应环境变量。

限制:订单接口必须提供 fromDate 和 toDate,不可省略;未与用户确认子账户类型前,不得替换 {subAccountId}。接口详情与响应结构见 references/endpoints.md,枚举见 references/enums.md。