toss-portfolio-state
Installation
SKILL.md
Toss Portfolio State
Collect a read-only Toss Invest OpenAPI snapshot as a normalized toss_portfolio_snapshot for temporary account-state evidence.
Quick Start
- Read
references/snapshot-contract.mdbefore mapping fields or changing the script. - Confirm from the requested outcome that the task is read-only. If it includes orders, transfers, automatic rebalancing, or live execution, state the boundary and stop before loading credentials.
- Prefer the configured home-server route when Toss restricts API access to that public IP. Read
references/remote-access.md, then run the bundled Bun transport from the active skill directory:
bun --no-env-file --no-install scripts/remote_portfolio_snapshot.ts fetch --market-context basic --orders-days 30 --recent-orders-limit 40
If the device is not configured, run the reference's one-time setup only after the user approves local SSH key and config changes. Do not create a per-device wrapper binary or fall back to a local Toss request.
- Use the direct fetcher only when the user explicitly chooses a local route whose egress IP is authorized. Load credentials only from process environment or a user-specified env file. Never store secrets, tokens, raw account numbers, or raw broker responses in the skill directory. Use
--no-env-fileso Bun does not auto-load an ambient.env; pass the intended file explicitly: