OpenAPI

HOME > OpenAPI > 환율조회

환율조회

고시은행, 고시일자, 환종별 환율 정보를 제공합니다


1 요청URL
GET
POST
    URL
  • https://api.goodapi.co.kr/api/ExchangeRates?sessionID=공개키
    • 샘플
  • https://api.goodapi.co.kr/api/ExchangeRates?sessionID=test
  • [application/x-www-form-urlencoded]
  • path01=081&date=20191021
  • [application/xml]
  • <R><path01>081</path01><date>20191021</date></R>
  • [application/json]
  • {"path01":"081","date":"20191021"}

    • 주의사항
  • filename, type, eCode, serviceKey, subFileName, wcfName 요청변수명은 사용이 불가하며,
  • path01 ~ path20은 Path에서 사용하지 않을 경우 사용가능.
  • 요청변수명 중복사용시 Query보다 Body가 우선함.

2 요청변수
구분 요청변수 변수명 유형 필수 샘플값 설명
Path fileName 요청 업무 string true ExchangeRates
 ExchangeRates
추가/변경 가능
path01 은행코드 int true 081 3자리은행코드
path02 환종 string false 조회하고자 하는 환종(USD,JPY,EUR)
Query returnType응답형식stringfalsexmlxml or json
HTTP Header의 Accept 사용 권장
eCode 법인코드 string false Dataservice 요청 처리하고자 하는 법인코드
sessionID 공개키 string true test 접근하려는 연계시스템 또는 사용자에 부여하는 Key값
subFileName 요청 업무(구분) string false 088 요청 업무 세부 구분 코드(예-은행코드)
date 고시일자 date false 20191021 조회하고자 하는 고시일자(8자리)

3 출력결과필드
출력변수 유형 샘플값 설명
R_CODE responseindex 0000 처리결과코드
R_MSG responseindex 정상 처리되었습니다 처리결과메세지
ExchangeRates table[0] 환율정보
컬럼명 샘플값 설명
환율일자 20191021
은행코드 081 고시은행코드
환율회차 1
통화코드 USD
국명 미국
통화고시구분 1 1:고시, 2:비고시
TTBUYING허용여부 True
TTSELLING허용여부 True
CASHBUYING허용여부 True
CASHSELLING허용여부 True
CHECKBUYING허용여부 True
송금보낼때 1192.00
송금받을때 1169.00
송금보낼때우대 0.00
송금받을때우대 0.00
현찰사실때 1201.15
현찰파실때 1159.85
스프레드사실때 1.75
스프레드파실때 1.75
외화수표파실때 1167.79
매매기준율 1180.50
대미환산율 1.0000
TC사실때 1194.66
TC파실때 0.00
환가료1년 3.70025
환가료구10일 0.10278
환가료12일 0.12334
환가료1개월 0.00000
환가료3개월 4.45325
비고
환율시간 2019-10-21 오전 8:34:45

4 추가응답코드
  • 개발가이드 페이지의 기본응답코드외 해당 업무특성상 추가되는 응답코드
    • 응답코드 응답메세지 조치 방안

    5 Test API
    Header
    Key Value 비고
    Content-Type application/x-www-form-urlencoded application/xml
    application/json
    Accept application/xml
    application/json
    Authorization 토큰 인증용 헤더(Bearer + ' ' + 발급토큰)
    client_id 접속회원ID
    client_secret 접속비밀번호
    serviec_key 서비스Key
    user-tr-no 요청자 거래고유번호(요청자 생성)


  • [GET] https://api.goodapi.co.kr/api/ExchangeRates


    • Response


  • [POST] https://api.goodapi.co.kr/api/ExchangeRates?sessionID=test

    • Body
    Key Value 비고
    path01 3자리은행코드
    path02 조회하고자 하는 환종(USD,JPY,EUR)
    date 조회하고자 하는 고시일자(8자리)


    Response