toss-fx-monitor

name: toss-fx-monitor description: >- Derive the USD/KRW exchange rate from Toss Securities account summary (implied rate from USD cash/positions and KRW equivalents) for cross-market position sizing and FX-aware order cost estimation. Logs daily rates to outputs/toss/fx-{date}.json and alerts on significant daily moves (> 1%). Use when the user asks to "check fx rate", "exchange rate", "환율 확인", "달러 환율", "toss fx", "원달러", "usd krw rate", or needs FX data for US stock position sizing in KRW. Do NOT use for general currency conversion unrelated to trading. Do NOT use for stock quotes (use tossinvest-cli). Do NOT use for live trading (use tossinvest-trading).

toss-fx-monitor

Derive the USD/KRW exchange rate from Toss Securities account summary (implied rate from USD cash/position KRW equivalents) for cross-market position sizing and FX-aware cost estimation. No dedicated FX API exists — the rate is inferred.

When to Use

• Checking current USD/KRW rate before US stock orders
• Sizing US positions in KRW equivalent
• Monitoring FX rate trends across days
• FX-aware P&L calculation for US holdings

When NOT to Use

• For general currency conversion → use WebSearch
• For stock quotes → use tossinvest-cli
• For placing orders → use tossinvest-trading

Prerequisites

• tossctl installed and in PATH
• Active authenticated session

Workflow

Step 1: Extract FX Rate

Primary method — extract from account summary (US positions report KRW equivalent):

tossctl account summary --output json

Parse the response for FX conversion data. The account summary includes USD cash/position values with KRW equivalents, from which the implied FX rate can be derived.

신선도 검증 (필수): 응답 timestamp을 현재 KST와 비교한다 — 60분 이내면 라이브, 초과면 전일 종가(stale)로 분류한다. stale이면 이후 단계에서 라이브 현재가로 단정하지 않는다.

Step 2–5: Delta + Trend + 렌더 (코드 위임)

포맷/집계 결정론은 [[sonnet-format-determinism]]을 따른다 — 모델은 content-only, 코드가 소유.

스크립트가 daily_change_pct 산술, INFO/WARNING/ALERT enum, trend-history append, 신선도 라벨, Korean mrkdwn 템플릿 전부 소유한다:

.venv/bin/python scripts/skills/toss_fx_monitor_fx_monitor.py \
  <today_fx.json> \
  --yesterday outputs/toss/fx-<yesterday>.json \
  --trend-file outputs/toss/fx-trend.json \
  --fmt slack

today_fx.json 스키마: {date, usd_krw, source, timestamp}. 선택: --json-out <path> 로 스냅샷 JSON 저장. --fmt md 로 마크다운 출력. --dry-run 으로 trend-file 쓰기 생략.

Output Files

Examples

User: 환율 확인해줘
Agent: toss-fx-monitor 실행 → USD/KRW ₩1,385.50 (전일 대비 +0.23%)

User: AAPL 10주 원화로 얼마야?
Agent: AAPL @ $178.50 × 10주 = $1,785.00 → ₩2,473,217 (환율 ₩1,385.50/USD)

User: toss fx rate
Agent: (runs the workflow, presents rate with trend)

Error Handling