Changelog

Version history below (source: the Korean-language CHANGELOG.md — entries are not yet translated). Binaries and release notes for each version are also on 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)

[0.3.6] - 2026-04-17

버그 수정

• auth login 이 멈추거나 조회 API 가 차단(403)되던 문제를 수정했습니다. (제보: @pinion05)

[0.3.5] - 2026-03-30

개선

• 표 출력 정렬 개선(종목명 좌측, 숫자 우측, 천단위 쉼표).

[0.3.4] - 2026-03-28

버그 수정

• auth login 브라우저 차단 해결 — 시스템 Google Chrome 을 사용합니다(별도 Chromium 설치 불필요).

[0.3.3] - 2026-03-24

새 기능

• 미국 포지션에 USD 금액 병기. (기여: @seilk)
• 한 줄 설치 스크립트(curl ... | sh, macOS/Linux).

버그 수정

• Linux 에서 auth login 이 실패하던 문제 수정.

[0.3.2] - 2026-03-23

새 기능

• Windows·Linux 바이너리 제공.

[0.3.1] - 2026-03-21

버그 수정

• 미국 주가가 센트($0.01) 단위로 반올림되도록 수정(가격 오류 해결).

[0.3.0] - 2026-03-21

새 기능

• 소수점(금액 기반) 주문 — order place --symbol TSLL --fractional --amount 18000 (미국 시장가).

[0.2.2] - 2026-03-21

새 기능

• quote batch — 여러 종목 시세 한 번에.
• export positions|orders --market — 시장별 CSV 내보내기.

[0.1.7] - 2026-03-21

새 기능

• 국내주식 거래 — order place --symbol 005930 --market kr.

[0.1.6] - 2026-03-21

새 기능

• 매도 주문 — order place --side sell.