Korea Eximbank Exchange CLI

Korea Eximbank (한국수출입은행) OpenAPI 기반 환율 조회 CLI이다. 지정한 날짜의 KRW 기준 환율표(AP01/일반고시환율 등)를 JSON/CSV로 출력한다.

• 공식 API: https://www.koreaexim.go.kr/site/program/financial/exchangeJSON
• 인증키: 환경변수 KOREAEXIM_API_KEY 사용

설치

pip install -e .

사용법

export KOREAEXIM_API_KEY="<발급키>"
eximbank-exchange --date 2024-12-31 --table AP01 --format json | jq '.'

옵션:

• --date YYYY-MM-DD 또는 YYYYMMDD (기본: 오늘, KST)
• --table AP01|AP02|AP12 (기본: AP01)
• --format json|csv (기본: json)
• --filter <CURRENCY> 특정 통화만 필터 (예: USD, JPY)

예시

eximbank-exchange --date 2025-01-02 --table AP01 --filter USD --format csv

주의사항

• 영업일이 아닌 경우 API는 빈 배열([])을 반환할 수 있다.
• 요청 제한이 있을 수 있으며, 오류 시 API의 msg 필드를 확인하라.