KIS Developers menu

API 문서 HOME API 문서 국내선물옵션시세


국내선물옵션시세

선물옵션 시세[v1_국내선물-006]

REST

선물옵션 시세[v1_국내선물-006]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-futureoption/v1/quotations/inquire-price
  • Format
     
  • Content-Type
     

개요

선물옵션 시세 API입니다.

※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)

※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA"
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전/모의투자]
FHMIF10000000 : 선물 옵션 시세
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
FID_COND_MRKT_DIV_CODE FID 조건 시장 분류 코드 String Y 2 F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션
FID_INPUT_ISCD FID 입력 종목코드 String Y 12 종목코드 (예: 101S03)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output1 응답상세1 Array Y
-hts_kor_isnm HTS 한글 종목명 String Y 40 종목명
-futs_prpr 선물 현재가 String Y 14 선물의 현재가격
-futs_prdy_vrss 선물 전일 대비 String Y 14 선물의 전일 종가와 당일 현재가의 차이 (당일 현재가-전일 종가)
-prdy_vrss_sign 전일 대비 부호 String Y 1 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락
-futs_prdy_clpr 선물 전일 종가 String Y 14 해당 선물 종목의 전일 종가
-futs_prdy_ctrt 선물 전일 대비율 String Y 11 선물 전일 대비 / 당일 현재가 * 100
-acml_vol 누적 거래량 String Y 18 당일 조회시점까지 전체 거래량
-acml_tr_pbmn 누적 거래 대금 String Y 18 당일 조회시점까지 전체 거래금액
-hts_otst_stpl_qty HTS 미결제 약정 수량 String Y 18 현재까지 반대매매로 청산되지 않은 계약수
-otst_stpl_qty_icdc 미결제 약정 수량 증감 String Y 10 전일대비 미결제 약정 수량의 증감
-futs_oprc 선물 시가2 String Y 14 당일 최초 거래가격
-futs_hgpr 선물 최고가 String Y 14 당일 조회 시점까지 가장 높은 거래가격
-futs_lwpr 선물 최저가 String Y 14 당일 조회 시점까지 가장 낮은 거래가격
-futs_mxpr 선물 상한가 String Y 14 당일 거래 가능한 최고 가격
-futs_llam 선물 하한가 String Y 14 당일 거래 가능한 최저 가격
-basis 베이시스 String Y 13 선물 이론가격과 현물가격과의 차이
-futs_sdpr 선물 기준가 String Y 14
-hts_thpr HTS 이론가 String Y 14 해당 월물의 이론적 가치를 계산한 것으로 주가지수 선물 이론가격은 (주가지수 선물 이론가격 = 주가지수 + 기간이자비용 - 기간배당수입) 로 계산
-dprt 괴리율 String Y 11 현재의 시장가가 이론가격으로부터 얼마나 벗어나 있는지에 대한 측정 자료
괴리도 = (현재가 - 이론가격)
-crbr_aply_mxpr 서킷브레이커 적용 상한가 String Y 14
-crbr_aply_llam 서킷브레이커 적용 하한가 String Y 14
-futs_last_tr_date 선물 최종 거래 일자 String Y 8 해당 선물 종목의 마지막 거래일
-hts_rmnn_dynu HTS 잔존 일수 String Y 5 최종 거래일까지 남은 일수
-futs_lstn_medm_hgpr 선물 상장 중 최고가 String Y 14 해당 선물 종목의 상장일 이후 최고 거래가격
-futs_lstn_medm_lwpr 선물 상장 중 최저가 String Y 14 해당 선물 종목의 상장일 이후 최저 거래가격
-delta_val 델타 값 String Y 16 옵션 종목의 지표값
-gama 감마 String Y 13 옵션 종목의 지표값
-theta 세타 String Y 13 옵션 종목의 지표값
-vega 베가 String Y 13 옵션 종목의 지표값
-rho 로우 String Y 13 옵션 종목의 지표값
-hist_vltl 역사적 변동성 String Y 16 옵션 종목의 지표값
-hts_ints_vltl HTS 내재 변동성 String Y 16 옵션 종목의 지표값
-mrkt_basis 시장 베이시스 String Y 13 현재 시장에서 형성된 선물가격과 현물가격과의 차이
-acpr 행사가 String Y 14 옵션의 행사가격
output2 응답상세2 Array Y
-bstp_cls_code 업종 구분 코드 String Y 4
-hts_kor_isnm HTS 한글 종목명 String Y 40 종목명
-bstp_nmix_prpr 업종 지수 현재가 String Y 14
-prdy_vrss_sign 전일 대비 부호 String Y 1
-bstp_nmix_prdy_vrss 업종 지수 전일 대비 String Y 14
-bstp_nmix_prdy_ctrt 업종 지수 전일 대비율 String Y 11
output3 응답상세3 Array Y
-bstp_cls_code 업종 구분 코드 String Y 4
-hts_kor_isnm HTS 한글 종목명 String Y 40
-bstp_nmix_prpr 업종 지수 현재가 String Y 14
-prdy_vrss_sign 전일 대비 부호 String Y 1
-bstp_nmix_prdy_vrss 업종 지수 전일 대비 String Y 14
-bstp_nmix_prdy_ctrt 업종 지수 전일 대비율 String Y 11

