변경 이력 | tossinvest-cli

버전별 변경 사항입니다. 각 릴리즈의 바이너리·릴리즈 노트는 GitHub Releases에서도 볼 수 있습니다.

[Unreleased]

[0.53.0] - 2026-09-28

새 기능

어닝콜 원문·번역·요약 조회 — market earnings transcript <event-id>로 문단별 시각과 원문, 제공되는 번역·요약을 조회합니다. market earnings report <event-id>는 실적 분석·관전 포인트·출처를 표시하며, 아직 제공되지 않는 항목은 null로 구분합니다.
지수 AI 분석 — market signal <index-code> --type index로 지수 분석을 조회합니다. 기존 주식·ETF 조회도 계속 지원합니다.
관심종목 폴더 뉴스 — watchlist news <folder-id>로 해당 폴더의 추천 뉴스와 관련 종목을 조회합니다. 존재하지 않는 폴더는 오류로 처리하며, 서버가 제공하는 한 페이지를 반환합니다.
새 조회 기능을 CLI의 표·JSON·CSV와 MCP에 연결했습니다. 안정 오퍼레이션은 120개입니다.

버그 수정

WTS 배포 파일이 gzip으로 제공될 때 API 변경 탐색에 실패하던 문제를 수정했습니다. 압축 전후 크기 제한과 동일 출처 검증을 유지합니다.
검색·섹터 조회의 확인된 호스트 별칭을 반영하고, 기존 시세 API가 공개 번들에서 사라져도 실제 사용 계약을 카탈로그에 보존합니다.
AI 분석에서 누락된 응답을 정상적인 빈 결과로 오인하지 않도록 하고, 없는 약관 정보는 null로 보존합니다.

검증·문서

기본 API 감시를 91개로 확대했습니다. 로그인 후 기본 91개와 기존 옵트인 모의투자 4개를 합친 95개 조회가 모두 통과했습니다.
최신 WTS 빌드의 1,307개 경로와 신규 조회 계약을 기록하고 한·영 명령어 문서를 갱신했습니다.
공식 캔들 시각 설명을 분봉 종료 시각·일봉 현지 거래일 기준으로 명확히 했습니다.

[0.52.1] - 2026-09-15

변경

국내 애프터마켓 안내 보완 — CLI 도움말·MCP 설명에 KRX·NXT를 합친 시간대임을 명시했습니다. KRX만 개장해도 애프터마켓은 표시될 수 있으며, NXT 휴장 시 단일가 종료 시각은 생략됩니다.
공식 주문 조회의 미지원 유형 예시를 최신 계약에 맞췄습니다. 설명 변경으로 새로운 주문 유형을 지원하는 것은 아니며, 장전·장후 시간외종가 등 미지원 주문은 여전히 조회에서 제외됩니다.

검증·문서

거래소별 애프터마켓 휴장과 서버 세션 시각 보존을 계약 테스트로 확인했습니다. 공매도 소수 비율과 null·0 구분도 검증하고, 한·영 가이드에 응답 범위를 정리했습니다.

[0.52.0] - 2026-09-14

새 기능

전체 기간 완료 주문 조회 — orders completed --all-dates로 이번 달 이전의 완료·취소 주문도 조회합니다. 국내·미국 시장 필터와 --size·--page를 지원하며, 다음 페이지에 필요한 서버 커서는 자동으로 이어 받습니다. MCP completed_orders의 all_dates에서도 같은 조회를 사용할 수 있습니다. 기본 조회는 기존처럼 이번 달입니다.

변경

전체 기간 완료 주문 API를 회귀 감시에 추가해 기본 조회 probe를 86개로 확대했습니다. API 응답에서 확인한 각 주문의 시장 정보를 보존합니다.
MCP 완료 주문 조회는 날짜 범위를 생략해도 size·page 설정을 적용합니다.

버그 수정

미체결·완료 주문 조회에서 서버 응답의 주문 목록이 누락되거나 null이면 오류로 알립니다. 응답 구조 변경을 "주문 없음"으로 오인하거나, 잘못된 빈 목록을 바탕으로 주문을 찾지 못했다고 판단하던 문제를 수정했습니다. 정상적인 빈 배열은 계속 빈 내역으로 처리합니다.
WTS 변경 감시가 새 버전의 주문 API를 자동으로 "구현됨"으로 분류하던 오류를 수정했습니다. 실제 사용 중인 조회 계약을 카탈로그에 보존하고 미구현 경로는 후보로 구분합니다.

문서

공식 API에 없는 30+ 기능과 설치·사용 흐름을 한·영 README에서 시각화했습니다. 한국어는 Pretendard를 사용하며, 다이어그램의 문구·원본·재생성 도구를 함께 제공합니다.
WTS 주문 API의 기존·신규 계약과 라이브 검증 범위를 기록했습니다. 기존 조회는 유지하고, 검증된 완료 v3를 전체 기간 조회에 사용합니다.

[0.51.0] - 2026-09-11

새 기능

로컬 이력 저장·검색·비교 — history sync로 보유 종목과 기간별 거래내역을 SQLite에 저장하고, history list·positions·transactions·search·compare로 로그인 없이 조회할 수 있습니다. 저장은 기본 preview 후 확인 토큰으로 실행하며, 수집 시각·범위·부분 실패를 결과에 남깁니다.
보유 종목 브리핑 — portfolio briefing이 현재 보유 종목에 연결된 뉴스·예정 어닝콜·미체결 주문을 함께 조회합니다. 일부 조회가 실패하면 해당 항목의 상태와 partial을 표시합니다.
필요한 JSON 필드만 출력 — --fields로 중첩 필드를 선택하고 --compact로 들여쓰기를 제거할 수 있습니다. MCP의 call_operation.fields도 결과 크기 제한 전에 같은 필드 선택을 적용합니다.

변경

MCP는 자격증명 없이도 시작해 로컬 이력을 조회할 수 있습니다. 안정 오퍼레이션은 117개이며, 웹 조회와 이력 수집에는 WTS 세션이 필요합니다.
보유 뉴스와 국내·미국 거래내역 계약을 공용 probe로 추가해 안정 API 감시를 85개로 확대했습니다. 한·영 문서에 로컬 이력·브리핑 가이드를 추가했습니다.

[0.50.3] - 2026-09-09

버그 수정

공식 API 차트를 과거→최신 순서로 맞춰 최신 종가와 시간축이 뒤집히던 문제를 수정했습니다. 표·JSON·CSV에 같은 순서를 적용합니다.
stream에서 0101N0 같은 국내 영숫자 종목코드가 미국 구독으로 분류되던 문제를 수정했습니다.

변경

공식 주문 조회에서 제외되는 시간외 주문 범위와 지수 캔들의 최신순·페이지 커서를 CLI·MCP·문서에 명시했습니다. 토큰 폐기 응답의 재발급·1회 재시도도 회귀 테스트로 검증합니다.
문서 사이트의 TypeScript·아이콘 호환성과 자동 PR·의존성 갱신 흐름을 정리했습니다.

[0.50.2] - 2026-09-07

버그 수정

monitor api가 관심종목 폴더 조회 실패를 “폴더 없음”으로 건너뛰던 문제를 수정했습니다. 불완전한 응답은 실패로 처리하고, 실행 취소 시 대기 중인 요청을 중단합니다.
WTS 주문 결과 확인을 신규·정정·취소가 함께 사용하도록 정리했습니다. 취소 내역 없이 미체결에서 사라진 주문은 unknown으로 표시하며, 국내 주문 정정 결과의 시장 정보가 미국으로 바뀌던 오류를 수정했습니다.
주문 내역의 매수·매도 방향을 확인하고, 일치 후보가 여러 개면 임의의 주문을 성공 결과로 연결하지 않도록 보완했습니다.

변경

README의 WTS 확장 기능 비교·기여자·스타 히스토리를 정리하고, 자동 PR 검사와 의존성을 갱신했습니다.

[0.50.1] - 2026-09-03

버그 수정

MCP 대형 결과를 줄이는 배열 할당에서 입력 길이에 산술을 적용하지 않도록 바꿔 정수 overflow 가능성을 제거했습니다.
문서 개발 도구의 취약한 transitive 의존성을 안전한 패치 버전으로 고정하고, CI 의존성 감사를 개발 의존성까지 확대했습니다.

[0.50.0] - 2026-09-03

새 기능

실험적 미국 옵션 모의투자 — 옵트인하면 CLI·ops/MCP에서 가상 잔고·교육 상태·주문을 조회하고, 가상 입금과 옵션 주문·취소를 실행할 수 있습니다. 모의 쓰기는 별도 simulation_execute 승인을 사용하며 실계좌로 전송되지 않습니다. 같은 주문 의도를 실주문 preview로 옮기는 기능도 실제 주문은 실행하지 않습니다. 현재 /paper/init이 일부 계정에서 500을 반환하므로 기본 화면에서는 숨긴 실험 기능으로 제공합니다.
증권 자산·계좌 조회 확대 — 포트폴리오 폴더와 기간별 성과·스냅샷, 접속·계좌 제한 상태, 거래 설정, 주식이체 대상 계좌, 주식모으기 자금연결 상태를 조회할 수 있습니다. 계좌번호와 내부 키는 기본적으로 마스킹하거나 출력하지 않습니다.
시장·리서치 조회 확대 — 지수 장 운영 정보, 어닝콜 자료, 한국·미국·개인화 브리핑, 종목 AI 시그널, 업종 상세, 주식대여 수익 랭킹을 CLI와 ops/MCP에서 조회할 수 있습니다.
설정 변경의 공통 안전 흐름 — 관심종목 폴더·종목, 목표가 알림, 포트폴리오 숨김 설정은 기본 preview 후 confirm token으로 실행하며, 적용 뒤 서버 상태를 다시 확인합니다.

버그 수정

모의 일괄취소의 예약주문 필드 오류를 고쳤습니다. 빈 2xx·불완전한 prepare/영수증을 성공으로 오인하지 않으며, 가상 입금은 전후 잔고 증가를, 취소는 실제 미체결 상태를 재검증합니다.
MCP 대형 결과 축소 과정의 정수 overflow와 상류 _omitted_items 충돌을 막고, 병렬 CLI 인스턴스의 monitor quiet flag 경합을 제거했습니다.
간헐적으로 400을 반환하던 거래목적 MyData 후보를 호출·감시 대상에서 제외해 자금연결 조회와 회귀 감시의 오탐을 줄였습니다.

변경

