Support Scope
Coverage vs the official Open API
Compare implemented official Open API and WTS-only capabilities. Implementation is not a guarantee of availability: credentials, eligibility, market hours, and server state can restrict calls. See the Hybrid guide for setup.
- ✅ supported · ❌ not supported · 🔸 partial · 🆕 added within 30 days or not yet released
- The
Official APIcolumn describes the public contract. Actual routing follows each command's policy and configuration. - Official ❌ rows are WTS additions or local features; CSV output and preview are not themselves WTS endpoints.
The README's 30+ extra capabilities count rows below where the official API is ❌ and tossctl is ✅, excluding local CSV export, order preview, and experimental paper trading. A capability can combine several calls, so this is not a distinct endpoint count.
Compared against the official Open API specification 1.2.15 on 2026-09-12. The official API also provides Korean investor-trading data, volume/value/price-change rankings, selected market indicators, and batch quotes. These overlap with WTS but differ in scope or fields; they are marked partial below and excluded from the extra-capability count.
Product domain ≠ access channel
Securities, Banking, and MyData are product domains. Official Open API, WTS, and mobile are access channels. WTS is the Toss Securities Web Trading System, not a web app for general Toss Banking.
| Product domain | Access channel | Current support |
|---|---|---|
| Toss Securities | official, WTS, Securities mobile surface inside Toss | official + WTS |
| General Banking | general Toss mobile API (no corresponding WTS) | unsupported — separate mobile auth required |
| MyData cards/spending | general Toss mobile API | partially confirmed statically; unsupported |
| System | login, Open API IP, change monitoring | supported |
The canonical accumulate funding-status command is the funding connection for
Securities stock accumulation, so it is securities + wts, not general Banking. The old banking status spelling is a deprecated alias. Its automated-order
funding flag is also a narrow Securities workflow state, not access to general Banking records.
The absence of a web UI is not itself a reason an API is unsupported. A WTS contract can be called without a UI once its current web-session contract is verified. General Banking/MyData is unsupported because the main-app session, app/device headers, and request/response cipher connector are not implemented—not because those APIs do not exist.
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 ip list | List allowed IPs (WTS session required) |
tossctl openapi ip replace-current | Preview/confirm replacement with the current public IP |
tossctl openapi logout | Delete the credentials file |
Use the global --backend auto|wts|openapi flag to override routing per request.
Reads and settings
Some rows include both reads and changes. add/remove, hide/show, and watchlist mutations are writes governed by the Safety Model.
| Feature | Command | Official API | tossctl |
|---|---|---|---|
| Accounts / summary | account list, account summary | ✅ | ✅ |
| 🆕 All-account overview | account overview [--full] | ❌ | ✅ |
| 🆕 Securities trading settings | account trading-settings [--account <key>] (only simple trade is account-specific) | ❌ | ✅ |
| 🆕 Securities transfer accounts | account transfer-accounts [--account <key>] [--full] (masked by default; never initiates a transfer) | ❌ | ✅ |
| 🆕 Securities access and account restrictions | account access-status [--account <key>] (last login, margin freeze, accident-account count; no mutation) | ❌ | ✅ |
| Portfolio | portfolio positions, portfolio allocation | ✅ | ✅ |
| 🆕 Portfolio folders | portfolio folders [--account] (the app's folder/holding organization; read-only) | ❌ | ✅ |
| 🆕 Portfolio valuation history | portfolio performance, portfolio snapshots, portfolio snapshot <date> (Securities WTS read with no current web UI; all accounts by default) | ❌ | ✅ |
| 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 | 🔸 (batch quotes for up to 200 stocks) | ✅ |
| Investor flows | quote flows (WTS), quote supply (official) | 🔸 (Korean daily trading volumes) | ✅ |
| Market indices / index detail | market index [<code|name>] (WTS), market indicator (official) | 🔸 (8 Korean index/bond indicators) | ✅ |
| Live popularity ranking | market ranking (WTS), market rankings (official) | 🔸 (volume/value/price-change rankings) | ✅ |
| Net-buy by investor | market investors | ❌ | ✅ |
| Sector movements & detail | market sectors, market sector <id> | ❌ | ✅ |
| Earnings calendar & detail | market earnings [event-id] (--major: major companies) | ❌ | ✅ |
| Personalized news briefing | market briefing (asset, return, reasoning, news) | ❌ | ✅ |
| Market, holdings, and watchlist news | market news --type <scope> | ❌ | ✅ |
| 🆕 Key earnings & economic releases | market key-events | ❌ | ✅ |
| 🆕 Securities stock-accumulation funding status | accumulate funding-status [--full] (banking status is a deprecated alias; not general Banking/MyData; internal ID omitted) | ❌ | ✅ |
| 🆕 Notification preferences and status | notifications list, notifications status (canonical preferences, inbox unread state, and AI-analysis agreement; no mutation) | ❌ | ✅ |
| Target-price alert read & management | quote alert list/add/remove | ❌ | ✅ |
| Hidden-holding read & management | portfolio hidden list/hide/show | ❌ | ✅ |
| Toss AI signals | market signals, market signal <symbol> | ❌ | ✅ |
| Stock-move explanations and signal cards | quote reasoning, quote reasons, quote signals | ❌ | ✅ |
| Screener | market screener | ❌ | ✅ |
| US-options expiries and chains | quote options <symbol> [--expiry <date>] (no prices; read-only) | ❌ | ✅ |
| Dividend report | portfolio dividends | ❌ | ✅ |
| Deposit-interest payment history | account interest --year N | ❌ | ✅ |
| Expected stock-lending income and rankings | lending expected, lending top (read-only) | ❌ | ✅ |
| Cumulative realized profit | profit | ❌ | ✅ |
| Overseas transfer income (tax) | tax overseas --year N | ❌ | ✅ |
| RIA tax-saving report | tax ria | ❌ | ✅ |
| Stock accumulation 📱 | accumulate list/status | ❌ (no web UI; found in Securities mobile UI, then WTS-verified) | ✅ |
| 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).
Experimental US-options paper trading
Hidden by default; opt in with tossctl config experimental paper-trading --enable. CLI commands include paper status/init/deposit, paper order place/cancel/live-preview, and paper orders pending/completed/cancel-all. MCP gains eight operations and monitor gains four probes.
Observations from 2026-09-03 verified simulated order creation/cancellation but recorded initialization 500s and inconsistent education state. This does not establish stability or availability to every user. Check rolling_features in the WTS inventory below for current observations. Paper and live authorization remain separate.
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.