Example

Request

{
"fid_cond_mrkt_div_code": "F",
"fid_input_iscd": "101S03"
}

Response

{
  "output1": {
    "hts_kor_isnm": "F 202203",
    "futs_prpr": "395.00",
    "futs_prdy_vrss": "6.70",
    "prdy_vrss_sign": "2",
    "futs_prdy_clpr": "388.30",
    "futs_prdy_ctrt": "1.73",
    "acml_vol": "220924",
    "acml_tr_pbmn": "21741293338",
    "hts_otst_stpl_qty": "247121",
    "otst_stpl_qty_icdc": "-592",
    "futs_oprc": "391.05",
    "futs_hgpr": "395.15",
    "futs_lwpr": "391.00",
    "futs_mxpr": "419.35",
    "futs_llam": "357.25",
    "basis": "0.82",
    "futs_sdpr": "388.30",
    "hts_thpr": "395.48",
    "dprt": "-0.12",
    "crbr_aply_mxpr": "0.00",
    "crbr_aply_llam": "0.00",
    "futs_last_tr_date": "20220310",
    "hts_rmnn_dynu": "58",
    "futs_lstn_medm_hgpr": "434.00",
    "futs_lstn_medm_lwpr": "366.60",
    "delta_val": "1.0000",
    "gama": "0.0000",
    "theta": "0.0000",
    "vega": "0.0000",
    "rho": "0.0000",
    "mrkt_basis": "0.34"
  },
  "output2": {
    "bstp_cls_code": "0001",
    "hts_kor_isnm": "종합",
    "bstp_nmix_prpr": "2972.48",
    "prdy_vrss_sign": "2",
    "bstp_nmix_prdy_vrss": "45.10",
    "bstp_nmix_prdy_ctrt": "1.54"
  },
  "output3": {
    "bstp_cls_code": "2001",
    "hts_kor_isnm": "KOSPI200",
    "bstp_nmix_prpr": "394.66",
    "prdy_vrss_sign": "2",
    "bstp_nmix_prdy_vrss": "5.69",
    "bstp_nmix_prdy_ctrt": "1.46"
  },
  "rt_cd": "0",
  "msg_cd": "MCA00000",
  "msg1": "정상처리 되었습니다!"
}

선물옵션 시세호가[v1_국내선물-007]

REST

선물옵션 시세호가[v1_국내선물-007]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-futureoption/v1/quotations/inquire-asking-price
  • Format
     
  • Content-Type
     

개요

선물옵션 시세호가 API입니다.

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)

