KIS (KR) 모의투자

ExchangeKeyTabs의 세 번째 탭(rose). 한국투자증권 OpenAPI 키를 등록합니다.

📸 KIS 키 등록 폼 (추후 자동 캡처 예정)

모의투자 강제

현재는 모든 신규 KIS 키가 모의투자(paper) 모드로 등록됩니다. 라이브 활성은 P4-01에서 도입됩니다.

필수 입력 (4개)

KIS는 다른 broker와 달리 계좌번호가 추가로 필요합니다.

필드	설명	예시
App Key	OpenAPI 발급	text
App Secret	OpenAPI 발급	password
Account Number (CANO)	계좌번호 8자리 (또는 8+2)	12345678 또는 1234567890
Product Code	상품 코드 2자리	01 (현금) / 29 (모의 해외주식)
Label	사용자 식별	기본 kis-paper

CANO를 10자리로 입력하면 서버가 자동으로 8+2로 분할합니다.

Product Code 가이드

코드	의미
01	일반 위탁 (실거래)
02	신용
04	선물옵션
22	해외주식 위탁
29	모의투자 해외주식 (현재 권장)

Test Connection 버튼

KIS는 토큰 발급 → GET /uapi/domestic-stock/v1/trading/inquire-account-balance로 검증합니다. 토큰 발급 자체에서 실패하면 즉시 에러를 반환합니다.

API 호출

curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  http://localhost:8000/api/exchange-keys \
  -d '{
    "asset_class": "kr_equity",
    "exchange": "kis",
    "api_key": "PSxxxxxxxxx",
    "api_secret": "xxx",
    "account_no": "12345678",
    "account_product_code": "29",
    "paper_mode": true,
    "label": "kis-paper"
  }'

토큰 만료

KIS 토큰은 24시간 후 만료됩니다. quant-ai는 자동 재발급을 시도하며, 실패 시 401 에러가 발생합니다.

자세한 트러블슈팅: KIS 토큰 만료

절대 룰

모의투자 only

현재 빌드에서 KR Equity는 모의투자만 지원합니다. 실거래 활성화 시 별도 PR + 리스크 검증이 필요합니다.

자주 묻는 질문

Q. CANO 8자리에 dash나 공백이 들어가도 되나요?
A. 숫자만 입력하세요. 다른 문자는 422 에러를 발생시킵니다.

Q. 모의투자 계좌는 어떻게 만드나요?
A. 한국투자증권 모바일/웹에서 모의투자 신청 → OpenAPI 신청 → app_key/app_secret 발급.

Q. Product code 02 (신용) 등록 시 위험?
A. 신용 거래는 손실이 예치금을 초과할 수 있습니다. 본 시스템은 02 코드 사용을 권장하지 않습니다.

Q. 야간(휴장 시간)에 키 등록은 가능?
A. 네. Test 버튼은 토큰만 발급하므로 시장이 닫혀 있어도 검증됩니다.

관련 페이지

• Crypto 키
• Alpaca 키
• KIS 토큰 만료 트러블슈팅