Unofficial Toss Securities bridge for terminal and AI agents
It exposes the hidden endpoints of a Korean brokerage so your terminal and your AI agent can see the full portfolio picture, taxes and all.

What it does
tossctl is a Go CLI that talks to both the official Toss Securities Open API and the company’s internal web API (WTS). It pulls standard data like quotes and order status from the official side, then layers on another thirty-odd capabilities—dividend history, realized gains, tax withholding records, watchlist folders, and news briefings for holdings—that the vendor never exposed for third-party use. The tool also ships as an MCP server, so Claude, Cursor, or Codex can query your brokerage data in natural language.
The interesting bit
The project treats the brokerage’s own web frontend as a secondary API surface, backfilling the official API’s blind spots with dashboard endpoints that were never meant for automation. Trading is deliberately disabled by default; orders stop at a human-in-the-loop preview stage, which is a rare nod to safety in an unofficial financial tool.
Key highlights
- Bridges official Open API and unofficial WTS internal API under one binary.
- Surfaces 30+ missing features: portfolio analytics, tax docs, stock lending income, earnings calendars, and AI-generated signals.
- MCP server mode lets LLM agents request consolidated briefings like asset changes, dividends, and holding news.
- Local history sync enables offline search and comparison of past positions and trades.
- Real-time trade streaming and read-only API health checks.
Caveats
- This is not an official product. The WTS integration relies on internal endpoints that may violate Toss Securities’ terms and could break without warning.
- The maintainer explicitly warns that account restrictions or losses are the user’s own responsibility.
- U.S. options mock trading is still experimental and hidden behind feature flags.
Verdict
Worth a look if you automate a Toss Securities account and need the full picture—dividends, tax docs, news—rather than just ticker prices. Skip it if you demand vendor-blessed stability or trade outside the Korean brokerage’s ecosystem.
Frequently asked
- What is JungHoonGhae/tossinvest-cli?
- It exposes the hidden endpoints of a Korean brokerage so your terminal and your AI agent can see the full portfolio picture, taxes and all.
- Is tossinvest-cli open source?
- Yes — JungHoonGhae/tossinvest-cli is open source, released under the MIT license.
- What language is tossinvest-cli written in?
- JungHoonGhae/tossinvest-cli is primarily written in Go.
- How popular is tossinvest-cli?
- JungHoonGhae/tossinvest-cli has 501 stars on GitHub.
- Where can I find tossinvest-cli?
- JungHoonGhae/tossinvest-cli is on GitHub at https://github.com/JungHoonGhae/tossinvest-cli.