Support Scope
Coverage vs the official Open API
tossctl covers 100% of the official Toss Open API's read & trade scope — and goes beyond. Register an official key and the features it supports are actually routed through OAuth; the rest go through WTS. See the Hybrid guide for setup.
- ✅ supported · ❌ not supported · 🔸 partial
Official APIcolumn = coverage per public docs; with an official key, ✅ rows are routed via OAuth- Rows where official is ❌ = tossctl-only (always via WTS)
openapi commands
| Command | Description |
|---|---|
tossctl init | Onboarding wizard — step-by-step session, official key, and trading setup |
tossctl openapi login | Register your key (env vars TOSSCTL_OPENAPI_KEY/TOSSCTL_OPENAPI_SECRET or flags) |
tossctl openapi status | Diagnose key · token · allowed IPs · routing state |
tossctl openapi test | Validate connectivity with a real API call |
tossctl openapi logout | Delete the credentials file |
Use the global --backend auto|wts|openapi flag to override routing per request.
Read-only
| Feature | Command | Official API | tossctl |
|---|---|---|---|
| Accounts / summary | account list, account summary | ✅ | ✅ |
| Portfolio | portfolio positions, portfolio allocation | ✅ | ✅ |
| Trade ticks / orderbook | quote trades, quote orderbook | ✅ | ✅ |
| Price limits / buy cautions | quote limits, quote warnings | ✅ | ✅ |
| Sellable qty / commission | quote sellable, quote commission | ✅ | ✅ |
| Quote / candles | quote get, quote chart | 🔸 | ✅ |
| Multi-quote / live refresh | quote batch --live | ❌ | ✅ |
| Investor flows | quote flows | ❌ | ✅ |
| Market indices / index detail | market index [<code|name>] | ❌ | ✅ |
| Live popularity ranking | market ranking | ❌ | ✅ |
| Net-buy by investor | market investors | ❌ | ✅ |
| Sector movements | market sectors | ❌ | ✅ |
| Earnings calendar | market earnings [--major] | ❌ | ✅ |
| Personalized news briefing | market briefing | ❌ | ✅ |
| Toss AI signals | market signals | ❌ | ✅ |
| Screener | market screener | ❌ | ✅ |
| Dividend report | portfolio dividends | ❌ | ✅ |
| Community rankings | community rankings | ❌ | ✅ |
| Watchlist read & management | watchlist ... | ❌ | ✅ |
| Transaction ledger / cash overview | transactions list/overview | ❌ | ✅ |
| CSV export | export ... | ❌ | ✅ |
Trading
| Feature | Command | Official API | tossctl |
|---|---|---|---|
| Buy/sell orders | order place | ✅ | ✅ |
| Cancel / amend | order cancel, order amend | ✅ | ✅ |
| dry-run preview | order preview | ❌ | ✅ |
| Fractional orders (US, amount/qty) | order place --fractional | ✅ | ✅ |
| Fractional orders — KRW settlement | order place --fractional --currency-mode KRW | ❌ | ✅ |
| Real-time push (SSE) | push listen | ❌ | ✅ |
Fractional sell (beta)
Implements the US market fractional-quantity SELL added in official Open API 1.1.5 (order place --fractional --side sell --qty 0.5, up to 6 decimals). Contract-tested, but not yet live-verified — run order preview before any live trade. Fractional buy remains amount-based (--amount).
Verification basis
The Official API column is verified against a specific version of the
official Open API docs. The verified version and
last-checked date are recorded in
.openapi-snapshot.json;
the full spec is mirrored daily and changes are auto-detected.
The full WTS web API catalog (implemented / next candidate / intentionally excluded) is
continuously tracked in
wts-endpoints.json.