환율 API 사용하기 수출입은행 Open API 제공

개인적으로 필요한 앱 기능을 개발하다가 환율정보가 필요한 부분이 있어 검색해 보니 수출입은행에서 환율 API 를 제공한다고 해서 사용해보기로 합니다. 

 

● 수출입은행 접속

---

https://www.koreaexim.go.kr/ir/HPHKIR019M01

수출입은행 Open API 메뉴에 접속합니다. 3가지의 Open API 가 제공 됩니다. 

국제금리, 대출금리, 현재환율 API 

 

● 인증키 발급 신청

---

필요한 API 를 클릭하고 하단으로 스크롤 하다가 보면 [인증키 발급신청] 버튼이 보입니다. 인증키를 신청하고 발급받아야지 API 사용이 가능 합니다.

---

본인인증을 거쳐 인증키를 발급받으면 [나의 인증키 발급내역] 에 발급된 내역을 조회할 수 있습니다.

 

---

발급받은 인증키로 브라우저에 접속하면 아래처럼 환율을 조회할 수 있습니다.

예제 ) https://www.koreaexim.go.kr/site/program/financial/exchangeJSON?authkey=발급받은인증키&searchdate=20240625&data=AP01

 

● 수출입은행 Open API 

• 일일 호출 가능 횟수를 1000회로 제한 (1000회 이상 호출 시 result:4 반환, 데이터 미제공) 
• 한국수출입은행에서 제공하는 OPEN API의 경우 신청시 개인정보를 받고 있어 개인정보보호법에 따라 보유기간(2년)이 지난 사용자의 경우 개인정보 및 사용정보 등이 폐기처리 됩니다. 다만, 보유기간 전 홈페이지에 접속하시어 개인정보 보유 재동의를 해주시면 사용기간이 2년이 연장됩니다.

요청변수 (Requester Parameter)
변수명	타입	변수설명	값설명
authkey	String(필수)	인증키	OpenAPI 신청시 발급된 인증키
searchdate	String	검색요청날짜	ex) 2015-01-01, 20150101, (DEFAULT)현재일
data	String(필수)	검색요청API타입	AP01 : 환율, AP02 : 대출금리, AP03 : 국제금리
출력결과 (Response Element)
변수명	타입	변수설명	값설명
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	서울외국환중개
		장부가격
이용시 유의사항
비영업일의 데이터, 혹은 영업당일 11시 이전에 해당일의 데이터를 요청할 경우 null 값이 반환