{"repo":"unohee/kis-agent","free":true,"listed":false,"github":"https://github.com/unohee/kis-agent","clone":"git clone https://github.com/unohee/kis-agent.git","description":"한국투자증권 OpenAPI Python 래퍼 — CLI · Python SDK · LLM Agent · 실시간 WebSocket. 문서: unohee.github.io/kis-agent","language":"Python","stars":50,"topics":["async","cli","llm-agent","openapi","python","stock-trading","websocket","korea-investment-securities","automated-trading","mcp-server"],"license":null,"category":"ai-agents","readme_excerpt":"KIS-Agent 한국투자증권 OpenAPI Python 래퍼 - Korea Investment & Securities Trading API Client 📖 공식 문서: unohee.github.io/kis-agent — 설치, 빠른 시작, 모의투자, CLI · Python API 레퍼런스, LLM Agent · MCP 연동, 아키텍처 가이드. CLI pip install kis-agent 하면 kis 명령이 바로 설치됩니다. - JSON 출력 (LLM 파싱 최적화), --pretty 로 사람 읽기용 - 한투 필드명 자동 변환: stck prpr → currentPrice , prdy ctrt → changeRate - 휴장일/장외 시간 자동 감지 — 직전 영업일 기준 데이터 안내 주요 특징 - CLI 도구 : 설치 즉시 터미널에서 시세 조회 - LLM Agent 연동 : JSON 출력 + 스키마 탐색으로 AI 에이전트 도구로 활용 - 고성능 : 지능형 캐싱으로 API 호출 80-95% 감소 - 안정성 : 실측 기반 Rate Limiting (18 RPS / 900 RPM) - 실시간 : WebSocket을 통한 실시간 데이터 스트리밍 - 국내시장 : KOSPI, KOSDAQ, NXT(넥스트) 시장 지원 - 해외시장 : 미국, 일본, 중국, 홍콩, 베트남 9개 거래소 지원 - 선물옵션 : 국내/해외 선물옵션 거래 지원 - 타입 안정성 : 96개 TypedDict 응답 모델, 100% 타입힌팅 설치 WebSocket, aiohttp, openpyxl은 기본 의존성에 포함되어 별도 설치가 불필요합니다. 사전 준비 1. 한국투자증권 API 포털에서 API 신청 2. APP KEY와 APP SECRET 발급 3. 계좌번호(CANO)와 계좌상품코드(ACNT PRDT CD) 확인 4. .env 파일 설정 ( .env.example 를 복사하여 사용): 모의투자 paper=True 로 Agent를 만들면 모의투자 URL과 모의투자 전용 TR ID가 자동 적용됩니다. 모의투자 APP KEY/SECRET/계좌번호는 실전과 별도로 발급받아야 합니다. CLI는 .env 의 KIS PAPER=1 만 설정하면 됩니다: 모의투자 미지원 API : KIS는 전체 336개 API 중 43개만 모의투자로 제공합니다. 해외선물옵션·장내채권·순위/투자자동향·재무 등은 모의투자에서 쓸 수 없습니다. 미지원 API를 모의투자로 호출하면 PaperTradingNotSupportedError 가 발생합니다. 지원 목록은 kis agent/core/tr mapping.py 의 REAL TO PAPER TR 를 참고하세요. 자세한 내용은 모의투자 가이드를 참고하세요. v1.8.0 Breaking change : 환경변수 이름이 KIS prefix로 통일되었습니다. 이전 별칭( MY APP , MY SEC , KIS SECRET , MY ACCT STOCK , MY PROD , PROD URL , VPS URL , MY AGENT )은 더 이상 인식되지 않습니다. 사용 중인 .en","default_branch":null,"files":null,"tree":[],"storefront":"/r/unohee","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/unohee/kis-agent/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}