用途:该技能用于以只读方式采集 Toss Invest OpenAPI 的账户组合快照,并归一化为 toss_portfolio_snapshot,作为临时账户状态证据交给下游工作流。若任务涉及下单、转账、自动调仓或实盘执行,应在加载凭据前声明边界并停止。
主要能力:允许的接口范围包括令牌创建、账户发现、持仓、购买力、可卖数量、佣金、订单历史、条件订单历史、汇率、市场日历、股票参考数据、股票警示、价格、订单簿、成交、K 线、排行与市场指标。输出遵循固定字段集、脱敏规则与外部数据信任边界,保留时间戳、来源与警告。
使用方式:先阅读 references/snapshot-contract.md 再映射字段或改脚本。若 Toss 限制 API 访问到特定公网 IP,优先使用已配置的家庭服务器路由,阅读 references/remote-access.md 后运行:bun --no-env-file --no-install scripts/remote_portfolio_snapshot.ts fetch --market-context basic --orders-days 30 --recent-orders-limit 40。仅在用户明确选择本地且出口 IP 已授权时使用直接抓取:bun --no-env-file --no-install scripts/fetch_portfolio_snapshot.ts --env-file .env --market-context basic --orders-days 30 --recent-orders-limit 40。必填环境变量为 TOSS_INVEST_API_KEY 与 TOSS_INVEST_SECRET_KEY,可选 TOSS_INVEST_BASE_URL 与 TOSS_INVEST_ACCOUNT_ALIAS;CLI 参数优先于显式 env 文件,后者优先于进程环境。非官方 base URL 需 --allow-custom-base-url 且必须是用户批准的 HTTPS 端点或回环 mock。
限制:不得打印或持久化令牌、原始账号、密钥或原始 API 信封;账号需掩码,订单 ID 等需省略。请求拒绝重定向,HTTP 错误只报状态码。不要用 bunx,不要安装客户端级 wrapper,不要在设备间复制 SSH 私钥。快照可能过期、延迟或对市场行情不完整,不能当作实时行情研究;近期已平仓订单也不能推断税务批次。失败时返回 blocker,说明失败能力与最小安全下一步,不返回依赖缺失字段的自信部分快照。