API 문서 HOME API 문서 국내선물옵션시세
국내선물옵션시세
선물옵션 시세[v1_국내선물-006]
REST
선물옵션 시세[v1_국내선물-006]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://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
※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 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"
}
"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": "정상처리 되었습니다!"
}
"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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://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"
}
"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": "정상처리 되었습니다."
}
"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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/domestic-futureoption/v1/quotations/inquire-daily-fuopchartprice
- Format
- Content-Type
개요
(지수)선물옵션 기간별시세 데이터(일/주/월/년) 조회 (최대 100건 조회)
실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
모의계좌의 경우, 한 번의 호출에 최대 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"
}
"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"
},
....
"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]
기본정보
- MethodGET
- 실전 Domainhttps://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 |