한국은행 경제통계시스템 Open API 서비스(ecos.bok.or.kr)는 개발자·연구자를 위한 경제통계 데이터 제공 창구로, 인증키 발급·통계 조회·100대 지표 호출 기능을 제공합니다. 특히 통계표코드·주기·항목코드를 정확히 맞춰야 데이터가 조회되기 때문에 코드 사전 확인이 필요합니다.
한국은행 경제통계시스템 Open API 서비스(ecos.bok.or.kr)란? – 이런 경우 확인이 필요합니다
ECOS Open API는 한국은행 경제통계시스템(ECOS)에 있는 금리, 물가, 통화량, 환율, GDP 같은 통계를 프로그램으로 바로 받아올 수 있게 열어 둔 공식 데이터 서비스입니다. 웹 화면에서 엑셀로 내려받는 대신, 코드로 요청하면 최신 데이터를 XML이나 JSON 형식으로 받을 수 있습니다.
ECOS 웹사이트는 사람이 화면에서 조회하는 곳이고, Open API는 프로그램이 자동으로 가져가는 창구라는 점이 다릅니다. 아래와 같은 경우라면 Open API를 확인해 볼 필요가 있습니다.
- 기준금리, 소비자물가, 환율을 대시보드나 앱에 자동으로 반영하려는 경우
- 논문이나 보고서용으로 긴 기간의 시계열을 한 번에 수집하려는 경우
- 파이썬, R, 엑셀 등으로 정기적인 경제지표 리포트를 자동화하려는 경우
- 블로그·서비스에 주요 경제지표를 최신값으로 보여 주려는 경우
정리하면, 경제통계를 “한 번 보는 것”이 아니라 “반복해서 가져다 쓰는 것”이 목적일 때 필요한 서비스가 ECOS Open API입니다.
한국은행 ECOS Open API 주요 서비스 – 6가지 호출 기능
ECOS Open API는 목적별로 나뉜 여러 서비스를 제공하며, 보통 “목록 확인 → 항목 확인 → 데이터 조회” 순서로 함께 씁니다. 핵심 서비스는 다음과 같습니다.
- 서비스 통계 목록(StatisticTableList): 조회할 수 있는 통계표와 통계표코드를 확인합니다.
- 통계 세부항목 목록(StatisticItemList): 특정 통계표 안의 세부 항목코드와 제공 주기, 수록 기간을 확인합니다.
- 통계 조회 조건 설정(StatisticSearch): 통계표코드, 주기, 기간, 항목코드를 지정해 실제 데이터를 받아옵니다.
- 100대 통계지표(KeyStatisticList): 기준금리, 물가, 성장률 등 주요 지표의 최신값을 한 번에 가져옵니다.
- 통계용어사전(StatisticWord): 경제 용어의 설명을 검색합니다.
- 통계메타DB(StatisticMeta): 통계의 작성 방법, 출처 같은 메타정보를 확인합니다.
실제 업무에서는 StatisticSearch가 핵심이고, 나머지는 필요한 코드를 찾거나 설명을 붙이는 보조 역할을 한다고 보면 됩니다.
한국은행 경제통계시스템 Open API 서비스 바로가기 + 이용 방법 (2026)
👉 한국은행 경제통계시스템 Open API 서비스 바로가기
처음 이용한다면 인증키를 받은 뒤, 코드를 찾아 요청 URL을 만드는 순서로 진행합니다.
1단계 – 회원가입과 인증키 신청. Open API 서비스 페이지에서 회원가입 후 인증키를 신청합니다. 신청 시 이용 목적 등을 입력하며, 발급 후 실제 호출이 가능해지기까지 약간의 시간이 걸릴 수 있습니다.
2단계 – 개발 명세서 확인. 서비스별 개발 가이드에서 요청 인자 순서와 출력 항목을 확인합니다. 인자 순서가 하나만 틀려도 결과가 나오지 않으므로 이 단계가 중요합니다.
3단계 – 통계표코드·항목코드 찾기. 통계 목록과 세부항목 목록 서비스로 원하는 통계의 통계표코드와 항목코드, 제공 주기를 확인합니다. ECOS 웹 화면에서 통계를 조회해 코드를 먼저 확인하는 방법도 편합니다.
4단계 – 요청 URL 만들기. Open API 기본 주소 뒤에 서비스명, 인증키, 요청 형식(json/xml), 언어(kr/en), 조회 시작·끝 건수, 통계표코드, 주기, 시작일, 종료일, 항목코드 순서로 경로를 이어 붙입니다.
/api/StatisticSearch/{인증키}/json/kr/1/100/{통계표코드}/{주기}/{시작일}/{종료일}/{항목코드}
5단계 – 주기에 맞는 날짜 형식 입력. 주기가 연(A)이면 YYYY, 분기(Q)면 2025Q1처럼 YYYYQn, 월(M)이면 YYYYMM, 일(D)이면 YYYYMMDD 형식으로 입력합니다.
6단계 – 결과 확인과 반복 호출. 응답에서 시점, 항목명, 값, 단위를 확인하고, 건수가 많으면 조회 시작·끝 건수를 나눠 여러 번 요청합니다.
결국 “인증키 발급 → 명세서 확인 → 코드 찾기 → URL 구성 → 날짜 형식 맞추기” 순서만 지키면 대부분의 통계를 문제없이 받아올 수 있습니다.
한국은행 ECOS Open API 자주 하는 실수 – 데이터가 안 나올 때 점검할 것
ECOS Open API에서 “데이터가 없다”는 응답이 나오는 원인은 대부분 요청 값의 작은 실수입니다. 자주 생기는 문제는 다음과 같습니다.
- 주기와 날짜 형식 불일치: 월 주기(M)에 20250101처럼 일 단위 날짜를 넣거나, 분기 형식을 잘못 쓰면 결과가 나오지 않습니다.
- 통계가 제공하지 않는 주기 요청: 월별로만 작성되는 통계를 일 주기로 요청하면 조회되지 않으므로, 세부항목 목록에서 제공 주기를 먼저 확인해야 합니다.
- 항목코드 누락·오타: 여러 항목이 있는 통계표는 항목코드를 정확히 지정해야 원하는 계열만 받을 수 있습니다.
- 수록 기간 밖의 날짜 요청: 통계가 작성되기 전 시점이나 아직 발표되지 않은 시점을 넣으면 빈 결과가 나옵니다.
- 샘플 키로 계속 테스트: 샘플 인증키는 조회 건수가 제한돼 있어 실제 수집에는 발급받은 본인 키를 써야 합니다.
- 인증키 코드 노출: 공개 저장소나 프런트엔드 코드에 인증키를 그대로 넣으면 타인에게 도용될 수 있습니다.
특히 통계 개편이나 기준년 변경이 있으면 통계표코드가 바뀌기도 하므로, 오래된 코드를 그대로 쓰기 전에 통계 목록에서 현재 코드를 다시 확인하는 습관이 가장 중요합니다.
한국은행 ECOS Open API 활용 팁 – 수집을 효율적으로 하는 법
ECOS Open API는 몇 가지 요령만 알면 훨씬 적은 호출로 필요한 데이터를 모을 수 있습니다.
- 최신값은 100대 지표로: 주요 지표의 현재 수치만 필요하다면 통계별로 따로 호출하기보다 100대 통계지표 서비스 한 번으로 가져오는 편이 효율적입니다.
- 코드는 웹에서 먼저 확인: ECOS 웹 화면에서 원하는 통계를 조회한 뒤 코드와 항목을 확인하고 API로 옮기면 시행착오가 줄어듭니다.
- 긴 기간은 나눠서 요청: 일별 데이터처럼 건수가 많은 경우 조회 건수나 기간을 나눠 반복 호출하는 방식이 안정적입니다.
- 인증키는 환경 변수로 관리: 코드에 직접 쓰지 말고 환경 변수나 설정 파일로 분리하면 보안과 유지보수가 쉬워집니다.
- 오픈소스 라이브러리 활용: 파이썬과 R에는 ECOS Open API를 감싼 라이브러리가 공개돼 있어, 요청 URL을 직접 만들지 않고도 데이터를 표 형태로 받을 수 있습니다.
- 발표 일정에 맞춰 갱신: 통계마다 발표 주기가 다르므로, 매번 전체를 다시 받기보다 최근 구간만 갱신하면 호출 수를 아낄 수 있습니다.
한마디로, 코드 사전 확인·요청 분할·인증키 분리 관리 세 가지만 지키면 ECOS Open API를 가장 효율적으로 활용할 수 있습니다.
한국은행 ECOS Open API 자주 묻는 질문(FAQ)
Q1. ECOS Open API 이용료가 있나요?
ECOS Open API는 회원가입 후 인증키를 발급받아 무료로 이용하는 방식입니다. 다만 한국은행 이용약관에 활용 조건과 책임 사항이 정해져 있으니, 서비스에 데이터를 활용한다면 약관을 먼저 확인하는 것이 좋습니다.
Q2. 인증키를 받았는데 바로 호출이 안 돼요.
발급 직후에는 인증키가 시스템에 반영되기까지 시간이 걸릴 수 있습니다. 잠시 후 다시 시도하고, 계속 오류가 나면 인증키를 정확히 복사했는지와 요청 URL의 인자 순서를 확인하세요.
Q3. 원하는 통계의 통계표코드는 어떻게 찾나요?
서비스 통계 목록(StatisticTableList)으로 전체 통계표와 코드를 확인할 수 있고, 세부 항목은 통계 세부항목 목록(StatisticItemList)으로 조회합니다. ECOS 웹사이트에서 통계를 검색해 코드를 확인하는 방법도 많이 씁니다.
Q4. “해당하는 데이터가 없습니다”라는 결과가 나와요.
대부분 주기와 날짜 형식이 맞지 않거나, 통계가 제공하지 않는 주기·기간을 요청한 경우입니다. 세부항목 목록에서 제공 주기와 수록 기간을 확인한 뒤 날짜 형식을 다시 맞춰 요청하세요.
Q5. 파이썬이나 R로도 쉽게 쓸 수 있나요?
요청 URL을 직접 만들어 호출할 수도 있고, 공개된 오픈소스 라이브러리를 쓰면 통계표 검색부터 데이터프레임 변환까지 간단히 처리할 수 있습니다. 어떤 방식이든 본인이 발급받은 인증키는 반드시 필요합니다.