오픈API

환율 조회 v1.0.0

환율 조회 v1.0.0

API개요

API개요(API 명, API 설명, URL, HTTP Method, OAuth 2.0, 제3자 정보제공 동의) 표
API 명 환율 조회
API 설명 현재 및 과거 환율을 조회할 수 있습니다.
URL /ibk/biz/bizXrtInq
HTTP Method POST
OAuth 2.0 N
제3자 정보제공 동의 비대상
이용금액 별도협의

Request Header

항목명 필드명 데이터타입 길이 Scale 필수여부 설명

클라이언트ID

X-IBK-Client-Id

String

 320 Y

클라이언트Sceret

X-IBK-Client-Secret

String

 32 0Y

Request Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1조회년월일 inqYmd String80 Y

환율을 조회하고자 하는 일자

1조회구분코드 inqDcd String1 0Y

'0':최종고시환율

- 조회하고자 일의 가장 최신 환율

'1':최초고시환율

- 조회하고자 일의 최초 환율

Request Sample

{
  "inqYmd" : "sample_inqYmd",
  "trnHms" : "sample_trnHms",
  "inqDcdNm" : "sample_inqDcdNm",
  "blerListRowcount" : 0.0,
  "blerList" : [ {
    "baseCrcd" : "sample_baseCrcd",
    "brgnBaseRt" : 0.0,
    "tlcbRt" : 0.0,
    "tlchSellRt" : 0.0,
    "cshBngRt" : 0.0,
    "cshSellRt" : 0.0,
    "tscnRt" : 0.0
  } ],
  "dfcrBlerListRowcount" : 0.0,
  "dfcrBlerList" : [ {
    "baseCrcd" : "sample_baseCrcd",
    "cocuCd" : "sample_cocuCd",
    "brgnBaseRt" : 0.0,
    "tlcbRt" : 0.0,
    "tlchSellRt" : 0.0,
    "cshBngRt" : 0.0,
    "cshSellRt" : 0.0
  } ]
}

Response Header

Response Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1조회년월일inqYmdString80Y
1거래시각trnHmsString60

Y

1조회구분코드명inqDcdNmString1000

Y

'0':최종고시환율

'1':최초고시환율

1고시환율목록카운트blerListRowcountNumber50

Y

1고시환율목록blerList

Array

00

Y

2기준통화코드baseCrcdString30

Y

※ 통화코드 시트 참조
2매매기준율brgnBaseRtNumber126

Y

2전신환매입율tlcbRtNumber126

Y

송금받을때
2전신환매도율tlchSellRtNumber126

Y

송금보낼때
2현찰매입율cshBngRtNumber126

Y

현찰팔때
2현찰매도율cshSellRtNumber126

Y

현찰살때
2대미환산율tscnRtNumber126

Y

미화환산율
1이종통화고시환율목록카운트dfcrBlerListRowcountNumber50

Y

1이종통화고시환율목록dfcrBlerList

Array

00

Y

2기준통화코드baseCrcdString30

Y

※ 통화코드 시트 참조
2상대통화코드cocuCdString30

Y

※ 통화코드 시트 참조
2매매기준율brgnBaseRtNumber126

Y

2전신환매입율tlcbRtNumber126

Y

송금받을때
2전신환매도율tlchSellRtNumber126

Y

송금보낼때
2현찰매입율cshBngRtNumber126

Y

현찰팔때

2현찰매도율cshSellRtNumber126

Y

현찰살때

Response Sample

{
  "inqYmd" : "sample_inqYmd",
  "trnHms" : "sample_trnHms",
  "inqDcdNm" : "sample_inqDcdNm",
  "blerListRowcount" : 0.0,
  "blerList" : [ {
    "baseCrcd" : "sample_baseCrcd",
    "brgnBaseRt" : 0.0,
    "tlcbRt" : 0.0,
    "tlchSellRt" : 0.0,
    "cshBngRt" : 0.0,
    "cshSellRt" : 0.0,
    "tscnRt" : 0.0
  } ],
  "dfcrBlerListRowcount" : 0.0,
  "dfcrBlerList" : [ {
    "baseCrcd" : "sample_baseCrcd",
    "cocuCd" : "sample_cocuCd",
    "brgnBaseRt" : 0.0,
    "tlcbRt" : 0.0,
    "tlchSellRt" : 0.0,
    "cshBngRt" : 0.0,
    "cshSellRt" : 0.0
  } ]
}

성공/실패 Case