SuperAPI AI 工具集

finhay-portfolio

编程与开发

查看项目

更新于 10-16 08:46

技能介绍

用途:该技能通过 Finhay Securities Open API 只读获取交易账户数据,覆盖用户身份、余额、股票持仓、订单历史、盈亏与公司行动权益(分红、配股、股东大会、转换事件)。订单执行被有意拆分到 finhay-trading 技能,以保证安全与隔离,本技能仅执行 GET 请求。

主要能力:查询全部投资产品的聚合净资产与余额;特定子账户的现金、购买力与负债;股票持仓的实时数量、均价与市值;指定日期区间的买卖订单历史;当日盈亏;以及公司行动权益。账户余额建议组合使用 assets/summary 与 accounts/summary 两个端点以获得最准确的总资产与净值。注意 products.bond 表示 HayBond 产品,并非传统债券。

使用方式:凭证通过环境变量 FINHAY_API_KEY/FINHAY_API_SECRET 或 ./finhay.sh auth 设置,运行 ./finhay.sh doctor 验证。缺少 ID 时运行 ./finhay.sh infer 以填充 USER_ID、SUB_ACCOUNT_NORMAL、SUB_ACCOUNT_MARGIN。发请求前必须导出 AGENT_NAME,例如 export AGENT_NAME=claude-code。CLI 命令包括 auth、doctor、infer、request、sync。请求示例:./finhay.sh request GET "/users/v3/users/$USER_ID/assets/summary" 与 ./finhay.sh request GET "/trading/v2/sub-accounts/$SUB_ACCOUNT_NORMAL/portfolio"。

限制:仅只读,只执行 GET;下单、改单、撤单需改用 finhay-trading 技能。输出中须遮蔽 API 密钥等敏感凭证;缺少凭证时应停止并请用户提供或运行 auth。查询明细端点前须与用户确认具体账户(Normal/Margin)。读端点仅用短子账户 ID,EXT_* 变体仅用于写操作。价格以 VND 表示且无乘数(如 25,500 VND → 25500)。