한국은행 ECOS Open API — 가입·키 발급 가이드

• 공식 사이트: https://ecos.bok.or.kr/api/
• 발급 키: ECOS_API_KEY
• Last Verified: 2026-06-10 (ecos 스킬 GUIDE에서 이전 — 실화면 재검증 시 갱신)

1. 가입 조건#

• ECOS 일반 회원가입으로 충분합니다 (비용 없음).
• 인증키는 신청 즉시 발급됩니다 (별도 승인 대기 없음).

2. 발급 절차#

1. ecos.bok.or.kr/api 접속 → 회원가입 후 로그인
2. Open API → 인증키 신청 → 사용 목적·서비스명 입력 후 제출 → 즉시 발급
3. 발급된 인증키 복사

3. 키 ↔ 환경변수 매핑#

ECOS_API_KEY=발급받은_키

4. 한도·주의사항#

• 즉시 발급되지만 첫 호출 시 수 분간 일시적으로 미반영될 수 있습니다 — 잠시 후 다시 시도하세요.
• “API 키가 없다”는 안내(INFO-100)는 키가 비어 있거나 등록 위치가 잘못된 경우입니다.
• 너무 긴 기간·세밀한 주기를 한 번에 조회하면 타임아웃될 수 있습니다 — 3~5년 단위로 나눠 조회합니다.