한국 주식 API 생태계 완전 가이드 (2025년 12월 최신판)

 

안녕하세요! 오늘은 한국에서 제공되는 다양한 증권 관련 API에 대해 상세히 소개해드리려고 합니다.

API는 애플리케이션 프로그램 인터페이스(Application Programming Interface)의 약자로, 프로그램 간 상호작용을 가능하게 하는 인터페이스입니다. 특히 금융 및 증권 분야에서는 실시간 데이터 조회, 주식 거래, 투자 정보 제공 등의 핵심 기능을 담당하고 있습니다.

 

 

 

---

한국 주식 API 생태계 완전 가이드 (월별 현행화판 · 2025.12.05)

“API 연동은 지금 잘 되는가가 전부입니다.”
이번 판은 NXT(넥스트레이드) 월초 유니버스 변동, KIS 레이트리밋 확대 & TLS 정책, 키움 REST 금현물 거래, LS Open API TR/유량 이슈, 국내 휴장 캘린더까지 한 번에 정리했어요.

---

🗓️ 2025년 12월 업데이트 하이라이트 (12/5 KST)

• NXT(넥스트레이드): 11/5에 추가 20종 제외가 시행되면서(8/20 → 9/1 → 9/22 → 11/5 순차 조치) 월초마다 거래가능 종목(유니버스) 변동이 커졌습니다. → 월초 자동 재빌드를 기본 루틴으로!
• KIS Developers: 9/30 ‘Open API 유량 확대’ 이후, 11/25 REST의 TLS 1.0/1.1 미지원 공지가 추가됐어요. 운영 서버·프록시·에이전트의 TLS 정책을 1.2 이상으로 고정했는지 꼭 점검하세요.
• 키움증권 REST: KRX 금시장 거래 API 오픈(9/19) — 전용 계좌/약관 동의 필요, 금 비중 자동 리밸런싱·헤지 전략에 유용.
• LS증권 Open API: t1702 변경(8/21), t8456(야간파생) 필드 추가(8/21), TR 유량변경(11/5) 공지 재확인 → 스키마·유량 회귀 테스트를 CI에 고정!
• 12월 휴장(국내): 12/25(성탄), 12/31(연말) — 일괄주문/리밸런싱/리포트 잡 스킵 플래그로 미리 조정하세요.

---

🗓️ 2025년 11월 업데이트 하이라이트 (11월 말 KST)

• NXT — 20종 추가 제외(11/3 공지 라운드)
  규정(‘6개월 평균 15% 룰’) 준수를 위해 월초 유니버스 변동이 반복됩니다. 1~3일 자동 크롤링 → 유니버스 재빌드 → 전략 필터 재적용을 의무화하면 안정적이에요.
• KIS — 12월 유량 확대 예고 + TLS 정책 공지
  유량 확대(9/30) 후속으로 11/25 TLS 1.0/1.1 중단. 피크 시간엔 WS 실시간 + REST 배치 혼합으로 429/버스트를 줄이세요.
• 키움 REST — 금시장 주문 가능(9월 오픈, 11월 변경 없음)
  금 현물은 전용 계좌/약관 동의가 선행 조건. 변동성 임계치↑ 시 금 비중 자동 상향 같은 분산/헤지 시나리오에 적합.
• LS Open API — TR 스펙/유량 공지 재확인
  8/21(스펙), 11/5(유량) 공지 기준. 스키마 스냅샷→Diff→회귀 테스트를 배포 게이트로 묶으면 야간/휴일 이슈에 강합니다.

---

🗓️ 2025년 10월 업데이트 하이라이트 (10/3 KST)

핵심 한 줄 요약: NXT ‘15%룰’ 첫 점검 준수(≈14.7%), KIS 유량 확대 시범(9/30), 키움 REST 금현물(9/19), LS TR 변경 재확인, KB 핀테크스토어 공지, ECOS(한국은행) 10/5 작업 예고.

• NXT: 출범 후 첫 6개월 점검에서 **약 14.7%**로 ‘15%룰’ 준수 확인. 월초 공지에 맞춰 거래가능 종목 동적 관리를 습관화하세요.
• KIS: 9/30 ‘유량 확대’ — 피크 구간 호출 예산 재배분(WS 실시간 + REST 배치 혼용) 추천.
• 키움 REST: KRX 금현물 거래 API 오픈(9/19) — 분산/리스크 관리에 실물 채널 추가.
• LS Open API: t1702 변경 / t8456(야간파생) 필드 추가 재확인 → TR 매핑 회귀 테스트 CI 고정.
• KB 핀테크스토어: 오픈API 종료(9/5), 동의 해지 협조(8/5), 미사용 API 정리(9/24) 공지.
• ECOS(한국은행): 10/5(일) 작업 — 주말 배치 재시도·백오프 켜두기.