※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA"
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전/모의투자]
FHMIF10010000 : 선물 옵션 시세 호가
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
FID_COND_MRKT_DIV_CODE FID 조건 시장 분류 코드 String Y 2 F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션
FID_INPUT_ISCD FID 입력 종목코드 String Y 12 종목코드 (예: 101S03)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output1 응답상세1 Array Y
-hts_kor_isnm HTS 한글 종목명 String Y 40 종목명
-futs_prpr 선물 현재가 String Y 14 선물의 현재가격
-prdy_vrss_sign 전일 대비 부호 String Y 1 1 : 상한
2 : 상승
3 : 보합
4 : 하한
5 : 하락
-futs_prdy_vrss 선물 전일 대비 String Y 14 선물의 전일 종가와 당일 현재가의 차이 (당일 현재가-전일 종가)
-futs_prdy_ctrt 선물 전일 대비율 String Y 11 선물 전일 대비 / 당일 현재가 * 100
-acml_vol 누적 거래량 String Y 18 당일 조회시점까지 전체 거래량
-futs_prdy_clpr 선물 전일 종가 String Y 14 해당 선물 종목의 전일 종가
-futs_shrn_iscd 선물 단축 종목코드 String Y 9
output2 응답상세2 Array Y
-futs_askp1 선물 매도호가1 String Y 14 해당 종목의 매도호가 중 1번째 낮은 호가
-futs_askp2 선물 매도호가2 String Y 14 해당 종목의 매도호가 중 2번째 낮은 호가
-futs_askp3 선물 매도호가3 String Y 14 해당 종목의 매도호가 중 3번째 낮은 호가
-futs_askp4 선물 매도호가4 String Y 14 해당 종목의 매도호가 중 4번째 낮은 호가
-futs_askp5 선물 매도호가5 String Y 14 해당 종목의 매도호가 중 5번째 낮은 호가
-futs_bidp1 선물 매수호가1 String Y 14 해당 종목의 매수호가 중 가장 높은 호가
-futs_bidp2 선물 매수호가1 String Y 14 해당 종목의 매수호가 중 2번째 높은 호가
-futs_bidp3 선물 매수호가3 String Y 14 해당 종목의 매수호가 중 3번째 높은 호가
-futs_bidp4 선물 매수호가4 String Y 14 해당 종목의 매수호가 중 4번째 높은 호가
-futs_bidp5 선물 매수호가5 String Y 14 해당 종목의 매수호가 중 5번째 높은 호가
-askp_rsqn1 매도호가 잔량1 String Y 12 매도호가 1의 미체결수량
-askp_rsqn2 매도호가 잔량2 String Y 12 매도호가 2의 미체결수량
-askp_rsqn3 매도호가 잔량3 String Y 12 매도호가 3의 미체결수량
-askp_rsqn4 매도호가 잔량4 String Y 12 매도호가 4의 미체결수량
-askp_rsqn5 매도호가 잔량5 String Y 12 매도호가 5의 미체결수량
-bidp_rsqn1 매수호가 잔량1 String Y 12 매수호가 1의 미체결수량
-bidp_rsqn2 매수호가 잔량2 String Y 12 매수호가 2의 미체결수량
-bidp_rsqn3 매수호가 잔량3 String Y 12 매수호가 3의 미체결수량
-bidp_rsqn4 매수호가 잔량4 String Y 12 매수호가 4의 미체결수량
-bidp_rsqn5 매수호가 잔량5 String Y 12 매수호가 5의 미체결수량
-askp_csnu1 매도호가 건수1 String Y 10 매도호가 1의 미체결 주문 건수
-askp_csnu2 매도호가 건수2 String Y 10 매도호가 2의 미체결 주문 건수
-askp_csnu3 매도호가 건수3 String Y 10 매도호가 3의 미체결 주문 건수
-askp_csnu4 매도호가 건수4 String Y 10 매도호가 4의 미체결 주문 건수
-askp_csnu5 매도호가 건수5 String Y 10 매도호가 5의 미체결 주문 건수
-bidp_csnu1 매수호가 건수1 String Y 10 매수호가 1의 미체결 주문 건수
-bidp_csnu2 매수호가 건수2 String Y 10 매수호가 2의 미체결 주문 건수
-bidp_csnu3 매수호가 건수3 String Y 10 매수호가 3의 미체결 주문 건수
-bidp_csnu4 매수호가 건수4 String Y 10 매수호가 4의 미체결 주문 건수
-bidp_csnu5 매수호가 건수5 String Y 10 매수호가 5의 미체결 주문 건수
-total_askp_rsqn 총 매도호가 잔량 String Y 12 매도호가 1~5의 잔량 합계
-total_bidp_rsqn 총 매수호가 잔량 String Y 12 매수호가 1~5의 잔량 합계
-total_askp_csnu 총 매도호가 건수 String Y 10 매도호가 1~5의 미체결 주문 건수 합계
-total_bidp_csnu 총 매수호가 건수 String Y 10 매수호가 1~5의 미체결 주문 건수 합계
-aspr_acpt_hour 호가 접수 시간 String Y 6 가장 최근 호가의 접수 시간

