오픈API

금기준가조회 v1.0.0

금기준가조회 v1.0.0

API개요

API개요(API 명, API 설명, URL, HTTP Method, OAuth 2.0, 제3자 정보제공 동의) 표
API 명 금기준가조회
API 설명 금기준가조회
URL /ibk/biz/gldBspcInq
HTTP Method POST
OAuth 2.0 N
제3자 정보제공 동의 비대상
이용금액 별도협의

Request Header

항목명 필드명 데이터타입 길이 Scale 필수여부 설명
클라이언트ID X-IBK-Client-Id String 32 0

클라이언트Sceret

X-IBK-Client-Secret

String

 320

Request Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1조회거래구분코드iqtrDcdString20
1조회년월일inqYmdString80
1정렬방법코드lnpMcdString10
1금가격그리드NEXTKEY고시회차gldPrcGridNextkeyBltnTobNumber50
1금가격그리드NEXTKEY등록년월일gldPrcGridNextkeyRgsnYmdString80
1금가격그리드NEXTKEY기준통화코드gldPrcGridNextkeyBaseCrcdString30
1금가격그리드NEXTKEY상대통화코드gldPrcGridNextkeyCocuCdString30
1금가격그리드NEXTKEY기타환율구분코드gldPrcGridNextkeyEtcXrtDcdString20

Request Sample

{
  "trnYmd" : "sample_trnYmd",
  "gldPrcGridRowcount" : 0.0,
  "gldPrcGrid" : [ {
    "bltnTob" : 0.0,
    "rgsnYmd" : "sample_rgsnYmd",
    "baseCrcd" : "sample_baseCrcd",
    "cocuCd" : "sample_cocuCd",
    "etcXrtDcd" : "sample_etcXrtDcd",
    "bltnHms" : "sample_bltnHms",
    "baseGldPrc" : 0.0,
    "mnrcGldPrc" : 0.0,
    "expiTrmtGldPrc" : 0.0,
    "gldExpiTrmtFee" : 0.0,
    "goldQoutAmt" : 0.0,
    "usdBrgnBaseRt" : 0.0
  } ],
  "gldPrcGridNextkeyBltnTob" : 0.0,
  "gldPrcGridNextkeyRgsnYmd" : "sample_gldPrcGridNextkeyRgsnYmd",
  "gldPrcGridNextkeyBaseCrcd" : "sample_gldPrcGridNextkeyBaseCrcd",
  "gldPrcGridNextkeyCocuCd" : "sample_gldPrcGridNextkeyCocuCd",
  "gldPrcGridNextkeyEtcXrtDcd" : "sample_gldPrcGridNextkeyEtcXrtDcd"
}

Response Header

Response Body

LV 항목명 필드명 데이터타입 길이 Scale 필수여부 설명
1거래년월일trnYmdString80
1금가격그리드카운트gldPrcGridRowcountNumber50
1금가격그리드gldPrcGrid

Array

00
2고시회차bltnTobNumber50
2등록년월일rgsnYmdString80
2기준통화코드baseCrcdString30
2상대통화코드cocuCdString30
2기타환율구분코드etcXrtDcdString20
2고시시각bltnHmsString60
2기준금가격baseGldPrcNumber193
2입금금가격mnrcGldPrcNumber193
2만기해지금가격expiTrmtGldPrcNumber193
2금만기해지수수료gldExpiTrmtFeeNumber193
2골드시세금액goldQoutAmtNumber193
2미화매매기준율usdBrgnBaseRtNumber158
1금가격그리드NEXTKEY고시회차gldPrcGridNextkeyBltnTobNumber50
1금가격그리드NEXTKEY등록년월일gldPrcGridNextkeyRgsnYmdString80
1금가격그리드NEXTKEY기준통화코드gldPrcGridNextkeyBaseCrcdString30
1금가격그리드NEXTKEY상대통화코드gldPrcGridNextkeyCocuCdString30
1금가격그리드NEXTKEY기타환율구분코드gldPrcGridNextkeyEtcXrtDcdString20

Response Sample

{
  "trnYmd" : "sample_trnYmd",
  "gldPrcGridRowcount" : 0.0,
  "gldPrcGrid" : [ {
    "bltnTob" : 0.0,
    "rgsnYmd" : "sample_rgsnYmd",
    "baseCrcd" : "sample_baseCrcd",
    "cocuCd" : "sample_cocuCd",
    "etcXrtDcd" : "sample_etcXrtDcd",
    "bltnHms" : "sample_bltnHms",
    "baseGldPrc" : 0.0,
    "mnrcGldPrc" : 0.0,
    "expiTrmtGldPrc" : 0.0,
    "gldExpiTrmtFee" : 0.0,
    "goldQoutAmt" : 0.0,
    "usdBrgnBaseRt" : 0.0
  } ],
  "gldPrcGridNextkeyBltnTob" : 0.0,
  "gldPrcGridNextkeyRgsnYmd" : "sample_gldPrcGridNextkeyRgsnYmd",
  "gldPrcGridNextkeyBaseCrcd" : "sample_gldPrcGridNextkeyBaseCrcd",
  "gldPrcGridNextkeyCocuCd" : "sample_gldPrcGridNextkeyCocuCd",
  "gldPrcGridNextkeyEtcXrtDcd" : "sample_gldPrcGridNextkeyEtcXrtDcd"
}

성공/실패 Case