---

🗂️ (보관) 2025년 9월 업데이트 핵심

• NXT: 9/1–9/30 총 53개 종목 정규·종가매매 제외(‘15%룰’ 준수 목적) — 시장별 가용 종목 필터 필수.
• 키움 REST: 공식 REST/WS 포털 정식 운영.
• KIS: 8/7 유량 안내 재확인.
• LS: t1702 TR 변경(8/29 16:00).
• KB: 동의 해지 협조(8/5), 자문주문 issueNo 보안 강화(7/14).

---

1) 증권사별 트레이딩·시세 API 상세 분석

1-1. 한국투자증권 KIS Developers (1순위 추천)

• 포털: https://apiportal.koreainvestment.com
• 장점: REST/WS 동시 지원, 샌드박스/문서/오류코드 정리 우수, 레이트리밋 문서 명확
• 운영 이슈
  • 9/30 ‘Open API 유량 확대’ 공지: 피크 시간대 호출 예산을 WS+REST 혼합으로 재배분.
  • 11/25 ‘REST TLS 1.0/1.1 미지원’: 런타임/프록시 TLS 정책을 **1.2+**로 고정.
• 레이트리밋 토큰버킷(예시)

class KISRateLimiter:
    def __init__(self, calls_per_min):
        self.limit = calls_per_min; self.tokens = calls_per_min; self.updated = time.time()
    def allow(self):
        now = time.time(); refill = int((now - self.updated) * (self.limit / 60))
        if refill: self.tokens = min(self.limit, self.tokens + refill); self.updated = now
        if self.tokens > 0: self.tokens -= 1; return True
        return False

• 팁: 429/5xx는 지수 백오프 + 서킷 브레이커, “유량 표/공지”는 대시보드 고정 링크.

---

1-2. 키움증권 OpenAPI+ / REST API (★ 2025 신설)

• 포털: https://developers.kiwoom.com
• 새로운 점: 공식 REST/WS 포털 정식 운영, KRX 금시장 거래 API 오픈(9/19) — 전용 계좌·약관 동의 필요.
• 환경: OpenAPI+(Windows·32bit), REST(크로스플랫폼), 서버 IP 화이트리스트 필수 → IaC로 자동 반영 추천.
• 추천 순서: 포털 가입/인증 → 샌드박스/실계좌 분리 → 조건검색/차트 → 주문·체결(WS) → 리스크 가드(체결캡·슬리피지 한도)

---

1-3. LS증권(구 이베스트) OPEN API

• 포털: https://openapi.ls-sec.co.kr
• 최근 공지: t1702 변경, t8456(야간파생) 필드 추가, TR 유량변경 — TR 의존 로직은 스키마 스냅샷→Diff→회귀 테스트 파이프라인 필수.
• 운영 포인트: 야간세션/휴일 이벤트 핸들링을 KRX 휴일 캘린더와 묶어 예외감소.

---

1-4. 대신증권 CYBOS Plus

• Windows 전용(32bit) — 개인 퀀트/시뮬 학습에 적합, 자료 풍부.

1-5. NH투자증권 API

• 인증→조회→주문 플로우 명확, 기본 기능 충실(시세/잔고/주문).

1-6. 삼성증권 API

• 주문 API는 제한적. 조회/연계는 표준 경로 + 주문은 오픈API 제공 브로커 혼합 구성 추천.

1-7. KB증권 핀테크스토어

• 포털: https://store.kbsec.com
• 운영 공지: 오픈API 종료(9/5), 동의 해지(8/5), 미사용 API 정리(9/24) — 권한·동의 라이프사이클 주기 점검(만료 7일 전 알림 + 재동의 링크).

---

2) 공공·거래소·거시 API

2-1. DART OpenAPI (필수)

• 포털: https://dart.fss.go.kr
• 상장사 공시/재무 머신리더블 제공 — 분기 시즌 스파이크 대비 큐·캐시 설계.

2-2. KRX 관련 오픈데이터(공공데이터포털)

• 포털: https://data.go.kr
• 집계 중심(실시간 틱/체결 미제공) — 리서치·백테스트 용도에 적합.

2-3. ECOS(한국은행) Open API

• 포털: https://ecos.bok.or.kr
• 10/5 작업 공지 이후 안정 — 주말 배치는 재시도·백오프·캐시 폴백을 기본값으로.