Example

Request

{
"fid_cond_mrkt_div_code" : "F",
"fid_input_iscd" : "101S06"
}

Response

{
  "output1": {
    "hts_kor_isnm": "F 202206",
    "futs_prpr": "364.40",
    "prdy_vrss_sign": "2",
    "futs_prdy_vrss": "3.00",
    "futs_prdy_ctrt": "0.83",
    "acml_vol": "193112",
    "futs_prdy_clpr": "361.40",
    "futs_shrn_iscd": "101S06"
  },
  "output2": {
    "futs_askp1": "364.40",
    "futs_askp2": "364.45",
    "futs_askp3": "364.50",
    "futs_askp4": "364.55",
    "futs_askp5": "364.60",
    "futs_bidp1": "364.35",
    "futs_bidp2": "364.30",
    "futs_bidp3": "364.25",
    "futs_bidp4": "364.20",
    "futs_bidp5": "364.15",
    "askp_rsqn1": "35",
    "askp_rsqn2": "47",
    "askp_rsqn3": "32",
    "askp_rsqn4": "56",
    "askp_rsqn5": "88",
    "bidp_rsqn1": "22",
    "bidp_rsqn2": "70",
    "bidp_rsqn3": "68",
    "bidp_rsqn4": "97",
    "bidp_rsqn5": "42",
    "askp_csnu1": "9",
    "askp_csnu2": "19",
    "askp_csnu3": "21",
    "askp_csnu4": "28",
    "askp_csnu5": "20",
    "bidp_csnu1": "9",
    "bidp_csnu2": "45",
    "bidp_csnu3": "26",
    "bidp_csnu4": "31",
    "bidp_csnu5": "22",
    "total_askp_rsqn": "7140",
    "total_bidp_rsqn": "9319",
    "total_askp_csnu": "1091",
    "total_bidp_csnu": "1115",
    "aspr_acpt_hour": "153744"
  },
  "rt_cd": "0",
  "msg_cd": "MCA00000",
  "msg1": "정상처리 되었습니다."
}

선물옵션기간별시세(일/주/월/년)[v1_국내선물-008]

REST

선물옵션기간별시세(일/주/월/년)[v1_국내선물-008]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-futureoption/v1/quotations/inquire-daily-fuopchartprice
  • Format
     
  • Content-Type
     

개요

(지수)선물옵션 기간별시세 데이터(일/주/월/년) 조회 (최대 100건 조회)
실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
모의계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
tr_id 거래ID String Y 13 [실전/모의투자]
FHKIF03020100
custtype 고객타입 String N 1 B : 법인
P : 개인

Query Parameter

