tossinvest-cli
connect your AI agents to Toss Securities
토스증권 계좌·시세·거래내역을 조회하고, 주문을 넣습니다. 토스 WTS 고유 기능까지tossctl 하나로 — 공식 Open API 100% 포함은 물론입니다.
$ 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
토스 앱에만 있던 기능, 지금 터미널에서
tossctl은 수급·AI 시그널·조건검색·배당 등 토스 WTS에만 있는 고유 기능 21개를 제공하고, 공식 Open API 지원 범위도 100% 포함해 총 40개를 하나의 명령 체계로 씁니다. 신청·승인 없이 지금 바로 시작할 수 있고, 공식 키를 연결하면 해당 기능은 자동으로 OAuth 경로로 라우팅돼 더 안정적입니다. 공식 Open API가 여는 범위는 토스 WTS 전체의 약 4%뿐이라, tossctl이 그만큼 더 넓은 영역을 커버합니다.
토스 WTS엔 있지만 공식 API엔 없는 수급·지수·AI 시그널·스크리너·배당 등 21개. 앱에서만 쓰던 기능을 터미널로.
공식 Open API가 여는 범위를 빠짐없이 100% 포함합니다. 공식 키를 연결하면 OAuth 경로로 더 안정적으로 동작합니다.
CLI는 JSON 출력으로, MCP 서버(tossctl mcp)는 툴로. 두 방식 모두 지원해 Claude·Codex·Cursor 등 어떤 AI 에이전트에든 바로 붙습니다.
공식 Open API는 토스 WTS 기능 ~440개 중 약 4%만 엽니다. tossctl은 그 너머까지 다룹니다.
공식 Open API와 WTS 자동 라우팅으로, 안전하고 빠르게
공식 키를 연결하면 tossctl이 지원하는 기능 중 공식 Open API가 지원하는 19개는 자동으로 공식 API(OAuth) 경로로 라우팅됩니다. 토큰이 자동 갱신되고 토스가 공식으로 지원하는 경로라 더 안전하고 안정적으로 동작합니다.
동시에 공식 API에는 없는 토스 WTS 고유 기능 21개까지 그대로 제공합니다. 새 기능은 대부분 앱(WTS)에 먼저 나오는데, tossctl은 공식 출시를 기다리지 않고 이 범위를 바로 씁니다. 신청이나 승인 없이 지금 시작할 수 있습니다.
더 빠른 범위와 더 안정적인 경로, 둘 다 취합니다.
공식 Open API 지원 전부(100% 커버) + 고유 21개 = 총 40개
두 소스를 하나의 명령 체계로
tossctl은 공식 Open API 지원 범위(19개)를 100% 포함하고, 공식엔 없는 토스 WTS 고유 기능 21개를 더해 총 40개를 제공합니다. (참고: 토스 WTS 전체는 ~440개, 의미있는 범위를 계속 넓혀가는 중입니다.)
- 계좌·잔고
- 시세·호가·체결
- 주문·취소·정정
- 공식 Open API 지원 기능 전부 (공식 키 연결 시 OAuth 경로로 더 안정적)
- 수급·시장지수·지수 상세·업종 등락
- AI 시그널·뉴스 브리핑·조건검색
- 배당·커뮤니티 랭킹·관심종목·실시간 푸시·dry-run preview
넓은 조회
계좌·시세·호가·체결·수급·지수·업종·배당·거래내역을 명령 한 줄로 조회합니다.
안전한 거래
거래는 기본으로 꺼져 있고, 주문 전 미리보기와 두 번의 확인을 거칩니다. 실수로 주문이 나가지 않습니다.
CLI + MCP 둘 다
CLI(JSON 출력)로도, MCP 서버(tossctl mcp)로도 붙습니다. 두 방식 모두 지원 — Claude·Codex·Cursor 등 어떤 에이전트에든 그대로 연동됩니다.
토스 AI 기능
공식 API에는 없는 AI 시그널·뉴스 브리핑·조건검색·커뮤니티 랭킹을 제공합니다.
실시간 푸시
주문·체결·보유 변동을 실시간으로 받아봅니다.
자동화 우선
표·파일·실시간 등 원하는 형식으로 내보내 스크립트와 자동화에 바로 연결합니다.
LLM이 바로 읽는 문서
모든 페이지에 Copy Markdown · ChatGPT/Claude/Cursor로 열기 + /llms.txt 제공.
자주 묻는 질문
여기에 없는 내용은 GitHub Issues 로 남겨 주세요.
어떻게 공식 Open API보다 많은 기능을 제공하나요?
새 기능을 직접 만든 게 아닙니다. tossctl 은 토스 웹·앱(WTS)이 실제로 쓰는 내부 API를 그대로 재사용합니다. 공식 Open API 는 그 전체 중 약 4%만 외부에 열어둔 상태라, 같은 출처를 쓰는 tossctl 이 자연히 더 넓은 범위를 다룹니다.
공식 API는 왜 항상 한 발 늦나요?
어느 플랫폼이든 새 기능은 자사 앱에서 가장 빠르게 실험·통합되므로 앱(WTS)에 먼저 들어갑니다. 외부 공개용 API는 버전·호환성·지원 부담이 커서 안정적인 범위만 신중히 뒤따라 엽니다. 누구의 잘못이 아니라 플랫폼의 구조이고, tossctl 은 이 구조를 거스르지 않고 그대로 활용합니다.
공식 API가 넓어지면 tossctl 은 무의미해지나요?
오히려 더 좋아집니다. 공식 Open API가 지원하는 기능은 자동으로 공식 API 경로(OAuth)로 라우팅해 안정성을 높이고, 공식 Open API에 아직 없는 범위는 계속 WTS 로 채웁니다. 공식 Open API 범위는 언제나 100% 포함합니다.
합법인가요? 토스 공식인가요?
쓰는 방식에 따라 다릅니다. tossctl 자체는 토스 공식 제품이 아니지만, 공식 Open API 키만 사용하면 토스가 공식 지원하는 합법 경로로 동작합니다. WTS(웹 내부 API) 경로는 비공식이라 이용약관(TOS) 위반에 해당할 수 있습니다. 계좌 제한·손실 등 사용에 따른 책임은 본인에게 있습니다.
실수로 주문이 나갈 수 있나요?
없습니다. 거래는 기본으로 꺼져 있고 config.json 에서 직접 켜야 합니다. 실거래는 미리보기 후 2단계 확인(--execute + --confirm)을 거칩니다.
내 계정 정보와 키는 안전한가요?
tossctl 은 로컬에서 동작합니다. 세션과 자격증명은 본인 컴퓨터에 0600 권한으로 저장되고, 제3자 서버로 전송되지 않습니다.
AI 에이전트와 어떻게 연동하나요?
모든 명령이 JSON 으로 출력되고 /llms.txt 와 에이전트 가이드를 제공합니다. Claude Code·Codex·Cursor 같은 도구가 바로 호출할 수 있습니다.