환율정보 API
한국수출입은행 환율 API 연동 가이드: 5분 만에 끝내는 실시간 데이터 활용
1. API 키 발급 (준비 단계)
먼저 데이터를 호출할 수 있는 '열쇠'인 API 키가 필요합니다.
- 공식 발급처: 한국수출입은행 Open API 페이지
- 위 페이지에서 회원가입 후 인증키를 신청하면
authkey를 즉시 확인할 수 있습니다. 이 키는 API 호출 시 신분증 역할을 하므로 외부에 유출되지 않도록 주의해야 합니다.
2. 호출 방식 및 파라미터
수출입은행 API는 REST 방식을 지원하며, 호출 주소와 필요한 파라미터는 다음과 같습니다.
- Base URL:
https://oapi.koreaexim.go.kr/site/program/financial/exchangeJSON - 필수 파라미터:
authkey: 발급받은 개인 API 키searchdate: 조회 날짜 (예: 20260305)data: 조회 타입 (AP01: 환율,AP02: 대출금리,AP03: 국제금리)
3. 결과 필드 읽기
호출에 성공하면 JSON 형식의 데이터를 응답받습니다. 실무에서 주로 사용하는 주요 필드는 아래와 같습니다.
| RESULT | Integer | 조회 결과 | 1 : 성공, 2 : DATA코드 오류, 3 : 인증코드 오류, 4 : 일일제한횟수 마감 | |
| CUR_UNIT | String | 통화코드 | ||
| CUR_NM | String | 국가/통화명 | ||
| TTB | String | 전신환(송금) | 받으실때 | |
| TTS | String | 전신환(송금) | 보내실때 | |
| DEAL_BAS_R | String | 매매 기준율 | ||
| BKPR | String | 장부가격 | ||
| YY_EFEE_R | String | 년환가료율 | ||
| TEN_DD_EFEE_R | String | 10일환가료율 | ||
| KFTC_DEAL_BAS_R | String | 서울외국환중개 | 매매기준율 | |
| KFTC_BKPR | String | 서울외국환중개 | 장부가격 |
실무 적용 시 팁: 휴일 데이터 처리
금융 API를 다룰 때 반드시 고려해야 할 점은 은행 영업일입니다.
주말이나 공휴일에는 새로운 환율 데이터가 생성되지 않기 때문에, API 호출 결과가 비어있을 수 있습니다.
이런 경우를 대비해 데이터가 없을 시 가장 최근 영업일의 날짜로 재요청하는 로직을 구현해 두는 것이 좋습니다.
또한 응답 데이터가 문자열(String) 형태로 들어오므로, 소수점 계산이 필요한 경우
적절한 숫자형으로 변환하는 과정이 필요합니다.
결론: 안정적인 금융 서비스의 시작
한국수출입은행 API는 무료이면서도 강력한 기능을 제공합니다.
환전 시스템이나 무역 관리 툴을 고민 중이라면 이 가이드를 통해 안정적인 데이터 환경을 구축해 보시기 바랍니다.
추가로 궁금한 점이나 코드 예제가 필요하다면 언제든 문의해 주세요.
출처: 한국수출입은행 Open API 가이드라인 ( https://www.koreaexim.go.kr/ir/HPHKIR019M01 )