---

3) ATS 시대: NXT(넥스트레이드) 실무 가이드

3-1. 기본 이해(시간·구조)

• 거래시간 12시간(08:00–20:00) — 프리 08:00–08:50, 애프터 15:40–20:00(일부 문서 15:30 표기 있으나 공식 기준 15:40 시작).
• 수수료: KRX 대비 20~40% 낮음 → SOR(최선집행)에 유리.

3-2. 10~12월 포인트(‘15%룰’ & 한도관리)

• 9월 말 첫 6개월 점검 **≈14.7%**로 룰 준수(10/1~2 보도). 이어 11/5 20종 추가 제외 등 월초 단위 한도관리가 반복 → 월초(1~3일) 공지 크롤링 → 유니버스 재빌드는 필수.

3-3. 실무 설계 체크리스트

• 시장별 가용성 모델링: tradable_on = {KRX, NXT} + 월별 스냅샷(nxt_tradables_YYYYMM.json) 저장(백테스트 재현성↑)
• 세션 분리 지표: 프리/정규/애프터별 체결·슬리피지 KPI 분리
• 휴일/단일가 분기: 개장·종가 단일가에선 NXT 일시 정지 로직

---

4) 포털/뉴스·검색 API — 오해 방지

• 네이버/다음: 공식 시세 API 없음(뉴스/검색/데이터랩 위주). 무단 크롤링은 약관·지속성 리스크.
• TradingView: 차트 UI 라이브러리이며, 데이터는 증권사/데이터사에서 별도 공급.

---

5) 12월 운영 체크리스트(업데이트판)

• NXT 공지 크롤링(월초) → 종목 스냅샷 저장 → 유니버스 재빌드(전략 필터 재적용)
• KIS: 유량 확대 반영 + TLS 1.2+ 강제(레거시 프록시/런타임 점검)
• 키움 REST 금현물: 모의→소액→본계좌 단계 적용, 수수료·경매체결 튜닝
• LS: TR 스키마·유량 변경 시 Diff 실패 → 배포 차단(CI 게이트)
• 휴장 캘린더: 12/25, 12/31 스킵 플래그 — 리밸런싱/리포트 잡 조정

---

6) 자주 묻는 질문(FAQ)

Q1. 실시간 주가 데이터는 어디서 받나요?
A. 공공데이터는 집계 중심입니다. 증권사 WebSocket(KIS/키움/LS 등)이나 코스콤 실시간 피드를 사용하세요.

Q2. NXT 애프터마켓은 15:30 or 15:40?
A. 자료마다 표기가 다르지만, 공식 기준 15:40~20:00이에요. (KRX 종가 단일가 이후 10분 갭)

Q3. KIS ‘유량 확대’와 ‘TLS 공지’는 꼭 반영해야 하나요?
A. 네. 피크 시간대 분산(WS+REST)과 TLS 1.2+ 강제는 연결 실패/429 방지에 직결됩니다.

Q4. 키움 REST 금현물은 언제 유용하죠?
A. 변동성 임계 시 금 비중 자동 상향, 배당월 현금유입에 맞춘 리밸런싱 등 분산/헤지에 좋아요. (전용 계좌·약관 필수)

---

마무리 🙌

이번 달은 가용성(월초 NXT 유니버스) · 보안(KIS TLS) · 운영 캘린더(12/25, 12/31) 3가지만 챙겨도 야근이 크게 줄어듭니다.
원하면 이 글을 섹션 분리 버전(브로커 API편/거시·공시편)이나, 운영 코드 스니펫(유니버스 크롤러/레이트리밋 대시보드)까지 덧붙여 줄게요.

---

참고·출처

• NXT ‘15%룰’ 준수(약 14.7%) 보도(10/1~2) (다음)
• NXT 시간·수수료(공식/영문), 애프터마켓 15:40~20:00(공식 사이트) (넥스트레이드)
• KIS Developers 공지: Open API 유량 확대 시범(9/30) (한국투자증권)
• 키움증권 REST: KRX 금현물 거래 API 오픈(9/19) (한국경제)
• LS증권 Open API 공지(8/21): t1702 변경, t8456 필드 추가 (openapi.ls-sec.co.kr)
• KB증권 핀테크스토어 공지: 종료 일정(9/5), 동의 해지(8/5), 미사용 API 정리(9/24) (store.kbsec.com)
• ECOS Open API: 10/5 작업 안내 (경제통계포털)
• KRX 휴장(10/3·개천절) 안내 캘린더 (Calendar Labs)

---