소개
토스증권을 AI 에이전트·터미널에서 다루는 비공식 CLI (tossctl)
토스증권을 AI 에이전트·터미널에서 다루는 비공식 CLI. 실행 바이너리는 tossctl.
토스증권 웹 세션을 재사용해 계좌·시세·거래내역 조회와 제한된 거래를 터미널에서 수행합니다.
Claude Code · Codex · Cursor · OpenClaw · bash · HTTP — 어떤 도구·에이전트든 동일한 명령
체계(tossctl)로 다룰 수 있고, 사람이 직접 터미널에서 쓸 수도 있습니다.
비공식 프로젝트
토스증권 공식 제품이 아닙니다. 웹 내부 API를 비공식적으로 사용하며, 이용약관(TOS) 위반에 해당할 수 있습니다. API는 예고 없이 변경될 수 있고, 사용으로 인한 계좌 제한·손실·기타 불이익에 대해 개발자는 책임지지 않습니다. 본인의 판단과 책임 하에 사용하세요.
거래는 기본 비활성
설치 직후 모든 거래 기능이 꺼져 있습니다. config.json에서 기능별로 직접 허용해야만
실행되며, 실거래는 --execute + --confirm <token> 2단계를 거칩니다.
자세한 내용은 안전 모델 참고.
핵심 요약
- 공식 Open API(예정)의 조회·거래 범위를 100% 커버하고, 그 너머까지 다룹니다.
- 공식에 없는 기능: 수급·시장지수·지수 상세 시세·토스 AI 시그널·뉴스 브리핑·조건검색· 배당 내역·업종별 등락·커뮤니티 랭킹·관심종목 관리·거래내역 ledger·실시간 푸시·소수점 주문 등.
- 출력 형식: 표(table) · JSON · CSV · SSE — 자동화/에이전트 파이프라인에 바로 연결.
전체 비교는 지원 범위를 참고하세요.
30초 시작
# 설치 (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/install.sh | sh
# 환경 점검 → 로그인 → 첫 조회
tossctl doctor
tossctl auth login
tossctl account summary --output json