Element 한글명 Type Required Length Description
FID_COND_MRKT_DIV_CODE FID 조건 시장 분류 코드 String Y 2 F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션,
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션
FID_INPUT_ISCD 종목코드 String Y 12 종목번호 (지수선물:6자리, 지수옵션 9자리)
FID_INPUT_DATE_1 조회 시작일자 String Y 10 조회 시작일자
FID_INPUT_DATE_2 조회 종료일자 String Y 10 조회 종료일자
FID_PERIOD_DIV_CODE 기간분류코드 String Y 32 D:일봉 W:주봉, M:월봉, Y:년봉

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output1 상세기본정보 Object Y 1 상세기본정보
-futs_prdy_vrss 전일 대비 String Y 14 전일 대비
-prdy_vrss_sign 전일 대비 부호 String Y 1 전일 대비 부호
-futs_prdy_ctrt 선물 전일 대비율 String Y 11 선물 전일 대비율
-futs_prdy_clpr 선물 전일 종가 String Y 14 선물 전일 종가
-acml_vol 누적 거래량 String Y 18 누적 거래량
-acml_tr_pbmn 누적 거래 대금 String Y 18 누적 거래 대금
-hts_kor_isnm HTS 한글 종목명 String Y 40 HTS 한글 종목명
-futs_prpr 현재가 String Y 14 현재가
-futs_shrn_iscd 단축 종목코드 String Y 9 단축 종목코드
-prdy_vol 전일 거래량 String Y 18 전일 거래량
-futs_mxpr 상한가 String Y 14 상한가
-futs_llam 하한가 String Y 14 하한가
-futs_oprc 시가 String Y 14 시가
-futs_hgpr 최고가 String Y 14 최고가
-futs_lwpr 최저가 String Y 14 최저가
-futs_prdy_oprc 전일 시가 String Y 14 전일 시가
-futs_prdy_hgpr 전일 최고가 String Y 14 전일 최고가
-futs_prdy_lwpr 전일 최저가 String Y 14 전일 최저가
-futs_askp 매도호가 String Y 14 매도호가
-futs_bidp 매수호가 String Y 14 매수호가
-basis 베이시스 String Y 12 베이시스
-kospi200_nmix KOSPI200 지수 String Y 14 KOSPI200 지수
-kospi200_prdy_vrss KOSPI200 전일 대비 String Y 14 KOSPI200 전일 대비
-kospi200_prdy_ctrt KOSPI200 전일 대비율 String Y 11 KOSPI200 전일 대비율
-kospi200_prdy_vrss_sign 전일 대비 부호 String Y 1 전일 대비 부호
-hts_otst_stpl_qty HTS 미결제 약정 수량 String Y 18 HTS 미결제 약정 수량
-otst_stpl_qty_icdc 미결제 약정 수량 증감 String Y 10 미결제 약정 수량 증감
-tday_rltv 당일 체결강도 String Y 14 당일 체결강도
-hts_thpr HTS 이론가 String Y 14 HTS 이론가
-dprt 괴리율 String Y 11 괴리율
output2 기간별 조회데이터 (배열) Array Y 1 기간별 조회데이터 (배열)
-stck_bsop_date 영업 일자 String Y 8 영업 일자
-futs_prpr 현재가 String Y 14 현재가
-futs_oprc 시가 String Y 14 시가
-futs_hgpr 최고가 String Y 14 최고가
-futs_lwpr 최저가 String Y 14 최저가
-acml_vol 누적 거래량 String Y 18 누적 거래량
-acml_tr_pbmn 누적 거래 대금 String Y 18 누적 거래 대금
-mod_yn 변경 여부 String Y 1 변경 여부

Example

Request

"input": {
            "fid_cond_mrkt_div_code": "F",
            "fid_input_date_1": "20220401",
            "fid_input_date_2": "20220524",
            "fid_input_iscd": "101S06",
            "fid_period_div_code": "D"
        }

Response

 "output1": {
            "acml_tr_pbmn": "15491417875",
            "acml_vol": "178446",
            "basis": "0.28",
            "dprt": "-0.14",
            "futs_askp": "344.70",
            "futs_bidp": "344.65",
            "futs_hgpr": "349.75",
            "futs_llam": "322.65",
            "futs_lwpr": "344.65",
            "futs_mxpr": "378.75",
            "futs_oprc": "348.85",
            "futs_prdy_clpr": "350.70",
            "futs_prdy_ctrt": "-1.71",
            "futs_prdy_hgpr": "351.85",
            "futs_prdy_lwpr": "348.65",
            "futs_prdy_oprc": "351.55",
            "futs_prdy_vrss": "-6.00",
            "futs_prpr": "344.70",
            "futs_shrn_iscd": "101S06",
            "hts_kor_isnm": "F 202206",
            "hts_otst_stpl_qty": "297901",
            "hts_thpr": "345.17",
            "kospi200_nmix": "344.89",
            "otst_stpl_qty_icdc": "4348",
            "prdy_vol": "222987",
            "prdy_vrss_sign": "5",
            "tday_rltv": "92.20"
        },
        "output2": [
            {
                "acml_tr_pbmn": "15491417875",
                "acml_vol": "178446",
                "futs_hgpr": "349.75",
                "futs_lwpr": "344.65",
                "futs_oprc": "348.85",
                "futs_prpr": "344.70",
                "mod_yn": "N",
                "stck_bsop_date": "20220524"
            },
....

선물옵션 분봉조회[v1_국내선물-012]

REST

선물옵션 분봉조회[v1_국내선물-012]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-futureoption/v1/quotations/inquire-time-fuopchartprice
  • Format
     
  • Content-Type
     

개요

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 FHKIF03020200
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객 타입 String Y 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
FID_COND_MRKT_DIV_CODE FID 조건 시장 분류 코드 String Y 2 F: 지수선물, O:지수옵션
JF: 주식선물, JO:주식옵션,
CF: 상품선물(금), 금리선물(국채), 통화선물(달러)
CM: 야간선물, EU: 야간옵션
FID_INPUT_ISCD FID 입력 종목코드 String Y 12 종목번호 (지수선물:6자리, 지수옵션 9자리)
FID_HOUR_CLS_CODE FID 시간 구분 코드 String Y 5 FID 시간 구분 코드(30: 30초, 60: 1분, 3600: 1시간)
FID_PW_DATA_INCU_YN FID 과거 데이터 포함 여부 String Y 2 Y(과거) / N (당일)
FID_FAKE_TICK_INCU_YN FID 허봉 포함 여부 String Y 2 N으로 입력
FID_INPUT_DATE_1 FID 입력 날짜1 String Y 10 입력 날짜 기준으로 이전 기간 조회(YYYYMMDD)
ex) 20230908 입력 시, 2023년 9월 8일부터 일자 역순으로 조회
FID_INPUT_HOUR_1 FID 입력 시간1 String Y 10 입력 시간 기준으로 이전 시간 조회(HHMMSS)
ex) 093000 입력 시, 오전 9시 30분부터 역순으로 분봉 조회

