tossinvest-cli
connect your AI agents to Toss Securities
공식 API의 계좌·시세·주문에 WTS 전용 수급·AI 시그널·배당·관심종목을 더하세요. tossctl 하나로 터미널과 AI 에이전트에서 사용합니다.
$ 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
계좌와 주문을 넘어, 토스증권 데이터를 자동화로
WTS는 토스증권 웹 트레이딩 시스템입니다. 공식 Open API에 없는 수급·AI 시그널·배당·관심종목을 웹 세션으로 연결하고, 공식 키가 필요한 기능은 공식 API로 사용합니다. 일반 토스뱅킹·카드 소비 내역은 아직 지원하지 않습니다.
투자자 수급, 시장 지수, AI 시그널, 조건검색, 배당과 관심종목을 조회·관리합니다.
공식 키를 등록하면 지원되는 조회는 기본적으로 공식 경로를 우선 사용합니다. 주문 경로는 명령별 정책을 따릅니다.
CLI는 JSON 출력으로, MCP 서버(tossctl mcp)는 툴로. 두 방식 모두 지원해 Claude·Codex·Cursor 등 어떤 AI 에이전트에든 바로 붙습니다.
실거래는 기본 비활성입니다. 설정 변경과 모의투자도 각자의 미리보기·승인 정책을 따릅니다.
공식 API와 WTS, 필요한 기능에 맞는 경로
공식 API는 키와 허용 IP로 연결합니다. WTS 기능은 휴대폰 승인을 거친 웹 세션이 필요합니다. 두 인증을 함께 연결하면 지원되는 공식·WTS 기능을 하나의 도구에서 사용할 수 있습니다.
일부 조회는 공식 API 오류 시 설정에 따라 WTS로 전환합니다. 주문은 한 경로로만 제출하며 다른 경로로 재시도하지 않습니다. WTS는 비공식 API이므로 예고 없이 변경될 수 있습니다.
기능 범위와 인증·실행 정책을 함께 확인하세요.
공식 API의 계좌·시세·주문에 WTS 전용 기능을 더합니다.
두 소스를 하나의 명령 체계로
기능별 지원 여부와 인증 요구사항은 지원 범위 문서에서 확인할 수 있습니다.
- 계좌·잔고
- 시세·호가·체결
- 주문·취소·정정
- 공식 API 계좌·시세·주문 (공식 키 필요)
- 수급·시장지수·지수 상세·업종 등락
- 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보다 많은 기능을 제공하나요?
공식 API에 없는 기능은 토스증권 WTS의 내부 API로 보완합니다. 검증된 조회·설정 기능만 구현하며, WTS 전체나 일반 토스 앱 전체를 지원한다는 뜻은 아닙니다.
토스뱅킹이나 카드 소비 내역도 되나요?
아직 지원하지 않습니다. 현재 대상은 토스증권이며, 일반 Banking·MyData는 별도의 모바일 인증과 연결 구현이 필요합니다. 증권 주식모으기의 자금연결 상태 조회와는 다릅니다.
공식 API가 넓어지면 tossctl 은 무의미해지나요?
공식 API 변경을 추적하고 지원 경로를 갱신합니다. WTS 전용 기능, CLI·MCP 인터페이스, 구조화된 출력과 실행 확인은 함께 유지합니다. 현재 지원 여부는 문서의 기능 비교표가 기준입니다.
합법인가요? 토스 공식인가요?
토스증권 공식 제품이 아닙니다. 공식 Open API와 비공식 WTS 경로를 함께 제공하며, WTS 사용은 이용약관 위반에 해당할 수 있고 예고 없이 중단될 수 있습니다. 사용 조건을 확인하고 본인의 책임으로 사용하세요.
실수로 주문이 나갈 수 있나요?
기본 설정에서는 실거래가 차단됩니다. 사용자가 기능을 켜도 주문별 미리보기와 --execute·--confirm이 필요합니다. 다만 잘못된 주문 승인이나 투자 손실까지 방지하는 보장은 아닙니다.
내 계정 정보와 키는 안전한가요?
자격증명은 로컬 소유자 전용 파일에 저장되며 인증·API 호출에 사용됩니다. AI 호스트에 반환한 계좌 데이터는 그 호스트의 처리 정책을 따르므로 공개 로그·프롬프트 공유에 주의하세요.
AI 에이전트와 어떻게 연동하나요?
일반 조회는 --output json으로 출력할 수 있고 /llms.txt 와 에이전트 가이드를 제공합니다. Claude Code·Codex·Cursor 같은 도구가 바로 호출할 수 있습니다.