지원 범위
공식 Open API 대비 커버리지
tossctl 은 토스 공식 Open API의 조회·거래 범위를 100% 커버하고, 그 너머까지 다룹니다. 공식 키를 등록하면 공식이 지원하는 기능은 실제로 OAuth 경로로 라우팅되며, 나머지는 WTS 경로로 처리됩니다. 자세한 설정 방법은 하이브리드 가이드를 참고하세요.
- ✅ 지원 · ❌ 미지원 · 🔸 부분 지원
공식 API칼럼 = 공개 문서 기준 커버리지; 공식 키 등록 시 해당 기능은 OAuth로 라우팅- 공식이 ❌ 인 행 = tossctl 고유 기능 (항상 WTS)
openapi 커맨드
| 커맨드 | 설명 |
|---|---|
tossctl init | 온보딩 위저드 — 세션·공식 키·거래 설정을 단계별 안내 |
tossctl openapi login | 공식 키 등록 (환경변수 TOSSCTL_OPENAPI_KEY/TOSSCTL_OPENAPI_SECRET 또는 플래그) |
tossctl openapi status | 키·토큰·허용 IP·라우팅 상태 진단 |
tossctl openapi test | 실제 API 호출로 연결 검증 |
tossctl openapi logout | 자격증명 파일 삭제 |
전역 플래그 --backend auto|wts|openapi 로 요청별 라우팅을 직접 지정할 수 있습니다.
조회 (읽기 전용)
| 기능 | 명령 | 공식 API | tossctl |
|---|---|---|---|
| 계좌 목록 / 요약 | account list, account summary | ✅ | ✅ |
| 포트폴리오 | portfolio positions, portfolio allocation | ✅ | ✅ |
| 체결 틱 / 호가 | quote trades, quote orderbook | ✅ | ✅ |
| 상·하한가 / 매수 유의 | quote limits, quote warnings | ✅ | ✅ |
| 매도가능수량 / 수수료 | quote sellable, quote commission | ✅ | ✅ |
| 시세 / 캔들 | quote get, quote chart | 🔸 | ✅ |
| 멀티 시세 / 실시간 갱신 | quote batch --live | ❌ | ✅ |
| 수급(투자자별 순매수) | quote flows | ❌ | ✅ |
| 시장 지수 / 지수 상세 | market index [<코드|이름>] | ❌ | ✅ |
| 실시간 인기 순위 | market ranking | ❌ | ✅ |
| 투자자별 순매수 상위 | market investors | ❌ | ✅ |
| 업종별 등락 | market sectors | ❌ | ✅ |
| 실적(어닝콜) 일정 | market earnings [--major] | ❌ | ✅ |
| 개인화 뉴스 브리핑 | market briefing | ❌ | ✅ |
| 토스 AI 시그널 | market signals | ❌ | ✅ |
| 조건검색(스크리너) | market screener | ❌ | ✅ |
| 배당 내역 | portfolio dividends | ❌ | ✅ |
| 커뮤니티 랭킹 | community rankings | ❌ | ✅ |
| 관심종목 조회·관리 | watchlist ... | ❌ | ✅ |
| 거래내역 ledger / 현금 overview | transactions list/overview | ❌ | ✅ |
| CSV 내보내기 | export ... | ❌ | ✅ |
거래
| 기능 | 명령 | 공식 API | tossctl |
|---|---|---|---|
| 매수·매도 주문 | order place | ✅ | ✅ |
| 주문 취소·정정 | order cancel, order amend | ✅ | ✅ |
| dry-run preview | order preview | ❌ | ✅ |
| 소수점 주문 (US, 금액/수량) | order place --fractional | ✅ | ✅ |
| 소수점 주문 — 원화(KRW) 결제 | order place --fractional --currency-mode KRW | ❌ | ✅ |
| 실시간 푸시(SSE) | push listen | ❌ | ✅ |
소수점 매도 (beta)
공식 Open API 1.1.5에 추가된 미국 시장가 소수점 수량 매도(order place --fractional --side sell --qty 0.5, 소수점 6자리)를 구현했습니다. 계약 테스트는 통과했으나 라이브 검증은 아직입니다 — 실거래 전 order preview로 확인하세요. 소수점 매수는 기존대로 금액 기반(--amount)입니다.
검증 기준
공식 API 칼럼은 공식 Open API 문서의 특정
버전 기준으로 검증됩니다. 검증된 버전·마지막 점검일은 저장소의
.openapi-snapshot.json
에 기록되며, 전체 spec 사본을 매일 미러링하고 변경 시 자동 감지·갱신합니다.
WTS 웹 API 전체 카탈로그(구현/다음 추가 후보/의도적 제외)는
wts-endpoints.json
에서 지속 추적합니다.