한국은행

한국은행 ECOS 경제통계

한국은행 경제통계정보시스템(ECOS)의 통계 시계열·통계표 목록·주요지표를 조회하는 공식 API. 기준금리·환율·GDP·소비자물가 등 거시경제 지표를 제공한다.

에이전트가 얻을 수 있는 정보

기준금리, 콜금리, KORIBOR, CD수익률, 환율(원/달러 등), GDP 성장률, 소비자물가지수(CPI), 산업생산, 소매판매, 주택가격지수 등 경제통계 시계열
경제 분석, 투자 의사결정, 물가·금리 추이 파악, 거시경제 리포트 작성, 환율 예측

활용 사례

기준금리 변동 추이 조회
환율 시계열 분석
소비자물가 상승률 확인
GDP 성장률 추이
통계표 검색 및 주요지표 확인

등록 API (3)

통계 시계열 조회 StatisticSearch

통계표코드+주기+기간으로 시계열 데이터 조회

stat_code 필수 — 통계표코드 예: 901Y009
cycle 필수 — 주기 (A=연, Q=분기, M=월, D=일) 예: D
start_dt 필수 — 검색시작일 예: 20260101
end_dt 필수 — 검색종료일 예: 20261010

출력: STAT_CODE(통계표코드), STAT_NAME, ITEM_CODE1/2/3(항목코드), ITEM_NAME1/2/3, TIME(시점), DATA_VALUE(값)

호출 한도: 일 10,000회 (ECOS 포털 기준)

통계표 목록 조회 StatisticTableList

통계표 검색 및 코드 확인

출력: 통계표 목록 (STAT_CODE, STAT_NAME, 주기, 분류 등)

호출 한도: 일 10,000회

100대 주요지표 KeyStatisticList

기준금리·환율·GDP 등 핵심 경제지표 한눈에 조회

출력: 100대 주요 경제지표 (지표명, 값, 변동 등)

호출 한도: 일 10,000회

인증·비용·약관

인증 방식	인증키 — ECOS 포털에서 무료 발급. 프록시 서버에만 보관.
비용	무료
이용허락	공공데이터: 출처표시 필수
재배포	허용 (출처표시 필수)
약관 확인일	2026-10-10
활용신청	ECOS 포털 회원가입 → OpenAPI 인증키 신청 (자동승인) 포털 바로가기
운영 상태	pending_key
최종 확인일	2026-10-10

에이전트 호출 방법

우리 프록시를 통해 호출합니다. 헤더 X-Agent-Token이 필요합니다.

예시: POST /agencatalog/api/call {service:'ecos-bok', endpoint:'StatisticSearch', params:{stat_code:'901Y009', cycle:'D', start_dt:'20260101', end_dt:'20261010'}}

기계용 JSON 스키마

{
  "service": "ecos-bok",
  "name": "한국은행 ECOS 경제통계",
  "provider": "한국은행",
  "apis": [
    {
      "id": "StatisticSearch",
      "name": "통계 시계열 조회",
      "params": [
        {
          "name": "stat_code",
          "required": true,
          "example": "901Y009",
          "desc": "통계표코드"
        },
        {
          "name": "cycle",
          "required": true,
          "example": "D",
          "desc": "주기 (A=연, Q=분기, M=월, D=일)"
        },
        {
          "name": "start_dt",
          "required": true,
          "example": "20260101",
          "desc": "검색시작일"
        },
        {
          "name": "end_dt",
          "required": true,
          "example": "20261010",
          "desc": "검색종료일"
        }
      ]
    },
    {
      "id": "StatisticTableList",
      "name": "통계표 목록 조회",
      "params": []
    },
    {
      "id": "KeyStatisticList",
      "name": "100대 주요지표",
      "params": []
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "출처: 한국은행 경제통계정보시스템 ECOS(ecos.bok.or.kr)"
}

이용 시 주의사항

기관 API 키는 서버에만 보관됩니다. 직접 키를 요청하는 클라이언트는 이 경로를 사용할 수 없습니다.
기관별 일일 한도가 있습니다. 한도 초과 시 429를 반환하고 추가 호출을 차단합니다.
기관 API 장애·한도 초과 시 오류가 전달됩니다. 재시도 전에 응답의 error 필드를 확인하세요.
출처 표기: 출처: 한국은행 경제통계정보시스템 ECOS(ecos.bok.or.kr)

마지막 확인: 2026-10-10