Reference
Command Reference
All tossctl commands
Every read command supports --output table|json|csv (default table). Automation and
agents should use --output json.
| Command | Description |
|---|
tossctl auth login [--headless] [--qr-output <path>] | QR + phone-approval login |
tossctl auth status | Session validity / expiry |
tossctl auth extend [--timeout 120s] | Extend session via phone push (~7 days) |
| Command | Description |
|---|
tossctl account list | Accounts |
tossctl account summary | Total assets, P&L, by market |
tossctl portfolio positions | Holdings (USD shown for US) |
tossctl portfolio allocation | Allocation |
tossctl portfolio dividends [--year N] [--by-payment-date] | Annual dividends (total, region, monthly, tax) |
| Command | Description |
|---|
tossctl quote get <symbol> | Quote (OHLC, 52w, market cap, trading value, strength) |
tossctl quote batch <s1,s2,...> [--chart] [--live] | Multi-quote / live refresh |
tossctl quote chart <symbol> --interval 1m|...|60m | ASCII candle chart |
tossctl quote orderbook <symbol> | 10-level orderbook |
tossctl quote trades <symbol> --count N | Trade ticks |
tossctl quote limits <symbol> | Price limits (KR) |
tossctl quote warnings <symbol> | Buy cautions |
tossctl quote sellable <symbol> | Sellable quantity |
tossctl quote commission <symbol> | Commission & tax rate |
| Command | Description |
|---|
tossctl market index [<code|name>] | Major indices / detail (OHLC, 52w) with an argument |
tossctl market ranking --size N | Live popularity ranking |
tossctl market investors | Top net-buy by investor (foreign, institution, retail) |
tossctl market sectors [<id>] | Sector movements (top-level/sub, 1d·1m·1y) |
tossctl market earnings [--major] | Earnings calendar / major companies |
tossctl market briefing | Personalized AI news briefing (by theme) |
tossctl market signals | Toss AI signals |
tossctl market fx | FX & dollar index |
tossctl market hours | Trading hours |
tossctl market screener [<preset-id>] [--filter '<json>'] [--nation kr|us] | Screener |
| Command | Description |
|---|
tossctl community rankings --type influencer|profit|followers | Community rankings |
Trading is disabled by default. See the Safety Model.
| Command | Description |
|---|
tossctl order preview --symbol <s> --side <buy|sell> --qty <n> --price <p> | dry-run preview (no order sent) |
tossctl order place ... --execute --confirm <token> | Live order (two-step gate) |
tossctl order cancel --order-id <id> --symbol <s> | Cancel |
tossctl order amend --order-id <id> ... | Amend |
tossctl orders list · orders completed · order show <id> | Pending/filled/single lookup |
Fractional (amount-based) order: order place --fractional --amount <krw> --qty 0 (US market order).
| Command | Description |
|---|
tossctl transactions list --market us|kr | Trades, deposits/withdrawals, dividends ledger |
tossctl transactions overview --market us|kr | Orderable / withdrawable / scheduled deposits |
tossctl export positions|orders --market us|kr|all | CSV export |
| Command | Description |
|---|
tossctl watchlist list · watchlist groups | Watchlist / folders |
tossctl watchlist group create|rename|delete | Folder management |
tossctl watchlist add|remove --group <id> | Add/remove symbols |
Connect an official key and the read/trade features the official API supports route through OAuth (tokens auto-refresh); everything else uses the WTS path. All features work without a key too. See the auto-routing guide.
| Command | Description |
|---|
tossctl init | Onboarding wizard (web-session login, official key, trading config) |
tossctl openapi login | Register official API Key/Secret (env, flags, or interactive; file 0600) |
tossctl openapi status | Diagnose key / token / allowed IPs / routing |
tossctl openapi test | Verify the connection with a real call |
tossctl openapi logout | Delete the credential file |
tossctl <command> --backend auto|wts|openapi | Pick the routing backend per request (global, default auto) |
| Command | Description |
|---|
tossctl push listen | Real-time push stream (orders/fills/holdings) via SSE |
tossctl monitor api | Core read API health (early server-change detection) |
tossctl doctor [--report] | Env/session diagnostics + official key/token/IP checks (JSON, home paths masked) |
tossctl version | Version / update availability |