tossinvest-cli
connect your AI agents to Toss Securities
Read accounts, quotes, and transactions, and place orders — plus the Toss WTS features the official API doesn't expose. All from tossctl, right now, official API coverage included.
$ tossctl auth login
$ tossctl account summary --output json
$ tossctl quote get 005930
$ tossctl market index nasdaq
$ tossctl order preview --symbol TSLA --side buy --qty 1 --price 250
Claude Code
Codex CLI
Gemini CLI
Cursor
GitHub Copilot
OpenCode
Qwen Code
DeepSeek
Mistral
Kimi CLI
OpenClaw
Hermes Agent
Beyond accounts and orders: Securities data for your automation
WTS is the Toss Securities Web Trading System. Connect a web session for investor flows, AI signals, dividends, and watchlists missing from the official API. Connect an official key for official-only features. General Toss banking and card spending are not supported.
Explore investor flows, indices, AI signals, screeners, dividends, and watchlists.
Supported reads prefer the official API by default when a key is connected. Order routing follows each command’s policy.
The CLI answers in JSON; the MCP server (tossctl mcp) exposes tools. Both are supported, so Claude, Codex, Cursor and any agent plug in right away.
Live trading is disabled by default. Settings and paper trading follow their own preview and authorization policies.
Official API and WTS: the right path for each feature
The official API needs a key and allowed IP. WTS uses a web session approved on your phone. Connect both credentials to use supported official and WTS features from one tool.
Some reads can fall back to WTS after an eligible official API failure. Orders use one backend without cross-backend retry. WTS is unofficial and can change without notice.
Check feature coverage alongside authentication and execution policies.
Official accounts, quotes, and orders, plus WTS-only features.
Two sources, one command interface
See Support Scope for feature availability and authentication requirements.
- Accounts · balances
- Quotes · orderbook · ticks
- Place · cancel · amend
- Official accounts, quotes, and orders (official key required)
- Flows · indices · index detail · sectors
- AI signals · news briefing · screener
- Dividends · community rankings · watchlist · real-time push · dry-run
Broad reads
Accounts, quotes, orderbook, ticks, flows, indices, sectors, dividends, ledger, in one command.
Safe trading
Live trading is disabled by default. Per-action config and order-specific preview and confirmation reduce unintended submissions.
CLI + MCP, both
Connect via the CLI (JSON output) or the MCP server (tossctl mcp) — both supported, so agents like Claude, Codex, and Cursor plug in right away.
Toss AI features
AI signals, news briefing, screener, community rankings, none of which the official API has.
Real-time push
See order, fill, and holdings changes the moment they happen.
Automation-first
Export as a table, file, or live feed, drop it straight into scripts and automation.
Docs LLMs can read directly
Every page has Copy Markdown · Open in ChatGPT/Claude/Cursor + /llms.txt.
Frequently asked
Anything missing? Open a GitHub issue.
How do you offer more features than the official Open API?
Features missing from the official API are supplied through verified Toss Securities WTS endpoints. This does not mean every WTS or general Toss app feature is implemented.
Does this support Toss banking or card spending?
Not yet. The current scope is Toss Securities. General Banking and MyData need a separate mobile connector and authentication; Securities accumulation funding status is a different feature.
Does tossctl become pointless once the official API grows?
We track official API changes and update supported routes. WTS-only features, CLI and MCP access, structured output, and execution checks remain useful. Consult the support matrix for current coverage.
Is this legal? Is it official?
This is not an official Toss Securities product. It supports both official API and unofficial WTS routes. WTS use may violate the Terms of Service and stop working without notice. Review the terms and use at your own risk.
Can an order fire by accident?
Live trading is blocked by default. Even after enabling it, each order needs a preview, --execute, and --confirm. These checks cannot guarantee against approving a wrong order or investment losses.
Are my account data and keys safe?
Credentials are stored in owner-only local files and used for authentication and API calls. Account data returned to an AI host follows that host’s processing policies, so avoid public logs and shared prompts.
How does it work with AI agents?
General reads support --output json, and there is an agent guide plus /llms.txt. Tools like Claude Code, Codex, and Cursor can call it directly.