tossctl×AI Agents

tossinvest-cli

connect your AI agents to Toss Securities

토스증권 계좌·시세·거래내역을 조회하고, 주문을 넣습니다. 토스 WTS 고유 기능까지tossctl 하나로 — 공식 Open API 100% 포함은 물론입니다.

5분 만에 시작GitHub
tossctl
tossctl
$ 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
Works with
Claude CodeCodex CLIGemini CLICursorGitHub CopilotOpenCodeQwen CodeDeepSeekMistralKimi CLIOpenClawHermes Agent
Trusted by builders from
TwelveLabs
Sendbird
Samsung
Kakao
Naver
Dunamu
TMAP
Daangn
400+ · 세계적 회사의 개발자들도 함께합니다
왜 지금

토스 앱에만 있던 기능, 지금 터미널에서

tossctl은 수급·AI 시그널·조건검색·배당 등 토스 WTS에만 있는 고유 기능 21개를 제공하고, 공식 Open API 지원 범위도 100% 포함해 총 40개를 하나의 명령 체계로 씁니다. 신청·승인 없이 지금 바로 시작할 수 있고, 공식 키를 연결하면 해당 기능은 자동으로 OAuth 경로로 라우팅돼 더 안정적입니다. 공식 Open API가 여는 범위는 토스 WTS 전체의 약 4%뿐이라, tossctl이 그만큼 더 넓은 영역을 커버합니다.

WTS 기능 21개

토스 WTS엔 있지만 공식 API엔 없는 수급·지수·AI 시그널·스크리너·배당 등 21개. 앱에서만 쓰던 기능을 터미널로.

공식 Open API 전부 100% 커버

공식 Open API가 여는 범위를 빠짐없이 100% 포함합니다. 공식 키를 연결하면 OAuth 경로로 더 안정적으로 동작합니다.

에이전트 연동

모든 명령이 JSON으로 출력되어 AI 에이전트와 바로 연동됩니다.

공식 Open API는 약 4%

공식 Open API는 토스 WTS 기능 ~440개 중 약 4%만 엽니다. tossctl은 그 너머까지 다룹니다.

공식 Open API와 WTS 자동 라우팅으로, 안전하고 빠르게

공식 키를 연결하면 tossctl이 지원하는 기능 중 공식 Open API가 지원하는 19개는 자동으로 공식 API(OAuth) 경로로 라우팅됩니다. 토큰이 자동 갱신되고 토스가 공식으로 지원하는 경로라 더 안전하고 안정적으로 동작합니다.

동시에 공식 API에는 없는 토스 WTS 고유 기능 21개까지 그대로 제공합니다. 새 기능은 대부분 앱(WTS)에 먼저 나오는데, tossctl은 공식 출시를 기다리지 않고 이 범위를 바로 씁니다. 신청이나 승인 없이 지금 시작할 수 있습니다.

더 빠른 범위와 더 안정적인 경로, 둘 다 취합니다.

공식 OPEN API 의 상위집합

공식 Open API 지원 전부(100% 커버) + 고유 21개 = 총 40개

19공식 Open API
40tossctl
21토스 WTS 고유 기능

두 소스를 하나의 명령 체계로

tossctl은 공식 Open API 지원 범위(19개)를 100% 포함하고, 공식엔 없는 토스 WTS 고유 기능 21개를 더해 총 40개를 제공합니다. (참고: 토스 WTS 전체는 ~440개, 의미있는 범위를 계속 넓혀가는 중입니다.)

21
공식 API엔 없는 토스 WTS 고유 기능
40
공식 Open API 지원 전부 + 고유 21 = tossctl 총 기능 수
약 4%
(참고) 공식 Open API가 여는 토스 WTS 기능 비중
공식 Open API
REST 조회·주문 기본 · 사전 신청 단계 롤아웃
  • 계좌·잔고
  • 시세·호가·체결
  • 주문·취소·정정
tossctl
공식 Open API 전부 100% 커버 + 고유 21 = 총 40개
  • 공식 Open API 지원 기능 전부 (공식 키 연결 시 OAuth 경로로 더 안정적)
  • 수급·시장지수·지수 상세·업종 등락
  • AI 시그널·뉴스 브리핑·조건검색
  • 배당·커뮤니티 랭킹·관심종목·실시간 푸시·dry-run preview
왜 tossctl 인가
DATA

넓은 조회

계좌·시세·호가·체결·수급·지수·업종·배당·거래내역을 명령 한 줄로 조회합니다.

SAFETY

안전한 거래

거래는 기본으로 꺼져 있고, 주문 전 미리보기와 두 번의 확인을 거칩니다. 실수로 주문이 나가지 않습니다.

AGENTS

에이전트 친화

모든 결과를 AI가 그대로 읽는 형식으로 내보내 에이전트와 바로 연동됩니다.

INTELLIGENCE

토스 AI 기능

공식 API에는 없는 AI 시그널·뉴스 브리핑·조건검색·커뮤니티 랭킹을 제공합니다.

REALTIME

실시간 푸시

주문·체결·보유 변동을 실시간으로 받아봅니다.

AUTOMATION

자동화 우선

표·파일·실시간 등 원하는 형식으로 내보내 스크립트와 자동화에 바로 연결합니다.

LLM이 바로 읽는 문서

모든 페이지에 Copy Markdown · ChatGPT/Claude/Cursor로 열기 + /llms.txt 제공.

AI 에이전트 가이드 →

자주 묻는 질문

여기에 없는 내용은 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 같은 도구가 바로 호출할 수 있습니다.

JungHoonGhae/tossinvest-cliGo/MIT/BETA

비공식 CLI · 토스증권과 무관 · 투자 손익의 책임은 본인에게 있습니다