用途:通过 Finhay Securities Open API 在越南证券市场执行股票下单、修改和撤销操作,属于真实资金操作,成交后不可逆。组合查询(余额、持仓、盈亏、历史订单)请使用 finhay-portfolio 技能,本技能仅负责交易执行。
主要能力:提供 CLI 命令 auth(配置凭证)、doctor(检查依赖与配置)、infer(解析 USER_ID 与交易子账户 ID)、request(发送签名 API 请求)、2fa(管理每日 OTP 会话)、sync(更新本地技能定义)。支持下单(POST)、改单(PUT)、撤单(DELETE 带 body),以及可用交易额度、订单簿、订单详情、市场交易时段等只读端点。
必要用法:需先设置 FINHAY_API_KEY/FINHAY_API_SECRET 或运行 ./finhay.sh auth,并用 ./finhay.sh doctor 验证。下单仅使用 subAccountExt 以 .4 结尾的专用子账户,路径用 $SUB_ACCOUNT_ORDER,请求体 sub_account 用 $SUB_ACCOUNT_EXT_ORDER;若为空须停止并提示联系 Finhay Securities 开通。每次写操作前须执行 6 步安全协议:收集参数、预检查(可用额度与市场时段)、展示确认、等待用户输入 confirm、2FA 会话预检、执行并报告。写操作需 X-FH-2FA-TOKEN,每日一个 OTP,最多 5 次请求,验证错误 3 次锁定,票据 5 分钟有效。请求前须导出 AGENT_NAME。
适用场景:在越南交易所(HOSE/HNX/UPCOM/HCX)通过 Finhay 执行真实股票订单的自动化或代理流程。
限制:仅支持 .4 子账户,其他子账户会被网关拒绝;2FA 自动恢复仅限交互式终端,非交互环境需手动执行 Step 5 命令;真实资金操作不可逆,须严格遵循安全协议。