변경 이력 | tossinvest-cli

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

[Unreleased]

[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 경로를 씁니다. 키 없이도 모든 기능이 동작하며, 원하는 시점에 선택적으로 추가할 수 있습니다.
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)