시세 조회부터 주문까지, 마우스 없이 한 줄로.
토스증권 Open API 를 감싼 비공식 오픈소스 CLI.
버튼을 누르면 설치 명령이 복사됩니다 · 공식 Open API 만 사용 · Python ≥ 3.11 · MIT
앱 내부(비공개) API 역공학 없이 공식 발급 경로만 — 약관 위반·계정 제재 사유가 없습니다.
▶ --sim자격증명·실계좌 없이 시뮬레이션 모드로 전 기능을 모의로. 진입장벽 없이 바로 시작.
🛡 안전장치dry-run 미리보기 · 확인 프롬프트 · 액션별 차단 게이트 · 1억+ 가드 · 멱등키 자동.
{ } JSON·CSV--json · --csv 출력과 AGENTS.md 규약으로 Claude Code 등 어떤 에이전트든 도구로 연결.
종목코드만 치면 시세. 수량을 붙이면 주문.
트레이딩 터미널의 문법을 그대로 가져왔습니다.
toss 한 번으로 진입합니다. 토큰과 연결을 세션 내내 재사용하고, 명령 히스토리와 자동완성을 지원합니다.
005930 100 은 100주 매수. 음수는 매도, 세 번째 인자는 지정가. 보유 종목은 p 한 글자면 충분합니다.
자격증명 없이 --sim 으로 전 기능 체험. 모의 시세를 움직여 손익까지 확인합니다.
공식 OpenAPI 스펙 기준 전 엔드포인트 래핑. 주문 규칙은 전송 전에 검증합니다.
c 005930 캔들 차트(이동평균·RSI·볼린저·이격도), w 005930 종목 대시보드, f 005930 펀더멘털(PER·PBR·EPS, 네이버), wl 관심종목 시세판.
--json 으로 원본 응답 그대로. jq 파이프라인에 바로 연결하세요.
자주 쓰는 것일수록 짧게. 전부 REPL 안에서 동작합니다.
모든 명령은 단발 실행과 REPL 안에서 동일하게 동작합니다.
각 명령 뒤에 --help 를 붙이면 전체 옵션이 나옵니다.
price현재가 — 여러 종목, --watch 폴링overview종목 대시보드 — 시세·보유·차트·호가 (REPL: w)watchlist관심종목 시세판 — 등락순·실시간 (REPL: wl)orderbook호가창trades최근 체결 내역candles캔들 데이터 (1m | 1d)chart터미널 캔들 차트 — MA · RSI · 볼린저 · 이격도limits상한가 · 하한가buy매수 — 지정가 · 시장가 · 금액 기반(US)sell매도list주문 목록 — --all 전체 페이지get주문 단건 조회modify정정cancel취소commissions매매 수수료list계좌 목록 (accountSeq 확인)holdings보유 주식 — 손익 · 수익률buying-power매수 가능 금액 (KRW | USD)sellable매도 가능 수량info기본 정보 — 시장 · ISIN · 상장일warnings매수 유의사항fundamentalsPER · PBR · EPS 등 (네이버 · REPL: f)fx환율calendar거래 캘린더 (KR | US)status설정 확인 — 시크릿 마스킹login토큰 강제 발급logout토큰 캐시 삭제repl대화형 셸 시작 (인자 없이 실행해도 동일)-a, --account계좌 지정--json원본 JSON 출력--csvCSV 출력 (파이프 · 엑셀 · 에이전트)--sim시뮬레이션 모드--dry-run주문 전송 없이 미리보기 (buy · sell):history명령 기록 목록 — !42 · !! · !o b 재실행, Ctrl-R 검색:account세션 계좌 변경 (:account 1):jsonJSON 출력 토글:tick모의 시세 이동 — sim 전용:reset시뮬레이션 상태 초기화 — sim 전용clear · cl화면 지우기 (cls · :clear 동일)? · /help명령 · 숏컷 목록/quit · q종료 (exit · Ctrl-D · Ctrl-C 두 번)공식 Open API 만 사용해 약관·계정 리스크가 없고,
진짜 계좌에 주문이 나가기에 빠름보다 확실함이 먼저입니다.
주문 요청 본문을 만들어 보여주기만 하고 전송하지 않습니다. 가격·수량·규칙 검증을 미리 통과시켜 보세요.
buy · sell · modify · cancel 은 기본적으로 확인을 거칩니다. 1억원 이상 주문은 별도 플래그까지 요구합니다.
시뮬레이션 상태는 로컬 파일에만 존재합니다. 실 계좌·실 API 와 완전히 분리된 채로 전체 흐름을 연습하세요.
지정가 가격 필수, 금액 주문은 미국 주식 전용 같은 규칙을 서버에 가기 전에 잡아냅니다.
한 번 auth keychain set 하면 client_id · client_secret 이
macOS Keychain 에 암호화 보관됩니다. .env 평문 파일 없이 어느 디렉터리에서든 동작하고,
auth status 출력에서도 키 원문은 마스킹됩니다 — 화면·로그에 드러나지 않습니다.
토큰은 소유자 전용 권한(600)으로 캐시 · 우선순위 env › .env › Keychain › toml
태그 한 번이면 PyPI 까지 자동으로 갑니다.
stock fundamentals(REPL f) — PER·추정PER·PBR·EPS·BPS·배당·시총·52주 고저, 국내·해외 모두w 대시보드에도 한 줄clear · cl · cls — 콜론 없이 화면 지우기toss --version 이 설치 패키지 버전을 그대로 읽도록 수정 (하드코딩 제거)o list·acc h·au k status 처럼 고유 접두어로 호출 — 모호하면 후보 안내toss --install-completion 또는 정적 스크립트ApiClient 프로토콜 통일, mypy 타입 체크 CI 도입p --sort daily — 일간 등락·수익률·평가금액 순 정렬:history·숏컷(w·c·wl) 노출auth keychain set — client_id·secret 을 Keychain 에 암호화 보관, .env 평문 없이 동작a hist 보유액 추이 차트 — 과거 종가로 근사 재구성 + 일일 평가액 스냅샷:history 명령 기록 메뉴 + !42 · !! · !o b 재실행--csv 전역 출력 — 파이프 · 엑셀 · AI 에이전트용 (중첩 응답 평탄화)TOSS_NO_BUY/SELL/MODIFY/CANCELtoss ledger showAGENTS.md · 영문 READMEwl 관심종목 시세판 — 전일 대비 등락순 정렬, -w 실시간 갱신/quit · q, 실행 중 Ctrl-C 는 명령만 중단c 005930 -P 1d 오늘(분봉) 차트 프리셋--watchw 005930 종목 원샷 대시보드, 보유종목 일간 손익TOSS_NO_SELL키 없이 먼저 체험하고, 준비되면 자격증명만 연결하면 됩니다.
Python ≥ 3.11. 설치하면 toss 명령이 등록됩니다.
시뮬레이션 모드 — 자격증명·실계좌 없이 모든 명령을 모의로.
개발자 콘솔에서 client_id · client_secret 을 발급받아 연결합니다.
우선순위: 환경변수 › .env › Keychain › ~/.toss-cli/config.toml · 확인은 toss auth status
uv tool install tossinvest-cli