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

  1. Read references/snapshot-contract.md before mapping fields or changing the script.
  2. 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.
  3. 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.

  1. 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-file so Bun does not auto-load an ambient .env; pass the intended file explicitly:
Installs
20
GitHub Stars
1
First Seen
Jul 10, 2026
toss-portfolio-state — gigio1023/agent-skills