This is a curated command reference. Use tossctl --help and subcommand help for all CLI options; use tossctl ops list and tossctl ops describe <id> for the ops/MCP catalog. General reads support --output table|json|csv; charts and streams have command-specific output formats.
| Command | Description |
|---|
tossctl history sync [--from DATE --to DATE --market all] | Preview SQLite collection; repeat with --execute --confirm <token> to save |
tossctl history list | Collection IDs, freshness, coverage, and completeness |
tossctl history positions [--snapshot ID] | Read stored holdings |
tossctl history transactions [--snapshot ID] [--query TEXT] | Filter, search, and page through stored transactions |
tossctl history search <query> [--snapshot ID] | Literal transaction search |
tossctl history compare <before-id> <after-id> | Compare quantity and valuation changes |
All commands except sync work offline. See the collection contract.
| Command | Description |
|---|
tossctl auth login [--link] [--headless] [--qr-output <path>] | QR or tap-on-phone link + phone-approval login |
tossctl auth status | Session validity / expiry |
tossctl auth extend [--timeout 120s] [--if-expiring 48h] | Extend via phone push (~7 days), optionally skip while enough time remains |
| Command | Description |
|---|
tossctl account list | Accounts |
tossctl account buying-power | Official buying power (official key required) |
tossctl account summary | Total assets, P&L, by market |
tossctl portfolio positions | Holdings (USD shown for US) |
tossctl portfolio briefing [--news-limit N] | Combine holdings, news, upcoming earnings calls, and pending orders |
tossctl portfolio allocation | Allocation |
tossctl portfolio folders [--account <key>] | User-defined folder holdings and fee-adjusted P/L (account and internal folder keys omitted) |
tossctl portfolio performance [--account <key>] | One-month daily principal, valuation, return, and range high/low (all Securities accounts by default) |
tossctl portfolio snapshots [--account <key>] [--cursor <key>] [--limit N] | Cursor-paged dated portfolio valuation history |
tossctl portfolio snapshot <YYYY-MM-DD> [--account <key>] | Full market and holding detail for one valuation date |
tossctl portfolio dividends [--year N] [--by-payment-date] | Annual dividends (total, region, monthly, tax) |
tossctl portfolio hidden list [--account <key>] | Holdings hidden from the Securities portfolio (account key omitted) |
tossctl portfolio hidden hide|show <symbol> [--execute --confirm <token>] | Preview/confirm hiding or restoring a holding |
tossctl profit | Cumulative realized profit (trading, dividends, lending, maturity, interest — KRW/USD) |
tossctl tax overseas [--year N] | Overseas transfer income (rate, deduction, per-stock P/L — for tax filing) |
tossctl accumulate list | Stock accumulation plans — 📱 found in the Securities mobile UI, then WTS-call verified |
tossctl accumulate status <symbol> | Accumulation plan for one stock (Active/Paused) |
| Command | Description |
|---|
tossctl quote get <symbol> | Quote (OHLC, 52w, market cap, trading value, strength) |
tossctl quote flows <symbol> | Investor net-buy flows (WTS) |
tossctl quote metadata <symbol> | Official stock metadata (official key required) |
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 |
tossctl quote alert list <symbol> | Securities target-price alerts |
tossctl quote alert add|remove <symbol> --price N --currency KRW|USD [--execute --confirm <token>] | Preview/confirm target-price alert changes |
| Command | Description |
|---|
tossctl market index [<code|name>] | Major indices / detail (OHLC, 52w, feed, session start/end/open state) with an argument |
tossctl market news [--limit N] | Market news |
tossctl market business-days <KR|US> · tossctl market stocks <MARKET> | Official business days and stock directory (official key required) |
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 sector <id> | Current sector move, related-sector tree, constituents, ETFs, and news |
tossctl market earnings [event-id] | Earnings calendar / report and media links for an ID (--major: major companies) |
tossctl market earnings transcript <event-id> | Timestamped original paragraphs, nullable translations and summaries |
tossctl market earnings report <event-id> | Analysis, watch points and source IDs; unavailable sections remain null |
tossctl market briefing | Personalized AI briefing with holdings/watchlist context, return, reasoning, news, and related stocks |
tossctl market key-events | Current key earnings and economic releases (estimates, actuals, previous values) |
tossctl market signals | Toss AI signals |
tossctl market signal <symbol> [--type stocks|equity_etf|index] | AI reasoning and source news for a stock, ETF, or index (e.g. KGG01P) |
tossctl market fx | FX & dollar index |
tossctl market hours | Trading hours |
tossctl market screener [<preset-id>] [--filter '<json>'] [--nation kr|us] | Screener |
market business-days KR returns combined KRX/NXT session times. An after-market
session may exist while NXT is closed and its auction end is absent. See
session and response scope.
earnings transcript returns available: false with an empty paragraph list when no transcript is available. Report analysis and watch points are independently nullable. Translation/summary nulls do not identify why content is unavailable. JSON preserves source IDs and timestamps; MCP may trim long results, so use fields projection or the CLI for the full transcript. market signal --type index uses index codes from market index; unavailable agreement metadata remains terms: null.
| 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> [--execute --confirm <token>] | Preview by default; cancel with that command's token |
tossctl order amend --order-id <id> ... [--execute --confirm <token>] | Preview by default; amend with that command's token |
tossctl orders list · orders completed · order show <id> | Pending/filled/single lookup |
tossctl orders completed --all-dates --market all --size 50 --page 1 | Recent completed and canceled orders across all dates |
orders completed defaults to the current month. --all-dates removes the date filter;
--size (default 50) and --page (default 1) each accept 1–100. Only the requested page
is returned. Reaching page N requires up to N history reads to follow server cursors.
For MCP, pass {"all_dates":true,"market":"all","size":50,"page":1} to completed_orders.
all_dates cannot be combined with from or to.
Fractional buys use --fractional --type market --amount <krw>; sells use --fractional --type market --side sell --qty <quantity>. Supply the other order fields and pass preview/execution gates. Fractional sells are not live-verified.
Conditional orders use order conditional list/get/place/cancel/modify and require an official key. Regular CLI orders choose an official/WTS route; ops/MCP live orders are official-only.
| 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 account overview [--full] | All-account and minor-account assets (account numbers masked by default) |
tossctl account trading-settings [--account <key>] | Read-only account-specific simple trade plus user-wide KRX/NXT, ATS notification, and option tick settings |
tossctl account transfer-accounts [--account <key>] [--full] | Securities own/recent transfer accounts (masked by default; never initiates a transfer) |
tossctl account access-status [--account <key>] | Last Securities login context and account-specific margin-freeze/accident-account status (read-only; raw account key omitted) |
tossctl accumulate funding-status [--full] | Securities accumulation funding and automated-order registration (banking status is a deprecated alias; not general Banking/MyData; holder/account masked, internal ID never emitted) |
tossctl notifications list | Read-only WTS notification preferences (internal user ID omitted) |
tossctl notifications status | Read-only canonical preferences, inbox unread state, and AI-analysis agreement |
| Command | Description |
|---|
tossctl watchlist list [<group-id>] [--all] · watchlist groups | Watchlist items by folder / folder list |
tossctl watchlist news <folder-id> | Recommended news for one existing folder; server-limited first page |
tossctl watchlist group create|rename|delete [--execute --confirm <token>] | Preview/confirm folder changes; delete also needs --acknowledge-irreversible |
tossctl watchlist add|remove <symbol or name> --group <id> [--execute --confirm <token>] | Preview/confirm adding or removing symbols |
Connect an official key and supported reads/trades route through OAuth (tokens auto-refresh); other features use WTS. WTS features work with only a web session, while account buying-power, market business-days|stocks, quote metadata, conditional orders, and stream require the official key. 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 ip list | List currently allowed IP addresses (WTS session required) |
tossctl openapi ip replace-current | Preview replacement with the current public IP; apply with --execute --confirm <token> |
tossctl openapi logout | Delete the credential file |
tossctl <command> --backend auto|wts|openapi | Pick the routing backend per request (global, default auto) |
Visible only after opting into experimental.paper_trading. Check server availability and known limits first.
| Command | Description |
|---|
tossctl paper status | Simulated cash and prerequisite status |
tossctl paper init · paper deposit <amount> | Preview initialization or simulated funding |
tossctl paper order place <option-code> · paper order cancel <order-id> | Preview simulated placement or cancellation |
tossctl paper orders pending · paper orders completed | Simulated order history |
tossctl paper orders cancel-all | Preview bulk cancellation of simulated orders |
tossctl paper order live-preview <option-code> | Convert intent to a live preview without submission |
Paper writes require explicit approval in the current request and --execute; they never authorize live trades.
| Command | Description |
|---|
tossctl stream --trade <symbol> | Official WebSocket trade subscription (official key required; not exposed as MCP streaming) |
tossctl update --check | Read-only update check |
tossctl push listen | Real-time push stream (orders/fills/holdings) via SSE |
tossctl monitor api | 82 read probes by default, four more after paper opt-in; exit 0 on success, 1 on failure |
tossctl doctor [--report] | Env/session diagnostics + official key/token/IP checks (JSON, home paths masked) |
tossctl version | Version / update availability |