비공식 토스증권 API / TossInvest API Skill: 로그인·계좌 인증 없이 주식·시장 데이터를 안전하게 조회하는 경량 스킬
개요
tossinvest.com의 공개 주식·시장 데이터를 **하는 스킬입니다. 비공식 프로젝트이며 로그인·계좌·주문이나 투자 조언은 지원하지 않습니다. 설치 후 스킬 목록에서 tossinvest-web-api가 보이는지 확인하세요. 설치 폴더명도 이 이름을 사용합니다. Codex 개인 스킬 경로에 직접 설치하는 예시입니다. 셸 명령은 Bash 기준입니다. 위 clone 명령은 main을 설치합니다. 버전을 고정하려면 --branch 를 추가하고 릴리스 목록의 실제 태그를 사용하세요. 최종 파일 위치는 .agents/skills/tossinvest-web-api/SKILL.md처럼 스킬 이름과 폴더명이 일치해야 합니다. Antigravity CLI는 agy 실행 후 /skills에서 설치 여부를 확인하세요. Hermes의 프로젝트 .hermes/skills 또는 .agents/skills를 사용하려면 해당 프로젝트가 신뢰된 상태여야 합니다. OpenClaw에서는 openclaw skills list --eligible과 openclaw skills info tossinvest-web-api로 발견 여부를 확인하세요. Python은 실제 실행 호스트나 샌드박스에도 필요합니다. SKILL.md, scripts/, references/는 호스트가 함께 사용하는 본체입니다. agents/openai.yaml은 Codex용 표시 정보와 자동 호출 정책이며 다른 호스트의 권한·호출 설정을 대신하지 않습니다. 각 환경에서 수동 점검 절차에 따라 스킬 발견과 첫 조회를 확인하세요. 직접 CLI를 실행할 때는 **을 사용합니다. HTTP 조회는 표준 라이브러리로 실행합니다. 스킬이 설치된 폴더(저장소 루트)에서 다음 명령을 실행하면 JSON 결과가 출력됩니다. python3 --version이 Python 3.14.7인지 확인하세요. Windows에서는 py -3.14로 바꿀 수 있지만, 3.14 명령 이름만으로 패치 버전이 고정되지는 않습니다.
README
토스증권 API Skill
tossinvest.com의 공개 주식·시장 데이터를 에이전트와 Python CLI에서 읽기 전용으로 조회하는 스킬입니다.
비공식 프로젝트이며 로그인·계좌·주문이나 투자 조언은 지원하지 않습니다.
설치 · 빠른 시작 · 지원 범위 · 문서 안내 · 변경 이력
설치
Codex에서는 다음과 같이 요청하세요.
https://github.com/dd3ok/tossinvest-api-skill 에서 스킬을 설치해줘.
설치 후 스킬 목록에서 tossinvest-web-api가 보이는지 확인하세요. 설치 폴더명도 이 이름을 사용합니다.
빠른 시작
설치 후 새 대화에서 자연어로 요청하세요.
토스증권 기준으로 A005930의 종목 요약과 현재 시세를 조회해줘.
직접 CLI를 실행할 때는 Python 3.14.7을 사용합니다. HTTP 조회는 표준 라이브러리로 실행합니다. 스킬이 설치된 폴더(저장소 루트)에서 다음 명령을 실행하면 JSON 결과가 출력됩니다.
python3 scripts/stock_summary.py --code A005930 --no-overview
python3 --version이 Python 3.14.7인지 확인하세요. Windows에서는 py -3.14로 바꿀 수 있지만, 3.14 명령 이름만으로 패치 버전이 고정되지는 않습니다.
다른 작업 폴더에서는 로드된 SKILL.md가 있는 디렉터리를 기준으로 스크립트와 번들 파일의 절대경로를 사용하세요. 상대 입력·출력 경로는 실행한 작업 폴더 기준입니다.
전체 옵션은 --help, 다른 조회 방법은 실행 예제를 참고하세요.
미국 주식 차트에는 US20100311002 같은 TossInvest 상품/소스 코드가 필요합니다. SPY, NVDA 같은 표시 티커를 그대로 넣으면 HTTP 400이 날 수 있습니다. 코드 선택 안내를 참고하세요.
지원 범위
| 하고 싶은 일 | 제공 기능 |
|---|---|
| 종목 살펴보기 | 국내·미국 종목 요약, 현재가·호가, 재무·배당, 투자자 동향 |
| 차트 분석하기 | 캔들 조회와 RSI·SMA·EMA·MACD·Bollinger Bands의 로컬 계산 |
| 시장 탐색하기 | 검색, 랭킹, 섹터·ETF, 지수·환율·채권·원자재, 캘린더, 스크리너 |
| 공개 콘텐츠 읽기 | 뉴스·공시, 정제된 피드·종목/라운지 댓글·답글 |
| 실시간 데이터 받기 | 공개 주식 체결과 검증된 지수·가상자산형 지수의 제한된 WebSocket 수신 |
문서 안내
| 찾는 내용 | 문서 |
|---|---|
| 실행 명령과 옵션 조합 | 실행 예제 |
| API 목록과 확인 상태 | API 카탈로그 |
| 종목 시세·차트·재무·공시 | 종목 API |
| 지수·환율·검색·랭킹·섹터·캘린더 | 시장 API |
| 뉴스 탐색·피드·공개 댓글 | 피드·커뮤니티 API |
| 실시간 채널·수신 필드·운영 제한 | WebSocket 문서 |
| 실제 스킬 선택·실행 비교 | Codex 평가 기록 |
| 응답 필드와 페이징 | 응답 설명 |
| 허용 범위와 중단 조건 | 안전 규칙 |
한계와 안전 범위
- 공개 데이터만 조회합니다. 로그인·계좌·보유종목·주문·개인화·쓰기 작업은 지원하지 않습니다.
- 대량 수집과 접근 제어 우회를 하지 않습니다. HTTP 403·429, 챌린지 또는 로그인 전환이 발생하면 중단합니다.
- 비공식 API의 경로·응답·데이터 가용성은 예고 없이 바뀔 수 있습니다. CI 통과가 현재 API의 성공이나 모든 호스트의 실행을 보장하지는 않습니다.
이 스킬은 토스증권의 공식 Open API 클라이언트가 아니며, 공식 API 앱 설정·OAuth 토큰·계좌 헤더·IP 등록이 필요하지 않습니다. 공식 API와의 구분을 참고하세요.
WebSocket의 임시 게스트 연결값은 실행 중 메모리에만 유지하고 출력·로그·파일에 남기지 않습니다.
wts-cert-api.tossinvest.com은 공개 페이지에서 확인되고 카탈로그에 있거나 스크립트로 검증된 엔드포인트군만 사용합니다. 쿠키·인증 헤더·계좌 식별자·개인 데이터가 필요한 요청은 제외합니다.
새 API를 조사할 때는 캡처 절차와 안전 규칙을 먼저 확인하세요.
안정성 및 버전 정책
v1.0.0부터 다음 저장소 표면을 안정된 공개 계약으로 취급합니다.
- 스킬 이름
tossinvest-web-api와.agents/skills/tossinvest-web-api설치 경로 SKILL.md,scripts/,references/,agents/를 포함한 설치 레이아웃- 문서화된 CLI 명령과 옵션, 로그인·계좌·주문을 제외하는 안전 경계
- Python 3.14.7 CI 호환성, HTTP 표준 라이브러리 실행, WebSocket 선택 의존성 잠금 파일
이 버전 정책은 이 저장소가 제공하는 인터페이스에 적용됩니다. 토스증권 웹 API와 WebSocket 채널은 여전히 비공식·미문서화 인터페이스이며 예고 없이 경로, 응답 필드, 접근 가능 여부가 바뀔 수 있습니다. 외부 응답 필드와 데이터 가용성은 하위 호환성 계약에 포함하지 않으며, 관찰된 변경은 API 카탈로그의 상태 표기와 릴리스 노트에 기록합니다.
2026-09-07부터 Python 3.14.7만 지원·검증하며 기존 Python 3.12 지원은 종료했습니다.
개발 및 문의
에이전트 작업 규칙은 SKILL.md에 있습니다. 수정 후 저장소 루트에서 테스트하고, 유지보수 안내의 검증 절차를 따르세요.
python3 -m pip install -r requirements-websocket.txt
python3 -B -m unittest discover -s tests
이 README는 main 기준이며, 릴리스 배지는 가장 최근에 발행한 버전을 가리킵니다.
특정 릴리스의 지원 환경은 해당 태그의 README를, 미출시 변경과 호환성 안내는 변경 이력을 확인하세요.
오류나 문서 개선은 Issues로 알려주세요. 쿠키·토큰·원본 HAR·계좌 정보는 공개 이슈에 올리지 마세요. 민감한 보안 제보는 SECURITY.md의 비공개 제보 절차를 따르세요.
라이선스
추천 도구
다른 키워드를 입력하거나 필터를 제거해 보세요.
설치
npx skillfish add dd3ok/tossinvest-api-skill