명령 레퍼런스
주요 CLI 명령과 전체 기능 탐색 방법
주요 명령을 기능별로 정리합니다. 전체 CLI 옵션은 tossctl --help와 각 하위 명령의 --help, ops/MCP 카탈로그는 tossctl ops list·tossctl ops describe <id>가 기준입니다. 일반 조회는 --output table|json|csv를 지원하며 차트·스트림은 명령별 출력 형식을 확인하세요.
| 명령 | 설명 |
|---|
tossctl history sync [--from DATE --to DATE --market all] | 로컬 SQLite 수집 preview; 저장은 같은 인자에 --execute --confirm <token> |
tossctl history list | 수집본 ID·수집 시각·범위·완전성 |
tossctl history positions [--snapshot ID] | 저장된 보유 종목 조회 |
tossctl history transactions [--snapshot ID] [--query TEXT] | 저장된 거래내역 필터·검색·페이지 조회 |
tossctl history search <query> [--snapshot ID] | 거래내역 문자열 검색 |
tossctl history compare <before-id> <after-id> | 수량·평가액 변화 비교 |
수집 외에는 오프라인으로 동작합니다. 수집·조회 계약을 참고하세요.
| 명령 | 설명 |
|---|
tossctl auth login [--link] [--headless] [--qr-output <path>] | QR 또는 휴대폰에서 누르는 링크 + 폰 승인 로그인 |
tossctl auth status | 세션 유효성·만료 확인 |
tossctl auth extend [--timeout 120s] [--if-expiring 48h] | 폰 푸시 승인으로 세션 연장(~7일); 충분히 남았으면 선택적으로 건너뜀 |
| 명령 | 설명 |
|---|
tossctl account list | 계좌 목록 |
tossctl account buying-power | 공식 매수가능금액(공식 키 필요) |
tossctl account summary | 총자산·평가손익·시장별 |
tossctl portfolio positions | 보유 종목 (미국은 USD 병기) |
tossctl portfolio briefing [--news-limit N] | 보유 종목·연관 뉴스·예정 어닝콜·미체결 주문 집계 |
tossctl portfolio allocation | 자산 배분 |
tossctl portfolio folders [--account <key>] | 사용자 정의 폴더별 보유종목·수수료 반영 평가손익(계좌·폴더 내부 키 비노출) |
tossctl portfolio performance [--account <key>] | 최근 1개월 일별 원금·평가액·수익률·기간 고저(기본: 모든 증권 계좌 합산) |
tossctl portfolio snapshots [--account <key>] [--cursor <key>] [--limit N] | 커서 기반 날짜별 포트폴리오 평가 이력 |
tossctl portfolio snapshot <YYYY-MM-DD> [--account <key>] | 특정 날짜의 시장·보유종목별 전체 평가 상세 |
tossctl portfolio dividends [--year N] [--by-payment-date] | 연간 배당 내역(총액·지역·월별·세금) |
tossctl portfolio hidden list [--account <key>] | 증권 포트폴리오에서 숨긴 보유종목 조회(계좌 키 비노출) |
tossctl portfolio hidden hide|show <symbol> [--execute --confirm <token>] | 보유종목 숨김·복원 preview/confirm |
tossctl profit | 누적 실현손익 (매매손익·배당·대여·만기·예탁금이자, KRW/USD) |
tossctl tax overseas [--year N] | 해외주식 양도소득 (세율·공제·종목별 손익 — 세금 신고용) |
tossctl accumulate list | 주식모으기 전체 설정 — 📱 증권 모바일 화면에서 발견 후 WTS 호출 검증 |
tossctl accumulate status <symbol> | 특정 종목의 주식모으기 설정 (Active/Paused) |
| 명령 | 설명 |
|---|
tossctl quote get <symbol> | 시세(OHLC·52주·시총·거래대금·체결강도) |
tossctl quote flows <symbol> | 투자자별 순매수 흐름(WTS) |
tossctl quote metadata <symbol> | 공식 종목 메타데이터(공식 키 필요) |
tossctl quote batch <s1,s2,...> [--chart] [--live] | 멀티 시세 / 실시간 갱신 |
tossctl quote chart <symbol> --interval 1m|...|60m | ASCII 캔들 차트 |
tossctl quote orderbook <symbol> | 10단계 호가 |
tossctl quote trades <symbol> --count N | 체결 틱 |
tossctl quote limits <symbol> | 상/하한가 (국내) |
tossctl quote warnings <symbol> | 매수 유의사항 |
tossctl quote sellable <symbol> | 매도가능수량 |
tossctl quote commission <symbol> | 수수료율·거래세율 |
tossctl quote alert list <symbol> | 증권 목표가 알림 조회 |
tossctl quote alert add|remove <symbol> --price N --currency KRW|USD [--execute --confirm <token>] | 목표가 알림 변경 preview/confirm |
| 명령 | 설명 |
|---|
tossctl market index [<코드|이름>] | 주요 지수 목록 / 인자 주면 상세(OHLC·52주·시세원·장 시작/종료·운영 여부) |
tossctl market news [--limit N] | 시장 뉴스 |
tossctl market business-days <KR|US> · tossctl market stocks <MARKET> | 공식 영업일·종목 조회(공식 키 필요) |
tossctl market ranking --size N | 실시간 인기 종목 |
tossctl market investors | 투자자별(외국인·기관·개인) 순매수 상위 |
tossctl market sectors [<id>] | 업종별 등락(대분류/하위, 1일·1개월·1년) |
tossctl market sector <id> | 업종 현재 등락·연관 업종·구성 종목·ETF·뉴스 집계 |
tossctl market earnings [event-id] | 어닝콜 일정 / ID 지정 시 보고서·오디오·대본·발표자료 링크 (--major: 주요 기업) |
tossctl market earnings transcript <event-id> | 시간대별 원문·번역·요약 문단; 없는 번역·요약은 null |
tossctl market earnings report <event-id> | 분석·관전 포인트·출처 ID; 미제공 섹션은 null |
tossctl market briefing | 개인화 AI 뉴스 브리핑(보유·관심 종목, 수익률, AI 사유, 뉴스·관련 종목) |
tossctl market key-events | 현재 핵심 실적·경제지표(예상·발표·직전값) |
tossctl market signals | 토스 AI 시그널 |
tossctl market signal <symbol> [--type stocks|equity_etf|index] | 종목·ETF·지수의 AI 근거와 출처 뉴스 (지수 코드 예: KGG01P) |
tossctl market fx | 환율·달러 인덱스 |
tossctl market hours | 장 운영 시간 |
tossctl market screener [<preset-id>] [--filter '<json>'] [--nation kr|us] | 조건검색 |
market business-days KR은 KRX·NXT를 합친 세션 시간을 반환합니다. 애프터마켓이
있어도 NXT는 휴장일 수 있으며, NXT 단일가 종료 시각은 생략될 수 있습니다.
세션·응답 범위를 참고하세요.
earnings transcript는 본문이 없으면 available: false와 빈 문단 목록을 반환합니다. 보고서의 분석·관전 포인트는 각각 null일 수 있습니다. 번역·요약의 null만으로 미제공 사유를 추측하지 않습니다. JSON은 출처 ID·시간을 보존하며, 긴 MCP 응답은 잘릴 수 있으므로 fields 선택이나 CLI로 전체 본문을 조회하세요. market signal --type index에는 market index의 지수 코드를 사용합니다. 약관 상태가 제공되지 않으면 terms: null로 표시합니다.
| 명령 | 설명 |
|---|
tossctl community rankings --type influencer|profit|followers | 커뮤니티 랭킹 |
거래는 기본 비활성. 안전 모델 참고.
| 명령 | 설명 |
|---|
tossctl order preview --symbol <s> --side <buy|sell> --qty <n> --price <p> | dry-run 미리보기(주문 안 나감) |
tossctl order place ... --execute --confirm <token> | 실제 주문(2단계 게이트) |
tossctl order cancel --order-id <id> --symbol <s> [--execute --confirm <token>] | 기본 preview; 같은 명령의 token으로 주문 취소 |
tossctl order amend --order-id <id> ... [--execute --confirm <token>] | 기본 preview; 같은 명령의 token으로 주문 정정 |
tossctl orders list · orders completed · order show <id> | 미체결/체결/단건 조회 |
tossctl orders completed --all-dates --market all --size 50 --page 1 | 전체 기간의 최근 완료·취소 주문 조회 |
orders completed는 기본적으로 이번 달 내역을 조회합니다. --all-dates는 날짜 필터 없이
조회하며, --size(기본 50)·--page(기본 1)는 각각 1–100입니다. 한 번에 요청한 페이지만
출력합니다. 서버 커서가 필요해 N페이지 조회 시 앞선 페이지부터 최대 N번 읽습니다.
MCP는 completed_orders에 {"all_dates":true,"market":"all","size":50,"page":1}을
전달합니다. all_dates와 from·to는 함께 사용할 수 없습니다.
소수점 매수는 --fractional --type market --amount <krw>, 매도는 --fractional --type market --side sell --qty <수량>을 사용합니다. symbol·side 등 나머지 주문 입력과 미리보기·실행 게이트도 필요합니다. 소수점 매도는 라이브 미검증입니다.
조건주문은 order conditional list/get/place/cancel/modify로 조회·관리하며 공식 키가 필요합니다. CLI 일반 주문은 공식/WTS 중 한 경로, ops/MCP 실주문은 공식 전용입니다.
| 명령 | 설명 |
|---|
tossctl transactions list --market us|kr | 매매·입출금·배당·입출고 ledger |
tossctl transactions overview --market us|kr | 주문가능·출금가능·예정입금 |
tossctl export positions|orders --market us|kr|all | CSV 내보내기 |
| 명령 | 설명 |
|---|
tossctl account overview [--full] | 전체·미성년 계좌 자산(계좌번호 기본 마스킹) |
tossctl account trading-settings [--account <key>] | 증권 계좌별 간편주문과 사용자 공통 KRX/NXT·ATS 알림·옵션 실시간 시세 설정 조회(읽기 전용) |
tossctl account transfer-accounts [--account <key>] [--full] | 증권 주식이체용 내·최근 계좌 조회(번호 기본 마스킹, 이체 실행 없음) |
tossctl account access-status [--account <key>] | 최근 증권 접속 환경과 계좌별 신용거래 동결·사고계좌 상태(읽기 전용, 원래 계좌 키 미출력) |
tossctl accumulate funding-status [--full] | 증권 주식모으기 자금연결·자동주문 등록 상태(banking status는 deprecated alias; 일반 Banking/MyData 아님, 예금주·계좌번호 기본 마스킹, 내부 ID 항상 미출력) |
tossctl notifications list | WTS 알림 설정 조회(읽기 전용, 내부 사용자 ID 제외) |
tossctl notifications status | 통합 알림 설정·받은함 미확인·AI 분석 동의 상태 조회(읽기 전용) |
| 명령 | 설명 |
|---|
tossctl watchlist list [<group-id>] [--all] · watchlist groups | 관심종목 폴더별 조회 / 폴더 목록 |
tossctl watchlist news <folder-id> | 기존 폴더의 추천 뉴스; 서버가 제한한 첫 페이지 |
tossctl watchlist group create|rename|delete [--execute --confirm <token>] | 폴더 변경 preview/confirm; 삭제는 --acknowledge-irreversible 추가 필요 |
tossctl watchlist add|remove <symbol or name> --group <id> [--execute --confirm <token>] | 종목 추가/제거 preview/confirm |
공식 키를 연결하면 공식이 지원하는 조회·거래는 공식 OAuth 경로로 처리되고(자동 토큰 갱신), 나머지는 WTS 경로를 씁니다. WTS 기능은 웹 세션만으로 동작하지만 account buying-power, market business-days|stocks, quote metadata, 조건주문, stream은 공식 키가 필요합니다. 자세한 내용은 자동 라우팅 가이드.
| 명령 | 설명 |
|---|
tossctl init | 온보딩 위저드(웹 세션 로그인·공식 키 등록·거래 설정 단계별 안내) |
tossctl openapi login | 공식 API Key·Secret 등록(환경변수·플래그·대화형, 파일 0600) |
tossctl openapi status | 키·토큰·허용 IP·라우팅 진단 |
tossctl openapi test | 실제 호출로 연결 검증 |
tossctl openapi ip list | 현재 허용 IP 목록 조회(WTS 세션 필요) |
tossctl openapi ip replace-current | 현재 공인 IP로 교체 계획 preview; --execute --confirm <token>으로 적용 |
tossctl openapi logout | 자격증명 파일 삭제 |
tossctl <명령> --backend auto|wts|openapi | 요청별 라우팅 백엔드 지정(전역, 기본 auto) |
experimental.paper_trading 옵트인 사용자에게만 노출됩니다. 서버 이용 가능 여부와 알려진 제한을 먼저 확인하세요.
| 명령 | 설명 |
|---|
tossctl paper status | 모의 잔고·선행 상태 조회 |
tossctl paper init · paper deposit <amount> | 초기화·모의 자금 추가의 기본 preview |
tossctl paper order place <option-code> · paper order cancel <order-id> | 모의 주문·취소의 기본 preview |
tossctl paper orders pending · paper orders completed | 모의 주문 이력 |
tossctl paper orders cancel-all | 모의 미체결 일괄 취소 preview |
tossctl paper order live-preview <option-code> | 같은 의도를 실주문 미리보기로 변환; 제출하지 않음 |
모의 쓰기 실행은 현재 요청의 명시적 승인과 --execute가 필요합니다. 실거래 승인을 대신하지 않습니다.
| 명령 | 설명 |
|---|
tossctl stream --trade <symbol> | 공식 WebSocket 체결 구독(공식 키 필요; MCP에는 스트림 미노출) |
tossctl update --check | 읽기 전용 업데이트 확인 |
tossctl push listen | 실시간 푸시(주문/체결/보유 변경) 스트림(SSE) |
tossctl monitor api | 기본 82개 조회 probe, paper 옵트인 시 4개 추가; 성공 exit 0, 실패 exit 1 |
tossctl doctor [--report] | 환경·세션 진단 + 공식 키·토큰·IP 허용 점검(JSON, 홈 경로 마스킹) |
tossctl version | 버전·업데이트 가능 여부 |