기술과 산업/AI
분야별 데이터 수집 전략 가이드 시리즈 - 5화. 한국은행 ECOS API로 경제지표 시계열 데이터 수집과 분석하는 방법
B컷개발자
2025. 5. 12. 20:52
728x90
메타 설명: 한국은행 ECOS API를 통해 금리, 환율, 물가 등 주요 경제 지표 데이터를 시계열로 수집하고 Python으로 분석 및 시각화하는 전략을 소개합니다.
한국은행 ECOS란?
한국은행 ECOS는 우리나라의 금융·경제 지표를 한눈에 확인할 수 있는 통계 데이터 서비스입니다.
특히 Open API를 통한 경제 지표 시계열 데이터 수집 기능이 제공되어, 데이터 분석, 리포트 자동화, 투자 리서치 등 실무에 매우 유용합니다.
ECOS API 활용 시 기대 효과
- 금리, 환율, 주식, 물가, 산업생산지수 등 4,000개 이상의 시계열 통계 제공
- 데이터 품질이 높은 공식 지표
- 매일, 매월 자동 갱신되는 최신 데이터
ECOS API 주요 제공 지표 예시
지표 코드 예시 설명
기준금리 | 060Y001 | 한국은행 기준금리 |
소비자물가지수 | 901Y010 | 전년 동월 대비 상승률 |
원/달러 환율 | 036Y001 | 미국 달러 환율 |
M2 통화량 | 722Y001 | 광의통화 지표 |
전체 코드 리스트는 ECOS 통계표 코드 검색에서 확인 가능
🔧 API Key 발급 및 구조
- 한국은행 ECOS 개발자센터 회원가입
- 'Open API Key 발급' 메뉴에서 무료 발급
- 요청 URL 예시
https://ecos.bok.or.kr/api/인증키/json/StatisticSearch/1/100/통계표코드/주기/시작일/종료일/통화/항목
- 통계표코드: 원하는 경제 지표 코드
- 주기: D(일), M(월), Q(분기), A(연)
- 시작일, 종료일: 예) 20240101, 20240501
🧪 Python 실전 예제: 기준금리 시계열 데이터 수집
1. 필요한 라이브러리
pip install requests pandas matplotlib
2. Python 코드
import requests
import pandas as pd
import matplotlib.pyplot as plt
API_KEY = 'YOUR_API_KEY'
STAT_CODE = '060Y001' # 한국은행 기준금리
url = f'https://ecos.bok.or.kr/api/{API_KEY}/json/StatisticSearch/1/100/{STAT_CODE}/M/20200101/20240501/'
response = requests.get(url)
data = response.json()['StatisticSearch']['row']
# DataFrame 변환
df = pd.DataFrame(data)
df = df[['TIME', 'DATA_VALUE']].rename(columns={'TIME': '날짜', 'DATA_VALUE': '기준금리'})
df['날짜'] = pd.to_datetime(df['날짜'], format='%Y%m')
df['기준금리'] = df['기준금리'].astype(float)
print(df.head())
# 시계열 그래프
plt.figure(figsize=(10,5))
plt.plot(df['날짜'], df['기준금리'], marker='o')
plt.title("한국은행 기준금리 변화 (2020~2025)")
plt.xlabel("날짜")
plt.ylabel("기준금리 (%)")
plt.grid(True)
plt.show()
📝 결과: 2020년부터 2025년까지 한국은행 기준금리 변화 그래프를 자동으로 생성
📊 추가 분석 아이디어
환율 + 금리 동시 비교 분석
- 원/달러 환율 코드(036Y001) + 기준금리 동시 호출
- Pandas Merge로 데이터프레임 통합
- 이중축 그래프로 상관관계 시각화
통화량 (M2)와 증시 연동성 분석
- M2 통화량 데이터(722Y001) 호출
- 국내 증시 지수 데이터와 함께 월별 추세 비교
소비자물가 상승률 추이 분석
- 소비자물가지수(901Y010)로 전년 대비 물가 상승률 분석
⚙️ 실무 활용 시 주의사항
항목 설명
API 호출 제한 | 월 최대 10,000건 (개인/기관 별도) |
주기 설정 | D(일간), M(월간), Q(분기), A(연간) 선택 가능 |
데이터 공백 | 일부 지표는 최근 데이터가 누락될 수 있음 |
시간 형식 | YYYYMM, YYYYQ, YYYY 형태로 응답 |
실무 활용 시나리오 예시
분야 적용 방식
투자 분석 | 금리/환율 동시 시계열 비교 |
정책 연구 | 통화량 + 물가 변화 관계 분석 |
블로그/미디어 | 최신 경제 트렌드 리포트 자동화 |
기업 경영 | 환율/금리 데이터로 글로벌 사업 리스크 분석 |
다음 회차 예고 – 통계청 KOSIS에서 인구·사회 통계 시계열 수집하기
6화에서는 **통계청 KOSIS 포털(kosis.kr)**에서
지역별 인구, 출생률, 고령화 지표 등을 시계열로 수집하고 Python으로 자동 분석하는 전략을 안내드립니다.
728x90