* CM(야간선물), EU(야간옵션)인 경우, 자정 이후 시간은 +24시간으로 입력
ex) 253000 입력 시, 새벽 1시 30분부터 역순으로 분봉 조회

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
Output1 응답상세 Object Array Y
-futs_prdy_vrss 선물 전일 대비 String Y 11
-prdy_vrss_sign 전일 대비 부호 String Y 1
-futs_prdy_ctrt 선물 전일 대비율 String Y 8
-futs_prdy_clpr 선물 전일 종가 String Y 11
-prdy_nmix 전일 지수 String Y 11
-acml_vol 누적 거래량 String Y 18
-acml_tr_pbmn 누적 거래 대금 String Y 18
-hts_kor_isnm HTS 한글 종목명 String Y 40
-futs_prpr 선물 현재가 String Y 11
-futs_shrn_iscd 선물 단축 종목코드 String Y 9
-prdy_vol 전일 거래량 String Y 18
-futs_mxpr 선물 상한가 String Y 11
-futs_llam 선물 하한가 String Y 11
-futs_oprc 선물 시가2 String Y 11
-futs_hgpr 선물 최고가 String Y 11
-futs_lwpr 선물 최저가 String Y 11
-futs_prdy_oprc 선물 전일 시가 String Y 11
-futs_prdy_hgpr 선물 전일 최고가 String Y 11
-futs_prdy_lwpr 선물 전일 최저가 String Y 11
-futs_askp 선물 매도호가 String Y 11
-futs_bidp 선물 매수호가 String Y 11
-basis 베이시스 String Y 8
-kospi200_nmix KOSPI200 지수 String Y 11
-kospi200_prdy_vrss KOSPI200 전일 대비 String Y 18
-kospi200_prdy_ctrt KOSPI200 전일 대비율 String Y 8
-kospi200_prdy_vrss_sign KOSPI200 전일 대비 부호 String Y 1
-hts_otst_stpl_qty HTS 미결제 약정 수량 String Y 18
-otst_stpl_qty_icdc 미결제 약정 수량 증감 String Y 10
-tday_rltv 당일 체결강도 String Y 11
-hts_thpr HTS 이론가 String Y 11
-dprt 괴리율 String Y 8
Output2 응답상세2 Object Y array
-stck_bsop_date 주식 영업 일자 String Y 8
-stck_cntg_hour 주식 체결 시간 String Y 6 CM(야간선물), EU(야간옵션)인 경우, 자정 이후 시간은 +24시간으로 표시
ex) "260000"인 경우, 오전 4시를 의미
-futs_prpr 선물 현재가 String Y 11
-futs_oprc 선물 시가2 String Y 11
-futs_hgpr 선물 최고가 String Y 11
-futs_lwpr 선물 최저가 String Y 11
-cntg_vol 체결 거래량 String Y 18
-acml_tr_pbmn 누적 거래 대금 String Y 18