operation catalog는 기능 영역(domain), 접근 경로(backend), 실행 환경(live/paper)과 쓰기 승인·가역성 정책을 분리해 공개합니다. 안정 기능 111개와 옵트인 모의투자 기능 8개를 구분합니다.
API 감시는 안정 계약 82개에 옵트인 모의투자 계약 4개를 더해 실행할 수 있으며, WTS build 변동과 Android APK 후보도 추적합니다. 불완전한 수집은 기존 카탈로그를 덮어쓰지 않습니다.
GitHub Actions·CodeQL·Dependabot·의존성 감사를 강화하고 외부 Action을 commit SHA로 고정했습니다. 문서 사이트는 필요한 흐름만 Mermaid로 표시하며 Next.js 16의 proxy.ts 규약을 사용합니다.
릴리즈 노트는 이 요약을 먼저 제공하고, GitHub가 병합 PR·신규 기여자·전체 비교 링크를 자동으로 덧붙이도록 바꿨습니다.

기여자

관심종목 그룹 계약을 상세히 제보하고 직접 수정해 주신 @anthonyminyungi 님께 감사드립니다. 이번 릴리즈의 관심종목 안전 쓰기 개선은 해당 기여를 바탕으로 확장했습니다(#176, #177).

[0.49.0] - 2026-09-03

새 기능

account overview [--full] — Android 앱 5.275.0의 정적 인터페이스와 마스킹된 라이브 응답으로 계약을 교차 검증해, 일반·미성년 계좌별 자산과 미체결 주문 수를 한 번에 조회합니다. 계좌번호는 table·JSON·CSV 모두 기본적으로 가립니다.
market key-events — 토스가 선별한 현재 핵심 기업 실적과 경제지표 발표를 한 번에 조회합니다. 실적 예상·발표·서프라이즈와 경제지표 실제·예상·직전값을 JSON·CSV에서도 보존합니다.
banking status [--full] — 주식모으기 출금에 연결된 오픈뱅킹 계좌와 연결·등록 가능 계좌 수를 조회합니다. 예금주명과 계좌번호는 CLI·MCP 모두 기본 마스킹하며 명시적인 --full/full=true에서만 보여줍니다.
notifications list — 현재 WTS 알림 종류와 활성화 여부를 읽기 전용으로 조회합니다. 내부 사용자 ID는 노출하지 않으며, 아직 완전히 검증하지 못한 알림 변경 API는 구현하지 않았습니다.
openapi ip list·openapi ip replace-current — 이사·회선 변경으로 공인 IP가 달라졌을 때 WTS 설정을 직접 열지 않고 공식 Open API 허용 IP를 교체합니다. 교체는 기본 preview이며 --execute --confirm <token>이 있어야 적용됩니다. 각 변경 뒤 서버 상태를 다시 검증하고, 응답 유실을 포함한 실패 시 실제 허용 목록을 재조회해 기존 상태를 복구합니다. MCP에도 openapi_ip_list·openapi_ip_replace_current로 같은 안전 경계를 노출합니다.

변경

auth login --link — QR을 카메라로 스캔하지 않고, 출력된 일회성 URL을 휴대폰에서 눌러 Toss 앱을 여는 로그인 흐름을 명시적으로 제공합니다. 기존 --headless 자동화는 그대로 호환됩니다.
market briefing을 개인화 v2 계약으로 확장했습니다. 보유·관심 종목, 수익률, 시그널 방향, AI 사유 제목, 원문 뉴스와 관련 종목을 함께 반환합니다. 상세 필드는 table·JSON·ops/MCP에서 제공하며, 기존 CSV 자동화가 깨지지 않도록 CSV는 category,title,agency,created_at 4열 계약을 유지합니다.
개인정보 마스킹을 공용 모듈로 통합했습니다. account overview와 banking status의 CLI table·JSON·CSV 및 ops/MCP 기본 출력이 같은 규칙을 사용합니다.
API 회귀 감시를 46개로 확대했습니다. 이번에 추가한 주요 일정·오픈뱅킹 연결 상태·알림 설정과 개인화 v2 브리핑의 스키마를 함께 감시합니다.
역공학 근거를 verified·partial·inferred·unknown으로 구분합니다. APK 문자열이나 경로 후보만으로 기능을 만들지 않고, 구현에는 전체 요청/응답 계약과 읽기 전용 라이브 스키마 검증을 요구합니다. 은행·소비 MyData와 쓰기 API는 현재 WTS 인증 범위 밖으로 분리했습니다.

[0.48.0] - 2026-09-02

새 기능

조건주문을 ops/MCP에서도 조회·실행할 수 있습니다. conditional_orders·conditional_order로 목록·상세를 조회하고, place_conditional_order·cancel_conditional_order·modify_conditional_order로 preview 후 실행합니다. 쓰기는 공식 Open API 전용이며 기본 호출은 dry-run입니다(#111).
quote metadata <symbol>[,symbol,...] [...] — 공식 Open API에서 최대 200개 종목의 이름·영문명·ISIN·시장·증권 유형·상장 상태·통화·상장주식수·상장/상장폐지일과 국내 KRX/NXT 거래 상태를 한 번에 조회합니다. market stocks가 시장 전체의 종목 유니버스를 찾는 명령이라면, 이 명령은 이미 아는 심볼의 정확한 참조 데이터를 채우는 용도입니다. JSON·CSV는 공식 응답의 전체 메타데이터를 보존합니다.

변경

일반 주문과 조건주문의 안전 정책을 trading.Service 하나로 통합했습니다. CLI와 ops/MCP가 같은 config 옵트인, execute, confirm-token 검사를 거치므로 새 호출 표면에서도 게이트가 달라지지 않습니다. 조건주문 confirm token은 idempotency key까지 묶고, OCO/OTO ops 입력은 두 번째 trigger 누락도 공식 API 호출 전에 거절합니다.
WTS 고정 정책을 hybrid 라우터 내부의 단일 불변식으로 강화했습니다. --backend wts에서는 ops가 쓰는 직접 공식 클라이언트, official-only 시장 조회·조건주문, WTS 실패 시 환율 폴백까지 모두 공식 경로를 비활성화합니다. 공식 전용 기능은 일관되게 Open API 접근 필요 오류를 반환합니다.
백엔드 선택 값을 공용 타입으로 통합했습니다. 설정·CLI·MCP·hybrid 라우터가 auto·openapi·wts의 같은 계약을 사용하고, 잘못된 값은 라우터 조립 전에 거부합니다. JSON Schema는 빠져 있던 openapi와 하위 호환 별칭 official을 모두 검증합니다.

기여자용

changelog 전체의 기여·제보·감사 항목에서 GitHub 사용자명이 실제 mention으로 쓰였는지 검사하고, 웹 changelog 사본이 원본과 달라지면 CI가 실패합니다.

[0.47.1] - 2026-09-01

버그 수정

watchlist add --group <id>가 지정한 폴더를 무시하고 기본 폴더를 만들던 문제를 수정했습니다. add 요청은 watchlistIds 배열을, remove 요청은 watchlistId 단일 값을 사용하도록 엔드포인트별 계약을 분리했습니다.

기여자

실제 API 계약을 제보하고 수정안을 제공해 주신 @anthonyminyungi 님께 감사드립니다(#177).

[0.47.0] - 2026-09-01

변경

call_operation·tossctl ops call 인자 계약을 엄격하게 검사합니다. 선언되지 않은 인자, 명시적 null·빈 --params, 잘못된 primitive 타입, 소수로 전달된 정수, float64 변환에서 정밀도를 잃는 큰 정수는 backend 호출 전에 오류가 납니다. superset/stale 파라미터 객체를 보내던 자동화는 describe_operation 의 현재 스키마에 맞춰야 합니다.
quote charts·quote reasons 의 누락 계약을 모든 기계 출력에 보존합니다. 결과는 요청 순서로 정렬되고, 서버가 생략한 종목은 JSON missing 배열과 CSV 의 빈 행으로 표시됩니다. 캔들이 0개인 정상 응답도 CSV 에서 사라지지 않습니다.

버그 수정

공식 키가 없거나 WTS 로 고정된 상태에서 account buying-power·market business-days 를 실행하면 panic 대신 Open API 로그인 안내를 반환합니다.
MCP 가 openapi.enabled=false 또는 --backend wts 설정을 무시하고 저장된 공식 키와 주문 서비스를 활성화하던 문제를 수정했습니다.
MCP 대형 응답을 30KB 이하로 줄이는 과정에서 2^53 보다 큰 정수가 반올림되던 문제를 수정했습니다.
지급 내역이 없는 account interest 결과가 CLI 와 operation 에서 같은 사용 가능 연도 정보를 돌려줍니다. 연도 조회는 성공 결과를 캐시하고 동시 요청을 공유하되, 마지막 대기자가 취소되면 실제 HTTP 요청도 취소하며, 보강 실패가 본 보고서를 막지 않습니다.
짧거나 비정상 형태의 계좌번호와 한 글자 예금주명도 account detail 기본 출력에서 노출되지 않도록 마스킹합니다.
관심종목 대화형 폴더 선택이 Cobra 에 주입된 입력·출력 스트림을 사용하도록 바꿔 임베디드 실행과 PTY 테스트에서 프로세스 전역 터미널에 잘못 연결되지 않게 했습니다.

기여자용

WTS endpoint 인벤토리가 Go AST 의 문자열 상수·fmt.Sprintf 조립 경로와 런타임 monitor probe 를 함께 읽고 host·method·소유권 불일치를 테스트에서 fail-closed로 감지합니다.

[0.46.0] - 2026-08-29

새 기능

account buying-power — 공식 API 의 현금 매수여력을 통화별로 봅니다(--currency KRW|USD). account summary 의 주문가능금액과는 다른 개념이라 별도 커맨드로 뒀습니다 — 한 표에 섞으면 서로를 다른 쪽으로 읽기 쉽습니다. 공식 키만 있고 웹 세션이 없는 분에게는 매수여력을 볼 유일한 경로입니다(계좌요약은 웹 세션 전용).

버그 수정

market fx 가 공식 키만으로는 동작하지 않던 문제. 이 커맨드는 "공식·웹 세션 둘 다 지원" 으로 표기돼 있었지만 실제로는 웹 세션 전용이었습니다. 이제 웹 세션이 없으면 공식 API 의 USD/KRW 로 답합니다.

웹 세션이 있으면 종전대로 전체 피드(USD/KRW·달러인덱스 등)를 그대로 보여줍니다 — 공식 API 는 통화쌍을 하나씩만 주기 때문에, 두 자격증명을 모두 가진 분이 받던 행이 줄어들지 않도록 웹 세션을 먼저 씁니다. 공식으로 대체된 경우에는 그 사실을 함께 알립니다.

[0.45.0] - 2026-08-29

새 기능

market business-days <KR|US> — 전 영업일·오늘·다음 영업일의 세션 시각을 봅니다. 공식 키만 있고 웹 세션이 없는 사용자가 세션 시각을 얻을 수 있는 유일한 경로입니다(기존 market hours 는 웹 세션 전용).
```
$ tossctl market business-days KR
구분        날짜        세션    시작   종료   단일가
─────────────────────────────────────────────────────
전 영업일   2026-03-24  정규장  09:00  15:30  15:20–
오늘        2026-03-25  장전    08:00  09:00  08:50–
                        정규장  09:00  15:30  15:20–
                        장후    15:30  20:00  –15:40
다음 영업일 2026-05-05  휴장
```
국내는 단일가 시각까지, 미국은 데이마켓까지 포함합니다. 두 시장의 응답 형태가 서로 다른데(국내는 세션이 중첩, 미국은 평탄) 한 표에 담기도록 정규화했습니다. 휴장 표현도 시장마다 달라서 하나의 플래그로 통일했습니다.

MCP 의 market_calendar 오퍼레이션도 같은 정규화된 형태를 돌려줍니다. 이전에는 서버 응답을 그대로 흘려보내 국내·미국 필드 구조가 달랐습니다.

[0.44.0] - 2026-08-29

버그 수정

watchlist list 가 빈 표만 출력하던 문제. 토스가 대시보드 경로(sections/all)로 관심종목을 더 이상 내려주지 않게 되면서(data: null) 목록이 비어 보였습니다. 웹·앱이 이미 쓰고 있는 관심종목 전용 API 로 전환했습니다. (@anthonyminyungi, #175)

새 기능

watchlist list <폴더ID> — 폴더 하나의 종목만 봅니다. 대화형 터미널에서 인자 없이 실행하면 폴더 선택 화면이 뜹니다. 인자 없이 파이프·스크립트에서 실행하면 종전대로 전체 폴더를 평탄화해 출력합니다. 폴더 ID 는 watchlist groups 로 확인합니다.
```
$ tossctl watchlist groups
ID        폴더         종목수  구분
───────────────────────────────────────────
19735190  최근 본           3  RECENT_WATCH
46533678  낸시 펠로시       4  USER_MADE

$ tossctl watchlist list 46533678
```
MCP 의 watchlist 오퍼레이션도 group_id 를 받습니다. 생략하면 종전대로 전체를 돌려줍니다.

[0.43.1] - 2026-08-25

버그 수정

한글 종목명이 섞이면 표 정렬이 어긋나던 문제 (16개 커맨드). 열 너비를 글자 수로 세고 있어서, 화면에서 두 칸을 차지하는 한글이 들어가면 오른쪽 열이 밀렸습니다. market investors·market sectors·profit daily·accumulate list·tax overseas·quote supply 등이 영향을 받았습니다.
```
이전                                  이후
 1   삼성전기   13,354,185,500          1  삼성전기        13,354,185,500
 2   SK          3,797,935,000          2  SK               3,797,935,000
 3   LG이노텍    3,477,123,500          3  LG이노텍         3,477,123,500
```
표를 직접 그리던 16곳을 공용 렌더러로 모으고, 렌더러가 문자 폭을 정확히 계산하도록 바꿨습니다. 이에 따라 표 구분선이 열 단위 조각에서 하나의 가로선으로 바뀝니다. JSON·CSV 출력은 그대로입니다. (@anthonyminyungi, #173)

[0.43.0] - 2026-08-25

새 기능

order place --time-in-force — 주문 유효 조건을 고를 수 있습니다. 공식 Open API 가 OPG(국내 시가단일가)를 정식 지원하면서 추가됐습니다.
```
$ tossctl order place --symbol 005930 --market kr --side buy --qty 1 --price 70000 \
    --time-in-force OPG
```
- DAY (기본, 종전과 동일) · CLS 미국 지정가 장마감 주문(LOC) · OPG 국내 시가단일가
- 조합 규칙은 시장별로 다릅니다 — CLS 는 미국 + 지정가 전용, OPG 는 국내 전용(지정가·시장가 모두). 맞지 않는 조합은 주문을 보내기 전에 거절합니다.
- 소수점 주문에는 쓸 수 없습니다. 금액 기반 주문 스키마에 이 항목이 없어 조용히 무시되기 때문입니다.
- OPG 는 장전 사전접수 시간 외에 넣으면 원장에서 거절될 수 있습니다.
- confirm 토큰에 이 값이 함께 묶입니다. DAY 로 미리보기해 받은 토큰으로 OPG 주문을 낼 수 없습니다. 값을 지정하지 않은 주문의 토큰은 종전과 같습니다.

버그 수정

tossctl update 가 릴리즈 직후 "이미 최신" 이라고 답하던 문제. 업데이트 확인 결과를 24시간 캐시하는데, 사용자가 직접 부른 tossctl update 까지 그 캐시를 타고 있었습니다. 새 버전이 나와도 마지막 확인으로부터 24시간이 지나기 전에는 Already up to date 로 답했고, 그러면서 "Checking latest version" 은 그대로 보여줬습니다. 이제 직접 실행한 확인은 캐시를 건너뜁니다(네트워크가 안 되면 캐시된 값으로 물러납니다). 백그라운드 알림은 종전대로 캐시를 씁니다.

[0.42.0] - 2026-08-24

새 기능

market anomalies — 토스가 평소와 다른 움직임으로 표시한 지수와, 거기 붙은 AI 시그널·키워드·Z점수를 봅니다. Z점수는 그 지수 자신의 최근 분포에서 얼마나 벗어났는지입니다.

$ tossctl market anomalies
지수      등락률  Z점수          키워드       AI 시그널
────────  ──────  ─────  ──────────────  ──────────────
코스피    -3.12%   0.00  외인·기관 매도  왜 떨어졌을까?
코스닥    +1.42%   0.00   ETF 자금 유입    왜 올랐을까?

quote reasons — 여러 종목이 왜 움직이는지를 한 번의 요청으로 받습니다(웹은 최대 100개까지 보냅니다). 보유 종목 전체의 오늘자 사유를 한눈에 볼 때 씁니다.
```
$ tossctl quote reasons 005930,000660,AAPL
종목                사유
──────  ────────────────
005930   주주환원 실망감
000660  외국인 매도 확대
AAPL       매수의견 상향
```
한 종목의 자세한 근거(요약·방향·관련 종목)는 기존 quote reasoning <symbol> 이 그대로 담당합니다. 사유가 없는 종목은 응답에서 빠지므로 요청한 개수보다 적게 나올 수 있습니다.
quote charts — 여러 종목의 당일 장중 캔들을 한 번의 요청으로 받습니다. 기존 quote batch --chart 는 종목마다 따로 호출합니다.
```
$ tossctl quote charts 005930,000660,035720
종목    간격  캔들       종가  기준가대비
──────  ────  ────  ─────────  ──────────
005930   10m    55    257,500      -8.53%
000660   10m    55  1,670,000      -3.47%
035720   10m    39     35,800      +0.00%
```
구간·간격은 서버가 정합니다(관측: 1일 / 10분) — 요청 파라미터가 아니라서, 간격을 고르려면 기존 quote chart <symbol> --interval 을 쓰세요. 데이터가 없는 종목은 서버가 오류 없이 빼고 주므로 빠진 종목을 따로 알려줍니다.

개선

account prime 에 가입 이후 누적 혜택이 추가됐습니다. 지금까지는 이번 달치만 보여줬는데, 환전·원화이자·달러이자별 누적액과 총합을 함께 표시합니다.

[0.41.0] - 2026-08-24

새 기능

market halt — 코스피·코스닥의 서킷브레이커·사이드카가 지금 발동 중인지 봅니다. 장이 멈췄는지를 주문 전에 확인하거나, 자동매매 스크립트의 가드로 쓰는 용도입니다.
```
$ tossctl market halt
시장            유형  상태
──────  ────────────  ────
KOSPI   서킷브레이커  정상
KOSPI       사이드카  정상
KOSDAQ  서킷브레이커  정상
KOSDAQ      사이드카  정상

발동 중인 서킷브레이커·사이드카가 없습니다.
```
발동 여부와 관계없이 네 개 스위치를 항상 전부 보여줍니다 — 발동된 것만 그리면 평상시 화면과 조회 실패가 구별되지 않기 때문입니다. --output json 의 activated 로 자동화에 그대로 물릴 수 있습니다.

개선

내부 API 카탈로그가 동적 경로를 더 이상 자르지 않습니다. 지금까지 /trading/stocks/{stockCode}/average-price 같은 경로가 /trading/stocks 로 잘려 기록됐고, 그 잘린 경로를 확인하면 당연히 "없는 엔드포인트" 로 판정됐습니다. 85건이 잘린 채였고 그중 33건이 그렇게 잘못 기각돼 있었습니다 — 재확인 결과 대부분 살아있는 엔드포인트였습니다. 이제 웹 번들이 선언한 경로·HTTP 메서드·호스트를 그대로 읽습니다.
엔드포인트 확인이 호스트를 추측하지 않습니다. 토스는 wts-api·wts-info-api·wts-cert-api 를 섞어 쓰는데, 지금까지는 호스트를 순회하며 찍어보고 틀린 호스트의 404 를 결과로 기록했습니다. 카탈로그가 아는 호스트만 확인하고, 다른 호스트로 잰 옛 기록은 폐기합니다.
개발 후보 목록에서 계좌개설·본인확인·약관 같은 노이즈 100여건을 걷어냈습니다 (candidate 377 → 335). 인증 plumbing(common/auth/*)과 복수형 accounts/* 네임스페이스가 통째로 후보로 새고 있었습니다.

[0.40.0] - 2026-08-19

새 기능

stream — 공식 웹소켓으로 실시간 체결·호가·본인 주문 이벤트를 구독합니다. 지금까지 실시간은 웹 세션 기반 push listen(알림 신호만) 뿐이었고, 시세는 폴링밖에 없었습니다.
```
$ tossctl stream --trade AAPL,005930
$ tossctl stream --orderbook 005930 --order
```
채널을 몇 개 붙여도 연결은 하나입니다. 끊기면 지수 백오프로 재연결하며 구독을 다시 선언하고, 60초마다 keepalive 를 보냅니다(서버는 클라이언트 수신이 180초 없으면 끊습니다). 구독 직후 스냅샷은 오지 않으므로 현재 상태는 quote·orders 로 먼저 확인하세요.

개선

공식 spec 변경 감지가 웹소켓 출시를 놓쳤던 구멍을 막았습니다 — tools/openapi_diff.py 에 스펙 메타(info·externalDocs·tags) 절과 "어느 절도 안 덮은 변경" catch-all 을 추가하고, 일일 모니터가 AsyncAPI 스펙도 따로 추적합니다.

[0.39.0] - 2026-08-11

새 기능

market stocks — 마켓의 전체 상장 종목을 봅니다. 종목 유니버스를 만들 때 씁니다.
```
$ tossctl market stocks KOSPI
KOSPI 상장 종목 (2474개)
  000020     동화약품                     STOCK
  000040     KR모터스                    STOCK
```
- KOSPI KOSDAQ NYSE NASDAQ AMEX KR_ETC US_ETC. --status(기본 ACTIVE)· --security-type·--common-share 로 좁힙니다.
- 페이지네이션 없이 한 번에 다 옵니다(NASDAQ 약 2,800건). 하루 한 번 갱신되는 저변동 데이터라 반복 조회보다 받아서 캐싱하는 쪽이 맞습니다.
- 공식 Open API 키가 필요합니다 (tossctl openapi login).

개선

에이전트(MCP)가 시장 투자자 매매동향을 볼 수 있습니다. market investor-trading 은 CLI 에만 있고 오퍼레이션 목록에 빠져 있어서, MCP 로 붙은 도구는 조회할 방법이 없었습니다.
- 지수(KOSPI/KOSDAQ) 단위입니다. 개별 종목 수급은 quote supply 입니다.

[0.38.0] - 2026-08-07

새 기능

quote supply — 국내 종목의 수급 5종을 봅니다. 공식 Open API 1.2.13 이 새로 연 영역입니다.
```
$ tossctl quote supply 005930 --type investor
종목 수급 — 투자자별 매매동향 (005930)
  날짜          개인 순매수    외국인 순매수      기관 순매수    기타법인
  2026-08-07             -        1401598          61000           -
  2026-08-06       4158399       -2994420       -1287849      138848
  … 더 보려면 --until 2026-08-04
```
- --type investor|short|credit|lending|program — 투자자별·공매도·신용거래·대차거래·프로그램매매.
- 당일 잠정 기록에서 아직 집계되지 않은 값은 - 로 나옵니다. 0 으로 찍으면 "순매수 0" 과 구분되지 않는데, 수급에서 그 둘은 정반대 신호입니다.
- --count 로 개수를, --until 로 다음 페이지를 넘깁니다. 표 아래에 다음 커서가 나옵니다.
- 공식 Open API 키가 필요합니다 (tossctl openapi login).

개선

quote flows 가 공식 API 를 먼저 씁니다. 키가 연결돼 있으면 공식 투자자별 매매동향을, 없으면 지금까지처럼 웹 세션을 씁니다. 출력 형식은 그대로입니다.
- 기관 7개 세부 분류·외국인 보유·CFD 잔고까지 보려면 quote supply --type investor 를 쓰세요.
market filters — 스크리너 필터가 실제로 어떤 값 범위를 갖는지 봅니다. 지금까지는 market screener --filter 로 임계값을 넣을 때 그 값이 말이 되는지 알 방법이 없었습니다.
```
$ tossctl market filters PER PBR 배당_수익률 주가등락률
스크리너 필터 값 범위 (kr)
  PER                          -8021.27 ~ 6973.8          기준 2026-08-03
  PBR                          -54.6065 ~ 202.488         기준 2026-08-03
  배당_수익률                            0 ~ 0.382436
  주가등락률                  (조회 불가: screener.invalid.filter-condition-period)
```
- 범위는 오늘의 종목 전체에서 나온 값이라 매일 바뀝니다. 기준일이 그래서 같이 나옵니다.
- 필터 id 는 market screener --output json 의 프리셋 filters 배열에서 얻습니다.
- 기간 조건이 더 필요한 필터는 서버 원문 코드를 그대로 보여줍니다. 토스가 이 코드의 매핑을 공개하지 않아 번역하면 추측이 됩니다.
- 여러 개를 물었을 때 하나가 거절돼도 나머지는 그대로 나옵니다.
옵션 계약도 기존 시세 커맨드로 조회됩니다. quote options 가 준 계약 코드를 quote get·orderbook·trades·chart 에 그대로 넣으면 됩니다.
```
$ tossctl quote get OPT_AAPL260805C00230000_20260722
Name: 애플 $230 콜
Last: 102.19
```
- 지금까지는 전부 실패했습니다. 계약 코드에 _ 가 들어 있는데 공식 API 의 심볼 규칙이 이를 거부하고, 그 400 은 도메인 에러라 웹 세션 폴백도 걸리지 않았습니다. 공식 API 가 표현할 수 없는 심볼은 이제 웹 세션으로 바로 갑니다.
- 차트는 증권 종류별로 경로가 갈리는데 옵션이 주식 경로로 새고 있었습니다.

[0.37.0] - 2026-08-04

새 기능

quote options — 미국 종목의 옵션 만기일과 체인을 봅니다. 만기를 안 주면 상장된 만기일 목록이, 주면 그 만기의 행사가별 콜/풋 미결제약정(OI) 이 나옵니다.
```
$ tossctl quote options AAPL
AAPL 옵션 만기일 (24개)
  2026-08-03  거래 종료
  2026-08-05  1일 후 거래 종료

$ tossctl quote options AAPL --expiry 2026-08-05
AAPL 옵션 체인 — 만기 2026-08-05
   콜 미결제      행사가      풋 미결제
           2         215           0
          18         230           2
```
- 체인에는 가격이 없습니다 — 행사가·계약 식별자·미결제약정뿐입니다.
- 행사가 순서는 서버가 준 그대로 둡니다(오름차순). 재정렬하면 앱과 어긋납니다.
quote reasoning — 종목이 왜 올랐는지/내렸는지 토스 AI 설명을 봅니다. 함께 움직인 관련 종목도 같이 나옵니다.
```
005930 — 왜 올랐을까?
  반도체주 강세와 AI 투자심리 개선으로 매수세가 유입됐어요.
    · 000660   더미하이닉스           (관심)
    · 402340   더미스퀘어            (추천)
```
- 관련 종목의 유형(관심·추천)은 서버 표시 문자열 그대로입니다. 토스가 이 값의 매핑을 공개하지 않아 번역하면 추측이 됩니다.
quote signals — 종목별 호재/악재 카드를 봅니다. market signals 는 시장 전체 개인화 피드라 표면이 다릅니다.
search — 이름이나 티커로 종목을 검색해 다른 커맨드에 넣을 종목 코드를 찾습니다.
```
$ tossctl search 삼성
  005930   삼성전자                 KSP   A005930
  009150   삼성전기                 KSP   A009150
```
- 인자를 공백으로 이어 붙이므로 tossctl search 삼성 바이오 처럼 따옴표 없이 씁니다.
account receivable — 미수금과 반대매매 통지 상태를 봅니다. 갚아야 할 금액, 납입 기한, 반대매매 시각, 거래정지 기간이 나옵니다. --currency KRW|USD.
- 정상 계좌는 모든 날짜가 비어 있습니다. 비어 있으면 줄 자체를 만들지 않습니다 — 0값을 찍으면 1970년 날짜가 나와 연체된 계좌처럼 읽힙니다.
quote crypto — 토스가 다루는 가상자산 원화 시세를 봅니다. 시가·고가·저가·52주 범위와 함께 김치 프리미엄(국내가가 글로벌 대비 얼마나 비싸거나 싼지)이 같이 나옵니다.
```
가상자산 시세 (KRW)
  BTC       100000000원    +1.00%   고 102000000 / 저 99000000
        김프   -0.40%  (-400000원)
```
- 심볼은 BTC 처럼 짧게 쓰거나 VWAP.KRW-BTC 전체 코드를 그대로 넣어도 됩니다. 여러 개를 콤마로 묶어도 요청은 한 번입니다.
- 프리미엄은 부호를 유지합니다 — 음수는 국내가 글로벌보다 싸다는 뜻이라 절대값으로 바꾸면 의미가 뒤집힙니다.

개선

auth extend --if-expiring <기간> — 세션 만료가 임박했을 때만 연장합니다. 여유가 있으면 폰 알림을 보내지 않고 아무 일 없이 끝나므로(exit 0), cron 이나 launchd 에 매일 걸어두면 만료 직전에만 승인 알림이 옵니다. 지금까지는 만료 경고를 보고 직접 쳐야 했습니다.
```
$ tossctl auth extend --if-expiring 48h
session has ~151h 59m left; not extending yet
```
남은 시간은 디스크에 저장된 값이 아니라 서버에 다시 물어봅니다 — 저장된 값은 auth status 를 돌려야 갱신되므로, 스케줄러가 오래된 숫자를 보고 판단하면 불필요한 알림이 가거나 세션이 조용히 죽습니다. 등록 방법은 README 참고.

[0.36.0] - 2026-08-04

새 기능

community boards — 토스 커뮤니티 라운지를 팔로워 순으로 봅니다. 댓글 수와 내가 참여 중인지도 함께 나옵니다.
```
인기 라운지 (팔로워 순)
   1  라운지A              팔로워 12000 · 댓글 3400 · 참여 중
   2  라운지B              팔로워 8100 · 댓글 900
```
- 서버가 준 순서를 그대로 유지합니다 — 그 순서가 곧 랭킹이라 다시 정렬하면 앱과 어긋납니다.
order funding — 지금 매수가 가능한지, 막혀 있다면 얼마를 입금하거나 환전해야 하는지 봅니다.
```
매수 불가
  잔고  원화 1000원 · 달러 2
  필요 입금액  5000원
  필요 환전액  3
```
- account summary 는 이미 주문 가능한 금액을 보여줍니다. 이쪽은 부족분이라 주문이 막히는 이유를 바로 알려줍니다.
- 부족액이 0이면 그 줄은 나오지 않습니다.
market option-hours — 미국 옵션 시장의 직전·오늘·다음 영업일과 세션 시간입니다. 주식 장 시간(market hours)과 휴장일 주변에서 갈릴 수 있어 따로 봅니다.
tax ria — RIA 계좌(해외주식 양도세 절세 계좌) 의 절세 리포트를 봅니다. 토스 모바일 앱에만 화면이 있어 데스크톱에서는 확인할 방법이 없던 기능입니다.
```
RIA 절세 리포트 — 예상 절세액 1200원
  양도세   공제 전 3000원 → 공제 후 1800원
  양도소득 합계 20000원 (일반계좌 15000 · RIA계좌 5000)
  공제     기본 2500원 + RIA 1500원 (공제율 0.2)
    Q1  손익 400원 × 가중치 1 = 400원
    H2  손익 800원 × 가중치 0.5 = 400원
  매도한도 잔여 20000원 / 총 50000원
  추가 절세 여지 없음 (사유 코드: NO_PROFITABLE_STOCKS)
```
- 분기 가중 손익까지 보여줍니다. 공제액 합계만 보면 왜 그 금액인지 알 수 없어서입니다. 서버가 주는 기간 라벨은 분기가 아닐 수 있습니다(하반기는 H2).
- 일반계좌 기준 신고 수치는 기존 tax overseas 입니다 — 그쪽엔 RIA 개념이 없습니다.
- 절세 여지가 없을 때 나오는 사유 코드는 서버 원문 그대로 냅니다. 토스가 웹에 매핑을 싣지 않아 번역하면 추측이 됩니다.
- 매도한도·추가 절세액을 못 불러와도 리포트 본체는 그대로 나옵니다.
account interest — 원화 예수금에 붙는 예탁금 이용료를 지급 건별로 봅니다. 세전액·세금·실지급액과 산정기간, 아직 안 들어온 예상 이자까지 구분됩니다.
```
예탁금 이용료 2025년 — 총 1300원
  2025-02-11  1300원
    세전 1500 · 세금 200 · 산정기간 2024-11-01 ~ 2025-01-31
  2025-02-28  400원 (예상)
    세전 400 · 세금 0 · 산정기간 2025-02-01 ~ 2025-02-28
```
- 산정기간은 지급월과 다릅니다. 위 예처럼 2월에 받은 이자가 작년 11월~1월분일 수 있어, 둘을 함께 보여줍니다.
- --year 로 연도를 고릅니다(기본: 올해). 내역이 없는 해를 고르면 내역이 있는 연도를 알려줍니다.
- 기간 합계 하나만 필요하면 기존 profit summary --type account-interest 를 쓰세요 — 이쪽은 건별 내역입니다.
account commission — 내 계좌에 적용되는 거래 수수료 체계를 시장별로 봅니다. 국내주식·미국주식은 요율(%), 미국옵션은 계약당 정액입니다.
```
계좌 수수료 체계
  국내주식              0.011%
  미국주식              0.2%           우대 적용 (~2026-12-31)
  미국옵션              $2.49/계약
```
- 종목 하나의 수수료·거래세를 보는 quote commission <symbol> 과 다릅니다 — 이쪽은 계좌 전체에 걸린 요율입니다.
- 미국옵션 약정이 없는 계좌에서는 해당 줄이 나오지 않습니다.

개선

account detail 이 거래목적 심사 상태를 보여줍니다 — 지금까지는 «송금 한도가 제한된 상태입니다» 라는 사실만 알 수 있었고 왜 인지는 알 수 없었습니다. 이제 심사 상태·목적과, 반려됐다면 그 사유가 함께 나옵니다.
- 상태 코드는 서버 원문 그대로 냅니다. 토스가 웹에 매핑을 싣지 않아 번역하면 추측이 됩니다.
- 제한이 안 걸렸어도 심사가 진행 중이거나 반려됐을 수 있어, 제한 여부와 별개로 표시합니다.
지정가 호가 단위가 도움말과 문서에 명시됐습니다 — 미국 지정가는 $1 미만 0.0001, $1 이상 0.01 단위여야 합니다. 어긋나면 서버가 400 과 함께 가장 가까운 호가를 알려줍니다. 공식 Open API 1.2.9 에서 미국 기준이 문서화되기 전까지는 국내 기준만 공개돼 있었습니다. (동작 변경은 아닙니다 — 검증은 원래도 서버에서 합니다.)
소수점 주문 접수 시간이 도움말과 문서에 명시됐습니다 — 미국 주식 금액 주문·소수점 수량 주문은 정규장 종료 1시간 전까지만 접수됩니다. 토스 공식 Open API 1.2.9 에서 "정규장 시간" 이 이렇게 좁혀졌는데, 지금까지는 서버가 422 로 거절해야만 알 수 있었습니다. order place --help 와 README 에 적었습니다. (동작 변경은 아닙니다 — 원래도 서버 규칙을 그대로 따랐습니다.)

[0.35.0] - 2026-08-03

새 기능

market issues — 지금 시장이 가장 많이 이야기하는 토픽을 순위로 봅니다. 순위 등락(▲▼)과 관련 기사 수가 함께 나옵니다.
```
 1 ▲  글로벌 D램 공급 확대  — CXMT 메모리 증설  (12건)
 3 ▼  금리 동결에도 긴축 심화  — 미 장기국채 급등  (6건)
```
- 기존 market news(헤드라인 목록)·market briefing(AI 카테고리 묶음)과 다른 축입니다 — 이쪽은 토픽 자체의 랭킹입니다.
- --full 로 각 토픽의 관련 기사를 함께 봅니다.
order autotrade — 계좌에 걸어둔 자동매매 규칙을 봅니다: 스탑로스(STOP_LOSS)·목표수익(PROFIT_RATE)·OCO·OTO, 각각의 감시가와 주문가·수량·설정 시각.
```
STOP_LOSS      EXPIRED        US20220809012 (us)
  수량 32 (전량) · 감시가 12824 · 주문가 12824 KRW · buy
  설정 2025-08-02 08:51:57.000
```
- 지금까지 tossctl 로는 볼 수 없던 것입니다. 공식 API 의 조건주문(order conditional list)과는 다른 표면이라, 앱에서 건 스탑로스는 어디에도 안 보였습니다.
- 조회 전용입니다. 설정·해제는 토스 앱/웹에서만 됩니다 — account detail 이 계좌관리 화면을 보여주되 변경 동작은 노출하지 않는 것과 같은 기준입니다.
- 상태는 서버가 숫자(6)로 주는데 이름(EXPIRED)으로 바꿔 보여줍니다. 매핑은 추측이 아니라 토스 웹 번들에서 읽어온 것이고, 원본 코드도 status_code 로 남깁니다. 모르는 상태가 와도 행이 사라지지 않습니다.

개선

캡처 도구가 3단으로 정리됐습니다 (기여자용) — 무엇이 존재하나(wts_endpoints.py) · 살아있나(probe_candidates.py) · 어떻게 부르나(capture_post_bodies.mjs --sweep) 를 각각 덮습니다.
- 새 스윕 모드가 여러 화면을 돌며 실제 요청의 파라미터 키와 호스트를 카탈로그에 기록합니다. 토스는 wts-api/wts-info-api/wts-cert-api 를 섞어 써서 경로만으로는 어디에 붙일지 알 수 없었는데, 이제 카탈로그를 보면 됩니다.
- 동적 화면도 훑습니다 — /stocks/[code] 같은 라우트는 아무 값이나 넣어도 그 화면의 스크립트가 내려온다는 걸 확인해, 건너뛰지 않고 수집합니다. 966 → 988개.
- 값은 저장하지 않습니다. 키 이름과 호스트만 남깁니다.

[0.34.0] - 2026-08-03

새 기능

market calendar 가 제대로 된 캘린더가 됐습니다 — 이제 월 단위로 보고, 경제지표의 시장 예상치·실제치·직전값, 국내·미국 실적 발표(종목 코드와 실적발표 시각), 휴장일까지 나옵니다.
```
2026-08-05
  실적(미국)   AMD 실적발표  (US20150102001)
  지표        ISM 서비스업 구매관리자지수 발표
              예상 54.5 · 직전 54 (Index Point)
```
- --month YYYY-MM 으로 다른 달을 봅니다(기본: 이번 달). 주간 AI 요약은 이번 주 이야기라 이번 달을 볼 때만 붙습니다.
- v0.33.0 은 대시보드 위젯용 축약본을 쓰고 있었습니다(고정 10일치, 실적·예상치 없음, 웹은 그중 3건만 표시). 정식 화면이 쓰는 API 로 교체했습니다.
- v0.33.0 의 "기간 파라미터를 받지 않는다" 는 설명은 틀렸습니다. 기간은 쿼리스트링이 아니라 경로에 있었습니다.

개선

API 카탈로그가 지연 로딩 화면까지 봅니다 — 지금까지 초기 번들만 훑어서, /calendar 처럼 나중에 로딩되는 화면의 API 는 한 번도 카탈로그에 들어온 적이 없었습니다. 이제 라우트를 자동으로 찾아 각 화면의 스크립트까지 수집합니다. 949 → 966개(청크 26 → 74개)로 늘었고, 증시 캘린더 API 셋이 그렇게 발견됐습니다.
후보 스윕이 POST 조회를 놓치지 않습니다 — 토스는 조회에도 POST 를 자주 쓰는데 GET 만 보내고 있었습니다. 405 로 사장됐던 34개를 다시 확인하니 29개가 살아있는 엔드포인트였고, 그중 하나가 월간 캘린더였습니다.

[0.33.0] - 2026-08-03

새 기능

market calendar — 증시 캘린더가 처음 들어왔습니다. (v0.33.0 에서는 대시보드 위젯용 축약본을 썼는데, v0.34.0 에서 전용 화면이 쓰는 정식 API 로 교체되며 실적·예상치까지 나옵니다.)

개선

미확인 API 후보를 한 번에 훑는 개발 도구가 생겼습니다 (tools/probe_candidates.py) — 기여자용입니다. WTS 카탈로그의 candidate 는 주간 모니터가 신규·삭제만 알려줘서, 처음 쌓인 날 눈에 안 띈 경로는 계속 방치됐습니다(2026-08-03 기준 358개 중 346개가 45일째 미확인). 이 도구가 찔러보고 worth-review / needs-params / thin / forbidden 등으로 갈라 카탈로그에 기록합니다. 응답 본문은 저장하지 않습니다.

[0.32.0] - 2026-08-03

새 기능

account detail 이 미국 배당 수령 방식을 보여줍니다 — 미국 주식 배당을 현금으로 받는지(CASH) 주식으로 재투자하는지(STOCK), 그리고 마지막으로 바꾼 날짜입니다. 세금이 발생하는 시점과 보유 수량이 갈리는 설정인데, 토스 앱에만 화면이 있어 데스크톱에서는 확인할 방법 자체가 없었습니다.
- 서버 원문 값(CASH/STOCK)을 한글 풀이와 함께 보여줍니다. 앱과 대조할 때 같은 토큰이 보여야 하고, 돈이 걸린 설정은 번역만 남기면 위험합니다.
- 조회만 합니다. 변경은 토스 앱에서만 됩니다 — 변경 API 는 웹 세션으로 호출하면 403 이고, account detail 이 계좌 변경 동작을 노출하지 않는 기준을 그대로 따릅니다.
- 이 항목을 못 불러와도 account detail 의 나머지는 그대로 나옵니다(경고만 붙습니다).

개선

monitor api 가 401 무더기를 세션 문제로 짚어줍니다 — 세션이 만료되면 계좌 조회 probe 가 한꺼번에 실패하는데, 지금까지는 ✗ ... status=401 이 여러 줄 찍힐 뿐이라 토스가 API 를 여러 개 깬 것처럼 보였습니다. 이제 마지막에 한 줄이 붙습니다: ⚠ 11 of 11 failures are 401/403 — likely one expired session, not 11 broken endpoints. 인증과 무관한 실패(스키마 불일치 등)는 이 집계에서 빠지므로, 진짜 계약 변경을 세션 탓으로 오해할 일은 없습니다.

[0.31.0] - 2026-07-28

고침

주문 목록이 "다음 페이지가 있다"는 사실을 더 이상 삼키지 않습니다 — orders 오퍼레이션(MCP·tossctl ops call orders)이 첫 페이지만 돌려주면서 그게 전부인 것처럼 보였습니다. 응답의 nextCursor/hasNext 를 읽어놓고 버리고 있었습니다. 토스 공식 spec v1.2.5 에서 status=CLOSED 가 에러 대신 페이징 응답을 주기 시작해 이 경로가 실제로 쓰이게 되면서 드러났습니다.

⚠️ 응답 형태가 바뀝니다. orders 결과가 배열에서 객체로 바뀌므로, 이 오퍼레이션 출력을 파싱하는 스크립트·에이전트는 수정이 필요합니다:
```
이전: [ {주문}, {주문} ]
이후: { "orders": [ {주문}, {주문} ], "next_cursor": "...", "has_next": true }
```
조건주문 목록(conditional_orders)이 원래부터 쓰던 형태와 같아졌습니다. 타입 있는 커맨드(tossctl orders 등)는 웹 세션 경로를 쓰므로 영향받지 않습니다.

[0.30.0] - 2026-07-25

새 기능

ops — MCP 서버가 쓰는 오퍼레이션 카탈로그를 터미널에서도 엽니다. 셸로 tossctl 을 쓰는 에이전트는 지금까지 --help 에 적힌 것만 알 수 있었고, 나머지 오퍼레이션이 존재한다는 사실조차 알 방법이 없었습니다.
- ops list [--query X] 으로 찾고, ops describe <id> 로 파라미터를 보고, ops call <id> --params '{...}' 로 실행합니다. 앞의 둘은 인증이 필요 없습니다 — 카탈로그는 로컬 선언이라서요.
- 실패는 셸 관례를 따릅니다: stdout 은 성공했을 때만 JSON 이고, 에러는 stderr 에 평문 + 종료 코드 0 이 아님. stdout 을 파싱해 에러를 찾지 마세요.
- MCP 툴과 1:1 대응입니다: 같은 id, 같은 JSON 파라미터, 같은 JSON 출력.
- 출력은 원시 데이터입니다 — --output 과 무관하게 항상 JSON 이고 계좌번호·실명이 가려지지 않습니다. 기계용 표면이라 그렇습니다. 사람이 읽을 거라면 타입 있는 커맨드(tossctl account 등)를 쓰세요.
- 주문 게이트는 그대로입니다: config opt-in + execute/confirm 토큰이 없으면 dry-run preview 만 나옵니다.

개선

MCP 로 넣은 주문도 이제 추적됩니다 — 지금까지 주문 이력(정정 시 바뀐 주문번호를 원래 번호로 되찾아주는 기록)은 터미널에서 tossctl order 로 낸 주문만 남았습니다. 에이전트가 MCP 로 낸 주문은 흔적이 없어서, 나중에 원래 주문번호로 취소·정정하려 하면 찾지 못했습니다. 이제 어느 표면에서 냈든 동일하게 기록됩니다.

[0.29.0] - 2026-07-25

새 기능

account detail — 웹 계좌관리 화면의 조회 부분을 봅니다: 계좌번호·개설일·최종거래일, 출금 가능액(D+0/1/2)과 1회·1일 한도·오늘 사용액·전액출금 가능일, 시장별 미수거래 가능 여부와 차등증거금 적용 여부.
- 계좌번호와 예금주명은 기본적으로 가려집니다 (137010**930, 계**) — 이 출력이 이슈나 채팅에 붙여넣어지기 때문입니다. 전체를 보려면 --full.
- 일부 항목을 못 불러와도 커맨드가 실패하지 않고 경고로 알립니다. 미수거래 조회 하나 때문에 계좌번호를 못 보는 일은 없습니다.
- 같은 화면의 계좌 변경 동작(계좌 해지·비밀번호 변경·달러 송금)은 의도적으로 노출하지 않습니다.
- MCP 에서도 account_detail 오퍼레이션으로 노출됩니다. 웹앱(WTS) 전용.
market news — 시장 뉴스를 봅니다. 단순 헤드라인 목록이 아니라 기사마다 관련 종목이 지금 얼마나 움직이는지(세이프티 인슈어런스 그룹 +41.48%)까지 함께 보여줍니다.
- --type 으로 범위를 고릅니다: all(기본, 전체 주요 뉴스) · watchlist(관심 종목) · holdings(보유 종목) · soaring(급상승 주식) · latest · recommended. 서버 enum 을 그대로 넣어도 되므로 토스가 범위를 추가해도 업데이트 없이 쓸 수 있습니다.
- 요약문은 기본적으로 생략됩니다(한 화면에 50건이 들어가지 않습니다) — --full 로 함께 봅니다. --limit N 으로 건수를 줄일 수 있습니다(서버 상한 50건, 페이지네이션·키워드 검색은 제공되지 않습니다).
- 기존 market briefing(AI 가 테마별로 묶어주는 브리핑)과는 다릅니다. 이쪽은 원문 목록 + 종목 연결입니다.
- MCP 에서도 market_news 오퍼레이션으로 노출됩니다. 웹앱(WTS) 전용.

개선

스크리너 커스텀 필터를 실제로 쓸 수 있게 됐습니다 — market screener --output json 이 각 프리셋의 filters 배열을 함께 보여줍니다. 필터 어휘(배당_수익률 같은 한글 id)는 토스 web 번들에만 있어 공개돼 있지 않은데, 지금까지는 그 배열이 출력에서 빠져 있어 --filter 를 조립할 방법이 사실상 없었습니다(도움말은 프리셋 출력을 참고하라고 안내했지만 거기에 필터가 없었습니다). 이제 프리셋을 복사해 임계값만 바꿔 되먹일 수 있습니다:
```
tossctl market screener --output json | jq '.presets[] | select(.id=="14") | .filters'
tossctl market screener --filter '<복사한 배열>' --nation us
```

[0.28.0] - 2026-07-25

새 기능

profit summary, profit daily — 실현손익을 기간별·종목별로 볼 수 있습니다. 기존 profit 은 누적 총액만 보여줬습니다.
- profit summary --type sales|dividend|lending|account-interest [--from --to] — 카테고리 하나의 수익금·수익률·매입금액 (KRW/USD). 날짜를 생략하면 전체 기간입니다.
- profit daily [--from --to] [--currency KRW|USD] — 종목별·일자별 실현손익(수량·손익·수익률·매도/매수 금액)을 페이지 전체를 모아 보여줍니다. --output csv 로 해외주식 양도소득 신고 준비에 바로 쓸 수 있습니다.
- --currency 는 필터가 아니라 수익률 기준 통화 입니다. 같은 종목이라도 원화 기준 수익률에는 환율 변동이 섞이고, 달러 기준에는 섞이지 않습니다.
- 잘못된 카테고리·통화나 미래 날짜는 네트워크 호출 없이 즉시 알려줍니다.
- MCP 에서도 profit_period·profit_daily 오퍼레이션으로 노출됩니다. 웹앱(WTS) 전용.

[0.27.0] - 2026-07-25

개선

MCP 조회가 백엔드 하나에 묶이지 않습니다 — 호가·체결·상하한가·투자경고·매도가능수량·수수료 6개 오퍼레이션이 이제 backend: "auto" 로, 공식 API 자격증명과 웹 세션 중 하나만 있어도 동작합니다. 공식 API 를 먼저 쓰고 일시적 장애(전송·인증·레이트리밋·서버 오류)면 웹 세션으로 자동 폴백합니다 — CLI 가 원래 하던 것과 동일한 동작이며, 이제 에이전트도 같은 혜택을 받습니다. 종목 조회 도중 공식 API 가 흔들려도 대화가 끊기지 않습니다.

[0.26.0] - 2026-07-22

새 기능

profit — 누적 실현손익을 카테고리별로 조회합니다. 매매손익·배당·주식대여·만기·예탁금이자를 원화와 달러로 각각 보여주며, account summary(현재 보유 평가)와는 다른 누적 관점입니다. 웹앱(WTS) 전용이라 웹 세션(tossctl auth login)이 필요합니다. MCP 에서도 profit_overview 오퍼레이션으로 노출됩니다.
tax overseas [--year YYYY] — 해외주식 양도소득(양도소득세 신고용)을 조회합니다. 연도별 세금 요약(세율·기본공제·산출세액)과 매도 종목별 손익을 페이지 전체를 모아 보여줍니다. 미국주식 양도세 신고에 쓸 수 있습니다. 웹앱(WTS) 전용. MCP 에서도 tax_overseas 오퍼레이션으로 노출됩니다.

[0.25.0] - 2026-07-22

새 기능

accumulate list, accumulate status <symbol> — 주식모으기(정기 자동매수) 설정을 조회합니다. 계좌에 설정된 전체 플랜 또는 특정 종목의 플랜을 보여주며, Active/Paused 상태, 매수 금액·수량, 주기, 완료 회차를 포함합니다. 주식모으기 설정 화면은 모바일 앱에만 있지만, 조회 API 는 웹 세션(tossctl auth login)으로 호출할 수 있습니다. MCP 에서도 accumulation_plans·accumulation_status 오퍼레이션으로 노출됩니다. (#101)

[0.24.1] - 2026-07-17

Fixed

MCP 대용량 응답 처리 — market briefing·sectors 같은 큰 응답이 MCP 클라이언트(Claude Desktop 등)의 크기 한도를 넘겨 통째로 실패하던 문제. 이제 30KB 상한을 적용하고, 잘린 경우 몇 건이 생략됐는지와 좁혀서 다시 요청하는 방법을 응답에 명시합니다. (#99)
auth login 경로 오류 — 심링크로 설치했거나 레포 밖 디렉터리에서 실행하면 chdir auth-helper 오류로 로그인이 실패하던 문제. Homebrew 설치는 영향 없었습니다.

[0.24.0] - 2026-07-15

새 기능

lending expected — 보유 종목의 주식대여(대주)로 예상되는 수익을 조회합니다. 월간·연간 예상액(USD)과 종목별 내역을 보여주며, 대차 약정이 없는 계좌에서도 조회할 수 있습니다(0으로 표시). 배당처럼 패시브 인컴을 한눈에 확인하는 용도입니다. 웹앱(WTS) 전용이라 웹 세션(tossctl auth login)이 필요합니다. MCP 에서도 lending_expected 오퍼레이션으로 노출됩니다.

[0.23.1] - 2026-07-10

버그 수정

tossctl doctor 의 점검 메시지 일부가 한국어 모드(--lang ko)에서도 영어로 출력되던 문제를 수정했습니다. 하드코딩돼 있던 문구를 i18n 카탈로그로 이관해 한국어·영어 모두 올바르게 번역됩니다. (@leeyudok, #97)

[0.23.0] - 2026-07-08

새 기능

MCP auth_status — 인증 상태를 읽기 전용으로 진단하는 오퍼레이션. WTS 웹 세션·공식 Open API 키 각각의 연결 여부(connected)와 만료일(expires_at)만 반환하며, key/secret·쿠키 값은 절대 노출하지 않습니다. 인증이 없어도 호출 가능해, 에이전트가 다른 조회 전에 상태를 확인하고 "웹 세션이 곧 만료됩니다 → tossctl auth extend"처럼 정확히 안내할 수 있습니다.

[0.22.0] - 2026-07-08

새 기능

MCP WTS 조회 커버리지 완성 — 전수 감사로 누락돼 있던 계좌·포지션·주문·거래내역·관심종목 계열을 일괄 추가했습니다: positions(보유·평가손익, 공식 키 없이도), pending_orders(미체결), transactions(거래내역 상세, 전 기간 aggregate), watchlist/watchlist_groups(관심종목), earnings_major(주요 어닝콜). MCP WTS 조회가 16→23 종으로 늘었고, catalog 방식은 그대로(상시 3툴)입니다.

[0.21.0] - 2026-07-08

새 기능

MCP completed_orders — 완료(체결)주문 내역을 MCP 로 가져올 수 있습니다. 주문별 평균체결가(average_execution_price)와 체결수량을 반환해 실현손익 계산에 쓸 수 있고, 기간(from/to)·페이지(size/page) 파라미터로 전 기간을 조회합니다. WTS 전용(웹 세션 필요). 그동안 MCP 에는 현금 흐름(transactions_overview)만 있어 체결가를 가져올 수 없던 갭을 해소했습니다.

[0.20.1] - 2026-07-08

버그 수정

MCP list_operations/call_operation 툴 설명이 "Toss official API operations" 로만 되어 있어, WTS 전용 조회가 추가된 뒤에도 에이전트가 "공식 기능만 된다"고 오해할 수 있던 문제를 수정했습니다. 설명에 WTS 전용 조회(backend: "wts")와 백엔드별 인증(웹 세션/공식 키)을 명시합니다.

[0.20.0] - 2026-07-08

새 기능

tossctl mcp 가 WTS 전용 조회까지 노출 — 기존 공식 Open API 오퍼레이션(조회 19)에 더해, 공식엔 없는 WTS 전용 조회 16종(실시간 인기 순위·수급·시장지수·AI 시그널·스크리너·투자자별 순매수·테마·업종·어닝콜·뉴스 브리핑·커뮤니티 랭킹·배당·Prime·계좌 요약·거래내역)을 MCP 카탈로그에 추가했습니다. WTS 조회는 웹 세션(tossctl auth login)이, 공식 조회·주문은 공식 키(tossctl openapi login)가 필요하며 둘 중 하나만 있어도 서버가 뜹니다. 주문(생성·취소·정정)은 여전히 공식 API 경로만 사용합니다. catalog 방식은 그대로 — 오퍼레이션이 19→35 로 늘어도 상시 노출 툴은 여전히 3개(list_operations/describe_operation/call_operation)입니다.
MCP initialize 안내(instructions) — 3툴 카탈로그 사용법과 백엔드별 인증을 담고, 새 버전이 있으면 "Update available" 알림을 실어 MCP 만 쓰는 사용자도 에이전트를 통해 업데이트를 인지할 수 있습니다.

[0.19.0] - 2026-07-08

새 기능

tossctl mcp — 공식 Toss Open API를 MCP(Model Context Protocol) 서버로 노출합니다. stdin/stdout(JSON-RPC 2.0) 위에서 동작하며 Claude Code·Claude Desktop·Codex 등 MCP 호스트에 tossctl mcp 커맨드로 등록해 쓸 수 있습니다. 20여 개의 API를 개별 툴로 등록하는 대신, 상시 컨텍스트를 최소화하는 catalog 방식(list_operations / describe_operation / call_operation 3개 툴)으로 노출합니다. 공식 Open API의 조회·거래 엔드포인트를 100% 커버합니다 — 조회(계좌·잔고·주문·시세·호가·체결·캔들·환율·수수료·장운영시간 등)뿐 아니라 주문 실행(매수/매도·취소·정정) 도 지원합니다. 주문은 CLI(tossctl order)와 동일하게 config 게이트(trading.* + allow_live_order_actions)와 preview→execute/confirm 2단계 흐름을 따르며(기본은 dry-run preview), 공식 API 경로만 사용(WTS 미경유) 합니다. tossctl openapi login 으로 저장한 자격증명이 필요합니다.

[0.18.0] - 2026-07-08

새 기능

order conditional list / order conditional get — 공식 Open API 로 조건주문(감시 조건부 주문)의 목록·상세를 조회합니다. 공식 키 연결이 필요합니다.
order conditional place / cancel / modify — 공식 Open API 로 조건주문(트리거/STOP)을 생성·취소·수정합니다. 기존 주문과 동일한 안전 게이트(config.json trading.conditional=true 허용 + --execute + --confirm <token>)를 거치며, 기본은 비활성입니다. 공식 키 연결이 필요합니다.

[0.17.0] - 2026-07-08

새 기능

market rankings — 토스 공식 Open API 주식 랭킹(거래대금·거래량·급상승·급하락·토스증권 내 상위)을 조회합니다. 공식 키 연결이 필요합니다.
market indicator / market indicator-candles — 시장 지표(코스피·코스닥) 현재가와 OHLCV 캔들을 공식 Open API 로 조회합니다. 공식 키 연결이 필요합니다.
market investor-trading — 시장 전체(코스피·코스닥) 투자자별(개인·외국인·기관·기타법인) 매매동향을 공식 Open API 로 조회합니다. 공식 키 연결이 필요합니다.

[0.16.0] - 2026-07-02

새 기능

account prime — 토스 Prime 구독 상태와 이번 달 수수료·이자 혜택(일반/Prime/내 적용 요율 비교)을 조회합니다. 비가입 상태에서도 조회 가능합니다.

[0.15.0] - 2026-07-02

새 기능

tossctl update — 설치 경로(Homebrew / install.sh·install.ps1 / 소스 빌드)를 자동 감지해 알맞은 방식으로 tossctl을 최신 버전으로 갱신합니다. --check 로 다운로드 없이 새 버전 여부만 확인, --yes 로 확인 프롬프트 생략 가능.

[0.14.0] - 2026-07-01

새 기능

한국어 UI 라우팅 — --lang ko (또는 환경변수 LANG/TOSSCTL_LANG) 로 help·온보딩 프롬프트·표 출력을 한국어로 볼 수 있습니다. 기본값은 OS 로케일을 따르고, 감지되지 않으면 영어로 표시합니다. --output json|csv 는 언어 설정과 무관하게 항상 고정된 형식을 유지합니다.

개선

CLI 커맨드 설명(--help)을 영어로 통일하고, 각 커맨드가 어떤 경로로 동작하는지(공식 Open API / WTS / 둘 다 / 로컬) 구조화된 메타로 노출했습니다.

[0.13.1] - 2026-06-29

개선

market themes 테이블 정렬 개선 — 한글 표시폭을 반영해 열을 맞추고 헤더 구분선을 추가했습니다.

[0.13.0] - 2026-06-29

새 기능

market themes — 테마 등락 랭킹. 오늘 가장 많이 오른 토스 테마(예: 배터리·연예기획사)를 등락률·상승종목수와 함께 보여줍니다. --size N 으로 개수 조정(0=전체). 공식 Open API 에는 없는 토스 WTS 고유 기능입니다. --output json|csv 지원.

개선

라우팅 백엔드 값 명칭 정리 — --backend 플래그와 openapi.prefer 의 official 값을 openapi 로 바꿨습니다(tossctl openapi 서브커맨드·openapi.* 설정과 일관). 기존 official 은 deprecated 별칭으로 계속 동작하므로 기존 설정·스크립트는 그대로 작동합니다.

[0.12.0] - 2026-06-27

새 기능

대화형 주문·폴더 선택 — 터미널에서 order cancel, order amend, order show를 --order-id 없이 실행하면 대기/최근 주문 목록을 직접 골라 진행할 수 있습니다. watchlist group delete·rename도 폴더 이름 없이 실행하면 목록에서 선택합니다 (rename "새이름"처럼 새 이름만 전달하면 폴더를 고릅니다). 플래그·인자를 지정하면 기존과 동일하게 비대화형으로 동작하며, 파이프·비TTY에서는 프롬프트 없이 명확한 오류를 반환합니다.
하이브리드 공식 Open API 연동 — 토스 공식 Open API 키를 선택적으로 연결할 수 있습니다. 연결하면 공식이 지원하는 조회·거래 기능은 OAuth 경로로 처리되어 더 안정적이며, 토큰을 자동 갱신합니다. 공식에 없는 기능은 기존대로 WTS 경로를 씁니다. WTS 세션만으로 WTS·하이브리드 기능을 사용할 수 있지만, 매수 가능 금액·영업일·종목 메타데이터·조건 주문·실시간 스트림처럼 공식 전용인 기능에는 Open API 키가 필요합니다.
tossctl init — 온보딩 위저드. 처음 설치한 사용자를 위해 웹 세션 로그인·공식 키 등록·거래 설정을 단계별로 안내합니다.
tossctl openapi login — 공식 API Key·Secret을 등록합니다. 환경변수(TOSSCTL_OPENAPI_KEY/TOSSCTL_OPENAPI_SECRET) 또는 플래그로 전달하거나 대화형으로 입력할 수 있습니다. 자격증명 파일은 0600 권한으로 저장됩니다.
tossctl openapi status — 현재 키·토큰·허용 IP·라우팅 상태를 진단합니다. IP 미허용·토큰 만료·키 미설정 등 오류 원인을 설명합니다.
tossctl openapi test — 실제 API 호출로 공식 키 연결을 검증합니다.
tossctl openapi logout — 자격증명 파일을 삭제합니다.
--backend auto|wts|official 전역 플래그 — 요청별로 라우팅 백엔드를 직접 지정합니다.
doctor 하이브리드 진단 — tossctl doctor 가 공식 키·토큰·IP 허용 상태를 함께 점검합니다.

개선

핵심 출력 손익 색상 — 포트폴리오·계좌·시세·관심종목의 주요 손익 수치에 한국식 색(상승/이익=빨강, 하락/손실=파랑)을 표시합니다. 파이프·비TTY·NO_COLOR 환경 및 --output json|csv 에서는 색 없이 기존과 동일하게 동작합니다.
관심종목 등락·등락률 컬럼 — watchlist list 결과 표에 기준가 대비 등락액·등락률 컬럼이 추가됐습니다. JSON/CSV 출력은 변경 없습니다.

버그 수정

설치 스크립트(curl ... install.sh | sh)가 /usr/local/bin 이 없는 환경(주로 새로 설정한 Apple Silicon Mac — Homebrew 가 /opt/homebrew 에 있어 /usr/local/bin 이 아직 없는 경우)에서 mv: ... No such file or directory 로 설치에 실패하던 문제 수정. 설치 디렉터리를 먼저 만들고, 쓰기 권한이 있으면 sudo 없이 설치합니다. INSTALL_DIR·SHARE_DIR 환경변수로 설치 위치를 바꿀 수도 있습니다.

[0.11.1] - 2026-06-25

버그 수정

소수점 매수(order place --fractional --amount <값>, --qty 미사용)가 required flag(s) "qty" not set 로 거부되던 문제 수정. --qty 를 정적 필수에서 제외하고, 수량/금액 검증을 케이스별로 order preview·place 에서 일원화했습니다. (소수점 매도는 --qty, 소수점 매수는 --amount 사용.)

[0.11.0] - 2026-06-25

새 기능

소수점 매도 (US, beta) — 미국 주식 시장가에서 소수점 수량으로 매도할 수 있습니다: order place --fractional --side sell --qty 0.5 (소수점 6자리까지). 공식 Open API 1.1.5에 추가된 기능을 반영했습니다. 소수점 매수는 기존대로 금액 기반(--amount)입니다. 계약 테스트는 통과했으나 라이브 검증 전이니 실거래 전 order preview 로 확인하세요.

문서

공식 Open API 가 소수점 주문(금액 기반 매수 + 1.1.5 소수점 매도)을 지원함을 반영해 비교표·소개를 정정했습니다. tossctl 고유 부분은 원화(KRW) 결제 모드(공식 금액 주문은 USD)·dry-run preview·안전 게이트로 명확히 했습니다.

[0.10.1] - 2026-06-23

버그 수정

Windows·Linux 에서 로그인은 성공하는데 auth status 와 모든 인증 요청이 거부(400/401/403)되던 문제 수정. tossctl 이 보내는 User-Agent 가 macOS 로 고정돼 있어, 다른 OS 에서 로그인한 세션과 불일치해 토스 서버가 거부하던 것이 원인이었습니다. 이제 로그인한 브라우저의 실제 User-Agent 를 세션에 저장해 그대로 쓰고, 기본값도 실행 OS 에 맞춰 만듭니다. (#36)
Windows 설치 시 playwright 설치 단계에서 실제로는 성공했는데도 빨간 NativeCommandError 가 표시되던 문제 수정 (PowerShell이 pip 진행 메시지를 오류로 처리). 이제 종료 코드로만 성공/실패를 판정합니다. (#35)

[0.10.0] - 2026-06-21

새 기능

market index <코드|이름> — 지수 상세 시세(OHLC·52주 고저·거래량). 예: market index nasdaq, market index 코스피. 인자 없으면 기존처럼 주요 지수 목록(코드 포함).

[0.9.1] - 2026-06-19

버그 수정

소스 설치 경로 정정 — go install github.com/JungHoonGhae/tossinvest-cli/cmd/tossctl@latest 가 정상 동작합니다 (모듈 경로가 실제 저장소와 불일치하던 문제). 바이너리·Homebrew 설치에는 영향 없습니다.

[0.9.0] - 2026-06-19

새 기능

portfolio dividends — 연간 배당 내역(총액·수령·예정, 지역별 KR/US, 월별). --by-payment-date 로 지급일 기준(세금·수수료 포함), --year 로 연도 선택.
community rankings --type influencer|profit|followers — 토스 커뮤니티 랭킹(인플루언서·수익금·팔로워 급증).
market sectors [id] — 업종별 등락(대분류 39개·하위 업종, 1일·1개월·1년 수익률). 인자로 업종 id 를 주면 하위 업종.
market briefing — 개인화 AI 뉴스 브리핑(테마별로 묶인 뉴스 헤드라인).
market earnings --major — 주요 기업 어닝콜만 큐레이션해서 표시.

(모두 토스 공식 Open API 에는 없는 tossctl 고유 기능입니다.)

[0.8.0] - 2026-06-19

새 기능

market investors — 외국인·기관·개인 투자자별 순매수 상위 종목.
market earnings — 다가오는 어닝콜(실적발표) 일정.

(둘 다 토스 공식 Open API 에는 없는 tossctl 고유 기능입니다.)

[0.7.0] - 2026-06-18

새 기능

Windows 설치 지원 — PowerShell 한 줄로 설치합니다: irm https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/install.ps1 | iex. 다운로드·체크섬 검증·PATH 등록·Chrome/Python 점검까지 자동으로 처리합니다. (기여: @thsvkd)

개선

Windows 설치 시 기존 PATH 환경변수가 손상되지 않도록 안전하게 등록합니다.

[0.6.0] - 2026-06-04

새 기능

quote orderbook <종목> — 10단계 호가(매도·매수 잔량).
quote sellable <종목> — 보유 종목의 매도가능수량.
quote commission <종목> — 수수료율·거래세율.

이로써 토스 공식 Open API 가 제공하는 조회·거래 기능을 100% 커버합니다.

[0.5.2] - 2026-06-04

개선

국내주식 6자리 코드(예: 005930)를 넣으면 --market kr 없이 자동으로 인식합니다.
멀티 시세·시세 조회 속도 향상(병렬 처리).
거래 설정 단순화 — 이제 US/KR 시장 구분 없이 동일하게 동작합니다 (기존엔 국내거래만 별도 옵션이 필요했습니다).

[0.5.1] - 2026-06-04

개선

실거래 실행 절차를 --execute + --confirm <token> 두 단계로 단순화했습니다(보호 강도는 동일).
오래된 설정 항목이 남아 있으면 명령 실행 시 한 줄로 안내합니다.

지원 종료 예정

--dangerously-skip-permissions 플래그는 더 이상 필요 없습니다. 당분간 호환을 위해 받아들이지만 다음 릴리즈에서 제거됩니다. --execute + --confirm <token> 을 사용하세요.

[0.5.0] - 2026-06-04

새 기능

market index — 코스피·코스닥·나스닥·S&P500·VIX 등 주요 시장 지수.
market ranking — 실시간 인기 종목 순위.
quote flows <종목> — 종목별 투자자 수급(개인·외국인·기관, 국내).
market signals — 토스 AI 시그널.
market screener — 가치주·배당주·성장주 등 조건 검색.
관심종목 관리 — 폴더 생성·이름변경·삭제, 종목 추가·제거 (watchlist group ..., watchlist add|remove).

[0.4.19] - 2026-06-03

새 기능

quote get 정보 확장 — 당일 OHLC, 52주 고저, 시가총액, 거래대금, 체결강도, 상/하한가.
market fx — 달러 환율·달러 인덱스.
market hours 가 휴장일에는 다음 영업일도 함께 표시합니다.

[0.4.18] - 2026-06-03

개선

미국 종목에 quote limits(상/하한가)를 쓰면 친절한 안내를 표시합니다 (상/하한가는 국내 전용 제도).

[0.4.17] - 2026-06-03

새 기능

quote trades (체결 틱), quote limits (상/하한가), quote warnings (매수 유의사항), market hours (장 운영 시간).

[0.4.16] - 2026-05-28

새 기능

quote batch --live — 실시간 갱신 모드(watch 대체). (기여: @Castor103)
quote batch 에서 쉼표로 여러 종목을 한 번에 조회.

[0.4.15] - 2026-05-20

새 기능

quote chart <종목> — 분봉 ASCII 캔들 차트(색상 지원). quote batch --chart 로 스파크라인 표시. (기여: @Castor103)
quote get / quote chart 가 여러 단어 종목명("KODEX 인버스" 등)을 지원합니다.

[0.4.14] - 2026-05-14

개선

새 버전 알림이 AI 에이전트 환경에서도 표시되도록 했습니다(하루 1회).
tossctl version 에 최신 버전·업데이트 가능 여부를 표시합니다.

[0.4.13] - 2026-05-14

새 기능

자동 업데이트 알림 — 새 버전이 있으면 명령 실행 후 한 줄로 안내합니다. 설정에서 끌 수 있고(update_check.enabled=false), 자동화 출력(JSON/CSV)은 오염시키지 않습니다.

[0.4.12] - 2026-05-14

버그 수정

Windows 에서 auth login 이 중간에 멈추던 문제를 수정했습니다. (제보·수정: @netics01)

[0.4.10] - 2026-05-13

개선

monitor api 단순화 — 통과/실패만 반환하고 알림 채널(Discord·Slack·이메일 등)은 cron 에서 자유롭게 연결합니다. (가이드: AGENTS.md)

[0.4.9] - 2026-05-13

새 기능

tossctl monitor api — 핵심 조회 API 상태를 점검해, 토스 서버 측 변경으로 명령이 깨지기 전에 조기 감지합니다.

[0.4.8] - 2026-05-13

버그 수정

토스 서버 변경으로 portfolio positions·watchlist list 가 실패하던 문제를 긴급 수정했습니다. (제보: kwakmu18)

[0.4.7] - 2026-05-06

버그 수정

order place --fractional --currency-mode USD 가 거부되던 문제를 수정했습니다. (제보: @leesj10147)

[0.4.6] - 2026-05-06

새 기능

tossctl auth extend — 폰 토스 앱 푸시 승인으로 세션을 약 7일 연장합니다(재로그인 불필요). (기여: @skyisle)
세션 만료 24시간 전부터 경고를 표시합니다.

[0.4.5] - 2026-04-29

새 기능

tossctl push listen — 실시간 푸시(주문/체결/보유 변경) 알림 스트림. (기여: @skyisle)

[0.4.4] - 2026-04-23

새 기능

미국 지정가 주문에 USD 가격 입력 허용 — order place --currency-mode USD --price 158.01. (기여: @skyisle)

[0.4.3] - 2026-04-23

개선

실제로 동작하지 않던 설정 항목들을 정리했습니다. 기존 설정은 그대로 둬도 되며, doctor 가 안내합니다.

[0.4.2] - 2026-04-23

새 기능

tossctl doctor --report — 환경·세션·엔드포인트 상태를 JSON 한 번에 출력합니다. 홈 경로는 자동으로 가려져 GitHub 이슈에 그대로 붙일 수 있습니다.

[0.4.1] - 2026-04-23

보안

로그인 중간 파일·QR 이미지·상태 폴더 권한을 소유자 전용으로 강화했습니다(공유 컴퓨터에서 다른 사용자가 세션을 읽지 못하도록).

[0.4.0] - 2026-04-23

새 기능

거래내역·현금 요약 — transactions list(매매·입출금·배당·입출고), transactions overview(주문가능·출금가능·예정입금). (기여: @skyisle)
로그인 유지(영속 세션) — 폰에서 "이 기기 로그인 유지"까지 마치면 약 1시간 뒤 만료되던 문제가 해결됩니다.
원격/헤드리스 로그인 — auth login --headless. QR URL 을 폰으로 보내 카메라 없이 인증. (기여: @skyisle)
helper Python 자동 탐지로 uv 설치 환경도 지원. (기여: @keenranger)