한국수출입은행 환율 API 연동 가이드: 실시간 금융 데이터 활용 방안
한국수출입은행 환율 API 연동 가이드: 실시간 금융 데이터 활용
1. API 인증키 발급 절차
데이터 호출을 위한 필수 요소인 API 인증키 발급 과정은 다음과 같습니다.
공식 발급처: 한국수출입은행 Open API 페이지
위 페이지에서 회원가입 후 인증키를 신청하면
authkey를 즉시 발급받을 수 있습니다. 이 인증키는 API 호출 시 인증 역할을 수행하므로, 보안을 위해 외부에 노출되지 않도록 각별히 유의해야 합니다.
2. API 호출 방식 및 필수 파라미터
한국수출입은행 Open API는 RESTful 방식을 지원하며, 환율 정보 조회를 위한 호출 주소와 파라미터는 다음과 같습니다.
Base URL:
https://oapi.koreaexim.go.kr/site/program/financial/exchangeJSON필수 파라미터:
authkey: 발급받은 개인 API 인증키searchdate: 조회하고자 하는 날짜 (형식: YYYYMMDD, 예: 20260305)data: 조회 데이터 타입 (AP01: 환율,AP02: 대출금리,AP03: 국제금리)
3. 응답 데이터 필드 분석
API 호출 성공 시 JSON 형식으로 응답 데이터를 수신하게 됩니다. 주요 응답 필드는 아래 표와 같습니다.
RESULT | Integer | 조회 결과 코드 | 1: 성공, 2: DATA 코드 오류, 3: 인증 코드 오류, 4: 일일 제한 횟수 마감 |
CUR_UNIT | String | 통화 단위 코드 | 예: USD, JPY |
CUR_NM | String | 국가/통화명 | 예: 미국 달러, 일본 엔화 |
TTB | String | 전신환(송금) 받으실 때 | 고객이 은행으로부터 외화를 받을 때 적용되는 환율 |
TTS | String | 전신환(송금) 보내실 때 | 고객이 은행에 외화를 보낼 때 적용되는 환율 |
DEAL_BAS_R | String | 매매 기준율 | 시중은행에서 고시하는 매매 기준 환율 |
BKPR | String | 장부 가격 | 장부상에 기록되는 환율 |
YY_EFEE_R | String | 년 환가료율 | 연간 적용되는 환가료율 |
TEN_DD_EFEE_R | String | 10일 환가료율 | 10일간 적용되는 환가료율 |
KFTC_DEAL_BAS_R | String | 서울외국환중개 매매기준율 | 서울외국환중개에서 고시하는 매매기준율 |
KFTC_BKPR | String | 서울외국환중개 장부가격 | 서울외국환중개에서 고시하는 장부가격 |
4. 실무 적용 시 고려사항
금융 API를 활용할 때 중요한 점은 은행 영업일 기준의 데이터 처리입니다. 주말 및 공휴일에는 새로운 환율 데이터가 생성되지 않으므로, API 호출 결과가 없을 경우 가장 최근 영업일의 날짜로 재요청하는 로직을 구현하는 것이 권장됩니다. 또한, 응답 데이터는 문자열(String) 형태로 제공되므로, 소수점 계산이 필요한 경우 적절한 숫자형으로 변환하는 과정이 필수적입니다.
결론: 안정적인 금융 데이터 활용의 기반
한국수출입은행 Open API는 신뢰할 수 있는 환율 데이터를 무료로 제공하여 다양한 금융 서비스 및 애플리케이션 개발에 활용될 수 있습니다. 본 가이드라인을 통해 안정적인 데이터 연동 환경을 구축하고, 효율적인 금융 데이터 처리를 위한 기반을 마련할 수 있을 것입니다.
출처: 한국수출입은행 Open API 가이드라인 ( https://www.koreaexim.go.kr/ir/HPHKIR019M01 )