ECOS 한국은행 경제통계 서비스 사용 가이드 한국은행 에서 제공하는 경제통계 오픈 API 서비스를 이용하려면 인증키가 필요합니다. 인증키를 얻기 위해서는 한국은행 Open API 서비스 에 회원가입해야 합니다. 가입과 동시에 인증키가 자동으로 부여되며 일반적으로 1일 이내에 API 호출이 가능합니다.
항목명
설명
샘플데이터
항목구분
통계표코드
통계표코드
102Y004
선택
translate
국문 컬럼명 여부 (기본값: True)
True
선택
항목명(국문)
항목명(영문)
항목설명
샘플데이터
상위통계표코드
P_STAT_CODE
상위통계표코드
442
통계표코드
STAT_CODE
통계표코드
102Y004
통계명
STAT_NAME
통계명
1.1.1.1.2. 본원통화 구성내역(평잔, 원계열)
주기
CYCLE
주기(년, 분기, 월)
M
검색가능여부
SRCH_YN
검색가능여부
Y
출처
ORG_NAME
출처
한국은행
from PublicDataReader import Ecos
service_key = "API 인증키"
api = Ecos (service_key )
df = api .get_statistic_table_list ()
df .head ()
상위통계표코드
통계표코드
통계명
시점
검색가능여부
출처
0
*
0000000001
1. 통화/금융
None
N
None
1
0000000001
0000000002
1.1. 통화/유동성
None
N
None
2
0000000002
0000000003
1.1.1. 본원통화
None
N
None
3
0000000003
0000000004
1.1.1.1. 본원통화 구성내역
None
N
None
4
0000000004
102Y004
1.1.1.1.1. 본원통화 구성내역(평잔, 계절조정계열)
M
Y
None
항목명
설명
샘플데이터
항목구분
용어
용어
소비자동향지수
필수
translate
국문 컬럼명 여부 (기본값: True)
True
선택
항목명(국문)
항목명(영문)
항목설명
샘플데이터
용어
WORD
용어
소비자동향지수
용어설명
CONTENT
용어설명
소비자들이 느끼는 경기, 소비지출계획, 생활형편 등 경제에 대한 전반적인 인식을 조사하여 지수화함으로써 소비 및 경기를 파악하는 지표로 활용된다. 소비자동향지수는 1964년 미국 미시간대학이 최초로 작성하였으며 그 이후 우리나라를 비롯한 세계 각국에서 편제하여 공표하고 있다. 한국은행의 소비자동향지수는 매월 초～중순에 걸쳐 조사하여 하순에 결과를 발표하고 있다.
from PublicDataReader import Ecos
service_key = "API 인증키"
api = Ecos (service_key )
df = api .get_statistic_word (용어 = "소비자동향지수" )
df .head ()
용어
용어설명
0
소비자동향지수
소비자들이 느끼는 경기, 소비지출계획, 생활형편 등 경제에 대한 전반적인 인식을 조...
항목명
설명
샘플데이터
항목구분
통계표코드
통계표코드
601Y002
필수
translate
국문 컬럼명 여부 (기본값: True)
True
선택
항목명(국문)
항목명(영문)
항목설명
샘플데이터
통계표코드
STAT_CODE
통계표코드
601Y002
통계명
STAT_NAME
통계명
7.5.2. 지역별 소비유형별 개인 신용카드
항목그룹코드
GRP_CODE
항목그룹코드
Group1
항목그룹명
GRP_NAME
항목그룹명
지역코드
통계항목코드
ITEM_CODE
통계항목코드
A
통계항목명
ITEM_NAME
통계항목명
서울
상위통계항목코드
P_ITEM_CODE
상위통계항목코드
nan
상위통계항목명
P_ITEM_NAME
상위통계항목명
nan
주기
CYCLE
주기
M
수록시작일자
START_TIME
수록시작일자
200912
수록종료일자
END_TIME
수록종료일자
202112
자료수
DATA_CNT
자료수
145
단위
UNIT_NAME
단위
십억원
가중치
WEIGHT
가중치
nan
from PublicDataReader import Ecos
service_key = "API 인증키"
api = Ecos (service_key )
df = api .get_statistic_item_list (통계표코드 = "601Y002" )
df .head ()
통계표코드
통계명
항목그룹코드
항목그룹명
통계항목코드
통계항목명
상위통계항목코드
상위통계항목명
시점
수록시작일자
수록종료일자
자료수
단위
가중치
0
601Y002
7.5.2. 지역별 소비유형별 개인 신용카드
Group1
지역코드
A
서울
None
None
M
200912
202212
12874
None
None
1
601Y002
7.5.2. 지역별 소비유형별 개인 신용카드
Group1
지역코드
B
부산
None
None
M
200912
202212
12874
None
None
2
601Y002
7.5.2. 지역별 소비유형별 개인 신용카드
Group1
지역코드
C
대구
None
None
M
200912
202212
12874
None
None
3
601Y002
7.5.2. 지역별 소비유형별 개인 신용카드
Group1
지역코드
D
인천
None
None
M
200912
202212
12874
None
None
4
601Y002
7.5.2. 지역별 소비유형별 개인 신용카드
Group1
지역코드
E
광주
None
None
M
200912
202212
12874
None
None
항목명
설명
샘플데이터
항목구분
통계표코드
통계표코드
200Y001
필수
주기
주기(년:A, 반년:S, 분기:Q, 월:M, 반월:SM, 일: D)
A
필수
검색시작일자
검색시작일자(주기에 맞는 형식으로 입력: 2015, 2015Q1, 201501, 20150101 등)
2015
필수
검색종료일자
검색종료일자(주기에 맞는 형식으로 입력: 2021, 2021Q1, 202101, 20210101 등)
2021
필수
통계항목코드1
통계항목코드1
10101
선택
통계항목코드2
통계항목코드2
nan
선택
통계항목코드3
통계항목코드3
nan
선택
통계항목코드4
통계항목코드4
nan
선택
translate
국문 컬럼명 여부 (기본값: True)
True
선택
항목명(국문)
항목명(영문)
항목설명
샘플데이터
통계표코드
STAT_CODE
통계표코드
200Y001
통계명
STAT_NAME
통계명
2.1.1.1. 주요지표(연간지표)
통계항목코드1
ITEM_CODE1
통계항목코드1
10101
통계항목명1
ITEM_NAME1
통계항목명1
국내총생산(명목, 원화표시)
통계항목코드2
ITEM_CODE2
통계항목코드2
nan
통계항목명2
ITEM_NAME2
통계항목명2
nan
통계항목코드3
ITEM_CODE3
통계항목코드3
nan
통계항목명3
ITEM_NAME3
통계항목명3
nan
통계항목코드4
ITEM_CODE4
통계항목코드3
nan
통계항목명4
ITEM_NAME4
통계항목명4
nan
단위
UNIT_NAME
단위
십억원
시점
TIME
시점
2015
값
DATA_VALUE
값
1658020.4
from PublicDataReader import Ecos
service_key = "API 인증키"
api = Ecos (service_key )
df = api .get_statistic_search (통계표코드 = "200Y001" , 주기 = "A" , 검색시작일자 = "2015" , 검색종료일자 = "2021" )
df .head ()
통계표코드
통계명
통계항목코드1
통계항목명1
통계항목코드2
통계항목명2
통계항목코드3
통계항목명3
통계항목코드4
통계항목명4
단위
시점
값
0
200Y001
2.1.1.1. 주요지표(연간지표)
3010101
민간
None
None
None
None
None
None
%
2015
2.2
1
200Y001
2.1.1.1. 주요지표(연간지표)
7010106
가계
None
None
None
None
None
None
%
2015
55.8
2
200Y001
2.1.1.1. 주요지표(연간지표)
7010107
기업
None
None
None
None
None
None
%
2015
22.5
3
200Y001
2.1.1.1. 주요지표(연간지표)
7010108
정부
None
None
None
None
None
None
%
2015
21.7
4
200Y001
2.1.1.1. 주요지표(연간지표)
70105
총조정처분가능소득의분배
None
None
None
None
None
None
None
2015
None
항목명
설명
샘플데이터
항목구분
translate
국문 컬럼명 여부 (기본값: True)
True
선택
항목명(국문)
항목명(영문)
항목설명
샘플데이터
통계그룹명
CLASS_NAME
통계그룹명
국민소득 · 경기 · 기업경영
통계명
KEYSTAT_NAME
통계명
경제성장률(전기대비)
값
DATA_VALUE
값
1.9
시점
CYCLE
통계의 최근 수록 시점
202003
단위
UNIT_NAME
단위
%, 달러, 십억원 등
from PublicDataReader import Ecos
service_key = "API 인증키"
api = Ecos (service_key )
df = api .get_key_statistic_list ()
df .head ()
통계그룹명
통계명
값
시점
단위
0
시장금리
한국은행 기준금리
3.5
20230315
%
1
시장금리
콜금리(익일물)
3.439
20230316
%
2
시장금리
KORIBOR(3개월)
3.56
20230317
%
3
시장금리
CD수익률(91일)
3.62
20230317
%
4
시장금리
통안증권수익률(364일)
3.429
20230317
%
항목명
설명
샘플데이터
항목구분
데이터명
데이터명
경제심리지수
필수
translate
국문 컬럼명 여부 (기본값: True)
True
선택
항목명(국문)
항목명(영문)
항목설명
샘플데이터
레벨
LVL
레벨
2
상위통계항목코드
P_CONT_CODE
부모통계항목코드
1
통계항목코드
CONT_CODE
통계항목코드
3
통계항목명
CONT_NAME
통계항목명
최초작성연도
메타데이터
META_DATA
메타데이터
2012.6월 최초 작성(과거 시계열은 2003.1월부터 제공)
from PublicDataReader import Ecos
service_key = "API 인증키"
api = Ecos (service_key )
df = api .get_statistic_meta (데이터명 = "경제심리지수" )
df .head ()
레벨
상위통계항목코드
통계항목코드
통계항목명
메타데이터
0
2
0000000001
0000000098
무응답률
None
1
2
0000000001
0000000099
MSE
None
2
1
None
0000000100
예산 인력 교육 홍보
None
3
2
0000000001
0000000101
관련 예산
None
4
2
0000000001
0000000102
인력
None