trex/trex-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add messaging transport rollout

Browse Source
This commit is contained in:
genichin
2026-06-06 00:02:52 +09:00
parent 4b91343ee8
commit 6c7a1cf6f6
383 changed files with 99045 additions and 487 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/broker/kis/rest/국내선물옵션/기본시세/205_v1_국내선물-006_선물옵션-시세.md
+184
View File
@@ -0,0 +1,184 @@
# 선물옵션 시세
- 원본 시트명: 선물옵션 시세
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: v1_국내선물-006
- HTTP Method: GET
- 실전 TR_ID: FHMIF10000000
- 모의 TR_ID: FHMIF10000000
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-price
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 시세 API입니다.
※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전/모의투자]<br>FHMIF10000000 : 선물 옵션 시세 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객타입 | string | N | 1 | B : 법인<br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션<br>JF: 주식선물, JO:주식옵션<br>CF: 상품선물(금), 금리선물(국채), 통화선물(달러)<br>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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공<br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| output1 | 응답상세1 | object | 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 : 상한 <br>2 : 상승<br>3 : 보합<br>4 : 하한<br>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 | 이론베이시스<br>선물 이론가격과 현물가격과의 차이 |
| futs_sdpr | 선물 기준가 | string | Y | 14 | |
| hts_thpr | HTS 이론가 | string | Y | 14 | 해당 월물의 이론적 가치를 계산한 것으로 주가지수 선물 이론가격은 (주가지수 선물 이론가격 = 주가지수 + 기간이자비용 - 기간배당수입) 로 계산 |
| dprt | 괴리율 | string | Y | 11 | 현재의 시장가가 이론가격으로부터 얼마나 벗어나 있는지에 대한 측정 자료<br>괴리도 = (현재가 - 이론가격) |
| 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 | 시장베이시스<br>현재 시장에서 형성된 선물가격과 현물가격과의 차이 |
| acpr | 행사가 | string | Y | 14 | 옵션의 행사가격 |
| output2 | 응답상세2 | object | 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 | object | 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 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code": "F",
"fid_input_iscd": "101S03"
}
```
### Response Example
```text
{
"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": "정상처리 되었습니다!"
}
```
docs/broker/kis/rest/국내선물옵션/기본시세/206_국내선물-021_국내선물-기초자산-시세.md
+116
View File
@@ -0,0 +1,116 @@
# 국내선물 기초자산 시세
- 원본 시트명: 국내선물 기초자산 시세
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: 국내선물-021
- HTTP Method: GET
- 실전 TR_ID: FHPIF05030000
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-top
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내선물 기초자산 시세 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0503] 선물옵션 종합시세(Ⅰ) 화면의 "상단 바" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | FHPIF05030000 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (F: 선물) |
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 선물최근월물 ex)(101V06) |
| FID_COND_MRKT_DIV_CODE1 | 조건 시장 분류 코드 | string | Y | 2 | 공백 |
| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | 공백 |
| FID_MTRT_CNT | 만기 수 | string | Y | 11 | 공백 |
| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object | Y | | |
| unas_prpr | 기초자산 현재가 | string | Y | 112 | |
| unas_prdy_vrss | 기초자산 전일 대비 | string | Y | 112 | |
| unas_prdy_vrss_sign | 기초자산 전일 대비 부호 | string | Y | 1 | |
| unas_prdy_ctrt | 기초자산 전일 대비율 | string | Y | 82 | |
| unas_acml_vol | 기초자산 누적 거래량 | string | Y | 18 | |
| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
| futs_prpr | 선물 현재가 | string | Y | 112 | |
| futs_prdy_vrss | 선물 전일 대비 | string | Y | 112 | |
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
| futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 82 | |
| output2 | 응답상세 | object array | Y | | array |
| hts_rmnn_dynu | HTS 잔존 일수 | string | Y | 5 | |
## 예제
### Request Example (Python)
```text
fid_cond_mrkt_div_code:F
fid_input_iscd:101V06
fid_cond_mrkt_div_code1:
fid_cond_scr_div_code:
fid_mtrt_cnt:
fid_cond_mrkt_cls_code:
```
### Response Example
```text
{
"output1": {
"unas_prpr": "367.25",
"unas_prdy_vrss": "-3.47",
"unas_prdy_vrss_sign": "5",
"unas_prdy_ctrt": "-0.94",
"unas_acml_vol": "161725000",
"hts_kor_isnm": "F 202406",
"futs_prpr": "369.35",
"futs_prdy_vrss": "-3.45",
"prdy_vrss_sign": "5",
"futs_prdy_ctrt": "-0.93"
},
"output2": [],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/국내선물옵션/기본시세/207_국내선물-018_선물옵션-일중예상체결추이.md
+805
View File
@@ -0,0 +1,805 @@
# 선물옵션 일중예상체결추이
- 원본 시트명: 선물옵션 일중예상체결추이
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: 국내선물-018
- HTTP Method: GET
- 실전 TR_ID: FHPIF05110100
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/quotations/exp-price-trend
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 일중예상체결추이 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0548] 선물옵션 예상체결추이 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | FHPIF05110100 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목번호 (지수선물:6자리, 지수옵션 9자리) |
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | F : 지수선물, O : 지수옵션 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object | Y | | |
| hts_kor_isnm | 영업 시간 | string | Y | 40 | |
| futs_antc_cnpr | 업종 지수 현재가 | string | Y | 112 | |
| antc_cntg_vrss_sign | 업종 지수 전일 대비 | string | Y | 1 | |
| futs_antc_cntg_vrss | 전일 대비 부호 | string | Y | 112 | |
| antc_cntg_prdy_ctrt | 업종 지수 전일 대비율 | string | Y | 82 | |
| futs_sdpr | 누적 거래 대금 | string | Y | 112 | |
| output2 | 응답상세 | object array | Y | | array |
| stck_cntg_hour | 주식체결시간 | string | Y | 6 | |
| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
| antc_cntg_vrss_sign | 예상체결대비부호 | string | Y | 1 | |
| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
| antc_cntg_prdy_ctrt | 예상체결전일대비율 | string | Y | 82 | |
## 예제
### Request Example (Python)
```text
FID_COND_MRKT_DIV_CODE:F
FID_INPUT_ISCD:101V06
```
### Response Example
```text
{
"output1": {
"hts_kor_isnm": "F 202406",
"futs_antc_cnpr": "0.000",
"antc_cntg_vrss_sign": "0",
"futs_antc_cntg_vrss": "0.000",
"antc_cntg_prdy_ctrt": "0.00",
"futs_sdpr": "376.95"
},
"output2": [
{
"stck_cntg_hour": "084500",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "380.00",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.05",
"antc_cntg_prdy_ctrt": "0.81"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "380.00",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.05",
"antc_cntg_prdy_ctrt": "0.81"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "380.00",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.05",
"antc_cntg_prdy_ctrt": "0.81"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "380.00",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.05",
"antc_cntg_prdy_ctrt": "0.81"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.95",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "3.00",
"antc_cntg_prdy_ctrt": "0.80"
},
{
"stck_cntg_hour": "084459",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.90",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.95",
"antc_cntg_prdy_ctrt": "0.78"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.80",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.85",
"antc_cntg_prdy_ctrt": "0.76"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.80",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.85",
"antc_cntg_prdy_ctrt": "0.76"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.75",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.80",
"antc_cntg_prdy_ctrt": "0.74"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.75",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.80",
"antc_cntg_prdy_ctrt": "0.74"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.75",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.80",
"antc_cntg_prdy_ctrt": "0.74"
},
{
"stck_cntg_hour": "084458",
"futs_antc_cnpr": "379.75",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.80",
"antc_cntg_prdy_ctrt": "0.74"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.75",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.80",
"antc_cntg_prdy_ctrt": "0.74"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.75",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.80",
"antc_cntg_prdy_ctrt": "0.74"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.75",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.80",
"antc_cntg_prdy_ctrt": "0.74"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084457",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084456",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084455",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.70",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.75",
"antc_cntg_prdy_ctrt": "0.73"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.60",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.65",
"antc_cntg_prdy_ctrt": "0.70"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084454",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084453",
"futs_antc_cnpr": "379.65",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.70",
"antc_cntg_prdy_ctrt": "0.72"
},
{
"stck_cntg_hour": "084453",
"futs_antc_cnpr": "379.60",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.65",
"antc_cntg_prdy_ctrt": "0.70"
},
{
"stck_cntg_hour": "084453",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084453",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084453",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084453",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
},
{
"stck_cntg_hour": "084453",
"futs_antc_cnpr": "379.55",
"antc_cntg_vrss_sign": "2",
"futs_antc_cntg_vrss": "2.60",
"antc_cntg_prdy_ctrt": "0.69"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/국내선물옵션/기본시세/208_v1_국내선물-008_선물옵션기간별시세일_주_월_년.md
+159
View File
@@ -0,0 +1,159 @@
# 선물옵션기간별시세(일_주_월_년)
- 원본 시트명: 선물옵션기간별시세(일_주_월_년)
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: v1_국내선물-008
- HTTP Method: GET
- 실전 TR_ID: FHKIF03020100
- 모의 TR_ID: FHKIF03020100
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-daily-fuopchartprice
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
(지수)선물옵션 기간별시세 데이터(일/주/월/년) 조회 (최대 100건 조회)
실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
모의계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token<br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)<br>법인(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 | [실전/모의투자]<br>FHKIF03020100 |
| custtype | 고객타입 | string | N | 1 | B : 법인<br>P : 개인 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션<br>JF: 주식선물, JO:주식옵션,<br>CF: 상품선물(금), 금리선물(국채), 통화선물(달러)<br>CM: 야간선물, EU: 야간옵션 |
| FID_INPUT_ISCD | 종목코드 | string | Y | 12 | 종목번호 (지수선물:6자리, 지수옵션 9자리) |
| FID_INPUT_DATE_1 | 조회 시작일자 | string | Y | 10 | 조회 시작일자 (ex. 20220401) |
| FID_INPUT_DATE_2 | 조회 종료일자 | string | Y | 10 | 조회 종료일자 (ex. 20220524)<br><br>※ 주(W), 월(M), 년(Y) 봉 조회 시에 아래 참고<br>ㅁ FID_INPUT_DATE_2 가 현재일 까지일때<br>. 주봉 조회 : 해당 주의 첫번째 영업일이 포함되어야함<br>. 월봉 조회 : 해당 월의 전월 일자로 시작되어야함<br>. 년봉 조회 : 해당 년의 전년도 일자로 시작되어야함<br>ㅁ FID_INPUT_DATE_2 가 현재일보다 이전일 때<br>. 주봉 조회 : 해당 주의 첫번째 영업일이 포함되어야함<br>. 월봉 조회 : 해당 월의 영업일이 포함되어야함<br>. 년봉 조회 : 해당 년의 영업일이 포함되어야함 |
| 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 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공 <br>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 | 변경 여부 |
## 예제
### Request Example (Python)
```text
"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 Example
```text
"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"
},
....
```
docs/broker/kis/rest/국내선물옵션/기본시세/209_국내선물-023_국내옵션전광판_선물.md
+239
View File
@@ -0,0 +1,239 @@
# 국내옵션전광판_선물
- 원본 시트명: 국내옵션전광판_선물
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: 국내선물-023
- HTTP Method: GET
- 실전 TR_ID: FHPIF05030200
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-futures
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내옵션전광판_선물 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0503] 선물옵션 종합시세(Ⅰ) 화면의 "하단" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | FHPIF05030200 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (F: 선물) |
| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20503) |
| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백: KOSPI200<br>MKI: 미니KOSPI200<br>WKM: KOSPI200위클리(월)<br>WKI: KOSPI200위클리(목)<br>KQI: KOSDAQ150 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object array | Y | | array |
| futs_shrn_iscd | 선물 단축 종목코드 | string | Y | 9 | |
| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
| futs_prpr | 선물 현재가 | string | Y | 112 | |
| futs_prdy_vrss | 선물 전일 대비 | string | Y | 112 | |
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
| futs_prdy_ctrt | 선물 전일 대비율 | string | Y | 82 | |
| hts_thpr | HTS 이론가 | string | Y | 112 | |
| acml_vol | 누적 거래량 | string | Y | 18 | |
| futs_askp | 선물 매도호가 | string | Y | 112 | |
| futs_bidp | 선물 매수호가 | string | Y | 112 | |
| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | |
| futs_hgpr | 선물 최고가 | string | Y | 112 | |
| futs_lwpr | 선물 최저가 | string | Y | 112 | |
| hts_rmnn_dynu | HTS 잔존 일수 | string | Y | 5 | |
| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 82 | |
## 예제
### Request Example (Python)
```text
FID_COND_MRKT_DIV_CODE:F
FID_COND_SCR_DIV_CODE:20503
FID_COND_MRKT_CLS_CODE:MKI
```
### Response Example
```text
{
"output": [
{
"futs_shrn_iscd": "105V05",
"hts_kor_isnm": "미니F 202405",
"futs_prpr": "368.28",
"futs_prdy_vrss": "-3.32",
"prdy_vrss_sign": "5",
"futs_prdy_ctrt": "-0.89",
"hts_thpr": "368.26",
"acml_vol": "91624",
"futs_askp": "368.28",
"futs_bidp": "368.26",
"hts_otst_stpl_qty": "38188",
"futs_hgpr": "372.86",
"futs_lwpr": "367.40",
"hts_rmnn_dynu": "28",
"total_askp_rsqn": "934",
"total_bidp_rsqn": "282",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
},
{
"futs_shrn_iscd": "105V06",
"hts_kor_isnm": "미니F 202406",
"futs_prpr": "369.48",
"futs_prdy_vrss": "-3.32",
"prdy_vrss_sign": "5",
"futs_prdy_ctrt": "-0.89",
"hts_thpr": "369.51",
"acml_vol": "621",
"futs_askp": "369.54",
"futs_bidp": "369.48",
"hts_otst_stpl_qty": "3433",
"futs_hgpr": "374.16",
"futs_lwpr": "368.64",
"hts_rmnn_dynu": "63",
"total_askp_rsqn": "68",
"total_bidp_rsqn": "53",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
},
{
"futs_shrn_iscd": "105V07",
"hts_kor_isnm": "미니F 202407",
"futs_prpr": "369.00",
"futs_prdy_vrss": "-3.98",
"prdy_vrss_sign": "5",
"futs_prdy_ctrt": "-1.07",
"hts_thpr": "369.43",
"acml_vol": "19",
"futs_askp": "370.24",
"futs_bidp": "367.52",
"hts_otst_stpl_qty": "31",
"futs_hgpr": "372.00",
"futs_lwpr": "369.00",
"hts_rmnn_dynu": "91",
"total_askp_rsqn": "257",
"total_bidp_rsqn": "13",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
},
{
"futs_shrn_iscd": "105V08",
"hts_kor_isnm": "미니F 202408",
"futs_prpr": "373.78",
"futs_prdy_vrss": "0.00",
"prdy_vrss_sign": "3",
"futs_prdy_ctrt": "0.00",
"hts_thpr": "370.41",
"acml_vol": "0",
"futs_askp": "403.58",
"futs_bidp": "344.00",
"hts_otst_stpl_qty": "1",
"futs_hgpr": "0.00",
"futs_lwpr": "0.00",
"hts_rmnn_dynu": "119",
"total_askp_rsqn": "4",
"total_bidp_rsqn": "5",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
},
{
"futs_shrn_iscd": "105V09",
"hts_kor_isnm": "미니F 202409",
"futs_prpr": "374.00",
"futs_prdy_vrss": "-0.50",
"prdy_vrss_sign": "5",
"futs_prdy_ctrt": "-0.13",
"hts_thpr": "371.67",
"acml_vol": "3",
"futs_askp": "404.36",
"futs_bidp": "369.82",
"hts_otst_stpl_qty": "10",
"futs_hgpr": "374.00",
"futs_lwpr": "371.00",
"hts_rmnn_dynu": "154",
"total_askp_rsqn": "4",
"total_bidp_rsqn": "12",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
},
{
"futs_shrn_iscd": "105V10",
"hts_kor_isnm": "미니F 202410",
"futs_prpr": "375.26",
"futs_prdy_vrss": "0.00",
"prdy_vrss_sign": "3",
"futs_prdy_ctrt": "0.00",
"hts_thpr": "371.72",
"acml_vol": "0",
"futs_askp": "405.18",
"futs_bidp": "345.34",
"hts_otst_stpl_qty": "0",
"futs_hgpr": "0.00",
"futs_lwpr": "0.00",
"hts_rmnn_dynu": "182",
"total_askp_rsqn": "4",
"total_bidp_rsqn": "4",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/국내선물옵션/기본시세/210_v1_국내선물-012_선물옵션-분봉조회.md
+206
View File
@@ -0,0 +1,206 @@
# 선물옵션 분봉조회
- 원본 시트명: 선물옵션 분봉조회
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: v1_국내선물-012
- HTTP Method: GET
- 실전 TR_ID: FHKIF03020200
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-time-fuopchartprice
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 분봉조회 API입니다.
실전계좌의 경우, 한 번의 호출에 최대 102건까지 확인 가능하며,
FID_INPUT_DATE_1(입력날짜), FID_INPUT_HOUR_1(입력시간)을 이용하여 다음조회 가능합니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션<br>JF: 주식선물, JO:주식옵션,<br>CF: 상품선물(금), 금리선물(국채), 통화선물(달러)<br>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)<br>ex) 20230908 입력 시, 2023년 9월 8일부터 일자 역순으로 조회 |
| FID_INPUT_HOUR_1 | FID 입력 시간1 | string | Y | 10 | 입력 시간 기준으로 이전 시간 조회(HHMMSS)<br>ex) 093000 입력 시, 오전 9시 30분부터 역순으로 분봉 조회<br><br>* CM(야간선물), EU(야간옵션)인 경우, 자정 이후 시간은 +24시간으로 입력<br>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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response 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시간으로 표시<br>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 | |
## 예제
### Request Example (Python)
```text
fid_cond_mrkt_div_code:F
fid_input_iscd:101V09
fid_hour_cls_code:30
fid_pw_data_incu_yn:N
fid_fake_tick_incu_yn:Y
fid_input_date_1:
fid_input_hour_1:
```
### Response Example
```text
{
"output1": {
"futs_prdy_vrss": "-0.30",
"prdy_vrss_sign": "5",
"futs_prdy_ctrt": "-0.08",
"futs_prdy_clpr": "359.90",
"prdy_nmix": "359.90",
"acml_vol": "349",
"acml_tr_pbmn": "31394925",
"hts_kor_isnm": "F 202409",
"futs_prpr": "359.60",
"futs_shrn_iscd": "101V09",
"prdy_vol": "721",
"futs_mxpr": "388.65",
"futs_llam": "331.15",
"futs_oprc": "361.50",
"futs_hgpr": "362.00",
"futs_lwpr": "357.20",
"futs_prdy_oprc": "364.95",
"futs_prdy_hgpr": "365.30",
"futs_prdy_lwpr": "358.60",
"futs_askp": "359.65",
"futs_bidp": "359.50",
"basis": "4.06",
"kospi200_nmix": "356.42",
"hts_otst_stpl_qty": "11529",
"otst_stpl_qty_icdc": "0",
"tday_rltv": "78.97",
"hts_thpr": "360.48",
"dprt": "-0.25"
},
"output2": [
{
"stck_bsop_date": "20240417",
"stck_cntg_hour": "141500",
"futs_prpr": "359.60",
"futs_oprc": "359.60",
"futs_hgpr": "359.60",
"futs_lwpr": "359.60",
"cntg_vol": "0",
"acml_tr_pbmn": "31394925"
},
{
"stck_bsop_date": "20240417",
"stck_cntg_hour": "141430",
"futs_prpr": "359.60",
"futs_oprc": "359.60",
"futs_hgpr": "359.60",
"futs_lwpr": "359.60",
"cntg_vol": "0",
"acml_tr_pbmn": "31394925"
},
{
"stck_bsop_date": "20240417",
"stck_cntg_hour": "141400",
"futs_prpr": "359.60",
"futs_oprc": "359.60",
"futs_hgpr": "359.60",
"futs_lwpr": "359.60",
"cntg_vol": "0",
"acml_tr_pbmn": "31394925"
},
{
"stck_bsop_date": "20240417",
"stck_cntg_hour": "141330",
"futs_prpr": "359.60",
"futs_oprc": "359.60",
"futs_hgpr": "359.60",
"futs_lwpr": "359.60",
"cntg_vol": "0",
"acml_tr_pbmn": "31394925"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/국내선물옵션/기본시세/211_국내선물-020_국내옵션전광판_옵션월물리스트.md
+133
View File
@@ -0,0 +1,133 @@
# 국내옵션전광판_옵션월물리스트
- 원본 시트명: 국내옵션전광판_옵션월물리스트
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: 국내선물-020
- HTTP Method: GET
- 실전 TR_ID: FHPIO056104C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-option-list
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내업종 국내옵션전광판_옵션월물리스트 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0503] 선물옵션 종합시세(Ⅰ) 화면의 "월물리스트 목록 확인" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | FHPIO056104C0 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(509) |
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 공백 |
| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object array | Y | | array |
| mtrt_yymm_code | 만기 년월 코드 | string | Y | 6 | |
| mtrt_yymm | 만기 년월 | string | Y | 6 | |
## 예제
### Request Example (Python)
```text
fid_cond_scr_div_code:509
fid_cond_mrkt_div_code:
fid_cond_mrkt_cls_code:
```
### Response Example
```text
{
"output": [
{
"mtrt_yymm_code": "0V05",
"mtrt_yymm": "202405"
},
{
"mtrt_yymm_code": "0V06",
"mtrt_yymm": "202406"
},
{
"mtrt_yymm_code": "0V07",
"mtrt_yymm": "202407"
},
{
"mtrt_yymm_code": "0V08",
"mtrt_yymm": "202408"
},
{
"mtrt_yymm_code": "0V09",
"mtrt_yymm": "202409"
},
{
"mtrt_yymm_code": "0V10",
"mtrt_yymm": "202410"
},
{
"mtrt_yymm_code": "0V12",
"mtrt_yymm": "202412"
},
{
"mtrt_yymm_code": "0W03",
"mtrt_yymm": "202503"
},
{
"mtrt_yymm_code": "0W06",
"mtrt_yymm": "202506"
},
{
"mtrt_yymm_code": "0W12",
"mtrt_yymm": "202512"
},
{
"mtrt_yymm_code": "0612",
"mtrt_yymm": "202612"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/국내선물옵션/기본시세/212_v1_국내선물-007_선물옵션-시세호가.md
+175
View File
@@ -0,0 +1,175 @@
# 선물옵션 시세호가
- 원본 시트명: 선물옵션 시세호가
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: v1_국내선물-007
- HTTP Method: GET
- 실전 TR_ID: FHMIF10010000
- 모의 TR_ID: FHMIF10010000
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/quotations/inquire-asking-price
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 시세호가 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전/모의투자]<br>FHMIF10010000 : 선물 옵션 시세 호가 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객타입 | string | N | 1 | B : 법인<br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | F: 지수선물, O:지수옵션<br>JF: 주식선물, JO:주식옵션<br>CF: 상품선물(금), 금리선물(국채), 통화선물(달러)<br>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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공<br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| output1 | 응답상세1 | object | Y | | |
| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | 종목명 |
| futs_prpr | 선물 현재가 | string | Y | 14 | 선물의 현재가격 |
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | 1 : 상한 <br>2 : 상승<br>3 : 보합<br>4 : 하한<br>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 | object array | Y | | Array |
| 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 | 가장 최근 호가의 접수 시간 |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code" : "F",
"fid_input_iscd" : "101S06"
}
```
### Response Example
```text
{
"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": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/국내선물옵션/기본시세/213_국내선물-022_국내옵션전광판_콜풋.md
+268
View File
@@ -0,0 +1,268 @@
# 국내옵션전광판_콜풋
- 원본 시트명: 국내옵션전광판_콜풋
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 기본시세
- API ID: 국내선물-022
- HTTP Method: GET
- 실전 TR_ID: FHPIF05030100
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/quotations/display-board-callput
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내옵션전광판_콜풋 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0503] 선물옵션 종합시세(Ⅰ) 화면의 "중앙" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
※ output1, output2 각각 100건까지만 확인이 가능합니다. (FY25년도 서비스 개선 예정)
※ 조회시간이 긴 API인 점 참고 부탁드리며, 잦은 호출을 삼가해주시기 바랍니다. (1초당 최대 1건 권장)
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | FHPIF05030100 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (O: 옵션) |
| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20503) |
| FID_MRKT_CLS_CODE | 시장 구분 코드 | string | Y | 2 | 시장구분코드 (CO: 콜옵션) |
| FID_MTRT_CNT | 만기 수 | string | Y | 11 | - FID_COND_MRKT_CLS_CODE : 공백(KOSPI200), MKI(미니KOSPI200), KQI(KOSDAQ150) 인 경우<br>: 만기년월(YYYYMM) 입력 (ex. 202407)<br><br>- FID_COND_MRKT_CLS_CODE : WKM(KOSPI200위클리(월)), WKI(KOSPI200위클리(목)) 인 경우<br>: 만기년월주차(YYMMWW) 입력<br>(ex. 2024년도 7월 3주차인 경우, 240703 입력) |
| FID_COND_MRKT_CLS_CODE | 조건 시장 구분 코드 | string | Y | 6 | 공백: KOSPI200<br>MKI: 미니KOSPI200<br>WKM: KOSPI200위클리(월)<br>WKI: KOSPI200위클리(목)<br>KQI: KOSDAQ150 |
| FID_MRKT_CLS_CODE1 | 시장 구분 코드 | string | Y | 2 | 시장구분코드 (PO: 풋옵션) |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object array | Y | | array |
| acpr | 행사가 | string | Y | 112 | |
| unch_prpr | 환산 현재가 | string | Y | 112 | |
| optn_shrn_iscd | 옵션 단축 종목코드 | string | Y | 9 | |
| optn_prpr | 옵션 현재가 | string | Y | 112 | |
| optn_prdy_vrss | 옵션 전일 대비 | string | Y | 112 | |
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
| optn_prdy_ctrt | 옵션 전일 대비율 | string | Y | 82 | |
| optn_bidp | 옵션 매수호가 | string | Y | 112 | |
| optn_askp | 옵션 매도호가 | string | Y | 112 | |
| tmvl_val | 시간가치 값 | string | Y | 132 | |
| nmix_sdpr | 지수 기준가 | string | Y | 112 | |
| acml_vol | 누적 거래량 | string | Y | 18 | |
| seln_rsqn | 매도 잔량 | string | Y | 12 | |
| shnu_rsqn | 매수2 잔량 | string | Y | 12 | |
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | |
| otst_stpl_qty_icdc | 미결제 약정 수량 증감 | string | Y | 10 | |
| delta_val | 델타 값 | string | Y | 114 | |
| gama | 감마 | string | Y | 84 | |
| vega | 베가 | string | Y | 84 | |
| theta | 세타 | string | Y | 84 | |
| rho | 로우 | string | Y | 84 | |
| hts_ints_vltl | HTS 내재 변동성 | string | Y | 114 | |
| invl_val | 내재가치 값 | string | Y | 132 | |
| esdg | 괴리도 | string | Y | 114 | |
| dprt | 괴리율 | string | Y | 82 | |
| hist_vltl | 역사적 변동성 | string | Y | 114 | |
| hts_thpr | HTS 이론가 | string | Y | 112 | |
| optn_oprc | 옵션 시가2 | string | Y | 112 | |
| optn_hgpr | 옵션 최고가 | string | Y | 112 | |
| optn_lwpr | 옵션 최저가 | string | Y | 112 | |
| optn_mxpr | 옵션 상한가 | string | Y | 112 | |
| optn_llam | 옵션 하한가 | string | Y | 112 | |
| atm_cls_name | ATM 구분 명 | string | Y | 10 | |
| rgbf_vrss_icdc | 직전 대비 증감 | string | Y | 10 | |
| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 82 | |
| output2 | 응답상세 | object array | Y | | array |
| acpr | 행사가 | string | Y | 112 | |
| unch_prpr | 환산 현재가 | string | Y | 112 | |
| optn_shrn_iscd | 옵션 단축 종목코드 | string | Y | 9 | |
| optn_prpr | 옵션 현재가 | string | Y | 112 | |
| optn_prdy_vrss | 옵션 전일 대비 | string | Y | 112 | |
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
| optn_prdy_ctrt | 옵션 전일 대비율 | string | Y | 82 | |
| optn_bidp | 옵션 매수호가 | string | Y | 112 | |
| optn_askp | 옵션 매도호가 | string | Y | 112 | |
| tmvl_val | 시간가치 값 | string | Y | 132 | |
| nmix_sdpr | 지수 기준가 | string | Y | 112 | |
| acml_vol | 누적 거래량 | string | Y | 18 | |
| seln_rsqn | 매도 잔량 | string | Y | 12 | |
| shnu_rsqn | 매수2 잔량 | string | Y | 12 | |
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
| hts_otst_stpl_qty | HTS 미결제 약정 수량 | string | Y | 18 | |
| otst_stpl_qty_icdc | 미결제 약정 수량 증감 | string | Y | 10 | |
| delta_val | 델타 값 | string | Y | 114 | |
| gama | 감마 | string | Y | 84 | |
| vega | 베가 | string | Y | 84 | |
| theta | 세타 | string | Y | 84 | |
| rho | 로우 | string | Y | 84 | |
| hts_ints_vltl | HTS 내재 변동성 | string | Y | 114 | |
| invl_val | 내재가치 값 | string | Y | 132 | |
| esdg | 괴리도 | string | Y | 114 | |
| dprt | 괴리율 | string | Y | 82 | |
| hist_vltl | 역사적 변동성 | string | Y | 114 | |
| hts_thpr | HTS 이론가 | string | Y | 112 | |
| optn_oprc | 옵션 시가2 | string | Y | 112 | |
| optn_hgpr | 옵션 최고가 | string | Y | 112 | |
| optn_lwpr | 옵션 최저가 | string | Y | 112 | |
| optn_mxpr | 옵션 상한가 | string | Y | 112 | |
| optn_llam | 옵션 하한가 | string | Y | 112 | |
| atm_cls_name | ATM 구분 명 | string | Y | 10 | |
| rgbf_vrss_icdc | 직전 대비 증감 | string | Y | 10 | |
| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
| futs_antc_cnpr | 선물예상체결가 | string | Y | 112 | |
| futs_antc_cntg_vrss | 선물예상체결대비 | string | Y | 112 | |
| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 82 | |
## 예제
### Request Example (Python)
```text
fid_cond_mrkt_div_code:O
fid_cond_scr_div_code:20503
fid_mrkt_cls_code:CO
fid_mtrt_cnt:202405
fid_cond_mrkt_cls_code:
fid_mrkt_cls_code1:PO
```
### Response Example
```text
{
"output1": [
{
"acpr": "480.00",
"unch_prpr": "3505.17",
"optn_shrn_iscd": "201V05480",
"optn_prpr": "0.01",
"optn_prdy_vrss": "0.00",
"prdy_vrss_sign": "3",
"optn_prdy_ctrt": "0.00",
"optn_bidp": "0.00",
"optn_askp": "0.01",
"tmvl_val": "0.01",
"nmix_sdpr": "0.01",
"acml_vol": "34",
"seln_rsqn": "1710",
"shnu_rsqn": "0",
"acml_tr_pbmn": "85",
"hts_otst_stpl_qty": "642",
"otst_stpl_qty_icdc": "39",
"delta_val": "0.0000",
"gama": "0.0000",
"vega": "0.0000",
"theta": "-0.0000",
"rho": "0.0000",
"hts_ints_vltl": "31.5614",
"invl_val": "0.00",
"esdg": "0.01",
"dprt": "9999.99",
"hist_vltl": "16.9285",
"hts_thpr": "0.00",
"optn_oprc": "0.01",
"optn_hgpr": "0.01",
"optn_lwpr": "0.01",
"optn_mxpr": "5.20",
"optn_llam": "0.01",
"atm_cls_name": "OTM",
"rgbf_vrss_icdc": "1",
"total_askp_rsqn": "1710",
"total_bidp_rsqn": "0",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
},
...
],
"output2": [
{
"acpr": "480.00",
"unch_prpr": "3505.17",
"optn_shrn_iscd": "301V05480",
"optn_prpr": "108.45",
"optn_prdy_vrss": "0.00",
"prdy_vrss_sign": "3",
"optn_prdy_ctrt": "0.00",
"optn_bidp": "78.35",
"optn_askp": "142.60",
"tmvl_val": "-4.30",
"nmix_sdpr": "108.45",
"acml_vol": "0",
"seln_rsqn": "10",
"shnu_rsqn": "10",
"acml_tr_pbmn": "0",
"hts_otst_stpl_qty": "48",
"otst_stpl_qty_icdc": "0",
"delta_val": "-1.0000",
"gama": "0.0000",
"vega": "0.0000",
"theta": "0.0460",
"rho": "-0.3541",
"hts_ints_vltl": "0.0000",
"invl_val": "112.75",
"esdg": "-3.06",
"dprt": "-2.74",
"hist_vltl": "16.9285",
"hts_thpr": "111.51",
"optn_oprc": "0.00",
"optn_hgpr": "0.00",
"optn_lwpr": "0.00",
"optn_mxpr": "142.60",
"optn_llam": "78.35",
"atm_cls_name": "ITM",
"rgbf_vrss_icdc": "0",
"total_askp_rsqn": "10",
"total_bidp_rsqn": "10",
"futs_antc_cnpr": "0.00",
"futs_antc_cntg_vrss": "0.00",
"antc_cntg_vrss_sign": "0",
"antc_cntg_prdy_ctrt": "0.00"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/190_국내선물-024_야간선물옵션-증거금-상세.md
+285
View File
@@ -0,0 +1,285 @@
# (야간)선물옵션 증거금 상세
- 원본 시트명: (야간)선물옵션 증거금 상세
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: 국내선물-024
- HTTP Method: GET
- 실전 TR_ID: (구) JTCE6003R (신) CTFN7107R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/ngt-margin-detail
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
(야간)선물옵션 증거금상세 API입니다.
한국투자 HTS(eFriend Plus) &gt; [2537] 야간선물옵션 증거금상세 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | (구) JTCE6003R (신) CTFN7107R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
| MGNA_DVSN_CD | 증거금 구분코드 | string | Y | 2 | 위탁(01), 유지(02) |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object array | Y | | array<br>아래 18가지 항목이 순서대로 출력됨<br>(1) A. 신규증거금 - 선물 - 1.개별종목<br>(2) A. 신규증거금 - 선물 - 2.스프레드<br>(3) A. 신규증거금 - 3. 옵션매수증거금<br>(4) A. 신규증거금 - 4. 옵션매도증거금<br>(5) A. 소계(1+2+3+4)<br>(6) B. 순위험증거금 - 1. 가격변동증거금<br>(7) B. 순위험증거금 - 2. 선물스프레드증거금<br>(8) B. 순위험증거금 - 3. 인수수도 증거금 등<br>(9) B. 순위험증거금 - 4. 최소증거금<br>(10) B. 순위험증거금 - 5. 옵션가격증거금<br>(11) B. 순위험증거금 - 6. 총위험증거금<br>(12) B. 소계SUM상품군별MAX[{MAX(1+2+3,4)+5},6]<br>(13) C. 결제예정금액 - 1. 당일옵션매수금액<br>(14) C. 결제예정금액 - 2. 당일옵션매도금액<br>(15) C. 결제예정금액 - 3. 당일선물손실<br>(16) C. 결제예정금액 - 4. 당일선물이익 <br>(17) C.소계(1-2+3-4)<br>(18) (A)+B+(C) |
| cash_amt | 현금금액 | string | Y | 19 | |
| tot_amt | 총금액 | string | Y | 19 | |
| output2 | 응답상세 | object array | Y | | array<br>아래 5가지 항목이 순서대로 출력됨<br>(1) 예수금<br>(2) 인출가능금액<br>(3) 주문가능금액<br>(4) 위탁증거금액<br>(5) 추가증거금액<br><br>※ 인출가능금액은 정산 후 인출가능 예정 금액입니다.<br>현재 시점 실제 인출 가능금액은 정규장, 야간시장 인출가능금액 중 적은 금액 기준입니다. |
| cash_amt | 현금금액 | string | Y | 19 | |
| sbst_amt | 대용금액 | string | Y | 19 | |
| tot_amt | 총금액 | string | Y | 19 | |
| output3 | 응답상세 | object | Y | | |
| base_dpsa_gdat_grad_cd | 기본예탁금차등등급코드 | string | Y | 2 | |
| bfdy_sbst_sll_ccld_amt | 전일대용매도체결금액 | string | Y | 19 | |
| bfdy_sbst_sll_sbst_amt | 전일대용매도대용금액 | string | Y | 19 | |
| excc_dfpa | 정산차금 | string | Y | 19 | |
| fee_amt | 수수료금액 | string | Y | 19 | |
| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
| opt_base_dpsa_gdat_grad_cd | 옵션기본예탁금차등등급코드 | string | Y | 2 | |
| opt_buy_exus_acnt_yn | 옵션매수전용계좌여부 | string | Y | 1 | |
| opt_dfpa | 옵션차금 | string | Y | 19 | |
| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
| thdt_sbst_sll_ccld_amt | 당일대용매도체결금액 | string | Y | 19 | |
| thdt_sbst_sll_sbst_amt | 당일대용매도대용금액 | string | Y | 19 | |
| output1 | 응답상세 | object array | Y | | Array 신 TR 사용 필드 |
| futr_new_mgn_amt | 선물신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| futr_sprd_ord_mgna | 선물스프레드주문증거금 | string | Y | 19 | 신 TR 사용 필드 |
| opt_sll_new_mgn_amt | 옵션매도신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| opt_buy_new_mgn_amt | 옵션매수신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| new_mgn_amt | 신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| opt_pric_mgna | 옵션가격증거금 | string | Y | 19 | 신 TR 사용 필드 |
| fuop_pric_altr_mgna | 선물옵션가격변동증거금 | string | Y | 19 | 신 TR 사용 필드 |
| futr_sprd_mgna | 선물스프레드증거금 | string | Y | 19 | 신 TR 사용 필드 |
| uwdl_mgna | 인수도증거금 | string | Y | 19 | 신 TR 사용 필드 |
| ctrt_per_min_mgna | 계약당최소증거금 | string | Y | 19 | 신 TR 사용 필드 |
| tot_risk_mgna | 총위험증거금 | string | Y | 19 | 신 TR 사용 필드 |
| netrisk_brkg_mgna | 순위험위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
| opt_sll_chgs | 옵션매도대금 | string | Y | 19 | 신 TR 사용 필드 |
| opt_buy_chgs | 옵션매수대금 | string | Y | 19 | 신 TR 사용 필드 |
| futr_loss_amt | 선물손실금액 | string | Y | 19 | 신 TR 사용 필드 |
| futr_prft_amt | 선물이익금액 | string | Y | 19 | 신 TR 사용 필드 |
| thdt_ccld_net_loss_amt | 당일체결순손실금액 | string | Y | 19 | 신 TR 사용 필드 |
| brkg_mgna | 위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
| output2 | 응답상세 | object array | Y | | Array 신 TR 사용 필드 |
| futr_new_mgn_amt | 선물신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| futr_sprd_ord_mgna | 선물스프레드주문증거금 | string | Y | 19 | 신 TR 사용 필드 |
| opt_sll_new_mgn_amt | 옵션매도신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| opt_buy_new_mgn_amt | 옵션매수신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| new_mgn_amt | 신규증거금액 | string | Y | 19 | 신 TR 사용 필드 |
| opt_pric_mgna | 옵션가격증거금 | string | Y | 19 | 신 TR 사용 필드 |
| fuop_pric_altr_mgna | 선물옵션가격변동증거금 | string | Y | 19 | 신 TR 사용 필드 |
| futr_sprd_mgna | 선물스프레드증거금 | string | Y | 19 | 신 TR 사용 필드 |
| uwdl_mgna | 인수도증거금 | string | Y | 19 | 신 TR 사용 필드 |
| ctrt_per_min_mgna | 계약당최소증거금 | string | Y | 19 | 신 TR 사용 필드 |
| tot_risk_mgna | 총위험증거금 | string | Y | 19 | 신 TR 사용 필드 |
| netrisk_brkg_mgna | 순위험위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
| opt_sll_chgs | 옵션매도대금 | string | Y | 19 | 신 TR 사용 필드 |
| opt_buy_chgs | 옵션매수대금 | string | Y | 19 | 신 TR 사용 필드 |
| futr_loss_amt | 선물손실금액 | string | Y | 19 | 신 TR 사용 필드 |
| futr_prft_amt | 선물이익금액 | string | Y | 19 | 신 TR 사용 필드 |
| thdt_ccld_net_loss_amt | 당일체결순손실금액 | string | Y | 19 | 신 TR 사용 필드 |
| brkg_mgna | 위탁증거금 | string | Y | 19 | 신 TR 사용 필드 |
| output3 | 응답상세 | object | Y | | Single 신 TR 사용 필드 |
| dnca_cash | 예수금현금 | string | Y | 19 | 신 TR 사용 필드 |
| dnca_sbst | 예수금대용 | string | Y | 19 | 신 TR 사용 필드 |
| dnca_tota | 예수금총액 | string | Y | 19 | 신 TR 사용 필드 |
| wdrw_psbl_cash_amt | 인출가능현금금액 | string | Y | 19 | 신 TR 사용 필드 |
| wdrw_psbl_sbsa | 인출가능대용금액 | string | Y | 19 | 신 TR 사용 필드 |
| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | 신 TR 사용 필드 |
| ord_psbl_cash_amt | 주문가능현금금액 | string | Y | 19 | 신 TR 사용 필드 |
| ord_psbl_sbsa | 주문가능대용금액 | string | Y | 19 | 신 TR 사용 필드 |
| ord_psbl_tot_amt | 주문가능총금액 | string | Y | 19 | 신 TR 사용 필드 |
| brkg_mgna_cash_amt | 위탁증거금현금금액 | string | Y | 19 | 신 TR 사용 필드 |
| brkg_mgna_sbst | 위탁증거금대용 | string | Y | 19 | 신 TR 사용 필드 |
| brkg_mgna_tot_amt | 위탁증거금총금액 | string | Y | 19 | 신 TR 사용 필드 |
| add_mgna_cash_amt | 추가증거금현금금액 | string | Y | 19 | 신 TR 사용 필드 |
| add_mgna_sbsa | 추가증거금대용금액 | string | Y | 19 | 신 TR 사용 필드 |
| add_mgna_tot_amt | 추가증거금총금액 | string | Y | 19 | 신 TR 사용 필드 |
| bfdy_sbst_sll_sbst_amt | 전일대용매도대용금액 | string | Y | 19 | 신 TR 사용 필드 |
| thdt_sbst_sll_sbst_amt | 당일대용매도대용금액 | string | Y | 19 | 신 TR 사용 필드 |
| bfdy_sbst_sll_ccld_amt | 전일대용매도체결금액 | string | Y | 19 | 신 TR 사용 필드 |
| thdt_sbst_sll_ccld_amt | 당일대용매도체결금액 | string | Y | 19 | 신 TR 사용 필드 |
| opt_dfpa | 옵션차금 | string | Y | 19 | 신 TR 사용 필드 |
| excc_dfpa | 정산차금 | string | Y | 19 | 신 TR 사용 필드 |
| fee_amt | 수수료금액 | string | Y | 19 | 신 TR 사용 필드 |
| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | 신 TR 사용 필드 |
| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | 신 TR 사용 필드 |
| opt_buy_exus_acnt_yn | 옵션매수전용계좌여부 | string | Y | 19 | 신 TR 사용 필드 |
| base_dpsa_gdat_grad_cd | 기본예탁금차등등급코드 | string | Y | 19 | 신 TR 사용 필드 |
| opt_base_dpsa_gdat_grad_cd | 옵션기본예탁금차등등급코드 | string | Y | 19 | 신 TR 사용 필드 |
## 예제
### Request Example (Python)
```text
CANO:12345678
ACNT_PRDT_CD:03
MGNA_DVSN_CD:01
```
### Response Example
```text
{
"output1": [
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
}
],
"output2": [
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "0",
"sbst_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"sbst_amt": "0",
"tot_amt": "0"
}
],
"output3": {
"bfdy_sbst_sll_sbst_amt": "0",
"thdt_sbst_sll_sbst_amt": "0",
"bfdy_sbst_sll_ccld_amt": "0",
"thdt_sbst_sll_ccld_amt": "0",
"opt_buy_exus_acnt_yn": "N",
"base_dpsa_gdat_grad_cd": "03",
"opt_dfpa": "0",
"excc_dfpa": "0",
"fee_amt": "0",
"nxdy_dncl_amt": "100000000",
"prsm_dpast_amt": "100000000",
"opt_base_dpsa_gdat_grad_cd": "01"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/191_v1_국내선물-014_선물옵션-총자산현황.md
+146
View File
@@ -0,0 +1,146 @@
# 선물옵션 총자산현황
- 원본 시트명: 선물옵션 총자산현황
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-014
- HTTP Method: GET
- 실전 TR_ID: CTRP6550R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-deposit
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 총자산현황 API 입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | CTRP6550R |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output | 응답상세 | object | Y | | |
| dnca_tota | 예수금총액 | string | Y | 19 | |
| bfdy_chck_amt | 전일수표금액 | string | Y | 19 | |
| thdt_chck_amt | 당일수표금액 | string | Y | 19 | |
| rlth_uwdl_dpos_amt | 실물인수도예치금액 | string | Y | 19 | |
| brkg_mgna_cash | 위탁증거금현금 | string | Y | 19 | |
| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | |
| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
| ord_psbl_tota | 주문가능총액 | string | Y | 19 | |
| dnca_sbst | 예수금대용 | string | Y | 19 | |
| scts_sbst_amt | 유가증권대용금액 | string | Y | 19 | |
| frcr_evlu_amt | 외화평가금액 | string | Y | 19 | |
| brkg_mgna_sbst | 위탁증거금대용 | string | Y | 19 | |
| sbst_rlse_psbl_amt | 대용해제가능금액 | string | Y | 19 | |
| mtnc_rt | 유지비율 | string | Y | 238 | |
| add_mgna_tota | 추가증거금총액 | string | Y | 19 | |
| add_mgna_cash | 추가증거금현금 | string | Y | 19 | |
| rcva | 미수금 | string | Y | 19 | |
| futr_trad_pfls | 선물매매손익 | string | Y | 19 | |
| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | |
| trad_pfls_smtl | 매매손익합계 | string | Y | 19 | |
| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | |
| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | |
| evlu_pfls_smtl | 평가손익합계 | string | Y | 19 | |
| excc_dfpa | 정산차금 | string | Y | 19 | |
| opt_dfpa | 옵션차금 | string | Y | 19 | |
| brkg_fee | 위탁수수료 | string | Y | 19 | |
| nxdy_dnca | 익일예수금 | string | Y | 19 | |
| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
| cash_mntn_amt | 현금유지금액 | string | Y | 19 | |
| hack_acdt_acnt_move_amt | 해킹사고계좌이전금액 | string | Y | 19 | |
## 예제
### Request Example (Python)
```text
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
}
```
### Response Example
```text
{
"output": {
"dnca_tota": "100000000",
"bfdy_chck_amt": "0",
"thdt_chck_amt": "0",
"rlth_uwdl_dpos_amt": "0",
"brkg_mgna_cash": "17907612",
"wdrw_psbl_tot_amt": "34046775",
"ord_psbl_cash": "64184775",
"ord_psbl_tota": "64184775",
"dnca_sbst": "0",
"scts_sbst_amt": "0",
"frcr_evlu_amt": "0",
"brkg_mgna_sbst": "17907613",
"sbst_rlse_psbl_amt": "0",
"mtnc_rt": "418.23000000",
"add_mgna_tota": "0",
"add_mgna_cash": "0",
"rcva": "0",
"futr_trad_pfls": "0",
"opt_trad_pfls_amt": "0",
"trad_pfls_smtl": "0",
"futr_evlu_pfls_amt": "4187500",
"opt_evlu_pfls_amt": "-697500",
"evlu_pfls_smtl": "3490000",
"excc_dfpa": "-30138000",
"opt_dfpa": "0",
"brkg_fee": "0",
"nxdy_dnca": "69862000",
"prsm_dpast_amt": "69864500",
"cash_mntn_amt": "0",
"hack_acdt_acnt_move_amt": "0"
},
"rt_cd": "0",
"msg_cd": "APRP0126",
"msg1": "조회이(가) 완료되었습니다. "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/192_v1_국내선물-017_선물옵션기간약정수수료일별.md
+268
View File
@@ -0,0 +1,268 @@
# 선물옵션기간약정수수료일별
- 원본 시트명: 선물옵션기간약정수수료일별
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-017
- HTTP Method: GET
- 실전 TR_ID: CTFO6119R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-daily-amount-fee
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션기간약정수수료일별 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | CTFO6119R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| INQR_STRT_DAY | 조회시작일 | string | Y | 8 | 조회시작일(YYYYMMDD) |
| INQR_END_DAY | 조회종료일 | string | Y | 8 | 조회종료일(YYYYMMDD) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | array | Y | | array |
| ord_dt | 주문일자 | string | Y | 8 | |
| pdno | 상품번호 | string | Y | 12 | |
| item_name | 종목명 | string | Y | 60 | |
| sll_agrm_amt | 매도약정금액 | string | Y | 19 | |
| sll_fee | 매도수수료 | string | Y | 19 | |
| buy_agrm_amt | 매수약정금액 | string | Y | 19 | |
| buy_fee | 매수수수료 | string | Y | 19 | |
| tot_fee_smtl | 총수수료합계 | string | Y | 19 | |
| trad_pfls | 매매손익 | string | Y | 19 | |
| output2 | 응답상세2 | object | Y | | |
| futr_agrm | 선물약정 | string | Y | 19 | |
| futr_agrm_amt | 선물약정금액 | string | Y | 19 | |
| futr_agrm_amt_smtl | 선물약정금액합계 | string | Y | 19 | |
| futr_sll_fee_smtl | 선물매도수수료합계 | string | Y | 19 | |
| futr_buy_fee_smtl | 선물매수수수료합계 | string | Y | 19 | |
| futr_fee_smtl | 선물수수료합계 | string | Y | 19 | |
| opt_agrm | 옵션약정 | string | Y | 19 | |
| opt_agrm_amt | 옵션약정금액 | string | Y | 19 | |
| opt_agrm_amt_smtl | 옵션약정금액합계 | string | Y | 19 | |
| opt_sll_fee_smtl | 옵션매도수수료합계 | string | Y | 19 | |
| opt_buy_fee_smtl | 옵션매수수수료합계 | string | Y | 19 | |
| opt_fee_smtl | 옵션수수료합계 | string | Y | 19 | |
| prdt_futr_agrm | 상품선물약정 | string | Y | 19 | |
| prdt_fuop | 상품선물옵션 | string | Y | 19 | |
| prdt_futr_evlu_amt | 상품선물평가금액 | string | Y | 8 | |
| futr_fee | 선물수수료 | string | Y | 19 | |
| opt_fee | 옵션수수료 | string | Y | 19 | |
| fee | 수수료 | string | Y | 19 | |
| sll_agrm_amt | 매도약정금액 | string | Y | 19 | |
| buy_agrm_amt | 매수약정금액 | string | Y | 19 | |
| agrm_amt_smtl | 약정금액합계 | string | Y | 19 | |
| sll_fee | 매도수수료 | string | Y | 19 | |
| buy_fee | 매수수수료 | string | Y | 19 | |
| fee_smtl | 수수료합계 | string | Y | 19 | |
| trad_pfls_smtl | 매매손익합계 | string | Y | 19 | |
## 예제
### Request Example (Python)
```text
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"INQR_STRT_DAY":"20230901",
"INQR_END_DAY":"20230920",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
```
### Response Example
```text
{
"ctx_area_fk200": "12345678!^03!^20230901!^20230920 ",
"ctx_area_nk200": " !^ ",
"output1": [
{
"ord_dt": "20230901",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230904",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230905",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230906",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230907",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230908",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230911",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230914",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230920",
"pdno": "KR4101TC0008",
"item_name": "F 202312",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "419375000",
"buy_fee": "41140",
"tot_fee_smtl": "41140",
"trad_pfls": "0"
},
{
"ord_dt": "20230920",
"pdno": "KR4201TA3409",
"item_name": "C 202310 340.0",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "700000",
"buy_fee": "2750",
"tot_fee_smtl": "2750",
"trad_pfls": "0"
}
],
"output2": {
"futr_agrm": "0",
"futr_agrm_amt": "419375000",
"futr_agrm_amt_smtl": "419375000",
"futr_sll_fee_smtl": "0",
"futr_buy_fee_smtl": "41140",
"futr_fee_smtl": "41140",
"opt_agrm": "0",
"opt_agrm_amt": "700000",
"opt_agrm_amt_smtl": "700000",
"opt_sll_fee_smtl": "0",
"opt_buy_fee_smtl": "2750",
"opt_fee_smtl": "2750",
"prdt_futr_agrm": "0",
"prdt_fuop": "0",
"prdt_futr_evlu_amt": "0",
"futr_fee": "0",
"opt_fee": "0",
"fee": "0",
"sll_agrm_amt": "0",
"buy_agrm_amt": "420075000",
"agrm_amt_smtl": "420075000",
"sll_fee": "0",
"buy_fee": "43890",
"fee_smtl": "43890",
"trad_pfls_smtl": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/193_국내선물-010_야간선물옵션-잔고현황.md
+203
View File
@@ -0,0 +1,203 @@
# (야간)선물옵션 잔고현황
- 원본 시트명: (야간)선물옵션 잔고현황
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: 국내선물-010
- HTTP Method: GET
- 실전 TR_ID: (구) JTCE6001R (신) CTFN6118R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ngt-balance
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
(야간)선물옵션 잔고현황 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | (구) JTCE6001R (신) CTFN6118R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| ACNT_PWD | 계좌비밀번호 | string | Y | 84 | 공란("")으로 조회 |
| MGNA_DVSN | 증거금구분 | string | Y | 2 | 01 : 개시, 02 : 유지 |
| EXCC_STAT_CD | 정산상태코드 | string | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)<br>2 : 본정산 (매입가격으로 잔고 조회) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output2 | 응답상세2 | object | Y | | |
| dnca_cash | 예수금현금 | string | Y | 19 | 총주문수량 |
| frcr_dncl_amt | 외화예수금액 | string | Y | 19 | 주문채번지점번호 |
| dnca_sbst | 예수금대용 | string | Y | 19 | |
| tot_dncl_amt | 총예수금액 | string | Y | 19 | |
| cash_mgna | 현금증거금 | string | Y | 19 | |
| sbst_mgna | 대용증거금 | string | Y | 19 | |
| mgna_tota | 증거금총액 | string | Y | 19 | |
| opt_dfpa | 옵션차금 | string | Y | 19 | |
| thdt_dfpa | 당일차금 | string | Y | 19 | |
| rnwl_dfpa | 갱신차금 | string | Y | 19 | |
| fee | 수수료 | string | Y | 19 | |
| nxdy_dnca | 익일예수금 | string | Y | 19 | |
| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
| prsm_dpast | 추정예탁자산 | string | Y | 19 | 종합계좌번호 |
| pprt_ord_psbl_cash | 적정주문가능현금 | string | Y | 19 | 총체결수량 |
| add_mgna_cash | 추가증거금현금 | string | Y | 19 | 총체결금액 |
| add_mgna_tota | 추가증거금총액 | string | Y | 19 | 종합계좌명 |
| futr_trad_pfls_amt | 선물매매손익금액 | string | Y | 19 | 수수료 |
| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | 계좌상품코드 |
| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | 주문일자 |
| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | 주문번호 |
| trad_pfls_amt_smtl | 매매손익금액합계 | string | Y | 19 | |
| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | |
| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | |
| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | |
| ord_psbl_tota | 주문가능총액 | string | Y | 19 | |
| mmga_tot_amt | 유지증거금총금액 | string | Y | 19 | 신규 TR 미사용 필드 |
| mmga_cash_amt | 유지증거금현금금액 | string | Y | 19 | 신규 TR 미사용 필드 |
| mtnc_rt | 유지비율 | string | Y | 32238 | 신규 TR 미사용 필드 |
| isfc_amt | 부족금액 | string | Y | 19 | 신규 TR 미사용 필드 |
| pchs_amt_smtl | 매입금액합계 | string | Y | 19 | |
| evlu_amt_smtl | 평가금액합계 | string | Y | 19 | |
| output1 | 응답상세2 | object array | Y | | 시간별체결 정보 |
| cano | 종합계좌번호 | string | Y | 8 | |
| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
| pdno | 상품번호 | string | Y | 12 | |
| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
| shtn_pdno | 단축상품번호 | string | Y | 12 | |
| prdt_name | 상품명 | string | Y | 60 | |
| sll_buy_dvsn_name | 매도매수구분명 | string | Y | 4 | 신규 TR 사용 필드 |
| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
| cblc_qty | 잔고수량 | string | Y | 19 | |
| excc_unpr | 정산단가 | string | Y | 32238 | |
| ccld_avg_unpr1 | 체결평균단가1 | string | Y | 32238 | |
| idx_clpr | 지수종가 | string | Y | 32238 | |
| pchs_amt | 매입금액 | string | Y | 19 | |
| evlu_amt | 평가금액 | string | Y | 19 | |
| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
| trad_pfls_amt | 매매손익금액 | string | Y | 19 | |
| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | |
## 예제
### Request Example (Python)
```text
{
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"ACNT_PWD":"",
"MGNA_DVSN":"01",
"EXCC_STAT_CD":"1",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
```
### Response Example
```text
{
"ctx_area_fk200": "80012345^03^01^1^ ",
"ctx_area_nk200": " ",
"output1": [
{
"cano": "80012345",
"acnt_prdt_cd": "03",
"pdno": "KR4101SC0009",
"prdt_type_cd": "301",
"shtn_pdno": "101S12",
"prdt_name": "F 202212",
"sll_buy_dvsn_cd": "02",
"trad_dvsn_name": "매수",
"cblc_qty": "3",
"excc_unpr": "309.10000000",
"ccld_avg_unpr1": "320.50000000",
"idx_clpr": "307.45000000",
"pchs_amt": "231825000",
"evlu_amt": "230587500",
"evlu_pfls_amt": "-1237500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "3"
}
],
"output2": {
"dnca_cash": "10101527360",
"frcr_dncl_amt": "0",
"dnca_sbst": "0",
"tot_dncl_amt": "10101527360",
"cash_mgna": "108922232",
"sbst_mgna": "133854708",
"mgna_tota": "242776940",
"opt_dfpa": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "-16200000",
"fee": "0",
"nxdy_dnca": "10085327360",
"prsm_dpast": "10085327360",
"pprt_ord_psbl_cash": "9858750420",
"add_mgna_cash": "0",
"add_mgna_tota": "0",
"futr_trad_pfls_amt": "0",
"opt_trad_pfls_amt": "0",
"futr_evlu_pfls_amt": "-1237500",
"opt_evlu_pfls_amt": "0",
"trad_pfls_amt_smtl": "0",
"evlu_pfls_amt_smtl": "-1237500",
"wdrw_psbl_tot_amt": "9858750420",
"ord_psbl_cash": "9858750420",
"ord_psbl_sbst": "0",
"ord_psbl_tota": "9858750420",
"mmga_tot_amt": "0",
"mmga_cash_amt": "0",
"mtnc_rt": "0.00000000",
"isfc_amt": "0",
"pchs_amt_smtl": "231825000",
"evlu_amt_smtl": "230587500"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/194_v1_국내선물-004_선물옵션-잔고현황.md
+355
View File
@@ -0,0 +1,355 @@
# 선물옵션 잔고현황
- 원본 시트명: 선물옵션 잔고현황
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-004
- HTTP Method: GET
- 실전 TR_ID: CTFO6118R
- 모의 TR_ID: VTFO6118R
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-balance
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 잔고현황 API입니다. 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전투자]<br>CTFO6118R : 선물 옵션 잔고 현황<br><br>[모의투자] <br>VTFO6118R : 선물 옵션 잔고 현황 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객타입 | string | N | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| MGNA_DVSN | 증거금 구분 | string | Y | 2 | 01 : 개시<br>02 : 유지 |
| EXCC_STAT_CD | 정산상태코드 | string | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)<br>2 : 본정산 (매입가격으로 잔고 조회) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공<br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
| output1 | 응답상세1 | array | Y | | |
| cano | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| pdno | 상품번호 | string | Y | 12 | 선물옵션종목코드 |
| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
| shtn_pdno | 단축상품번호 | string | Y | 12 | 단축상품번호 (예: 101P09) |
| prdt_name | 상품명 | string | Y | 60 | |
| sll_buy_dvsn_name | 매도매수구분명 | string | Y | 4 | 매도/매수 구분의 명칭<br><br>- 매수잔고를 가진 경우, "매수" 혹은 "BUY"로 출력<br>- 매도잔고를 가진 경우, "매도" 혹은 "SLL"로 출력<br>- 당일 잔고를 청산하여 잔고를 가지고 있지 않은 경우 빈칸으로 출력 |
| cblc_qty | 잔고수량 | string | Y | 10 | 보유한 종목의 수량 |
| excc_unpr | 정산단가 | string | Y | 32 | 당일 종가로 정산한 가격 |
| ccld_avg_unpr1 | 체결평균단가1 | string | Y | 32 | 보유한 종목의 평균 체결 가격 |
| idx_clpr | 지수종가 | string | Y | 32 | |
| pchs_amt | 매입금액 | string | Y | 19 | 보유 종목을 매수한 금액 |
| evlu_amt | 평가금액 | string | Y | 19 | 보유 종목을 현재가로 평가하여 산출한 금액 |
| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | 매입금액과 평가금액을 비교한 손익 |
| trad_pfls_amt | 매매손익금액 | string | Y | 19 | 매수와 매도가 완료된 수량에 대한 실현 손익 |
| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | 청산 가능한 수량 |
| output2 | 응답상세2 | object | Y | | |
| dnca_cash | 예수금현금 | string | Y | 19 | 원화로 보유한 현금 (현금미수금액, 수수료미수금액 차감) |
| frcr_dncl_amt | 외화예수금액 | string | Y | 19 | 외화로 보유한 현금 |
| dnca_sbst | 예수금대용 | string | Y | 19 | 주식대용금액+채권대용금액+전일대용매도대용금액+당일대용매도대용금액 |
| tot_dncl_amt | 총예수금액 | string | Y | 19 | 상기 3개 예수금 항목의 합계 금액 |
| tot_ccld_amt | 총체결금액 | string | Y | 19 | 체결된 주문의 합계금액 |
| cash_mgna | 현금증거금 | string | Y | 19 | 원화 현금 중 주문증거금으로 사용된 금액 |
| sbst_mgna | 대용증거금 | string | Y | 19 | 대용 예수금 중 주문증거금으로 사용된 금액 |
| mgna_tota | 증거금총액 | string | Y | 19 | 증거금으로 사용된 항목의 합계 금액 |
| opt_dfpa | 옵션차금 | string | Y | 19 | 당일옵션매도금에서 당일옵션매수금을 차감한 금액 |
| thdt_dfpa | 당일차금 | string | Y | 19 | 당일의 각 매수거래에 대하여 1에 의하여 산출한 금액의 합계액과 당일의 각 매도거래에 대하여 2에 의하여 산출한 금액의 합계액을 합산한 금액<br>1. 매수거래수량*(당일의 정산가격-체결가격)*최소가격변동금액*환산승수<br>2. 매도거래수량*(체결가격-당일의 정산가격)*최소가격변동금액*환산승수 |
| rnwl_dfpa | 갱신차금 | string | Y | 19 | 직전 거래일의 매수미결제약정에 대하여 1에 의하여 산출한 금액과 직전거래일의 매도미결제약정에 대하여 2에 의하여 산출한 금액을 합산한 금액<br>1. 매수미결제약정*(당일의 정산가격-직전거래일의 정산가격)*최소가격변동 금액*환산승수<br>2. 매도미결제약정*(직전거래일의 정산가격-당일의 정산가격)*최소가격변동 금액*환산승수 |
| fee | 수수료 | string | Y | 19 | 체결된 주문에 의한 매매수수료 |
| nxdy_dnca | 익일예수금 | string | Y | 19 | 당일 매매내역을 근거로 익일(결제일) 고객님 계좌에 있는 현금 |
| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
| prsm_dpast | 추정예탁자산 | string | Y | 19 | 보유한 잔고를 정산 기준으로 평가한 금액과 예수금을 합한 금액 |
| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
| pprt_ord_psbl_cash | 적정주문가능현금 | string | Y | 19 | 미수없는 주문가능금액 |
| add_mgna_cash | 추가증거금현금 | string | Y | 19 | 장 종료 후 예탁평가액이 유지증거금을 하회할 경우 또는 예탁현금이 결제금액 보다 적은 경우 고객이 추가적으로 납부해야<br>하는 증거금 |
| add_mgna_tota | 추가증거금총액 | string | Y | 19 | |
| futr_trad_pfls_amt | 선물매매손익금액 | string | Y | 19 | 선물 매수와 매도가 완료된 수량에 대한 실현 손익 |
| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | 옵션 매수와 매도가 완료된 수량에 대한 실현 손익 |
| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | 선물 잔고의 매입가격 또는 정산가격과 평가금액을 비교한 손익 |
| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | 옵션 잔고의 매입가격 또는 정산가격과 평가금액을 비교한 손익 |
| trad_pfls_amt_smtl | 매매손익금액합계 | string | Y | 19 | 선물매매손익금액과 옵션매매손익금액을 합한 금액 |
| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | 선물평가손익금액과 옵션평가손익금액을 합한 금액 |
| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | 출금 가능한 현금(예탁현금+예탁대용-예탁증거금총액) |
| ord_psbl_cash | 주문가능현금 | string | Y | 19 | 예수금현금에서 현금증거금을 차감한 금액 |
| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | 예수금대용에서 대용증거금을 차감한 금액 |
| ord_psbl_tota | 주문가능총액 | string | Y | 19 | 주문가능현금과 주문가능대용을 합한 금액 |
| pchs_amt_smtl | 매입금액합계 | string | Y | 19 | 종목별 매입금액의 합계 금액 |
| evlu_amt_smtl | 평가금액합계 | string | Y | 19 | 종목별 평가금액의 합계 금액 |
## 예제
### Request Example (Python)
```text
{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"3",
"MGNA_DVSN": "01",
"EXCC_STAT_CD": "1",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}
```
### Response Example
```text
{
"ctx_area_fk200": "연속조회검색조건200을 입력하세요.",
"output1": {
"lqd_psbl_qty": [
"6",
"133",
"110",
"1000",
"1000",
"1000",
"1000",
"1",
"25"
],
"pdno": [
"KR4101RC0000",
"KR4101S30001",
"KR4111RA0000",
"KR41ACRC0005",
"KR41ACS60004",
"KR41ADRC0004",
"KR41ADS30005",
"KR41AES90007",
"KR41DRRA0007"
],
"prdt_type_cd": [
"301",
"301",
"301",
"301",
"301",
"301",
"301",
"301",
"301"
],
"pchs_amt": [
"586950000",
"12937575000",
"78980000",
"3003000000",
"3012000000",
"5686000000",
"5672000000",
"2610000",
"21350000"
],
"sll_buy_dvsn_name": [
"SLL",
"BUY",
"BUY",
"BUY",
"SLL",
"BUY",
"SLL",
"SLL",
"BUY"
],
"trad_pfls_amt": [
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"shtn_pdno": [
"101R12",
"101S03",
"111R10",
"1ACR12",
"1ACS06",
"1ADR12",
"1ADS03",
"1AES09",
"1DRR10"
],
"acnt_prdt_cd": [
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"cblc_qty": [
"6",
"133",
"110",
"1000",
"1000",
"1000",
"1000",
"1",
"25"
],
"excc_unpr": [
"391.30000000",
"389.10000000",
"71800.00000000",
"3003.00000000",
"3012.00000000",
"5686.00000000",
"5672.00000000",
"2610.00000000",
"85400.00000000"
],
"cano": [
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"idx_clpr": [
"380.55000000",
"389.10000000",
"71800.00000000",
"3003.00000000",
"3012.00000000",
"5686.00000000",
"5672.00000000",
"2610.00000000",
"85400.00000000"
],
"ccld_avg_unpr1": [
"402.28975400",
"406.38538995",
"71618.18181818",
"4626.00000000",
"4766.50000000",
"6992.50000000",
"5695.50000000",
"3430.50000000",
"87700.00000000"
],
"evlu_pfls_amt": [
"16125000",
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"evlu_amt": [
"570825000",
"12937575000",
"78980000",
"3003000000",
"3012000000",
"5686000000",
"5672000000",
"2610000",
"21350000"
],
"prdt_name": [
"F 202112",
"F 202203",
"SamsungEle F 202110 ( 10)",
"BBIG K-NewDeal F 202112",
"BBIG K-NewDeal F 202206",
"Battery K-NewDeal F 202112",
"Battery K-NewDeal F 202203",
"Bio K-NewDeal F 202209",
"C2S F 202110 ( 10)"
]
},
"rt_cd": "0",
"output2": {
"nxdy_dnca": "90016125000",
"sbst_mgna": "1391065523",
"cash_mgna": "0",
"ord_psbl_tota": "88608934477",
"opt_dfpa": "0",
"fee": "0",
"pchs_amt_smtl": "31000465000",
"prsm_dpast": "90016125000",
"evlu_pfls_amt_smtl": "16125000",
"thdt_dfpa": "0",
"prsm_dpast_amt": "90016125000",
"frcr_dncl_amt": "0",
"pprt_ord_psbl_cash": "88608934477",
"evlu_amt_smtl": "30984340000",
"futr_trad_pfls_amt": "0",
"rnwl_dfpa": "16125000",
"futr_evlu_pfls_amt": "16125000",
"wdrw_psbl_tot_amt": "88608934477",
"dnca_sbst": "0",
"opt_evlu_pfls_amt": "0",
"dnca_cash": "90000000000",
"tot_dncl_amt": "90000000000",
"nxdy_dncl_amt": "90016125000",
"tot_ccld_amt": "0",
"opt_trad_pfls_amt": "0",
"trad_pfls_amt_smtl": "0",
"ord_psbl_cash": "88608934477",
"mgna_tota": "1391065523",
"ord_psbl_sbst": "0",
"add_mgna_tota": "0",
"add_mgna_cash": "0"
},
"msg1": "조회 되었습니다. (마지막 자료) ",
"msg_cd": "KIOK0460",
"ctx_area_nk200": ""
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/195_v1_국내선물-001_선물옵션-주문.md
+122
View File
@@ -0,0 +1,122 @@
# 선물옵션 주문
- 원본 시트명: 선물옵션 주문
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-001
- HTTP Method: POST
- 실전 TR_ID: (주간 매수/매도) TTTO1101U (야간 매수/매도) (구) JTCE1001U (신) STTN1101U
- 모의 TR_ID: (주간 매수/매도) VTTO1101U (야간은 모의투자 미제공)
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/trading/order
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
​선물옵션 주문 API입니다.
* 선물옵션 운영시간 외 API 호출 시 애러가 발생하오니 운영시간을 확인해주세요.
※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전투자]<br>TTTO1101U : 선물 옵션 매수 매도 주문 주간 <br>(신) STTN1101U : 선물 옵션 매수 매도 주문 야간 <br><br>[모의투자]<br>VTTO1101U : 선물 옵션 매수 매도 주문 주간 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객타입 | string | N | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| ORD_PRCS_DVSN_CD | 주문처리구분코드 | string | Y | 2 | 02 : 주문전송 |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도<br>02 : 매수 |
| SHTN_PDNO | 단축상품번호 | string | Y | 12 | 종목번호<br>선물 6자리 (예: A01603)<br>옵션 9자리 (예: B01603955) |
| ORD_QTY | 주문수량 | string | Y | 10 | |
| UNIT_PRICE | 주문가격1 | string | Y | 23 | 시장가나 최유리 지정가인 경우 0으로 입력 |
| NMPR_TYPE_CD | 호가유형코드 | string | N | 2 | ※ ORD_DVSN_CD(주문구분코드)를 입력한 경우 ""(공란)으로 입력해도 됨<br>01 : 지정가<br>02 : 시장가 <br>03 : 조건부<br>04 : 최유리 |
| KRX_NMPR_CNDT_CD | 한국거래소호가조건코드 | string | N | 1 | ※ ORD_DVSN_CD(주문구분코드)를 입력한 경우 ""(공란)으로 입력해도 됨<br>0 : 없음<br>3 : IOC<br>4 : FOK |
| CTAC_TLNO | 연락전화번호 | string | N | 20 | 고객의 연락 가능한 전화번호 |
| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | string | N | 2 | 공란(Default) |
| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | 01 : 지정가<br>02 : 시장가<br>03 : 조건부<br>04 : 최유리,<br>10 : 지정가(IOC)<br>11 : 지정가(FOK)<br>12 : 시장가(IOC)<br>13 : 시장가(FOK)<br>14 : 최유리(IOC)<br>15 : 최유리(FOK) |
### Response Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공<br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| output | 응답상세 | array | Y | | |
| ACNT_NAME | 계좌명 | string | Y | 60 | 계좌의 고객명 |
| TRAD_DVSN_NAME | 매매구분명 | string | Y | 60 | 매도/매수 등 구분값 |
| ITEM_NAME | 종목명 | string | Y | 60 | 주문 종목 명칭 |
| ORD_TMD | 주문시각 | string | Y | 6 | 주문 접수 시간 |
| ORD_GNO_BRNO | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
| ODNO | 주문번호 | string | Y | 10 | 접수한 주문의 일련번호 |
## 예제
### Request Example (Python)
```text
{
"ORD_PRCS_DVSN_CD":"02",
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"SLL_BUY_DVSN_CD":"02",
"SHTN_PDNO":"167R12",
"ORD_QTY":"1",
"UNIT_PRICE":"123",
"NMPR_TYPE_CD":"",
"KRX_NMPR_CNDT_CD":"",
"CTAC_TLNO":"",
"FUOP_ITEM_DVSN_CD":"",
"ORD_DVSN_CD":"01"
}
```
### Response Example
```text
{
"rt_cd": "0",
"msg_cd": "APBK0029",
"msg1": "주문전송이 정상적으로 처리되었습니다.",
"output": {
"ACNT_NAME": "류민수",
"TRAD_DVSN_NAME": "매도",
"ITEM_NAME": "코스피200 F 202203",
"ORD_TMD": "131604",
"ORD_GNO_BRNO": "06010",
"ODNO": "0000007045"
}
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/196_v1_국내선물-015_선물옵션-잔고평가손익내역.md
+245
View File
@@ -0,0 +1,245 @@
# 선물옵션 잔고평가손익내역
- 원본 시트명: 선물옵션 잔고평가손익내역
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-015
- HTTP Method: GET
- 실전 TR_ID: CTFO6159R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-balance-valuation-pl
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 잔고평가손익내역 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | CTFO6159R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| MGNA_DVSN | 증거금구분 | string | Y | 2 | 01 : 개시, 02 : 유지 |
| EXCC_STAT_CD | 정산상태코드 | string | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)<br>2 : 본정산 (매입가격으로 잔고 조회) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output2 | 응답상세 | object | Y | | |
| dnca_cash | 예수금현금 | string | Y | 19 | |
| frcr_dncl_amt | 외화예수금액 | string | Y | 19 | |
| dnca_sbst | 예수금대용 | string | Y | 19 | |
| tot_dncl_amt | 총예수금액 | string | Y | 19 | |
| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
| cash_mgna | 현금증거금 | string | Y | 19 | |
| sbst_mgna | 대용증거금 | string | Y | 19 | |
| mgna_tota | 증거금총액 | string | Y | 19 | |
| opt_dfpa | 옵션차금 | string | Y | 19 | |
| thdt_dfpa | 당일차금 | string | Y | 19 | |
| rnwl_dfpa | 갱신차금 | string | Y | 19 | |
| fee | 수수료 | string | Y | 19 | |
| nxdy_dnca | 익일예수금 | string | Y | 19 | |
| nxdy_dncl_amt | 익일예수금액 | string | Y | 19 | |
| prsm_dpast | 추정예탁자산 | string | Y | 19 | |
| prsm_dpast_amt | 추정예탁자산금액 | string | Y | 19 | |
| pprt_ord_psbl_cash | 적정주문가능현금 | string | Y | 19 | |
| add_mgna_cash | 추가증거금현금 | string | Y | 19 | |
| add_mgna_tota | 추가증거금총액 | string | Y | 19 | |
| futr_trad_pfls_amt | 선물매매손익금액 | string | Y | 19 | |
| opt_trad_pfls_amt | 옵션매매손익금액 | string | Y | 19 | |
| futr_evlu_pfls_amt | 선물평가손익금액 | string | Y | 19 | |
| opt_evlu_pfls_amt | 옵션평가손익금액 | string | Y | 19 | |
| trad_pfls_amt_smtl | 매매손익금액합계 | string | Y | 19 | |
| evlu_pfls_amt_smtl | 평가손익금액합계 | string | Y | 19 | |
| wdrw_psbl_tot_amt | 인출가능총금액 | string | Y | 19 | |
| ord_psbl_cash | 주문가능현금 | string | Y | 19 | |
| ord_psbl_sbst | 주문가능대용 | string | Y | 19 | |
| ord_psbl_tota | 주문가능총액 | string | Y | 19 | |
| output1 | 응답상세2 | array | Y | | array |
| cano | 종합계좌번호 | string | Y | 8 | |
| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
| pdno | 상품번호 | string | Y | 12 | |
| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
| shtn_pdno | 단축상품번호 | string | Y | 12 | |
| prdt_name | 상품명 | string | Y | 60 | |
| sll_buy_dvsn_name | 매도매수구분명 | string | Y | 4 | |
| cblc_qty1 | 잔고수량1 | string | Y | 10 | |
| excc_unpr | 정산단가 | string | Y | 24 | |
| ccld_avg_unpr1 | 체결평균단가1 | string | Y | 24 | |
| idx_clpr | 지수종가 | string | Y | 24 | |
| pchs_amt | 매입금액 | string | Y | 19 | |
| evlu_amt | 평가금액 | string | Y | 19 | |
| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
| trad_pfls_amt | 매매손익금액 | string | Y | 19 | |
| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | |
## 예제
### Request Example (Python)
```text
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"MGNA_DVSN":"02",
"EXCC_STAT_CD":"1",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
```
### Response Example
```text
{
"ctx_area_fk200": "12345678!^03!^02!^1 ",
"ctx_area_nk200": " !^ !^ !^ ",
"output1": [
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4101T90003",
"prdt_type_cd": "301",
"shtn_pdno": "101T09",
"prdt_name": "F 202309",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "2",
"excc_unpr": "340.30000000",
"ccld_avg_unpr1": "345.50000000",
"idx_clpr": "0.00000000",
"pchs_amt": "170150000",
"evlu_amt": "0",
"evlu_pfls_amt": "0",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "2"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4101TC0008",
"prdt_type_cd": "301",
"shtn_pdno": "101T12",
"prdt_name": "F 202312",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "5",
"excc_unpr": "350.00000000",
"ccld_avg_unpr1": "335.50000000",
"idx_clpr": "353.35000000",
"pchs_amt": "437500000",
"evlu_amt": "441687500",
"evlu_pfls_amt": "4187500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "5"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4175TA0001",
"prdt_type_cd": "301",
"shtn_pdno": "175T10",
"prdt_name": "미국달러 F 202310",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "1",
"excc_unpr": "1349.20000000",
"ccld_avg_unpr1": "1338.60000000",
"idx_clpr": "0.00000000",
"pchs_amt": "13492000",
"evlu_amt": "0",
"evlu_pfls_amt": "0",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "1"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4201TA3409",
"prdt_type_cd": "301",
"shtn_pdno": "201T10340",
"prdt_name": "C 202310 340.0",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "1",
"excc_unpr": "2.80000000",
"ccld_avg_unpr1": "2.80000000",
"idx_clpr": "0.01000000",
"pchs_amt": "700000",
"evlu_amt": "2500",
"evlu_pfls_amt": "-697500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "1"
}
],
"output2": {
"dnca_cash": "100000000",
"frcr_dncl_amt": "0",
"dnca_sbst": "0",
"tot_dncl_amt": "100000000",
"tot_ccld_amt": "0",
"cash_mgna": "0",
"sbst_mgna": "23910150",
"mgna_tota": "23910150",
"opt_dfpa": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "-30138000",
"fee": "0",
"nxdy_dnca": "69862000",
"nxdy_dncl_amt": "69862000",
"prsm_dpast": "69864500",
"prsm_dpast_amt": "69864500",
"pprt_ord_psbl_cash": "64184775",
"add_mgna_cash": "0",
"add_mgna_tota": "0",
"futr_trad_pfls_amt": "0",
"opt_trad_pfls_amt": "0",
"futr_evlu_pfls_amt": "4187500",
"opt_evlu_pfls_amt": "-697500",
"trad_pfls_amt_smtl": "0",
"evlu_pfls_amt_smtl": "3490000",
"wdrw_psbl_tot_amt": "34046775",
"ord_psbl_cash": "64184775",
"ord_psbl_sbst": "0",
"ord_psbl_tota": "64184775"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/197_선물옵션-증거금률_선물옵션-증거금률.md
+79
View File
@@ -0,0 +1,79 @@
# 선물옵션 증거금률
- 원본 시트명: 선물옵션 증거금률
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: 선물옵션 증거금률
- HTTP Method: GET
- 실전 TR_ID: TTTO6032R
- 모의 TR_ID: 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/quotations/margin-rate
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
※ 승수, 계약당 선물 증거금은 최근월물 기준으로 표기되며, 월물에 따라 상이할 수 있습니다.
※ 계약당 선물 증거금은 선물 1계약 기준 신규 주문증거금이며 스프레드 증거금은 조회되지 않습니다.
※ 2023.05.24일부터 조회 가능하며, 익영업일 기준 증거금은 17:00~18:00시에 조회됩니다.
※ 데이터는 하루에 한 번 고정된 이후 데이터 변동이 없으므로 조회가 제한되는 점 이용에 참고 부탁드립니다.
## 레이아웃
### 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 <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | TTTO6032R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회 <br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| BASS_DT | 기준일자 | string | Y | 8 | 날짜 입력) ex) 20260313 |
| BAST_ID | 기초자산ID | string | Y | 20 | 공백 입력 |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 다음 조회 시 필요, 입력 후 header tr_cont : N 설정 필수 |
### 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 | 공백 : 초기 조회 <br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output | 응답상세 | object array | Y | | Array |
| bast_id | 기초자산ID | string | Y | 20 | |
| bast_name | 기초자산명 | string | Y | 60 | |
| brkg_mgna_rt | 위탁증거금율 | string | Y | 23 | 소수점 8자리까지 표현 |
| tr_mgna_rt | 거래증거금율 | string | Y | 23 | 소수점 8자리까지 표현 |
| bast_pric | 기초자산가격 | string | Y | 18 | 소수점 8자리까지 표현 |
| tr_mtpl_idx | 거래승수지수 | string | Y | 18 | 소수점 8자리까지 표현 |
| ctrt_per_futr_mgna | 계약당선물증거금 | string | Y | 18 | 소수점 8자리까지 표현 |
## 메모
- Request Example (Python)
- Response Example
docs/broker/kis/rest/국내선물옵션/주문/계좌/198_v1_국내선물-002_선물옵션-정정취소주문.md
+106
View File
@@ -0,0 +1,106 @@
# 선물옵션 정정취소주문
- 원본 시트명: 선물옵션 정정취소주문
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-002
- HTTP Method: POST
- 실전 TR_ID: (주간 정정/취소) TTTO1103U (야간 정정/취소) (구) JTCE1002U (신) STTN1103U
- 모의 TR_ID: (주간 정정/취소) VTTO1103U (야간은 모의투자 미제공)
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/trading/order-rvsecncl
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 주문 건에 대하여 정정 및 취소하는 API입니다. 단, 이미 체결된 건은 정정 및 취소가 불가합니다.
※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전투자]<br>TTTO1103U : 선물 옵션 정정 취소 주문 주간<br><br>(신) STTN1103U : 선물 옵션 정정 취소 주문 야간 <br>[모의투자]<br>VTTO1103U : 선물 옵션 정정 취소 주문 주간 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객타입 | string | N | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| ORD_PRCS_DVSN_CD | 주문처리구분코드 | string | Y | 2 | 02 : 주문전송 |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | string | Y | 2 | 01 : 정정<br>02 : 취소 |
| ORGN_ODNO | 원주문번호 | string | Y | 10 | 정정 혹은 취소할 주문의 번호 |
| ORD_QTY | 주문수량 | string | Y | 10 | [Header tr_id TTTO1103U(선물옵션 정정취소 주간)]<br>전량일경우 0으로 입력<br><br>[Header tr_id JTCE1002U(선물옵션 정정취소 야간)]<br>일부수량 정정 및 취소 불가, 주문수량 반드시 입력 (공백 불가)<br>일부 미체결 시 잔량 전체에 대해서 취소 가능<br>EX) 2개 매수주문 후 1개 체결, 1개 미체결인 상태에서 취소주문 시 ORD_QTY는 1로 입력<br><br>※ 모의계좌의 경우, 주문수량 반드시 입력 (공백 불가) |
| UNIT_PRICE | 주문가격1 | string | Y | 23 | 시장가나 최유리의 경우 0으로 입력 (취소 시에도 0 입력) |
| NMPR_TYPE_CD | 호가유형코드 | string | Y | 2 | 01 : 지정가<br>02 : 시장가<br>03 : 조건부<br>04 : 최유리 |
| KRX_NMPR_CNDT_CD | 한국거래소호가조건코드 | string | Y | 1 | 취소시 0으로 입력<br>정정시<br>0 : 없음<br>3 : IOC<br>4 : FOK |
| RMN_QTY_YN | 잔여수량여부 | string | Y | 1 | Y : 전량<br>N : 일부 |
| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | string | N | 2 | [Header tr_id TTTO1103U(선물옵션 정정취소 주간)]<br>공란(Default)<br><br>[Header tr_id JTCE1002U(선물옵션 정정취소 야간)]<br>01 : 선물<br>02 : 콜옵션<br>03 : 풋옵션<br>04 : 스프레드 |
| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | [정정]<br>01 : 지정가<br>02 : 시장가<br>03 : 조건부<br>04 : 최유리,<br>10 : 지정가(IOC)<br>11 : 지정가(FOK)<br>12 : 시장가(IOC)<br>13 : 시장가(FOK)<br>14 : 최유리(IOC)<br>15 : 최유리(FOK)<br><br>[취소]<br>01 로 입력 |
### Response Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공<br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| output | 응답상세 | array | Y | | |
| ACNT_NAME | 계좌명 | string | Y | 60 | 계좌의 고객명 |
| TRAD_DVSN_NAME | 매매구분명 | string | Y | 60 | 매도/매수 등 구분값 |
| ITEM_NAME | 종목명 | string | Y | 60 | 주문 종목 명칭 |
| ORD_TMD | 주문시각 | string | Y | 6 | 주문 접수 시간 |
| ORD_GNO_BRNO | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
| ORGN_ODNO | 원주문번호 | string | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
| ODNO | 주문번호 | string | Y | 10 | 접수한 주문(정정 또는 취소)의 일련번호 |
## 예제
### Request Example (Python)
```text
{
"ORD_PRCS_DVSN_CD": "02",
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "03",
"RVSE_CNCL_DVSN_CD": "02",
"ORGN_ODNO": "0000005605",
"ORD_QTY": "1",
"UNIT_PRICE": "460.00",
"NMPR_TYPE_CD": "",
"KRX_NMPR_CNDT_CD": "",
"RMN_QTY_YN": "N",
"CTAC_TLNO": "000 00000000",
"FUOP_ITEM_DVSN_CD": "",
"ORD_DVSN_CD": "01"
}
```
## 메모
- Response Example
docs/broker/kis/rest/국내선물옵션/주문/계좌/199_v1_국내선물-003_선물옵션-주문체결내역조회.md
+208
View File
@@ -0,0 +1,208 @@
# 선물옵션 주문체결내역조회
- 원본 시트명: 선물옵션 주문체결내역조회
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-003
- HTTP Method: GET
- 실전 TR_ID: TTTO5201R
- 모의 TR_ID: VTTO5201R
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ccnl
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 주문체결내역조회 API입니다. 한 번의 호출에 최대 100건​까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전투자] <br>TTTO5201R : 선물 옵션 주문 체결 내역 조회<br><br>[모의투자] <br>VTTO5201R : 선물 옵션 주문 체결 내역 조회 |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객타입 | string | N | 1 | B : 법인<br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| STRT_ORD_DT | 시작주문일자 | string | Y | 8 | 주문내역 조회 시작 일자, YYYYMMDD |
| END_ORD_DT | 종료주문일자 | string | Y | 8 | 주문내역 조회 마지막 일자, YYYYMMDD |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 00 : 전체<br>01 : 매도<br>02 : 매수 |
| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 00 : 전체<br>01 : 체결<br>02 : 미체결 |
| SORT_SQN | 정렬순서 | string | Y | 2 | AS : 정순<br>DS : 역순 |
| STRT_ODNO | 시작주문번호 | string | Y | 10 | 조회 시작 번호 입력 |
| PDNO | 상품번호 | string | Y | 12 | 공란 시, 전체 조회<br>선물 6자리 (예: 101S03)<br>옵션 9자리 (예: 201S03370) |
| MKET_ID_CD | 시장ID코드 | string | Y | 3 | 공란(Default) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
### 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 : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공<br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| ctx_area_fk200 | 연속조회검색조건200 | string | Y | 200 | |
| ctx_area_nk200 | 연속조회키200 | string | Y | 200 | |
| output1 | 응답상세1 | array | Y | | |
| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
| cano | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| csac_name | 종합계좌명 | string | Y | 60 | 계좌의 고객명 |
| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| ord_dt | 주문일자 | string | Y | 8 | 주문의 접수일자 |
| odno | 주문번호 | string | Y | 10 | 접수한 주문의 일련번호 |
| orgn_odno | 원주문번호 | string | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | 00 : 전체 <br>01 : 매도 <br>02 : 매수 |
| trad_dvsn_name | 매매구분명 | string | Y | 60 | 매도/매수 등 구분값 |
| nmpr_type_cd | 호가유형코드 | string | Y | 2 | 01 : 지정가<br>02 : 시장가<br>03 : 조건부<br>04 : 최유리 |
| nmpr_type_name | 호가유형명 | string | Y | 60 | 호가 유형의 명칭 |
| pdno | 상품번호 | string | Y | 12 | 선물옵션종목코드 |
| prdt_name | 상품명 | string | Y | 60 | |
| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
| ord_qty | 주문수량 | string | Y | 10 | 주문 수량 |
| ord_idx | 주문지수 | string | Y | 24 | 주문 가격 |
| qty | 잔량 | string | Y | 10 | 주문 체결되지 않고 남은 수량 |
| ord_tmd | 주문시각 | string | Y | 6 | 주문 접수 시간 |
| tot_ccld_qty | 총체결수량 | string | Y | 10 | 주문 체결된 수량 |
| avg_idx | 평균지수 | string | Y | 27 | 체결된 주문 수량의 평균 체결 가격 |
| tot_ccld_amt | 총체결금액 | string | Y | 19 | 체결된 주문의 합계금액 |
| rjct_qty | 거부수량 | string | Y | 10 | 접수된 주문이 정상 처리되지 못하고 거부된 수량 |
| ingr_trad_rjct_rson_cd | 장내매매거부사유코드 | string | Y | 5 | 정상 처리되지 못하고 거부된 주문의 사유코드 |
| ingr_trad_rjct_rson_name | 장내매매거부사유명 | string | Y | 60 | 정상 처리되지 못하고 거부된 주문의 사유 |
| ord_stfno | 주문직원번호 | string | Y | 6 | 주문 접수한 직원의 사번 또는 온라인 주문 시 매체 유형코드 |
| sprd_item_yn | 스프레드종목여부 | string | Y | 1 | 스프레드 종목 여부 구분값 |
| ord_ip_addr | 주문IP주소 | string | Y | 200 | 주문 시 사용한 매체의 IP 주소 |
| output2 | 응답상세2 | object | Y | | |
| tot_ord_qty | 총주문수량 | string | Y | 10 | 전체 주문 수량 |
| tot_ccld_amt_smtl | 총체결금액합계 | string | Y | 19 | 체결된 주문 전체의 합계 금액 |
| tot_ccld_qty_smtl | 총체결수량합계 | string | Y | 19 | 체결된 주문 전체의 합계 수량 |
| fee_smtl | 수수료합계 | string | Y | 19 | 체결된 주문에 대한 매매수수료의 합계 금액 |
| ctac_tlno | 연락전화번호 | string | Y | 20 | 고객의 연락 가능한 전화번호 |
## 예제
### Request Example (Python)
```text
{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"STRT_ORD_DT": "20211122",
"END_ORD_DT": "20211122",
"SLL_BUY_DVSN_CD": "00",
"CCLD_NCCS_DVSN": "00",
"SORT_SQN": "DS",
"STRT_ODNO": "",
"PDNO": "",
"MKET_ID_CD": "00",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}
```
### Response Example
```text
{
"ctx_area_fk200": "81055689^03^20220101^20220114^DS^ ",
"ctx_area_nk200": " ",
"output1": [
{
"ord_gno_brno": "06010",
"cano": "810XXXXX",
"csac_name": "",
"acnt_prdt_cd": "03",
"ord_dt": "20220113",
"odno": "0000007045",
"orgn_odno": "0000000000",
"sll_buy_dvsn_cd": "01",
"trad_dvsn_name": "HTS SELL",
"nmpr_type_cd": "01",
"nmpr_type_name": "Limit Order",
"pdno": "101S03",
"prdt_name": "F 202203",
"prdt_type_cd": "301",
"ord_qty": "1",
"ord_idx": "400.00",
"qty": "0",
"ord_tmd": "131604",
"tot_ccld_qty": "1",
"avg_idx": "400.00000000",
"tot_ccld_amt": "100000000",
"rjct_qty": "0",
"ingr_trad_rjct_rson_cd": "00000",
"ingr_trad_rjct_rson_name": "NORMAL",
"ord_stfno": "Nsmart",
"sprd_item_yn": "N",
"ord_ip_addr": "P01032651641"
},
{
"ord_gno_brno": "06010",
"cano": "810XXXXX",
"csac_name": "",
"acnt_prdt_cd": "03",
"ord_dt": "20220111",
"odno": "0000007006",
"orgn_odno": "0000007004",
"sll_buy_dvsn_cd": "01",
"trad_dvsn_name": "CANCEL CONFIRM",
"nmpr_type_cd": "01",
"nmpr_type_name": "Limit Order",
"pdno": "101S03",
"prdt_name": "F 202203",
"prdt_type_cd": "301",
"ord_qty": "1",
"ord_idx": "0.00",
"qty": "0",
"ord_tmd": "150233",
"tot_ccld_qty": "0",
"avg_idx": "0.00000000",
"tot_ccld_amt": "0",
"rjct_qty": "0",
"ingr_trad_rjct_rson_cd": "00000",
"ingr_trad_rjct_rson_name": "NORMAL",
"ord_stfno": "Nsmart",
"sprd_item_yn": "N",
"ord_ip_addr": "P01032651641"
}
],
"output2": {
"tot_ord_qty": "4",
"tot_ccld_amt_smtl": "200000000",
"tot_ccld_qty_smtl": "2",
"fee_smtl": "28570",
"ctac_tlno": "01047859775"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/200_국내선물-009_야간선물옵션-주문체결-내역조회.md
+159
View File
@@ -0,0 +1,159 @@
# (야간)선물옵션 주문체결 내역조회
- 원본 시트명: (야간)선물옵션 주문체결 내역조회
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: 국내선물-009
- HTTP Method: GET
- 실전 TR_ID: (구) JTCE5005R (신) STTN5201R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ngt-ccnl
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
(야간)선물옵션 주문체결 내역조회 API입니다.
1. 야간 시장이 종료(06:00)된 이후 약 06:10경 야간시장의 주문체결내역이 주간으로 이관됩니다.
&gt; 주간 API를 사용한다면 야간 장 중 주문체결내역을 실시간으로 조회할 수 없습니다.
&gt; 주문체결내역의 이관이 완료되는 시점부터 주간 테이블에서 야간의 주문체결내역을 조회할 수 있습니다.
2. KRX야간시장의 경우 주문일자는 (T+1)일 입니다.
&gt; 금요일의 경우 주문일자는 주말 및 공휴일을 제외하고 익 영업일인 월요일로 설정됩니다.
&gt; 위 내용은 당사의 기준이 아닌 KRX 거래소의 기준으로 전 회원사 동일한 기준으로 주문체결이 이루어지고 있습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | (구) JTCE5005R (신) STTN5201R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| STRT_ORD_DT | 시작주문일자 | string | Y | 8 | |
| END_ORD_DT | 종료주문일자 | string | Y | 8 | 조회하려는 마지막 일자 다음일자로 조회<br>(ex. 20221011 까지의 내역을 조회하고자 할 경우, <br>20221012로 종료주문일자 설정) |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 공란 : default (00: 전체 ,01 : 매도, 02 : 매수) |
| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 00 : 전체<br>01 : 체결<br>02 : 미체결 |
| SORT_SQN | 정렬순서 | string | Y | 2 | 공란 : default (DS : 정순, 그외 : 역순) |
| STRT_ODNO | 시작주문번호 | string | Y | 10 | 공란 : default |
| PDNO | 상품번호 | string | Y | 12 | 공란 : default |
| MKET_ID_CD | 시장ID코드 | string | Y | 3 | 공란 : default |
| FUOP_DVSN_CD | 선물옵션구분코드 | string | Y | 2 | 공란 : 전체, 01 : 선물, 02 : 옵션 |
| SCRN_DVSN | 화면구분 | string | Y | 2 | 02(Default) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터) |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output2 | 응답상세1 | object | Y | | |
| tot_ord_qty | 총주문수량 | string | Y | 10 | |
| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
| tot_ccld_qty_SMTL | 총체결수량 | string | Y | 19 | 신규 TR 사용 필드 |
| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
| tot_ccld_amt_SMTL | 총체결금액 | string | Y | 11 | 신규 TR 사용 필드 |
| fee | 수수료 | string | Y | 19 | |
| ctac_tlno | 연락전화번호 | string | Y | 20 | 신규 TR 사용 필드 |
| output1 | 응답상세2 | object array | Y | | 시간별체결 정보 |
| ord_gno_brno | 주문채번지점번호 | string | Y | 5 | |
| cano | 종합계좌번호 | string | Y | 8 | |
| csac_name | 종합계좌명 | string | Y | 60 | |
| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 | |
| ord_dt | 주문일자 | string | Y | 8 | |
| odno | 주문번호 | string | Y | 10 | |
| orgn_odno | 원주문번호 | string | Y | 10 | |
| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 | |
| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
| nmpr_type_name | 호가유형명 | string | Y | 60 | |
| pdno | 상품번호 | string | Y | 12 | |
| prdt_name | 상품명 | string | Y | 60 | |
| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
| ord_qty | 주문수량 | string | Y | 10 | |
| ord_idx4 | 주문지수 | string | Y | 20 | 신규 TR 사용 필드 |
| qty | 잔량 | string | Y | 10 | |
| ord_tmd | 주문시각 | string | Y | 6 | |
| tot_ccld_qty | 총체결수량 | string | Y | 10 | |
| avg_idx | 평균지수 | string | Y | 19 | |
| tot_ccld_amt | 총체결금액 | string | Y | 19 | |
| rjct_qty | 거부수량 | string | Y | 10 | |
| ingr_trad_rjct_rson_cd | 장내매매거부사유코드 | string | Y | 5 | |
| ingr_trad_rjct_rson_name | 장내매매거부사유명 | string | Y | 60 | |
| ord_stfno | 주문직원번호 | string | Y | 6 | |
| sprd_item_yn | 스프레드종목여부 | string | Y | 1 | |
| ord_ip_addr | 주문IP주소 | string | Y | 200 | |
## 예제
### Request Example (Python)
```text
{
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"STRT_ORD_DT":"20220730",
"END_ORD_DT":"20221214",
"SLL_BUY_DVSN_CD":"00",
"CCLD_NCCS_DVSN":"00",
"SORT_SQN":"DS",
"STRT_ODNO":"",
"PDNO":"",
"MKET_ID_CD":"00",
"FUOP_DVSN_CD":"",
"SCRN_DVSN":"00",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
```
### Response Example
```text
{
"ctx_area_fk200": "81012345^03^20221214^20221214^DS^ ",
"ctx_area_nk200": " ",
"output1": [],
"output2": {
"tot_ord_qty": "0",
"tot_ccld_qty": "0",
"tot_ccld_amt": "0",
"fee": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0560",
"msg1": "조회할 내용이 없습니다 "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/201_국내선물-011_야간선물옵션-주문가능-조회.md
+105
View File
@@ -0,0 +1,105 @@
# (야간)선물옵션 주문가능 조회
- 원본 시트명: (야간)선물옵션 주문가능 조회
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: 국내선물-011
- HTTP Method: GET
- 실전 TR_ID: (구) JTCE1004R (신) STTN5105R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-psbl-ngt-order
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
(야간)선물옵션 주문가능 조회 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | (구) JTCE1004R (신) STTN5105R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | |
| PDNO | 상품번호 | string | Y | 12 | |
| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 301 : 선물옵션 |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도 , 02 : 매수 |
| UNIT_PRICE | 주문가격1 | string | Y | 23 | |
| ORD_DVSN_CD | 주문구분코드 | string | Y | 2 | '01 : 지정가 02 : 시장가 <br>03 : 조건부 04 : 최유리, <br>10 : 지정가(IOC) 11 : 지정가(FOK) <br>12 : 시장가(IOC) 13 : 시장가(FOK) <br>14 : 최유리(IOC) 15 : 최유리(FOK)' |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output | 응답상세1 | object | Y | | |
| max_ord_psbl_qty | 최대주문가능수량 | string | Y | 19 | 최대주문가능수량 (신규 TR 미사용 필드) |
| tot_psbl_qty | 최대주문가능수량 | string | Y | 19 | |
| lqd_psbl_qty | 청산가능수량 | string | Y | 19 | 청산가능수량 |
| lqd_psbl_qty_1 | 청산가능수량 | string | Y | 19 | 신규 TR 사용 필드 |
| ord_psbl_qty | 주문가능수량 | string | Y | 19 | |
| bass_idx | 기준지수 | string | Y | 23 | 신규 TR 사용 필드 |
## 예제
### Request Example (Python)
```text
{
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"PDNO":"101T03",
"PRDT_TYPE_CD":"301",
"SLL_BUY_DVSN_CD":"02",
"UNIT_PRICE":"",
"ORD_DVSN_CD":"01"
}
```
### Response Example
```text
{
"output": {
"max_ord_psbl_qty": "996",
"lqd_psbl_qty": "0",
"ord_psbl_qty": "996"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/202_v1_국내선물-013_선물옵션-잔고정산손익내역.md
+147
View File
@@ -0,0 +1,147 @@
# 선물옵션 잔고정산손익내역
- 원본 시트명: 선물옵션 잔고정산손익내역
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-013
- HTTP Method: GET
- 실전 TR_ID: CTFO6117R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-balance-settlement-pl
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 잔고정산손익내역 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | CTFO6117R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| INQR_DT | 조회일자 | string | Y | 8 | 조회일자(YYYYMMDD) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output2 | 응답상세 | object | Y | | |
| nxdy_dnca | 익일예수금 | string | Y | 19 | |
| mmga_cash | 유지증거금현금 | string | Y | 19 | |
| brkg_mgna_cash | 위탁증거금현금 | string | Y | 19 | |
| opt_buy_chgs | 옵션매수대금 | string | Y | 19 | |
| opt_lqd_evlu_amt | 옵션청산평가금액 | string | Y | 19 | |
| dnca_sbst | 예수금대용 | string | Y | 19 | |
| mmga_tota | 유지증거금총액 | string | Y | 19 | |
| brkg_mgna_tota | 위탁증거금총액 | string | Y | 19 | |
| opt_sll_chgs | 옵션매도대금 | string | Y | 19 | |
| fee | 수수료 | string | Y | 19 | |
| thdt_dfpa | 당일차금 | string | Y | 19 | |
| rnwl_dfpa | 갱신차금 | string | Y | 19 | |
| dnca_cash | 예수금현금 | string | Y | 19 | |
| output1 | 응답상세2 | array | Y | | array |
| pdno | 상품번호 | string | Y | 12 | |
| prdt_name | 상품명 | string | Y | 60 | |
| trad_dvsn_name | 매매구분명 | string | Y | 60 | |
| bfdy_cblc_qty | 전일잔고수량 | string | Y | 19 | |
| new_qty | 신규수량 | string | Y | 10 | |
| mnpl_rpch_qty | 전매환매수량 | string | Y | 10 | |
| cblc_qty | 잔고수량 | string | Y | 19 | |
| cblc_amt | 잔고금액 | string | Y | 19 | |
| trad_pfls_amt | 매매손익금액 | string | Y | 19 | |
| evlu_amt | 평가금액 | string | Y | 19 | |
| evlu_pfls_amt | 평가손익금액 | string | Y | 19 | |
## 예제
### Request Example (Python)
```text
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"INQR_DT":"20230906",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
```
### Response Example
```text
{
"ctx_area_fk200": "12345678!^03!^20230906 ",
"ctx_area_nk200": " !^ ",
"output1": [
{
"pdno": "101T09",
"prdt_name": "F 202309",
"trad_dvsn_name": "매수",
"bfdy_cblc_qty": "2",
"new_qty": "0",
"mnpl_rpch_qty": "0",
"cblc_qty": "2",
"cblc_amt": "-425000",
"trad_pfls_amt": "0",
"evlu_amt": "149350000",
"evlu_pfls_amt": "-1675000"
}
],
"output2": {
"nxdy_dnca": "0",
"mmga_cash": "0",
"brkg_mgna_cash": "0",
"opt_buy_chgs": "0",
"opt_lqd_evlu_amt": "0",
"dnca_sbst": "0",
"mmga_tota": "0",
"brkg_mgna_tota": "0",
"opt_sll_chgs": "0",
"fee": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "0",
"dnca_cash": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/203_v1_국내선물-005_선물옵션-주문가능.md
+102
View File
@@ -0,0 +1,102 @@
# 선물옵션 주문가능
- 원본 시트명: 선물옵션 주문가능
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-005
- HTTP Method: GET
- 실전 TR_ID: TTTO5105R
- 모의 TR_ID: VTTO5105R
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-psbl-order
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 주문가능 API입니다. 주문가능 내역과 수량을 확인하실 수 있습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access Token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Credentials Grant 절차를 준용) <br>제휴사(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전투자] <br>TTTO5105R : 선물 옵션 주문 가능<br><br>[모의투자] <br>VTTO5105R : 선물 옵션 주문 가능 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객타입 | string | N | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사 APP을 사용하는 경우 사용자(회원) 핸드폰번호<br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | 제휴사는 사용자(회원)의 IP Address 필수이며 일반고객은 제외 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | N | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | N | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| PDNO | 상품번호 | string | N | 12 | 선물옵션종목코드<br>선물 6자리 (예: 101S03)<br>옵션 9자리 (예: 201S03370) |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | N | 2 | 01 : 매도<br>02 : 매수 |
| UNIT_PRICE | 주문가격1 | string | N | 23 | 주문가격<br>※ 주문가격 '0'일 경우<br> - 옵션매수 : 현재가<br> - 그 이외 : 기준가 |
| ORD_DVSN_CD | 주문구분코드 | string | N | 2 | 01 : 지정가<br>02 : 시장가<br>03 : 조건부<br>04 : 최유리,<br>10 : 지정가(IOC)<br>11 : 지정가(FOK)<br>12 : 시장가(IOC)<br>13 : 시장가(FOK)<br>14 : 최유리(IOC)<br>15 : 최유리(FOK) |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공<br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| output | 응답상세 | array | Y | | |
| tot_psbl_qty | 총가능수량 | string | Y | 10 | 총가능수량 |
| lqd_psbl_qty1 | 청산가능수량1 | string | Y | 10 | 청산가능수량 |
| ord_psbl_qty | 주문가능수량 | string | Y | 10 | 주문가능수량 |
| bass_idx | 기준지수 | string | Y | 32 | 기준지수 |
## 예제
### Request Example (Python)
```text
{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"PDNO": "101R12",
"SLL_BUY_DVSN_CD": "02",
"UNIT_PRICE": "397.95",
"ORD_DVSN_CD": "01"
}
```
### Response Example
```text
{
"output": {
"tot_psbl_qty": "11679",
"lqd_psbl_qty1": "0",
"ord_psbl_qty": "11665",
"bass_idx": "379.67000000"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
```
docs/broker/kis/rest/국내선물옵션/주문/계좌/204_v1_국내선물-016_선물옵션-기준일체결내역.md
+143
View File
@@ -0,0 +1,143 @@
# 선물옵션 기준일체결내역
- 원본 시트명: 선물옵션 기준일체결내역
- API 통신방식: REST
- 메뉴 위치: [국내선물옵션] 주문/계좌
- API ID: v1_국내선물-016
- HTTP Method: GET
- 실전 TR_ID: CTFO5139R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-futureoption/v1/trading/inquire-ccnl-bstime
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
선물옵션 기준일체결내역 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | CTFO5139R |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| ORD_DT | 주문일자 | string | Y | 8 | 주문일자(YYYYMMDD) |
| FUOP_TR_STRT_TMD | 선물옵션거래시작시각 | string | Y | 6 | 선물옵션거래시작시간(HHMMSS) |
| FUOP_TR_END_TMD | 선물옵션거래종료시각 | string | Y | 6 | 선물옵션거래종료시간(HHMMSS) |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 | 연속조회키200 |
### 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 | F or M : 다음 데이터 있음<br>D or E : 마지막 데이터 |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | array | Y | | array |
| pdno | 상품번호 | string | Y | 12 | |
| prdt_name | 상품명 | string | Y | 60 | |
| odno | 주문번호 | string | Y | 10 | |
| tr_type_name | 거래유형명 | string | Y | 60 | |
| last_sttldt | 최종결제일 | string | Y | 8 | |
| ccld_idx | 체결지수 | string | Y | 24 | |
| ccld_qty | 체결량 | string | Y | 10 | |
| trad_amt | 매매금액 | string | Y | 19 | |
| fee | 수수료 | string | Y | 19 | |
| ccld_btwn | 체결시간 | string | Y | 6 | |
| output2 | 응답상세2 | object | Y | | |
| tot_ccld_qty_smtl | 총체결수량합계 | string | Y | 19 | |
| tot_ccld_amt_smtl | 총체결금액합계 | string | Y | 19 | |
| fee_adjt | 수수료조정 | string | Y | 19 | |
| fee_smtl | 수수료합계 | string | Y | 19 | |
## 예제
### Request Example (Python)
```text
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"ORD_DT":"20230920",
"FUOP_TR_STRT_TMD":"000000",
"FUOP_TR_END_TMD":"240000",
"CTX_AREA_FK200":"",
'CTX_AREA_NK200":""
}
```
### Response Example
```text
{
"ctx_area_fk200": "12345678!^03!^20230920!^000000!^240000 ",
"ctx_area_nk200": " !^ !^ !^ ",
"output1": [
{
"pdno": "201T10340",
"prdt_name": "코스피200 C 202310 340.0",
"odno": "0000219602",
"tr_type_name": "지수콜옵션매수",
"last_sttldt": "20231012",
"ccld_idx": "2.80000000",
"ccld_qty": "1",
"trad_amt": "700000",
"fee": "2758",
"ccld_btwn": "140144"
},
{
"pdno": "101T12",
"prdt_name": "코스피200 F 202312",
"odno": "0000219606",
"tr_type_name": "지수선물매수",
"last_sttldt": "20231214",
"ccld_idx": "335.50000000",
"ccld_qty": "5",
"trad_amt": "419375000",
"fee": "41144",
"ccld_btwn": "140121"
}
],
"output2": {
"tot_ccld_qty_smtl": "6",
"tot_ccld_amt_smtl": "420075000",
"fee_adjt": "43902",
"fee_smtl": "43890"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
```