KRX OPEN API 활용하여 주식정보 가져오기-STEP3

STEP1 다시보기 : https://yeolco.tistory.com/224

STEP2 다시보기 : https://yeolco.tistory.com/225

 

KRX Open API(openapi.krx.co.kr)를 활용하여 특정 주식의 상세 정보를 가져오는 방법을 가이드해 드립니다. 현재 2026년 5월 6일 기준으로 유효한 단계별 절차와 구현 방식입니다.

---

1. 호출을 위한 필수 파라미터 확인

특정 종목의 정보를 가져오기 위해서는 KRX API 명세에 따라 다음과 같은 핵심 파라미터가 필요합니다.

• 인증키 (serviceKey): KRX 포털에서 발급받은 본인만의 고유 키.
• 종목코드 (isuCd): 조회하고자 하는 특정 주식의 코드 (예: 삼성전자 005930).
• 조회 일자 (basDd): 데이터를 가져올 기준 날짜 (예: 20260506).

---

2. Python 활용 실전 예제

가장 직관적인 Python의 requests 라이브러리를 사용한 예제입니다.

Python

 

import requests

def get_stock_info(isu_cd):
    # KRX 주식 시세 조회 엔드포인트 (명세서에 따라 변경 가능)
    url = "http://openapi.krx.co.kr/api/service/rest/Sise/getSise" 
    
    params = {
        'serviceKey': '본인의_인증키_입력', #
        'isuCd': isu_cd,              #
        'basDd': '20260506'           #
    }

    try:
        response = requests.get(url, params=params)
        if response.status_code == 200:
            data = response.json() #
            return data
    except Exception as e:
        print(f"Error: {e}")
        return None

# 삼성전자 종목 정보 호출
stock_data = get_stock_info("005930")
print(stock_data)

---

3. Java (Spring Boot) 활용 구조

진행 중인 Java 기반 프로젝트에 적용할 때 권장되는 구조입니다.

• RestTemplate 또는 WebClient 사용: 외부 API인 KRX 서버와 통신하기 위해 사용합니다.
• 보안 관리: 인증키(serviceKey)는 소스 코드에 직접 노출하지 말고, application.yml 파일이나 환경 변수로 관리하는 것이 보안상 안전합니다.
• 데이터 파싱: 응답받은 JSON 데이터를 전용 DTO(Data Transfer Object) 클래스로 매핑하여 필요한 정보(현재가, 등락률 등)만 추출합니다.

---

💡 활용 팁

• 일일 한도: KRX API는 사용자 등급에 따라 일일 호출 횟수가 제한되어 있으므로 불필요한 중복 호출을 피해야 합니다.
• 에러 처리: 시장 휴장일(토요일, 일요일, 공휴일)에는 해당 날짜로 데이터를 요청하면 빈 값이 올 수 있으므로, 최근 거래일 데이터를 가져오도록 예외 처리가 필요합니다.

포스팅용으로 특정 상장 기업의 실시간 지표를 웹에 띄우고 싶으시다면, 위 로직을 백엔드에서 처리한 후 프론트엔드로 데이터를 넘겨주는 방식으로 구현하시면 됩니다.