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
Features that only lived in the app, now in your terminal
tossctl brings 21 Toss WTS-only features (flows, AI signals, screener, dividends, and more) to the terminal, and covers 100% of the official Open API's supported range too, for a total of 40 — all through one command interface. No application, no approval, start right now. Connect an official key and those features auto-route through OAuth for extra stability. The official API only opens about 4% of the full Toss WTS surface, so tossctl reaches a lot further.
Flows, indices, AI signals, screener, dividends: 21 Toss WTS features the official API doesn't expose. App-only, now in your terminal.
tossctl covers the official API's whole area 100%. Add an official key and it routes through OAuth (more stable, auto-renewing).
Every command answers in JSON, so people and agents use it the same way.
Of ~440 Toss WTS features, the official Open API opens only about 4% — tossctl covers the rest too.
Auto-routing between the official API and WTS — safe and fast
Connect an official key and the 19 features tossctl shares with the official API auto-route through the official API's OAuth path. Tokens refresh automatically, and it runs on Toss's officially supported path — safer and more stable.
At the same time, tossctl still gives you the 21 Toss WTS-only features the official API doesn't expose. Most new features land in the app (WTS) first, and tossctl uses that scope right away instead of waiting for an official rollout. No application, no approval — start now.
The faster surface and the steadier route, both at once.
Everything the official API supports (100% covered) + 21 unique = 40 total
Two sources, one command interface
tossctl covers 100% of what the official API supports (19) and adds 21 Toss WTS-only features the official API doesn't expose, for 40 total. (For context: Toss WTS has ~440 features total, and tossctl keeps expanding into the meaningful ones.)
- Accounts · balances
- Quotes · orderbook · ticks
- Place · cancel · amend
- Everything the official API supports (official key unlocks OAuth routing)
- 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
Trading is off by default, with an order preview and two confirmations before anything runs. No accidental orders.
Agent-friendly
Every result comes back in a format AI reads directly, so agents like Claude, Codex, and Cursor connect 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?
tossctl didn't build these features. It reuses the same internal API the Toss web and app (WTS) already use. The official Open API exposes only about 4% of that surface, so a tool drawing from the same source naturally covers more.
Why does the official API always lag?
On any platform, new features are shipped and integrated fastest inside the first-party app, so they land in the app (WTS) first. A public API carries versioning, compatibility, and support costs, so it opens a stable subset afterwards. It is not anyone’s fault, just the shape of the platform, and tossctl works with it.
Does tossctl become pointless once the official API grows?
It gets better. Features the official API supports auto-route through the official API's path (OAuth) for stability, while the rest keep coming from WTS. tossctl always covers 100% of the official API's scope.
Is this legal? Is it official?
It depends how you use it. tossctl itself is not an official Toss product, but using only an official Open API key runs on Toss's sanctioned, legitimate path. The WTS (internal web API) path is unofficial and may violate the Terms of Service. You are responsible for any account restrictions or losses from using it.
Can an order fire by accident?
No. Trading is off by default and must be enabled in config.json. A live order requires a preview and a two-step confirm (--execute + --confirm).
Are my account data and keys safe?
tossctl runs locally. Your session and credentials are stored on your own machine with 0600 permissions and never sent to any third-party server.
How does it work with AI agents?
Every command answers in JSON, and there is an agent guide plus /llms.txt. Tools like Claude Code, Codex, and Cursor can call it directly.