feat: add messaging transport rollout

2026-06-06 00:02:52 +09:00
parent 4b91343ee8
commit 6c7a1cf6f6
383 changed files with 99045 additions and 487 deletions
@@ -0,0 +1,168 @@
+# 해외선물종목현재가
+
+- 원본 시트명: 해외선물종목현재가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: v1_해외선물-009
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55010000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+  1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제   
+     https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+   
+  2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+     Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+       품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+
+[참고자료]
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+   https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+   
+※ 모의투자는 실전투자계좌를 활용하여 조회 부탁드립니다.
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 &gt; FAQ &gt; 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### 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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55010000 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default   개인: "" |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) CNHU24<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수선물" 참고 |
+
+### 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 | 응답상세1 | object | N |  |  |
+| proc_date | 최종처리일자 | string | N | 8 | 최종처리일자 |
+| high_price | 고가 | string | N | 15 | 고가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| proc_time | 최종처리시각 | string | N | 6 | 최종처리시각 |
+| open_price | 시가 | string | N | 15 | 시가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| trst_mgn | 증거금 | string | N | 19 | 증거금 |
+| low_price | 저가 | string | N | 15 | 저가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| last_price | 현재가 | string | N | 15 | 현재가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| vol | 누적거래수량 | string | N | 10 | 누적거래수량 |
+| prev_diff_flag | 전일대비구분 | string | N | 1 | 전일대비구분<br>'1':상한 '2':상승 '3':보합 '4':하한 '5':하락 |
+| prev_diff_price | 전일대비가격 | string | N | 15 | 전일대비가격 |
+| prev_diff_rate | 전일대비율 | string | N | 10 | 전일대비율 |
+| bid_qntt | 매수1수량 | string | N | 10 | 매수1수량 |
+| bid_price | 매수1호가 | string | N | 15 | 매수1호가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| ask_qntt | 매도1수량 | string | N | 10 | 매도1수량 |
+| ask_price | 매도1호가 | string | N | 15 | 매도1호가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| prev_price | 전일종가 | string | N | 15 | 전일종가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| exch_cd | 거래소코드 | string | N | 10 | 거래소코드 |
+| crc_cd | 거래통화 | string | N | 10 | 거래통화 |
+| trd_fr_date | 상장일 | string | N | 8 | 상장일 |
+| expr_date | 만기일 | string | N | 8 | 만기일 |
+| trd_to_date | 최종거래일 | string | N | 8 | 최종거래일 |
+| remn_cnt | 잔존일수 | string | N | 4 | 잔존일수 |
+| last_qntt | 체결량 | string | N | 10 | 체결량 |
+| tot_ask_qntt | 총매도잔량 | string | N | 10 | 총매도잔량 |
+| tot_bid_qntt | 총매수잔량 | string | N | 10 | 총매수잔량 |
+| tick_size | 틱사이즈 | string | N | 19 | 틱사이즈 |
+| open_date | 장개시일자 | string | N | 8 | 장개시일자 |
+| open_time | 장개시시각 | string | N | 6 | 장개시시각 |
+| close_date | 장종료일자 | string | N | 8 | 장종료일자 |
+| close_time | 장종료시각 | string | N | 6 | 장종료시각 |
+| sbsnsdate | 영업일자 | string | N | 8 | 영업일자 |
+| sttl_price | 정산가 | string | N | 15 | 정산가 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:BRNF25
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "proc_date": "20241108",
+        "proc_time": "173937",
+        "open_price": "          75.55",
+        "high_price": "          75.61",
+        "low_price": "          74.66",
+        "last_price": "          74.90",
+        "vol": "33004",
+        "prev_diff_flag": "5",
+        "prev_diff_price": "           0.67",
+        "prev_diff_rate": "     -0.89",
+        "bid_qntt": "         7",
+        "bid_price": "          74.89",
+        "ask_qntt": "         4",
+        "ask_price": "          74.90",
+        "prev_price": "          75.57",
+        "trst_mgn": "               3670",
+        "exch_cd": "ICE",
+        "crc_cd": "USD",
+        "trd_fr_date": "20180110",
+        "expr_date": "20241129",
+        "trd_to_date": "20241129",
+        "remn_cnt": "  22",
+        "last_qntt": "1",
+        "tot_ask_qntt": "       115",
+        "tot_bid_qntt": "       157",
+        "tick_size": "               0.01",
+        "open_date": "20241108",
+        "open_time": "100000",
+        "close_date": "20241109",
+        "close_time": "080000",
+        "sbsnsdate": "20241108",
+        "sttl_price": "  75.6300000000"
+    },
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,147 @@
+# 해외선물종목상세
+
+- 원본 시트명: 해외선물종목상세
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: v1_해외선물-008
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55010100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/stock-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+  1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제   
+     https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+   
+  2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+     Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+       품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석.
+	   
+※ 모의투자는 실전투자계좌를 활용하여 조회 부탁드립니다.
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 &gt; FAQ &gt; 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### 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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | HHDFC55010100 |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default   개인: "" |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) CNHU24<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수선물" 참고 |
+
+### 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 | 응답상세1 | object | N |  |  |
+| exch_cd | 거래소코드 | string | N | 10 | 거래소코드 |
+| tick_sz | 틱사이즈 | string | N | 19 | 틱사이즈 |
+| disp_digit | 가격표시진법 | string | N | 10 | 가격표시진법 |
+| trst_mgn | 증거금 | string | N | 19 | 증거금 |
+| sttl_date | 정산일 | string | N | 8 | 정산일 |
+| prev_price | 전일종가 | string | N | 15 | 전일종가<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| crc_cd | 거래통화 | string | N | 10 | 거래통화 |
+| clas_cd | 품목종류 | string | N | 3 | 품목종류 |
+| tick_val | 틱가치 | string | N | 19 | 틱가치 |
+| mrkt_open_date | 장개시일자 | string | N | 8 | 장개시일자 |
+| mrkt_open_time | 장개시시각 | string | N | 6 | 장개시시각 |
+| mrkt_close_date | 장마감일자 | string | N | 8 | 장마감일자 |
+| mrkt_close_time | 장마감시각 | string | N | 6 | 장마감시각 |
+| trd_fr_date | 상장일 | string | N | 8 | 상장일 |
+| expr_date | 만기일 | string | N | 8 | 만기일 |
+| trd_to_date | 최종거래일 | string | N | 8 | 최종거래일 |
+| remn_cnt | 잔존일수 | string | N | 4 | 잔존일수 |
+| stat_tp | 매매여부 | string | N | 1 | 매매여부 |
+| ctrt_size | 계약크기 | string | N | 19 | 계약크기 |
+| stl_tp | 최종결제구분 | string | N | 20 | 최종결제구분 |
+| frst_noti_date | 최초식별일 | string | N | 8 | 최초식별일 |
+| sprd_srs_cd1 | 스프레드 종목 #1 | string | N | 32 |  |
+| sprd_srs_cd2 | 스프레드 종목 #2 | string | N | 32 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+     "SRS_CD": "6AU22"
+ }
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "exch_cd": "CME",
+        "clas_cd": "001",
+        "crc_cd": "USD",
+        "prev_price": "         6722.0",
+        "sttl_date": "20220919",
+        "trst_mgn": "               2200",
+        "disp_digit": "        10",
+        "tick_sz": "            0.00005",
+        "tick_val": "                  5",
+        "mrkt_open_date": "20220919",
+        "mrkt_open_time": "070000",
+        "mrkt_close_date": "20220920",
+        "mrkt_close_time": "060000",
+        "trd_fr_date": "20170906",
+        "expr_date": "20220919",
+        "trd_to_date": "20220919",
+        "remn_cnt": "   0",
+        "stat_tp": "2",
+        "ctrt_size": "             100000",
+        "stl_tp": "실물인수도",
+        "frst_noti_date": "20220919",
+        "sprd_srs_cd1": "",
+        "sprd_srs_cd2": ""
+    },
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,171 @@
+# 해외선물 호가
+
+- 원본 시트명: 해외선물 호가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-031
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC86000000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-asking-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물 호가 API입니다. 
+한국투자 HTS(eFriend Plus) &gt; [8602] 해외선물옵션 종합주문(Ⅰ) 화면에서 "왼쪽 호가 창" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물옵션시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+  1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제   
+     https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+   
+  2) 혹은 포럼 - FAQ - 종목정보 다운로드 - 해외선물옵션 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+     Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+       품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+
+[참고자료]
+※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+   https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+
+## 레이아웃
+
+### 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 | HHDFC86000000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 32 | 종목코드 |
+
+### 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 |  |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| lowp_rice | 저가 | string | Y | 15 |  |
+| last_price | 현재가 | string | Y | 15 |  |
+| prev_price | 전일종가 | string | Y | 15 |  |
+| vol | 거래량 | string | Y | 10 |  |
+| prev_diff_price | 전일대비가 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+| quot_date | 호가수신일자 | string | Y | 8 |  |
+| quot_time | 호가수신시각 | string | Y | 6 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| bid_qntt | 매수수량 | string | Y | 10 |  |
+| bid_num | 매수번호 | string | Y | 10 |  |
+| bid_price | 매수호가 | string | Y | 15 |  |
+| ask_qntt | 매도수량 | string | Y | 10 |  |
+| ask_num | 매도번호 | string | Y | 10 |  |
+| ask_price | 매도호가 | string | Y | 15 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "open_price": "         6430.0",
+        "high_price": "         6466.5",
+        "lowp_rice": "         6425.0",
+        "last_price": "         6443.5",
+        "prev_price": "         6428.5",
+        "vol": "27383",
+        "prev_diff_price": "             15",
+        "prev_diff_rate": "      0.23",
+        "quot_date": "20240422",
+        "quot_time": "160201"
+    },
+    "output2": [
+        {
+            "bid_qntt": "        35",
+            "bid_num": "        11",
+            "bid_price": "         6443.0",
+            "ask_qntt": "        11",
+            "ask_num": "         7",
+            "ask_price": "         6443.5"
+        },
+        {
+            "bid_qntt": "       108",
+            "bid_num": "        25",
+            "bid_price": "         6442.5",
+            "ask_qntt": "       137",
+            "ask_num": "        23",
+            "ask_price": "         6444.0"
+        },
+        {
+            "bid_qntt": "       145",
+            "bid_num": "        28",
+            "bid_price": "         6442.0",
+            "ask_qntt": "       120",
+            "ask_num": "        24",
+            "ask_price": "         6444.5"
+        },
+        {
+            "bid_qntt": "       139",
+            "bid_num": "        29",
+            "bid_price": "         6441.5",
+            "ask_qntt": "       142",
+            "ask_num": "        21",
+            "ask_price": "         6445.0"
+        },
+        {
+            "bid_qntt": "       128",
+            "bid_num": "        25",
+            "bid_price": "         6441.0",
+            "ask_qntt": "       127",
+            "ask_num": "        20",
+            "ask_price": "         6445.5"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,332 @@
+# 해외선물 분봉조회
+
+- 원본 시트명: 해외선물 분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-016
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-time-futurechartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물분봉조회 API입니다. ★ 반드시 아래 호출방법을 확인하시고 호출 사용하시기 바랍니다.
+한국투자 HTS(eFriend Plus) &gt; [5502] 해외선물옵션 체결추이 화면에서 "분" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+
+※ 해외선물분봉조회 조회 방법
+params
+. START_DATE_TIME: 공란 입력 ("")
+. CLOSE_DATE_TIME: 조회일자 입력 ("20231214")
+. QRY_CNT: 120 입력 시, 가장 최근 분봉 120건 조회( 한번에 최대 120건 조회 가능)
+                240 입력 시, 240 이전 분봉 ~ 120 이전 분봉 조회
+                360 입력 시, 360 이전 분봉 ~ 240 이전 분봉 조회
+. QRY_TP: 처음조회시, 공백 입력
+              다음조회시, P 입력
+. INDEX_KEY: 처음조회시, 공백 입력
+                  다음조회시, 이전 조회 응답의 output2 &gt; index_key 값 입력
+
+* 따라서 분봉데이터를 기간별로 수집하고자 하실 경우 QRY_TP, INDEX_KEY 값을 이용하시면서 다음조회하시면 됩니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 &gt; FAQ &gt; 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### 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 | HHDFC55020400 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) CNHU24<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수선물" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | ex) 20230823 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 120 (조회갯수) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 5 (분간격) |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 다음조회(QRY_TP를 P로 입력) 시, 이전 호출의 "output1 > index_key" 기입하여 조회 |
+
+### 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 |  |
+| output2 | 응답상세 | object | Y |  |  |
+| ret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output1 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 |  |
+| data_time | 시각 | string | Y | 6 |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 | 체결가격<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:BRNQ24
+EXCH_CD:ICE
+START_DATE_TIME:
+CLOSE_DATE_TIME:20231212
+QRY_TP:P
+QRY_CNT:500
+QRY_GAP:1
+INDEX_KEY:20231211       128
+```
+
+### Response Example
+
+```text
+{
+    "output2": {
+        "ret_cnt": "0500",
+        "last_n_cnt": "",
+        "index_key": "20231208       246"
+    },
+    "output1": [
+        {
+            "data_date": "20231208",
+            "data_time": "202100",
+            "open_price": "75.41",
+            "high_price": "75.41",
+            "low_price": "75.41",
+            "last_price": "75.41",
+            "last_qntt": "5",
+            "vol": "3985",
+            "prev_diff_flag": "3",
+            "prev_diff_price": "0",
+            "prev_diff_rate": "0"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "202200",
+            "open_price": "75.41",
+            "high_price": "75.43",
+            "low_price": "75.41",
+            "last_price": "75.43",
+            "last_qntt": "3",
+            "vol": "3988",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "0.02",
+            "prev_diff_rate": "0.02652168"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "202300",
+            "open_price": "75.45",
+            "high_price": "75.45",
+            "low_price": "75.45",
+            "last_price": "75.45",
+            "last_qntt": "19",
+            "vol": "4007",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "0.02",
+            "prev_diff_rate": "0.02651464"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "202400",
+            "open_price": "75.45",
+            "high_price": "75.45",
+            "low_price": "75.45",
+            "last_price": "75.45",
+            "last_qntt": "2",
+            "vol": "4009",
+            "prev_diff_flag": "3",
+            "prev_diff_price": "0",
+            "prev_diff_rate": "0"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "202600",
+            "open_price": "75.45",
+            "high_price": "75.47",
+            "low_price": "75.45",
+            "last_price": "75.47",
+            "last_qntt": "4",
+            "vol": "4013",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "0.02",
+            "prev_diff_rate": "0.02650762"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "202700",
+            "open_price": "75.49",
+            "high_price": "75.49",
+            "low_price": "75.48",
+            "last_price": "75.48",
+            "last_qntt": "3",
+            "vol": "4016",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "0.01",
+            "prev_diff_rate": "0.01325029"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "202800",
+            "open_price": "75.45",
+            "high_price": "75.46",
+            "low_price": "75.45",
+            "last_price": "75.46",
+            "last_qntt": "3",
+            "vol": "4019",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "0.02",
+            "prev_diff_rate": "-0.0264970"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "203100",
+            "open_price": "75.46",
+            "high_price": "75.46",
+            "low_price": "75.46",
+            "last_price": "75.46",
+            "last_qntt": "1",
+            "vol": "4020",
+            "prev_diff_flag": "3",
+            "prev_diff_price": "0",
+            "prev_diff_rate": "0"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "203300",
+            "open_price": "75.43",
+            "high_price": "75.43",
+            "low_price": "75.43",
+            "last_price": "75.43",
+            "last_qntt": "1",
+            "vol": "4021",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "0.03",
+            "prev_diff_rate": "-0.0397561"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "203400",
+            "open_price": "75.41",
+            "high_price": "75.41",
+            "low_price": "75.4",
+            "last_price": "75.4",
+            "last_qntt": "6",
+            "vol": "4027",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "0.03",
+            "prev_diff_rate": "-0.0397719"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "203500",
+            "open_price": "75.41",
+            "high_price": "75.41",
+            "low_price": "75.41",
+            "last_price": "75.41",
+            "last_qntt": "2",
+            "vol": "4029",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "0.01",
+            "prev_diff_rate": "0.01326259"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "203700",
+            "open_price": "75.43",
+            "high_price": "75.43",
+            "low_price": "75.41",
+            "last_price": "75.41",
+            "last_qntt": "30",
+            "vol": "4060",
+            "prev_diff_flag": "3",
+            "prev_diff_price": "0",
+            "prev_diff_rate": "0"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "204000",
+            "open_price": "75.41",
+            "high_price": "75.41",
+            "low_price": "75.41",
+            "last_price": "75.41",
+            "last_qntt": "54",
+            "vol": "4113",
+            "prev_diff_flag": "3",
+            "prev_diff_price": "0",
+            "prev_diff_rate": "0"
+        },
+        {
+            "data_date": "20231208",
+            "data_time": "204200",
+            "open_price": "75.37",
+            "high_price": "75.38",
+            "low_price": "75.37",
+            "last_price": "75.38",
+            "last_qntt": "2",
+            "vol": "4118",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "0.03",
+            "prev_diff_rate": "-0.0397825"
+        },...
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,654 @@
+# 해외선물 체결추이(틱)
+
+- 원본 시트명: 해외선물 체결추이(틱)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-019
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/tick-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(틱) API입니다. 
+한국투자 HTS(eFriend Plus) &gt; [5502] 해외선물옵션 체결추이 화면에서 "Tick" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+  1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제   
+     https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+   
+  2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+     Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+       품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 &gt; FAQ &gt; 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### 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 | HHDFC55020200 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 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 | Y |  |  |
+| tret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 |  |
+| data_time | 시각 | string | Y | 6 |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 | 체결가격<br>※ ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고 |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240423
+QRY_TP:Q
+QRY_CNT:40
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0040",
+        "last_n_cnt": "0001",
+        "index_key": "20240423      6445"
+    },
+    "output2": [
+        {
+            "data_date": "20240423",
+            "data_time": "164434",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         4",
+            "vol": "27806",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164434",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         1",
+            "vol": "27807",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164450",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         5",
+            "vol": "27812",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164501",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         2",
+            "vol": "27814",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164503",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         9",
+            "vol": "27823",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164503",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         1",
+            "vol": "27824",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164507",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         1",
+            "vol": "27825",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164517",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         1",
+            "vol": "27826",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164517",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         2",
+            "vol": "27828",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164526",
+            "open_price": "           6465",
+            "high_price": "           6465",
+            "low_price": "           6465",
+            "last_price": "           6465",
+            "last_qntt": "         2",
+            "vol": "27830",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              5",
+            "prev_diff_rate": "      0.08"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164542",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         1",
+            "vol": "27831",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164551",
+            "open_price": "           6464",
+            "high_price": "           6464",
+            "low_price": "           6464",
+            "last_price": "           6464",
+            "last_qntt": "         1",
+            "vol": "27832",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              4",
+            "prev_diff_rate": "      0.06"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164555",
+            "open_price": "         6463.5",
+            "high_price": "         6463.5",
+            "low_price": "         6463.5",
+            "last_price": "         6463.5",
+            "last_qntt": "         1",
+            "vol": "27833",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            3.5",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164611",
+            "open_price": "           6463",
+            "high_price": "           6463",
+            "low_price": "           6463",
+            "last_price": "           6463",
+            "last_qntt": "         1",
+            "vol": "27834",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              3",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164613",
+            "open_price": "           6463",
+            "high_price": "           6463",
+            "low_price": "           6463",
+            "last_price": "           6463",
+            "last_qntt": "         1",
+            "vol": "27835",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              3",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164620",
+            "open_price": "           6463",
+            "high_price": "           6463",
+            "low_price": "           6463",
+            "last_price": "           6463",
+            "last_qntt": "         2",
+            "vol": "27837",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              3",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164620",
+            "open_price": "           6463",
+            "high_price": "           6463",
+            "low_price": "           6463",
+            "last_price": "           6463",
+            "last_qntt": "         1",
+            "vol": "27838",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              3",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164634",
+            "open_price": "         6463.5",
+            "high_price": "         6463.5",
+            "low_price": "         6463.5",
+            "last_price": "         6463.5",
+            "last_qntt": "        10",
+            "vol": "27848",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            3.5",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164634",
+            "open_price": "         6463.5",
+            "high_price": "         6463.5",
+            "low_price": "         6463.5",
+            "last_price": "         6463.5",
+            "last_qntt": "         1",
+            "vol": "27849",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            3.5",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164634",
+            "open_price": "         6463.5",
+            "high_price": "         6463.5",
+            "low_price": "         6463.5",
+            "last_price": "         6463.5",
+            "last_qntt": "         1",
+            "vol": "27850",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            3.5",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164634",
+            "open_price": "         6463.5",
+            "high_price": "         6463.5",
+            "low_price": "         6463.5",
+            "last_price": "         6463.5",
+            "last_qntt": "        25",
+            "vol": "27875",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            3.5",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164634",
+            "open_price": "           6464",
+            "high_price": "           6464",
+            "low_price": "           6464",
+            "last_price": "           6464",
+            "last_qntt": "         5",
+            "vol": "27880",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              4",
+            "prev_diff_rate": "      0.06"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164650",
+            "open_price": "           6464",
+            "high_price": "           6464",
+            "low_price": "           6464",
+            "last_price": "           6464",
+            "last_qntt": "         2",
+            "vol": "27882",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              4",
+            "prev_diff_rate": "      0.06"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164658",
+            "open_price": "           6464",
+            "high_price": "           6464",
+            "low_price": "           6464",
+            "last_price": "           6464",
+            "last_qntt": "       400",
+            "vol": "28282",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              4",
+            "prev_diff_rate": "      0.06"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164658",
+            "open_price": "           6464",
+            "high_price": "           6464",
+            "low_price": "           6464",
+            "last_price": "           6464",
+            "last_qntt": "         3",
+            "vol": "28285",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              4",
+            "prev_diff_rate": "      0.06"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164707",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         2",
+            "vol": "28287",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164714",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         1",
+            "vol": "28288",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164714",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         2",
+            "vol": "28290",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164715",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         4",
+            "vol": "28294",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164716",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "       315",
+            "vol": "28609",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164735",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         2",
+            "vol": "28611",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164735",
+            "open_price": "         6464.5",
+            "high_price": "         6464.5",
+            "low_price": "         6464.5",
+            "last_price": "         6464.5",
+            "last_qntt": "         3",
+            "vol": "28614",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            4.5",
+            "prev_diff_rate": "      0.07"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164817",
+            "open_price": "           6464",
+            "high_price": "           6464",
+            "low_price": "           6464",
+            "last_price": "           6464",
+            "last_qntt": "         7",
+            "vol": "28621",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              4",
+            "prev_diff_rate": "      0.06"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164828",
+            "open_price": "         6463.5",
+            "high_price": "         6463.5",
+            "low_price": "         6463.5",
+            "last_price": "         6463.5",
+            "last_qntt": "         2",
+            "vol": "28623",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            3.5",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164837",
+            "open_price": "           6463",
+            "high_price": "           6463",
+            "low_price": "           6463",
+            "last_price": "           6463",
+            "last_qntt": "         1",
+            "vol": "28624",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              3",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164838",
+            "open_price": "           6463",
+            "high_price": "           6463",
+            "low_price": "           6463",
+            "last_price": "           6463",
+            "last_qntt": "         1",
+            "vol": "28625",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              3",
+            "prev_diff_rate": "      0.05"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164856",
+            "open_price": "         6462.5",
+            "high_price": "         6462.5",
+            "low_price": "         6462.5",
+            "last_price": "         6462.5",
+            "last_qntt": "         2",
+            "vol": "28627",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            2.5",
+            "prev_diff_rate": "      0.04"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164856",
+            "open_price": "         6462.5",
+            "high_price": "         6462.5",
+            "low_price": "         6462.5",
+            "last_price": "         6462.5",
+            "last_qntt": "         5",
+            "vol": "28632",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            2.5",
+            "prev_diff_rate": "      0.04"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164856",
+            "open_price": "         6462.5",
+            "high_price": "         6462.5",
+            "low_price": "         6462.5",
+            "last_price": "         6462.5",
+            "last_qntt": "        10",
+            "vol": "28642",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            2.5",
+            "prev_diff_rate": "      0.04"
+        },
+        {
+            "data_date": "20240423",
+            "data_time": "164856",
+            "open_price": "         6462.5",
+            "high_price": "         6462.5",
+            "low_price": "         6462.5",
+            "last_price": "         6462.5",
+            "last_qntt": "         2",
+            "vol": "28644",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            2.5",
+            "prev_diff_rate": "      0.04"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,654 @@
+# 해외선물 체결추이(주간)
+
+- 원본 시트명: 해외선물 체결추이(주간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-017
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/weekly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(주간) API입니다. 
+한국투자 HTS(eFriend Plus) &gt; [5502] 해외선물옵션 체결추이 화면에서 "주간" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+  1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제   
+     https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+   
+  2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+     Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+       품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 &gt; FAQ &gt; 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### 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 | HHDFC55020000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 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 | Y |  |  |
+| ret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 |  |
+| data_time | 시각 | string | Y | 6 |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 |  |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240424
+QRY_TP:
+QRY_CNT:40
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0040",
+        "last_n_cnt": "",
+        "index_key": "20230522"
+    },
+    "output2": [
+        {
+            "data_date": "20230522",
+            "data_time": "",
+            "open_price": "         6713.0",
+            "high_price": "         6713.0",
+            "low_price": "         6620.0",
+            "last_price": "         6620.0",
+            "last_qntt": "",
+            "vol": "        10",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             93",
+            "prev_diff_rate": "     -1.39"
+        },
+        {
+            "data_date": "20230612",
+            "data_time": "",
+            "open_price": "         6809.5",
+            "high_price": "         6817.0",
+            "low_price": "         6809.0",
+            "last_price": "         6817.0",
+            "last_qntt": "",
+            "vol": "        20",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            197",
+            "prev_diff_rate": "      2.98"
+        },
+        {
+            "data_date": "20230626",
+            "data_time": "",
+            "open_price": "         6692.0",
+            "high_price": "         6692.0",
+            "low_price": "         6692.0",
+            "last_price": "         6692.0",
+            "last_qntt": "",
+            "vol": "5         ",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            125",
+            "prev_diff_rate": "     -1.83"
+        },
+        {
+            "data_date": "20230710",
+            "data_time": "",
+            "open_price": "         6840.5",
+            "high_price": "         6840.5",
+            "low_price": "         6840.0",
+            "last_price": "         6840.0",
+            "last_qntt": "",
+            "vol": "5         ",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            148",
+            "prev_diff_rate": "      2.21"
+        },
+        {
+            "data_date": "20230731",
+            "data_time": "",
+            "open_price": "         6702.0",
+            "high_price": "         6702.0",
+            "low_price": "         6605.0",
+            "last_price": "         6605.0",
+            "last_qntt": "",
+            "vol": "        11",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            235",
+            "prev_diff_rate": "     -3.44"
+        },
+        {
+            "data_date": "20230807",
+            "data_time": "",
+            "open_price": "         6594.5",
+            "high_price": "         6594.5",
+            "low_price": "         6594.5",
+            "last_price": "         6594.5",
+            "last_qntt": "",
+            "vol": "5         ",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           10.5",
+            "prev_diff_rate": "     -0.16"
+        },
+        {
+            "data_date": "20230904",
+            "data_time": "",
+            "open_price": "         6535.0",
+            "high_price": "         6535.0",
+            "low_price": "         6535.0",
+            "last_price": "         6535.0",
+            "last_qntt": "",
+            "vol": "1         ",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           59.5",
+            "prev_diff_rate": "     -0.90"
+        },
+        {
+            "data_date": "20230911",
+            "data_time": "",
+            "open_price": "         6494.0",
+            "high_price": "         6512.5",
+            "low_price": "         6470.0",
+            "last_price": "         6512.5",
+            "last_qntt": "",
+            "vol": "         8",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           22.5",
+            "prev_diff_rate": "     -0.34"
+        },
+        {
+            "data_date": "20230918",
+            "data_time": "",
+            "open_price": "         6500.5",
+            "high_price": "         6558.5",
+            "low_price": "         6459.5",
+            "last_price": "         6479.5",
+            "last_qntt": "",
+            "vol": "        43",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             33",
+            "prev_diff_rate": "     -0.51"
+        },
+        {
+            "data_date": "20230925",
+            "data_time": "",
+            "open_price": "         6439.5",
+            "high_price": "         6450.5",
+            "low_price": "         6430.0",
+            "last_price": "         6450.5",
+            "last_qntt": "",
+            "vol": "         3",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             29",
+            "prev_diff_rate": "     -0.45"
+        },
+        {
+            "data_date": "20231002",
+            "data_time": "",
+            "open_price": "         6480.5",
+            "high_price": "         6480.5",
+            "low_price": "         6360.0",
+            "last_price": "         6406.0",
+            "last_qntt": "",
+            "vol": "        40",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           44.5",
+            "prev_diff_rate": "     -0.69"
+        },
+        {
+            "data_date": "20231009",
+            "data_time": "",
+            "open_price": "         6410.0",
+            "high_price": "         6471.5",
+            "low_price": "         6388.5",
+            "last_price": "         6388.5",
+            "last_qntt": "",
+            "vol": "        21",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           17.5",
+            "prev_diff_rate": "     -0.27"
+        },
+        {
+            "data_date": "20231016",
+            "data_time": "",
+            "open_price": "         6381.0",
+            "high_price": "         6423.0",
+            "low_price": "         6345.0",
+            "last_price": "         6360.0",
+            "last_qntt": "",
+            "vol": "        16",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           28.5",
+            "prev_diff_rate": "     -0.45"
+        },
+        {
+            "data_date": "20231023",
+            "data_time": "",
+            "open_price": "         6361.5",
+            "high_price": "         6366.0",
+            "low_price": "         6361.5",
+            "last_price": "         6366.0",
+            "last_qntt": "",
+            "vol": "6         ",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              6",
+            "prev_diff_rate": "      0.09"
+        },
+        {
+            "data_date": "20231030",
+            "data_time": "",
+            "open_price": "         6460.5",
+            "high_price": "         6547.0",
+            "low_price": "         6460.5",
+            "last_price": "         6530.0",
+            "last_qntt": "",
+            "vol": "       102",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            164",
+            "prev_diff_rate": "      2.58"
+        },
+        {
+            "data_date": "20231106",
+            "data_time": "",
+            "open_price": "         6502.0",
+            "high_price": "         6502.0",
+            "low_price": "         6395.0",
+            "last_price": "         6395.0",
+            "last_qntt": "",
+            "vol": "        34",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            135",
+            "prev_diff_rate": "     -2.07"
+        },
+        {
+            "data_date": "20231113",
+            "data_time": "",
+            "open_price": "         6410.0",
+            "high_price": "         6548.0",
+            "low_price": "         6410.0",
+            "last_price": "         6529.5",
+            "last_qntt": "",
+            "vol": "        18",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "          134.5",
+            "prev_diff_rate": "      2.10"
+        },
+        {
+            "data_date": "20231120",
+            "data_time": "",
+            "open_price": "         6564.0",
+            "high_price": "         6622.0",
+            "low_price": "         6561.0",
+            "last_price": "         6620.5",
+            "last_qntt": "",
+            "vol": "       190",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             91",
+            "prev_diff_rate": "      1.39"
+        },
+        {
+            "data_date": "20231127",
+            "data_time": "",
+            "open_price": "         6610.0",
+            "high_price": "         6703.0",
+            "low_price": "         6610.0",
+            "last_price": "         6702.0",
+            "last_qntt": "",
+            "vol": "       326",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           81.5",
+            "prev_diff_rate": "      1.23"
+        },
+        {
+            "data_date": "20231204",
+            "data_time": "",
+            "open_price": "         6697.5",
+            "high_price": "         6697.5",
+            "low_price": "         6565.0",
+            "last_price": "         6614.0",
+            "last_qntt": "",
+            "vol": "       296",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             88",
+            "prev_diff_rate": "     -1.31"
+        },
+        {
+            "data_date": "20231211",
+            "data_time": "",
+            "open_price": "         6605.0",
+            "high_price": "         6760.5",
+            "low_price": "         6578.0",
+            "last_price": "         6730.0",
+            "last_qntt": "",
+            "vol": "       510",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            116",
+            "prev_diff_rate": "      1.75"
+        },
+        {
+            "data_date": "20231218",
+            "data_time": "",
+            "open_price": "         6731.0",
+            "high_price": "         6855.5",
+            "low_price": "         6725.0",
+            "last_price": "         6827.0",
+            "last_qntt": "",
+            "vol": "       617",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             97",
+            "prev_diff_rate": "      1.44"
+        },
+        {
+            "data_date": "20231225",
+            "data_time": "",
+            "open_price": "         6834.0",
+            "high_price": "         6900.0",
+            "low_price": "         6811.5",
+            "last_price": "         6858.5",
+            "last_qntt": "",
+            "vol": "       353",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           31.5",
+            "prev_diff_rate": "      0.46"
+        },
+        {
+            "data_date": "20240101",
+            "data_time": "",
+            "open_price": "         6841.0",
+            "high_price": "         6864.5",
+            "low_price": "         6683.0",
+            "last_price": "         6742.0",
+            "last_qntt": "",
+            "vol": "       325",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "          116.5",
+            "prev_diff_rate": "     -1.70"
+        },
+        {
+            "data_date": "20240108",
+            "data_time": "",
+            "open_price": "         6762.0",
+            "high_price": "         6762.0",
+            "low_price": "         6678.0",
+            "last_price": "         6711.0",
+            "last_qntt": "",
+            "vol": "       310",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             31",
+            "prev_diff_rate": "     -0.46"
+        },
+        {
+            "data_date": "20240115",
+            "data_time": "",
+            "open_price": "         6709.5",
+            "high_price": "         6728.0",
+            "low_price": "         6556.0",
+            "last_price": "         6624.5",
+            "last_qntt": "",
+            "vol": "       900",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           86.5",
+            "prev_diff_rate": "     -1.29"
+        },
+        {
+            "data_date": "20240122",
+            "data_time": "",
+            "open_price": "         6622.0",
+            "high_price": "         6643.0",
+            "low_price": "         6579.5",
+            "last_price": "         6600.0",
+            "last_qntt": "",
+            "vol": "       389",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           24.5",
+            "prev_diff_rate": "     -0.37"
+        },
+        {
+            "data_date": "20240129",
+            "data_time": "",
+            "open_price": "         6598.0",
+            "high_price": "         6646.5",
+            "low_price": "         6529.0",
+            "last_price": "         6539.5",
+            "last_qntt": "",
+            "vol": "       962",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           60.5",
+            "prev_diff_rate": "     -0.92"
+        },
+        {
+            "data_date": "20240205",
+            "data_time": "",
+            "open_price": "         6520.5",
+            "high_price": "         6563.5",
+            "low_price": "         6494.5",
+            "last_price": "         6549.5",
+            "last_qntt": "",
+            "vol": "      1019",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             10",
+            "prev_diff_rate": "      0.15"
+        },
+        {
+            "data_date": "20240212",
+            "data_time": "",
+            "open_price": "         6553.0",
+            "high_price": "         6568.0",
+            "low_price": "         6469.0",
+            "last_price": "         6557.5",
+            "last_qntt": "",
+            "vol": "       891",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              8",
+            "prev_diff_rate": "      0.12"
+        },
+        {
+            "data_date": "20240219",
+            "data_time": "",
+            "open_price": "         6564.0",
+            "high_price": "         6616.5",
+            "low_price": "         6544.5",
+            "last_price": "         6584.0",
+            "last_qntt": "",
+            "vol": "      1773",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           26.5",
+            "prev_diff_rate": "      0.40"
+        },
+        {
+            "data_date": "20240226",
+            "data_time": "",
+            "open_price": "         6588.5",
+            "high_price": "         6588.5",
+            "low_price": "         6509.5",
+            "last_price": "         6546.0",
+            "last_qntt": "",
+            "vol": "      3428",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             38",
+            "prev_diff_rate": "     -0.58"
+        },
+        {
+            "data_date": "20240304",
+            "data_time": "",
+            "open_price": "         6546.0",
+            "high_price": "         6686.5",
+            "low_price": "         6498.0",
+            "last_price": "         6644.0",
+            "last_qntt": "",
+            "vol": "     35069",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             98",
+            "prev_diff_rate": "      1.50"
+        },
+        {
+            "data_date": "20240311",
+            "data_time": "",
+            "open_price": "         6645.0",
+            "high_price": "         6646.0",
+            "low_price": "        0.66235",
+            "last_price": "         6577.5",
+            "last_qntt": "",
+            "vol": "    115245",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           66.5",
+            "prev_diff_rate": "     -1.00"
+        },
+        {
+            "data_date": "20240318",
+            "data_time": "",
+            "open_price": "         6576.5",
+            "high_price": "         6650.5",
+            "low_price": "         6525.5",
+            "last_price": "         6530.5",
+            "last_qntt": "",
+            "vol": "    328691",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             47",
+            "prev_diff_rate": "     -0.71"
+        },
+        {
+            "data_date": "20240325",
+            "data_time": "",
+            "open_price": "           6530",
+            "high_price": "         6574.5",
+            "low_price": "         6499.5",
+            "last_price": "           6530",
+            "last_qntt": "",
+            "vol": "    301604",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            0.5",
+            "prev_diff_rate": "     -0.01"
+        },
+        {
+            "data_date": "20240401",
+            "data_time": "",
+            "open_price": "         6531.5",
+            "high_price": "           6633",
+            "low_price": "         6495.0",
+            "last_price": "           6593",
+            "last_qntt": "",
+            "vol": "    474911",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             63",
+            "prev_diff_rate": "      0.96"
+        },
+        {
+            "data_date": "20240408",
+            "data_time": "",
+            "open_price": "           6590",
+            "high_price": "         6657.5",
+            "low_price": "         6468.0",
+            "last_price": "         6474.0",
+            "last_qntt": "",
+            "vol": "    594239",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            119",
+            "prev_diff_rate": "     -1.80"
+        },
+        {
+            "data_date": "20240415",
+            "data_time": "",
+            "open_price": "         6475.5",
+            "high_price": "         6505.0",
+            "low_price": "         6373.0",
+            "last_price": "         6428.5",
+            "last_qntt": "",
+            "vol": "    540988",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           45.5",
+            "prev_diff_rate": "     -0.70"
+        },
+        {
+            "data_date": "20240422",
+            "data_time": "",
+            "open_price": "         6430.0",
+            "high_price": "         6466.5",
+            "low_price": "         6425.0",
+            "last_price": "         6460.0",
+            "last_qntt": "",
+            "vol": "82245     ",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           31.5",
+            "prev_diff_rate": "      0.49"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,654 @@
+# 해외선물 체결추이(일간)
+
+- 원본 시트명: 해외선물 체결추이(일간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-018
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/daily-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(일간) API입니다. 
+한국투자 HTS(eFriend Plus) &gt; [5502] 해외선물옵션 체결추이 화면에서 "일간" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+  1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제   
+     https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+   
+  2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+     Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+       품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 &gt; FAQ &gt; 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### 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 | HHDFC55020100 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 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 | Y |  |  |
+| tret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 |  |
+| data_time | 시각 | string | Y | 6 |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 |  |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240424
+QRY_TP:
+QRY_CNT:40
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0040",
+        "last_n_cnt": "",
+        "index_key": "20240226"
+    },
+    "output2": [
+        {
+            "data_date": "20240226",
+            "data_time": "",
+            "open_price": "         6588.5",
+            "high_price": "         6588.5",
+            "low_price": "         6555.0",
+            "last_price": "         6562.5",
+            "last_qntt": "",
+            "vol": "       639",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           21.5",
+            "prev_diff_rate": "     -0.33"
+        },
+        {
+            "data_date": "20240227",
+            "data_time": "",
+            "open_price": "         6555.0",
+            "high_price": "         6577.5",
+            "low_price": "         6549.0",
+            "last_price": "         6565.0",
+            "last_qntt": "",
+            "vol": "       134",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            2.5",
+            "prev_diff_rate": "      0.04"
+        },
+        {
+            "data_date": "20240228",
+            "data_time": "",
+            "open_price": "         6567.0",
+            "high_price": "         6568.5",
+            "low_price": "         6511.0",
+            "last_price": "         6515.0",
+            "last_qntt": "",
+            "vol": "      1210",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             50",
+            "prev_diff_rate": "     -0.76"
+        },
+        {
+            "data_date": "20240229",
+            "data_time": "",
+            "open_price": "         6516.0",
+            "high_price": "         6551.0",
+            "low_price": "         6509.5",
+            "last_price": "         6519.0",
+            "last_qntt": "",
+            "vol": "       503",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              4",
+            "prev_diff_rate": "      0.06"
+        },
+        {
+            "data_date": "20240301",
+            "data_time": "",
+            "open_price": "         6517.5",
+            "high_price": "         6554.5",
+            "low_price": "         6510.5",
+            "last_price": "         6546.0",
+            "last_qntt": "",
+            "vol": "       942",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             27",
+            "prev_diff_rate": "      0.41"
+        },
+        {
+            "data_date": "20240304",
+            "data_time": "",
+            "open_price": "         6546.0",
+            "high_price": "         6549.0",
+            "low_price": "         6528.5",
+            "last_price": "         6528.5",
+            "last_qntt": "",
+            "vol": "      2298",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           17.5",
+            "prev_diff_rate": "     -0.27"
+        },
+        {
+            "data_date": "20240305",
+            "data_time": "",
+            "open_price": "         6530.5",
+            "high_price": "         6541.0",
+            "low_price": "         6498.0",
+            "last_price": "         6523.5",
+            "last_qntt": "",
+            "vol": "     13778",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "              5",
+            "prev_diff_rate": "     -0.08"
+        },
+        {
+            "data_date": "20240306",
+            "data_time": "",
+            "open_price": "         6522.0",
+            "high_price": "         6600.5",
+            "low_price": "         6512.5",
+            "last_price": "         6584.5",
+            "last_qntt": "",
+            "vol": "      3269",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             61",
+            "prev_diff_rate": "      0.94"
+        },
+        {
+            "data_date": "20240307",
+            "data_time": "",
+            "open_price": "         6582.0",
+            "high_price": "         6643.5",
+            "low_price": "         6582.0",
+            "last_price": "         6639.0",
+            "last_qntt": "",
+            "vol": "     10466",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           54.5",
+            "prev_diff_rate": "      0.83"
+        },
+        {
+            "data_date": "20240308",
+            "data_time": "",
+            "open_price": "         6637.0",
+            "high_price": "         6686.5",
+            "low_price": "         6632.5",
+            "last_price": "         6644.0",
+            "last_qntt": "",
+            "vol": "      5258",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "              5",
+            "prev_diff_rate": "      0.08"
+        },
+        {
+            "data_date": "20240311",
+            "data_time": "",
+            "open_price": "         6645.0",
+            "high_price": "         6646.0",
+            "low_price": "         6616.0",
+            "last_price": "         6633.0",
+            "last_qntt": "",
+            "vol": "     39035",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             11",
+            "prev_diff_rate": "     -0.17"
+        },
+        {
+            "data_date": "20240312",
+            "data_time": "",
+            "open_price": "         0.6624",
+            "high_price": "         0.6624",
+            "low_price": "        0.66235",
+            "last_price": "         0.6625",
+            "last_qntt": "",
+            "vol": "        11",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "      6632.3375",
+            "prev_diff_rate": "    -99.99"
+        },
+        {
+            "data_date": "20240313",
+            "data_time": "",
+            "open_price": "          0.664",
+            "high_price": "         0.6641",
+            "low_price": "          0.664",
+            "last_price": "          0.664",
+            "last_qntt": "",
+            "vol": "        50",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "         0.0015",
+            "prev_diff_rate": "      0.23"
+        },
+        {
+            "data_date": "20240314",
+            "data_time": "",
+            "open_price": "         6598.5",
+            "high_price": "         6598.5",
+            "low_price": "         6598.5",
+            "last_price": "         6598.5",
+            "last_qntt": "",
+            "vol": "        83",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "       6597.836",
+            "prev_diff_rate": " 993650.00"
+        },
+        {
+            "data_date": "20240315",
+            "data_time": "",
+            "open_price": "         6598.5",
+            "high_price": "         6599.5",
+            "low_price": "         6569.5",
+            "last_price": "         6577.5",
+            "last_qntt": "",
+            "vol": "     76056",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             21",
+            "prev_diff_rate": "     -0.32"
+        },
+        {
+            "data_date": "20240318",
+            "data_time": "",
+            "open_price": "         6576.5",
+            "high_price": "         6576.5",
+            "low_price": "         6576.5",
+            "last_price": "         6576.5",
+            "last_qntt": "",
+            "vol": "         1",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "              1",
+            "prev_diff_rate": "     -0.02"
+        },
+        {
+            "data_date": "20240319",
+            "data_time": "",
+            "open_price": "           6548",
+            "high_price": "           6549",
+            "low_price": "           6548",
+            "last_price": "         6548.5",
+            "last_qntt": "",
+            "vol": "        44",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             28",
+            "prev_diff_rate": "     -0.43"
+        },
+        {
+            "data_date": "20240320",
+            "data_time": "",
+            "open_price": "         6548.0",
+            "high_price": "         6603.5",
+            "low_price": "         6528.0",
+            "last_price": "         6602.5",
+            "last_qntt": "",
+            "vol": "    100506",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             54",
+            "prev_diff_rate": "      0.82"
+        },
+        {
+            "data_date": "20240321",
+            "data_time": "",
+            "open_price": "         6598.0",
+            "high_price": "         6650.5",
+            "low_price": "         6577.0",
+            "last_price": "         6586.0",
+            "last_qntt": "",
+            "vol": "    126413",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           16.5",
+            "prev_diff_rate": "     -0.25"
+        },
+        {
+            "data_date": "20240322",
+            "data_time": "",
+            "open_price": "         6585.5",
+            "high_price": "         6592.5",
+            "low_price": "         6525.5",
+            "last_price": "         6530.5",
+            "last_qntt": "",
+            "vol": "    101727",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           55.5",
+            "prev_diff_rate": "     -0.84"
+        },
+        {
+            "data_date": "20240325",
+            "data_time": "",
+            "open_price": "           6530",
+            "high_price": "         6562.5",
+            "low_price": "           6525",
+            "last_price": "         6555.5",
+            "last_qntt": "",
+            "vol": "     70152",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             25",
+            "prev_diff_rate": "      0.38"
+        },
+        {
+            "data_date": "20240326",
+            "data_time": "",
+            "open_price": "         6555.5",
+            "high_price": "         6574.5",
+            "low_price": "         6545.5",
+            "last_price": "         6548.5",
+            "last_qntt": "",
+            "vol": "     58147",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "              7",
+            "prev_diff_rate": "     -0.11"
+        },
+        {
+            "data_date": "20240327",
+            "data_time": "",
+            "open_price": "           6548",
+            "high_price": "           6553",
+            "low_price": "         6525.5",
+            "last_price": "           6549",
+            "last_qntt": "",
+            "vol": "     68767",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            0.5",
+            "prev_diff_rate": "      0.01"
+        },
+        {
+            "data_date": "20240328",
+            "data_time": "",
+            "open_price": "         6548.5",
+            "high_price": "         6555.5",
+            "low_price": "         6499.5",
+            "last_price": "           6530",
+            "last_qntt": "",
+            "vol": "    104538",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             19",
+            "prev_diff_rate": "     -0.29"
+        },
+        {
+            "data_date": "20240401",
+            "data_time": "",
+            "open_price": "         6531.5",
+            "high_price": "         6554.0",
+            "low_price": "         6495.0",
+            "last_price": "         6504.0",
+            "last_qntt": "",
+            "vol": "     74942",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             26",
+            "prev_diff_rate": "     -0.40"
+        },
+        {
+            "data_date": "20240402",
+            "data_time": "",
+            "open_price": "         6504.0",
+            "high_price": "         6538.0",
+            "low_price": "         6496.5",
+            "last_price": "         6531.5",
+            "last_qntt": "",
+            "vol": "     83996",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           27.5",
+            "prev_diff_rate": "      0.42"
+        },
+        {
+            "data_date": "20240403",
+            "data_time": "",
+            "open_price": "           6532",
+            "high_price": "           6584",
+            "low_price": "         6517.5",
+            "last_price": "         6579.5",
+            "last_qntt": "",
+            "vol": "     94108",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             48",
+            "prev_diff_rate": "      0.73"
+        },
+        {
+            "data_date": "20240404",
+            "data_time": "",
+            "open_price": "           6577",
+            "high_price": "           6633",
+            "low_price": "           6577",
+            "last_price": "         6601.5",
+            "last_qntt": "",
+            "vol": "    115253",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             22",
+            "prev_diff_rate": "      0.33"
+        },
+        {
+            "data_date": "20240405",
+            "data_time": "",
+            "open_price": "         6601.5",
+            "high_price": "         6606.5",
+            "low_price": "           6563",
+            "last_price": "           6593",
+            "last_qntt": "",
+            "vol": "    106612",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            8.5",
+            "prev_diff_rate": "     -0.13"
+        },
+        {
+            "data_date": "20240408",
+            "data_time": "",
+            "open_price": "           6590",
+            "high_price": "         6623.5",
+            "low_price": "           6573",
+            "last_price": "         6617.5",
+            "last_qntt": "",
+            "vol": "     71474",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           24.5",
+            "prev_diff_rate": "      0.37"
+        },
+        {
+            "data_date": "20240409",
+            "data_time": "",
+            "open_price": "           6617",
+            "high_price": "         6657.5",
+            "low_price": "           6612",
+            "last_price": "         6641.5",
+            "last_qntt": "",
+            "vol": "     88858",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             24",
+            "prev_diff_rate": "      0.36"
+        },
+        {
+            "data_date": "20240410",
+            "data_time": "",
+            "open_price": "         6641.5",
+            "high_price": "         6644.5",
+            "low_price": "         6512.0",
+            "last_price": "         6525.0",
+            "last_qntt": "",
+            "vol": "    186665",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "          116.5",
+            "prev_diff_rate": "     -1.75"
+        },
+        {
+            "data_date": "20240411",
+            "data_time": "",
+            "open_price": "         6524.5",
+            "high_price": "         6565.0",
+            "low_price": "         6514.5",
+            "last_price": "         6550.5",
+            "last_qntt": "",
+            "vol": "    121379",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           25.5",
+            "prev_diff_rate": "      0.39"
+        },
+        {
+            "data_date": "20240412",
+            "data_time": "",
+            "open_price": "         6550.5",
+            "high_price": "         6555.5",
+            "low_price": "         6468.0",
+            "last_price": "         6474.0",
+            "last_qntt": "",
+            "vol": "    125863",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           76.5",
+            "prev_diff_rate": "     -1.17"
+        },
+        {
+            "data_date": "20240415",
+            "data_time": "",
+            "open_price": "         6475.5",
+            "high_price": "         6505.0",
+            "low_price": "         6449.0",
+            "last_price": "         6453.5",
+            "last_qntt": "",
+            "vol": "    113834",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           20.5",
+            "prev_diff_rate": "     -0.32"
+        },
+        {
+            "data_date": "20240416",
+            "data_time": "",
+            "open_price": "         6456.5",
+            "high_price": "         6456.5",
+            "low_price": "         6401.0",
+            "last_price": "         6414.0",
+            "last_qntt": "",
+            "vol": "    120271",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           39.5",
+            "prev_diff_rate": "     -0.61"
+        },
+        {
+            "data_date": "20240417",
+            "data_time": "",
+            "open_price": "         6413.5",
+            "high_price": "         6457.5",
+            "low_price": "         6411.5",
+            "last_price": "         6446.0",
+            "last_qntt": "",
+            "vol": "    110152",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             32",
+            "prev_diff_rate": "      0.50"
+        },
+        {
+            "data_date": "20240418",
+            "data_time": "",
+            "open_price": "         6446.0",
+            "high_price": "         6467.0",
+            "low_price": "         6427.5",
+            "last_price": "         6432.0",
+            "last_qntt": "",
+            "vol": "     76120",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "             14",
+            "prev_diff_rate": "     -0.22"
+        },
+        {
+            "data_date": "20240419",
+            "data_time": "",
+            "open_price": "         6431.5",
+            "high_price": "         6444.0",
+            "low_price": "         6373.0",
+            "last_price": "         6428.5",
+            "last_qntt": "",
+            "vol": "    120611",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            3.5",
+            "prev_diff_rate": "     -0.05"
+        },
+        {
+            "data_date": "20240422",
+            "data_time": "",
+            "open_price": "         6430.0",
+            "high_price": "         6466.5",
+            "low_price": "         6425.0",
+            "last_price": "         6460.0",
+            "last_qntt": "",
+            "vol": "     82245",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "           31.5",
+            "prev_diff_rate": "      0.49"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,303 @@
+# 해외선물 체결추이(월간)
+
+- 원본 시트명: 해외선물 체결추이(월간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-020
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55020300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/monthly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 체결추이(월간) API입니다. 
+한국투자 HTS(eFriend Plus) &gt; [5502] 해외선물옵션 체결추이 화면에서 "월간" 선택 시 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외선물시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- ffcode.mst(해외선물종목마스터 파일) 다운로드 방법 2가지
+  1) 한국투자증권 Github의 파이썬 샘플코드를 사용하여 mst 파일 다운로드 및 excel 파일로 정제   
+     https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/overseas_future_code.py
+   
+  2) 혹은 포럼 - FAQ - 종목정보 다운로드(해외) - 해외지수선물 클릭하셔서 ffcode.mst(해외선물종목마스터 파일)을 다운로드 후
+     Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외선물정보.h)를 참고하여 해석
+
+- 소수점 계산 시, ffcode.mst(해외선물종목마스터 파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) ffcode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 6A 계산소수점 -4 → 시세 6882.5 수신 시 0.68825 로 해석
+       품목코드 GC 계산소수점 -1 → 시세 19225 수신 시 1922.5 로 해석
+
+※ CME, SGX 거래소 API시세는 유료시세로 HTS/MTS에서 유료가입 후 익일부터 시세 이용 가능합니다.
+포럼 &gt; FAQ &gt; 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소)
+
+## 레이아웃
+
+### 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 | HHDFC55020300 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | 예) 6AM24 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 예) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | 공백 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | 예) 20240402 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 (분만 사용) |
+| INDEX_KEY | 이전조회KEY | string | Y | 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 | Y |  |  |
+| tret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 |  |
+| data_time | 시각 | string | Y | 6 |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 |  |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:6AM24
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:20240423
+QRY_TP:
+QRY_CNT:30
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0013",
+        "last_n_cnt": "",
+        "index_key": ""
+    },
+    "output2": [
+        {
+            "data_date": "20230401",
+            "data_time": "",
+            "open_price": "         6770.0",
+            "high_price": "         6770.0",
+            "low_price": "         6770.0",
+            "last_price": "         6770.0",
+            "last_qntt": "",
+            "vol": "3",
+            "prev_diff_flag": "3",
+            "prev_diff_price": "      0.0000000",
+            "prev_diff_rate": "      0.00"
+        },
+        {
+            "data_date": "20230501",
+            "data_time": "",
+            "open_price": "         6795.0",
+            "high_price": "         6800.0",
+            "low_price": "         6620.0",
+            "last_price": "         6620.0",
+            "last_qntt": "",
+            "vol": "        16",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "    150.0000000",
+            "prev_diff_rate": "     -2.22"
+        },
+        {
+            "data_date": "20230601",
+            "data_time": "",
+            "open_price": "         6809.5",
+            "high_price": "         6817.0",
+            "low_price": "         6692.0",
+            "last_price": "         6692.0",
+            "last_qntt": "",
+            "vol": "        25",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "     72.0000000",
+            "prev_diff_rate": "      1.09"
+        },
+        {
+            "data_date": "20230701",
+            "data_time": "",
+            "open_price": "         6840.5",
+            "high_price": "         6840.5",
+            "low_price": "         6840.0",
+            "last_price": "         6840.0",
+            "last_qntt": "",
+            "vol": "5",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "    148.0000000",
+            "prev_diff_rate": "      2.21"
+        },
+        {
+            "data_date": "20230801",
+            "data_time": "",
+            "open_price": "         6702.0",
+            "high_price": "         6702.0",
+            "low_price": "         6594.5",
+            "last_price": "         6594.5",
+            "last_qntt": "",
+            "vol": "        16",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "    245.5000000",
+            "prev_diff_rate": "     -3.59"
+        },
+        {
+            "data_date": "20230901",
+            "data_time": "",
+            "open_price": "         6535.0",
+            "high_price": "         6558.5",
+            "low_price": "         6430.0",
+            "last_price": "         6450.5",
+            "last_qntt": "",
+            "vol": "        55",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "    144.0000000",
+            "prev_diff_rate": "     -2.18"
+        },
+        {
+            "data_date": "20231001",
+            "data_time": "",
+            "open_price": "         6480.5",
+            "high_price": "         6480.5",
+            "low_price": "         6345.0",
+            "last_price": "         6366.0",
+            "last_qntt": "",
+            "vol": "        83",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "     84.5000000",
+            "prev_diff_rate": "     -1.31"
+        },
+        {
+            "data_date": "20231101",
+            "data_time": "",
+            "open_price": "         6460.5",
+            "high_price": "         6675.0",
+            "low_price": "         6395.0",
+            "last_price": "         6640.0",
+            "last_qntt": "",
+            "vol": "       532",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "    274.0000000",
+            "prev_diff_rate": "      4.30"
+        },
+        {
+            "data_date": "20231201",
+            "data_time": "",
+            "open_price": "         6642.0",
+            "high_price": "         6900.0",
+            "low_price": "         6565.0",
+            "last_price": "         6858.5",
+            "last_qntt": "",
+            "vol": "      1914",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "    218.5000000",
+            "prev_diff_rate": "      3.29"
+        },
+        {
+            "data_date": "20240101",
+            "data_time": "",
+            "open_price": "         6841.0",
+            "high_price": "         6864.5",
+            "low_price": "         6556.0",
+            "last_price": "         6591.0",
+            "last_qntt": "",
+            "vol": "      2302",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "    267.5000000",
+            "prev_diff_rate": "     -3.90"
+        },
+        {
+            "data_date": "20240201",
+            "data_time": "",
+            "open_price": "         6588.0",
+            "high_price": "         6629.0",
+            "low_price": "         6469.0",
+            "last_price": "         6519.0",
+            "last_qntt": "",
+            "vol": "      6753",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "     72.0000000",
+            "prev_diff_rate": "     -1.09"
+        },
+        {
+            "data_date": "20240301",
+            "data_time": "",
+            "open_price": "         6517.5",
+            "high_price": "         6686.5",
+            "low_price": "        0.66235",
+            "last_price": "           6530",
+            "last_qntt": "",
+            "vol": "    781551",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "     11.0000000",
+            "prev_diff_rate": "      0.17"
+        },
+        {
+            "data_date": "20240401",
+            "data_time": "",
+            "open_price": "         6531.5",
+            "high_price": "         6657.5",
+            "low_price": "         6373.0",
+            "last_price": "         6460.0",
+            "last_qntt": "",
+            "vol": "   1692383",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "     70.0000000",
+            "prev_diff_rate": "     -1.07"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,160 @@
+# 해외선물 상품기본정보
+
+- 원본 시트명: 해외선물 상품기본정보
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-023
+- HTTP Method: GET
+- 실전 TR_ID: HHDFC55200000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/search-contract-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 상품기본정보 API입니다.
+한국투자 HTS(eFriend Plus) &gt; [0054] 해외선물옵션 상품기본정보 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+QRY_CNT에 SRS_CD 요청 개수 입력, SRS_CD_01 ~SRS_CD_32 까지 최대 32건의 상품코드 추가 입력하여 해외선물옵션 상품기본정보 확인이 가능합니다.
+
+## 레이아웃
+
+### 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 | HHDFC55200000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| QRY_CNT | 요청개수 | string | Y | 4 | 입력한 코드 개수 |
+| SRS_CD_01 | 품목종류 | string | Y | 32 | 최대 32개 까지 가능 |
+| SRS_CD_02… | 품목종류… | string | Y | 32 |  |
+| SRS_CD_32 | 품목종류 | string | Y | 32 |  |
+
+### 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 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| exch_cd | 거래소코드 | string | Y | 10 |  |
+| clas_cd | 품목종류 | string | Y | 3 |  |
+| crc_cd | 거래통화 | string | Y | 10 |  |
+| sttl_price | 정산가 | string | Y | 15 |  |
+| sttl_date | 정산일 | string | Y | 8 |  |
+| trst_mgn | 증거금 | string | Y | 19 |  |
+| disp_digit | 가격표시진법 | string | Y | 10 |  |
+| tick_sz | 틱사이즈 | string | Y | 19 |  |
+| tick_val | 틱가치 | string | Y | 19 |  |
+| mrkt_open_date | 장개시일자 | string | Y | 8 |  |
+| mrkt_open_time | 장개시시각 | string | Y | 6 |  |
+| mrkt_close_date | 장마감일자 | string | Y | 8 |  |
+| mrkt_close_time | 장마감시각 | string | Y | 6 |  |
+| trd_fr_date | 상장일 | string | Y | 8 |  |
+| expr_date | 만기일 | string | Y | 8 |  |
+| trd_to_date | 최종거래일 | string | Y | 8 |  |
+| remn_cnt | 잔존일수 | string | Y | 4 |  |
+| stat_tp | 매매여부 | string | Y | 1 |  |
+| ctrt_size | 계약크기 | string | Y | 19 |  |
+| stl_tp | 최종결제구분 | string | Y | 20 |  |
+| frst_noti_date | 최초식별일 | string | Y | 8 |  |
+| sub_exch_nm | 서브거래소코드 | string | Y | 32 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+QRY_CNT:2
+SRS_CD_01:6AM24
+SRS_CD_02:10YK24
+```
+
+### Response Example
+
+```text
+{
+    "output2": [
+        {
+            "exch_cd": "CME",
+            "clas_cd": "001",
+            "crc_cd": "USD",
+            "sttl_price": "         6684.5",
+            "sttl_date": "20240516",
+            "trst_mgn": "               1595",
+            "disp_digit": "        10",
+            "tick_sz": "            0.00005",
+            "tick_val": "                  5",
+            "mrkt_open_date": "20240517",
+            "mrkt_open_time": "070000",
+            "mrkt_close_date": "20240518",
+            "mrkt_close_time": "060000",
+            "trd_fr_date": "20190604",
+            "expr_date": "20240617",
+            "trd_to_date": "20240617",
+            "remn_cnt": "  29",
+            "stat_tp": "1",
+            "ctrt_size": "             100000",
+            "stl_tp": "실물인수도",
+            "frst_noti_date": "20240617",
+            "sub_exch_nm": "CME"
+        },
+        {
+            "exch_cd": "CME",
+            "clas_cd": "002",
+            "crc_cd": "USD",
+            "sttl_price": "           4375",
+            "sttl_date": "20240516",
+            "trst_mgn": "                352",
+            "disp_digit": "        10",
+            "tick_sz": "              0.001",
+            "tick_val": "                  1",
+            "mrkt_open_date": "20240517",
+            "mrkt_open_time": "070000",
+            "mrkt_close_date": "20240518",
+            "mrkt_close_time": "060000",
+            "trd_fr_date": "20240315",
+            "expr_date": "20240531",
+            "trd_to_date": "20240531",
+            "remn_cnt": "  15",
+            "stat_tp": "1",
+            "ctrt_size": "               1000",
+            "stl_tp": "현금결제",
+            "frst_noti_date": "20240531",
+            "sub_exch_nm": "CBOT"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,206 @@
+# 해외선물 미결제추이
+
+- 원본 시트명: 해외선물 미결제추이
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-029
+- HTTP Method: GET
+- 실전 TR_ID: HHDDB95030000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/investor-unpd-trend
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물 미결제추이 API입니다.
+한국투자 HTS(eFriend Plus) &gt; [1959] 해외선물 미결제추이의 기능을 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 | HHDDB95030000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| PROD_ISCD | 상품 | string | Y | 5 | 금리 (GE, ZB, ZF,ZN,ZT), 금속(GC, PA, PL,SI, HG), 농산물(CC, CT,KC, OJ, SB, ZC,ZL, ZM, ZO, ZR, ZS, ZW), 에너지(CL, HO, NG, WBS), 지수(ES, NQ, TF, YM, VX), 축산물(GF, HE, LE), 통화(6A, 6B, 6C, 6E, 6J, 6N, 6S, DX) |
+| BSOP_DATE | 일자 | string | Y | 8 | 기준일(ex)20240513) |
+| UPMU_GUBUN | 구분 | string | Y | 1 | 0(수량), 1(증감) |
+| CTS_KEY | CTS_KEY | string | Y | 16 | 공백 |
+
+### 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 |  |  |
+| row_cnt | 응답레코드카운트 | string | Y | 4 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| prod_iscd | 상품 | string | Y | 5 |  |
+| cftc_iscd | CFTC코드 | string | Y | 10 |  |
+| bsop_date | 일자 | string | Y | 8 |  |
+| bidp_spec | 매수투기 | string | Y | 10 |  |
+| askp_spec | 매도투기 | string | Y | 10 |  |
+| spread_spec | 스프레드투기 | string | Y | 10 |  |
+| bidp_hedge | 매수헤지 | string | Y | 10 |  |
+| askp_hedge | 매도헤지 | string | Y | 10 |  |
+| hts_otst_smtn | 미결제합계 | string | Y | 10 |  |
+| bidp_missing | 매수누락 | string | Y | 10 |  |
+| askp_missing | 매도누락 | string | Y | 10 |  |
+| bidp_spec_cust | 매수투기고객 | string | Y | 10 |  |
+| askp_spec_cust | 매도투기고객 | string | Y | 10 |  |
+| spread_spec_cust | 스프레드투기고객 | string | Y | 10 |  |
+| bidp_hedge_cust | 매수헤지고객 | string | Y | 10 |  |
+| askp_hedge_cust | 매도헤지고객 | string | Y | 10 |  |
+| cust_smtn | 고객합계 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+PROD_ISCD:ES
+BSOP_DATE:20240624
+UPMU_GUBUN:0
+CTS_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "row_cnt": "0100"
+    },
+    "output2": [
+        {
+            "prod_iscd": "ES",
+            "cftc_iscd": "13874A",
+            "bsop_date": "20240611",
+            "bidp_spec": "270380",
+            "askp_spec": "381794",
+            "spread_spec": "0",
+            "bidp_hedge": "1606798",
+            "askp_hedge": "1617849",
+            "hts_otst_smtn": "2266096",
+            "bidp_missing": "297310",
+            "askp_missing": "174845",
+            "bidp_spec_cust": "80",
+            "askp_spec_cust": "68",
+            "spread_spec_cust": "55",
+            "bidp_hedge_cust": "253",
+            "askp_hedge_cust": "205",
+            "cust_smtn": "472"
+        },
+        {
+            "prod_iscd": "ES",
+            "cftc_iscd": "13874A",
+            "bsop_date": "20240604",
+            "bidp_spec": "265433",
+            "askp_spec": "330433",
+            "spread_spec": "0",
+            "bidp_hedge": "1534557",
+            "askp_hedge": "1581649",
+            "hts_otst_smtn": "2160026",
+            "bidp_missing": "287673",
+            "askp_missing": "175581",
+            "bidp_spec_cust": "76",
+            "askp_spec_cust": "68",
+            "spread_spec_cust": "45",
+            "bidp_hedge_cust": "262",
+            "askp_hedge_cust": "207",
+            "cust_smtn": "474"
+        },
+        {
+            "prod_iscd": "ES",
+            "cftc_iscd": "13874A",
+            "bsop_date": "20240528",
+            "bidp_spec": "330937",
+            "askp_spec": "333145",
+            "spread_spec": "0",
+            "bidp_hedge": "1503708",
+            "askp_hedge": "1609652",
+            "hts_otst_smtn": "2179731",
+            "bidp_missing": "289071",
+            "askp_missing": "180919",
+            "bidp_spec_cust": "80",
+            "askp_spec_cust": "63",
+            "spread_spec_cust": "39",
+            "bidp_hedge_cust": "251",
+            "askp_hedge_cust": "203",
+            "cust_smtn": "469"
+        },
+        {
+            "prod_iscd": "ES",
+            "cftc_iscd": "13874A",
+            "bsop_date": "20240521",
+            "bidp_spec": "304226",
+            "askp_spec": "327000",
+            "spread_spec": "0",
+            "bidp_hedge": "1501724",
+            "askp_hedge": "1593706",
+            "hts_otst_smtn": "2148201",
+            "bidp_missing": "288496",
+            "askp_missing": "173740",
+            "bidp_spec_cust": "78",
+            "askp_spec_cust": "66",
+            "spread_spec_cust": "42",
+            "bidp_hedge_cust": "249",
+            "askp_hedge_cust": "205",
+            "cust_smtn": "470"
+        },
+        {
+            "prod_iscd": "ES",
+            "cftc_iscd": "13874A",
+            "bsop_date": "20240514",
+            "bidp_spec": "273398",
+            "askp_spec": "298682",
+            "spread_spec": "0",
+            "bidp_hedge": "1477881",
+            "askp_hedge": "1550928",
+            "hts_otst_smtn": "2081097",
+            "bidp_missing": "278004",
+            "askp_missing": "179673",
+            "bidp_spec_cust": "83",
+            "askp_spec_cust": "67",
+            "spread_spec_cust": "45",
+            "bidp_hedge_cust": "248",
+            "askp_hedge_cust": "201",
+            "cust_smtn": "470"
+        },...
+    ],
+    "rt_cd": "0",
+    "msg_cd": "",
+    "msg1": "정상 조회되었습니다."
+}
+```
@@ -0,0 +1,160 @@
+# 해외옵션종목현재가
+
+- 원본 시트명: 해외옵션종목현재가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-035
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55010000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션종목현재가 API입니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55010000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 32 | ex) OESU24 C5500<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+
+### 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 |  |  |
+| proc_date | 최종처리일자 | string | Y | 8 |  |
+| proc_time | 최종처리시각 | string | Y | 6 |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 현재가 | string | Y | 15 | 현재가<br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+| bid_qntt | 매수1수량 | string | Y | 10 |  |
+| bid_price | 매수1호가 | string | Y | 15 |  |
+| ask_qntt | 매도1수량 | string | Y | 10 |  |
+| ask_price | 매도1호가 | string | Y | 15 |  |
+| trst_mgn | 증거금 | string | Y | 19 |  |
+| exch_cd | 거래소코드 | string | Y | 10 |  |
+| crc_cd | 거래통화 | string | Y | 10 |  |
+| trd_fr_date | 상장일 | string | Y | 8 |  |
+| expr_date | 만기일 | string | Y | 8 |  |
+| trd_to_date | 최종거래일 | string | Y | 8 |  |
+| remn_cnt | 잔존일수 | string | Y | 4 |  |
+| last_qntt | 체결량 | string | Y | 10 |  |
+| tot_ask_qntt | 총매도잔량 | string | Y | 10 |  |
+| tot_bid_qntt | 총매수잔량 | string | Y | 10 |  |
+| tick_size | 틱사이즈 | string | Y | 19 |  |
+| open_date | 장개시일자 | string | Y | 8 |  |
+| open_time | 장개시시각 | string | Y | 6 |  |
+| close_date | 장종료일자 | string | Y | 8 |  |
+| close_time | 장종료시각 | string | Y | 6 |  |
+| sbsnsdate | 영업일자 | string | Y | 8 |  |
+| sttl_price | 정산가 | string | N | 15 | 정산가 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OGXX24 C19500
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "proc_date": "20241108",
+        "proc_time": "173441",
+        "open_price": "           84.0",
+        "high_price": "           84.0",
+        "low_price": "           83.0",
+        "last_price": "           83.0",
+        "vol": "         3",
+        "prev_diff_flag": "5",
+        "prev_diff_price": "           38.0",
+        "prev_diff_rate": "    -31.40",
+        "bid_qntt": "       275",
+        "bid_price": "           83.0",
+        "ask_qntt": "       425",
+        "ask_price": "           87.0",
+        "prev_price": "          121.0",
+        "trst_mgn": "               4101",
+        "exch_cd": "EUREX",
+        "crc_cd": "EUR",
+        "trd_fr_date": "20240816",
+        "expr_date": "20240816",
+        "trd_to_date": "20241115",
+        "remn_cnt": "0008",
+        "last_qntt": "         2",
+        "tot_ask_qntt": "       952",
+        "tot_bid_qntt": "       726",
+        "tick_size": "                0.1",
+        "open_date": "20241108",
+        "open_time": "150000",
+        "close_date": "20241109",
+        "close_time": "013000",
+        "sbsnsdate": "20241108",
+        "sttl_price": "          102.2"
+    },
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,141 @@
+# 해외옵션종목상세
+
+- 원본 시트명: 해외옵션종목상세
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-034
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55010100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션종목상세 API입니다.
+
+(주의) sstl_price 자리에 정산가 X 전일종가 O 가 수신되는 점 유의 부탁드립니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55010100 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 32 | ex) OESU24 C5500<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+
+### 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 |  |  |
+| exch_cd | 거래소코드 | string | Y | 10 |  |
+| clas_cd | 품목종류 | string | Y | 1 |  |
+| crc_cd | 거래통화 | string | Y | 10 |  |
+| sttl_price | 전일종가 | string | Y | 15 | (★주의) 정산가 X 전일종가 O 가 수신됨<br><br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| sttl_date | 정산일 | string | Y | 8 |  |
+| trst_mgn | 증거금 | string | Y | 19 |  |
+| disp_digit | 가격표시진법 | string | Y | 10 |  |
+| tick_sz | 틱사이즈 | string | Y | 19 |  |
+| tick_val | 틱가치 | string | Y | 19 |  |
+| mrkt_open_date | 장개시일자 | string | Y | 8 |  |
+| mrkt_open_time | 장개시시각 | string | Y | 6 |  |
+| mrkt_close_date | 장마감일자 | string | Y | 8 |  |
+| mrkt_close_time | 장마감시각 | string | Y | 6 |  |
+| trd_fr_date | 상장일 | string | Y | 8 |  |
+| expr_date | 만기일 | string | Y | 8 |  |
+| trd_to_date | 최종거래일 | string | Y | 8 |  |
+| remn_cnt | 잔존일수 | string | Y | 4 |  |
+| stat_tp | 매매여부 | string | Y | 1 |  |
+| ctrt_size | 계약크기 | string | Y | 19 |  |
+| stl_tp | 최종결제구분 | string | Y | 20 |  |
+| frst_noti_date | 최초식별일 | string | Y | 8 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 P5650
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "exch_cd": "CME",
+        "clas_cd": "4",
+        "crc_cd": "USD",
+        "sttl_price": "           7525",
+        "sttl_date": "20240826",
+        "trst_mgn": "               7788",
+        "disp_digit": "        10",
+        "tick_sz": "                  0",
+        "tick_val": "                2.5",
+        "mrkt_open_date": "20240826",
+        "mrkt_open_time": "070000",
+        "mrkt_close_date": "20240827",
+        "mrkt_close_time": "060000",
+        "trd_fr_date": "20240610",
+        "expr_date": "20240920",
+        "trd_to_date": "20240920",
+        "remn_cnt": "  26",
+        "stat_tp": "1",
+        "ctrt_size": "                 50",
+        "stl_tp": "현금결제",
+        "frst_noti_date": "20240920"
+    },
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,152 @@
+# 해외옵션 호가
+
+- 원본 시트명: 해외옵션 호가
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-033
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO86000000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-asking-price
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 호가 API입니다.
+한국투자 HTS(eFriend Plus) &gt; [5501] 해외선물옵션 현재가 화면 의 "왼쪽 상단 현재가" 기능을 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 | HHDFO86000000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목명 | string | Y | 8 | 예)OESM24 C5340 |
+
+### 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 |  |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| lowp_rice | 저가 | string | Y | 15 |  |
+| last_price | 현재가 | string | Y | 15 |  |
+| sttl_price | 정산가 | string | Y | 15 |  |
+| vol | 거래량 | string | Y | 10 |  |
+| prev_diff_price | 전일대비가 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+| quot_date | 호가수신일자 | string | Y | 8 |  |
+| quot_time | 호가수신시각 | string | Y | 6 |  |
+| output2 | 응답상세 | object array | Y |  | array (1호가~ 5호가 순서대로 표시) |
+| bid_qntt | 매수수량 | string | Y | 10 |  |
+| bid_num | 매수번호 | string | Y | 10 |  |
+| bid_price | 매수호가 | string | Y | 15 |  |
+| ask_qntt | 매도수량 | string | Y | 10 |  |
+| ask_num | 매도번호 | string | Y | 10 |  |
+| ask_price | 매도호가 | string | Y | 15 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OTXM24 C22000
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "open_price": "          282.0",
+        "high_price": "          295.0",
+        "lowp_rice": "          280.0",
+        "last_price": "          290.0",
+        "sttl_price": "          288.0",
+        "vol": "       100",
+        "prev_diff_price": "            2.0",
+        "prev_diff_rate": "      0.69",
+        "quot_date": "20240528",
+        "quot_time": "184601"
+    },
+    "output2": [
+        {
+            "bid_qntt": "        37",
+            "bid_num": "         0",
+            "bid_price": "          288.0",
+            "ask_qntt": "         4",
+            "ask_num": "         0",
+            "ask_price": "          290.0"
+        },
+        {
+            "bid_qntt": "        43",
+            "bid_num": "         0",
+            "bid_price": "          287.0",
+            "ask_qntt": "         8",
+            "ask_num": "         0",
+            "ask_price": "          291.0"
+        },
+        {
+            "bid_qntt": "        20",
+            "bid_num": "         0",
+            "bid_price": "          285.0",
+            "ask_qntt": "        54",
+            "ask_num": "         0",
+            "ask_price": "          292.0"
+        },
+        {
+            "bid_qntt": "         4",
+            "bid_num": "         0",
+            "bid_price": "          280.0",
+            "ask_qntt": "        21",
+            "ask_num": "         0",
+            "ask_price": "          295.0"
+        },
+        {
+            "bid_qntt": "         5",
+            "bid_num": "         0",
+            "bid_price": "          276.0",
+            "ask_qntt": "         1",
+            "ask_num": "         0",
+            "ask_price": "          296.0"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,201 @@
+# 해외옵션 분봉조회
+
+- 원본 시트명: 해외옵션 분봉조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-040
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020400
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/inquire-time-optchartprice
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 분봉조회 API입니다. 
+한 번의 호출에 120건까지 확인 가능하며, QRY_TP, INDEX_KEY 를 이용하여 다음조회 가능합니다.
+
+※ 다음조회 방법
+(처음조회) "QRY_TP":"Q", "QRY_CNT":"120", "INDEX_KEY":""
+(다음조회) "QRY_TP":"P", "QRY_CNT":"120", "INDEX_KEY":"20240902         5"  ◀ 이전 호출의 "output1 &gt; index_key" 기입
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55020400 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력<br>※ 날짜 입력해도 처리 안됨 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 120 (최대 120) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 1: 1분봉, 5: 5분봉 ... |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 다음조회(QRY_TP를 P로 입력) 시, 이전 호출의 "output1 > index_key" 기입하여 조회 |
+
+### 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 |  |
+| output2 | 응답상세 | object | Y |  |  |
+| ret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output1 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 |  |
+| data_time | 시간 | string | Y | 6 |  |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 | 체결가격<br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5660
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:120
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output2": {
+        "ret_cnt": "0120",
+        "last_n_cnt": "",
+        "index_key": "20240820        29"
+    },
+    "output1": [
+        {
+            "data_date": "20240821",
+            "data_time": "031600",
+            "open_price": "6375",
+            "high_price": "6425",
+            "low_price": "6375",
+            "last_price": "6425",
+            "last_qntt": "18",
+            "vol": "251",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "75",
+            "prev_diff_rate": "1.18"
+        },
+        {
+            "data_date": "20240821",
+            "data_time": "043400",
+            "open_price": "6000",
+            "high_price": "6000",
+            "low_price": "6000",
+            "last_price": "6000",
+            "last_qntt": "2",
+            "vol": "253",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "-425",
+            "prev_diff_rate": "-6.61"
+        },
+        {
+            "data_date": "20240821",
+            "data_time": "044100",
+            "open_price": "6025",
+            "high_price": "6025",
+            "low_price": "6000",
+            "last_price": "6000",
+            "last_qntt": "4",
+            "vol": "257",
+            "prev_diff_flag": "3",
+            "prev_diff_price": "0",
+            "prev_diff_rate": "0.00"
+        },
+        {
+            "data_date": "20240821",
+            "data_time": "044700",
+            "open_price": "6025",
+            "high_price": "6025",
+            "low_price": "6025",
+            "last_price": "6025",
+            "last_qntt": "10",
+            "vol": "267",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "25",
+            "prev_diff_rate": "0.42"
+        },...
+        {
+            "data_date": "20240826",
+            "data_time": "141000",
+            "open_price": "6950",
+            "high_price": "6950",
+            "low_price": "6950",
+            "last_price": "6950",
+            "last_qntt": "1",
+            "vol": "1",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "-125",
+            "prev_diff_rate": "-1.77"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,175 @@
+# 해외옵션 체결추이(틱)
+
+- 원본 시트명: 해외옵션 체결추이(틱)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-038
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020200
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-tick-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(틱) API입니다. 
+한 번의 호출에 40건까지 확인 가능하며, QRY_TP, INDEX_KEY 를 이용하여 다음조회 가능합니다.
+
+※ 다음조회 방법
+(처음조회) "QRY_TP":"Q", "QRY_CNT":"40", "INDEX_KEY":""
+(다음조회) "QRY_TP":"P", "QRY_CNT":"40", "INDEX_KEY":"20240906       221"  ◀ 이전 호출의 "output1 &gt; index_key" 기입
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55020200 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력<br>※ 날짜 입력해도 처리 안됨 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q : 최초조회시 , P : 다음키(INDEX_KEY) 입력하여 조회시 |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 30 (최대 40) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | 공백 |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | 다음조회(QRY_TP를 P로 입력) 시, 이전 호출의 "output1 > index_key" 기입하여 조회 |
+
+### 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 |  |  |
+| ret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | HHMMSS |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 | 체결가격<br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5600
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:30
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0030",
+        "last_n_cnt": "0001",
+        "index_key": "20240823       146"
+    },
+    "output2": [
+        {
+            "data_date": "20240824",
+            "data_time": "024037",
+            "open_price": "9900",
+            "high_price": "9900",
+            "low_price": "9900",
+            "last_price": "9900",
+            "last_qntt": "6",
+            "vol": "343",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "1700",
+            "prev_diff_rate": "20.73"
+        },
+        {
+            "data_date": "20240824",
+            "data_time": "024417",
+            "open_price": "10050",
+            "high_price": "10050",
+            "low_price": "10050",
+            "last_price": "10050",
+            "last_qntt": "6",
+            "vol": "349",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "1850",
+            "prev_diff_rate": "22.56"
+        },...
+        {
+            "data_date": "20240826",
+            "data_time": "081707",
+            "open_price": "10375",
+            "high_price": "10375",
+            "low_price": "10375",
+            "last_price": "10375",
+            "last_qntt": "1",
+            "vol": "7",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "-400",
+            "prev_diff_rate": "-3.71"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,176 @@
+# 해외옵션 체결추이(일간)
+
+- 원본 시트명: 해외옵션 체결추이(일간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-037
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020100
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-daily-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(일간) API입니다.
+최근 120건까지 데이터 확인이 가능합니다. ("QRY_CNT: 119 입력", START_DATE_TIME, CLOSE_DATE_TIME은 공란)
+
+※ 호출 시 유의사항
+ : START_DATE_TIME, CLOSE_DATE_TIME은 공란 입력, QRY_CNT는 확인 데이터 개수의 -1 개 입력
+ex) "START_DATE_TIME":"","CLOSE_DATE_TIME":"","QRY_CNT":"119" → 최근 120건 데이터 조회
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55020100 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 100 (최대 119)<br>※ QRY_CNT 입력값의 +1 개 데이터가 조회됩니다. |
+| QRY_GAP | 묶음개수 | string | Y | 3 | "" 공란 입력 |
+| INDEX_KEY | 이전조회KEY | string | Y | 30 | "" 공란 입력<br>※ 다음조회 불가 |
+
+### 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 |  |  |
+| ret_cnt | 자료개수 | string | Y | 4 | ※ "input > QRY_CNT" +1 개 만큼 조회됨 |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | "" |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 | 체결가격<br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5500
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:119
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0120",
+        "last_n_cnt": "",
+        "index_key": "20240308"
+    },
+    "output2": [
+        {
+            "data_date": "20240308",
+            "data_time": "",
+            "open_price": "           6600",
+            "high_price": "           6675",
+            "low_price": "           6600",
+            "last_price": "           6675",
+            "last_qntt": "",
+            "vol": "        20",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            800",
+            "prev_diff_rate": "     13.62"
+        },
+        {
+            "data_date": "20240311",
+            "data_time": "",
+            "open_price": "           5075",
+            "high_price": "           5100",
+            "low_price": "           5000",
+            "last_price": "           5100",
+            "last_qntt": "",
+            "vol": "        17",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           1575",
+            "prev_diff_rate": "    -23.60"
+        },
+		...
+        {
+            "data_date": "20240909",
+            "data_time": "",
+            "open_price": "            400",
+            "high_price": "            400",
+            "low_price": "            385",
+            "last_price": "            385",
+            "last_qntt": "",
+            "vol": "         2",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "             50",
+            "prev_diff_rate": "     14.93"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,185 @@
+# 해외옵션 체결추이(주간)
+
+- 원본 시트명: 해외옵션 체결추이(주간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-036
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-weekly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(주간) API입니다.
+최근 120건까지 데이터 확인이 가능합니다. (START_DATE_TIME, CLOSE_DATE_TIME은 공란 입력)
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55020000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 20 (최대 120) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | "" 공란 입력 |
+| INDEX_KEY | 이전조회KEY | string | Y | 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 | Y |  |  |
+| ret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | "" |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 | 체결가격<br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5600
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:100
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0052",
+        "last_n_cnt": "",
+        "index_key": ""
+    },
+    "output2": [
+        {
+            "data_date": "20221128",
+            "data_time": "",
+            "open_price": "           5525",
+            "high_price": "           5550",
+            "low_price": "           5525",
+            "last_price": "           5525",
+            "last_qntt": "",
+            "vol": "       150",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            425",
+            "prev_diff_rate": "     -7.14"
+        },
+        {
+            "data_date": "20221219",
+            "data_time": "",
+            "open_price": "           3650",
+            "high_price": "           3650",
+            "low_price": "           3650",
+            "last_price": "           3650",
+            "last_qntt": "",
+            "vol": "        25",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "           1875",
+            "prev_diff_rate": "    -33.94"
+        },
+        {
+            "data_date": "20230102",
+            "data_time": "",
+            "open_price": "           2900",
+            "high_price": "           2900",
+            "low_price": "           2825",
+            "last_price": "           2875",
+            "last_qntt": "",
+            "vol": "       225",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "            775",
+            "prev_diff_rate": "    -21.23"
+        },
+		...
+        {
+            "data_date": "20240909",
+            "data_time": "",
+            "open_price": "            900",
+            "high_price": "            950",
+            "low_price": "            900",
+            "last_price": "            950",
+            "last_qntt": "",
+            "vol": "        26",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "            145",
+            "prev_diff_rate": "     18.01"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,224 @@
+# 해외옵션 체결추이(월간)
+
+- 원본 시트명: 해외옵션 체결추이(월간)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-039
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55020300
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/opt-monthly-ccnl
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 체결추이(월간) API입니다. 
+최근 120건까지 데이터 확인이 가능합니다. (START_DATE_TIME, CLOSE_DATE_TIME은 공란 입력)
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55020300 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| SRS_CD | 종목코드 | string | Y | 32 | ex) OESU24 C5500<br>※ 종목코드 "포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션" 참고 |
+| EXCH_CD | 거래소코드 | string | Y | 10 | 종목코드에 맞는 거래소 코드 ex) CME |
+| START_DATE_TIME | 조회시작일시 | string | Y | 12 | "" 공란 입력 |
+| CLOSE_DATE_TIME | 조회종료일시 | string | Y | 12 | "" 공란 입력 |
+| QRY_TP | 조회구분 | string | Y | 1 | Q |
+| QRY_CNT | 요청개수 | string | Y | 4 | 예) 20 (최대 120) |
+| QRY_GAP | 묶음개수 | string | Y | 3 | "" 공란 입력 |
+| INDEX_KEY | 이전조회KEY | string | Y | 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 | Y |  |  |
+| ret_cnt | 자료개수 | string | Y | 4 |  |
+| last_n_cnt | N틱최종개수 | string | Y | 4 |  |
+| index_key | 이전조회KEY | string | Y | 30 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| data_date | 일자 | string | Y | 8 | 과거일자 ~ 최근일자 순으로 조회됨 |
+| data_time | 시간 | string | Y | 6 | "" |
+| open_price | 시가 | string | Y | 15 |  |
+| high_price | 고가 | string | Y | 15 |  |
+| low_price | 저가 | string | Y | 15 |  |
+| last_price | 체결가격 | string | Y | 15 | 체결가격<br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| last_qntt | 체결수량 | string | Y | 10 |  |
+| vol | 누적거래수량 | string | Y | 10 |  |
+| prev_diff_flag | 전일대비구분 | string | Y | 1 |  |
+| prev_diff_price | 전일대비가격 | string | Y | 15 |  |
+| prev_diff_rate | 전일대비율 | string | Y | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+SRS_CD:OESU24 C5600
+EXCH_CD:CME
+START_DATE_TIME:
+CLOSE_DATE_TIME:
+QRY_TP:Q
+QRY_CNT:20
+QRY_GAP:
+INDEX_KEY:
+```
+
+### Response Example
+
+```text
+{
+    "output1": {
+        "ret_cnt": "0016",
+        "last_n_cnt": "",
+        "index_key": ""
+    },
+    "output2": [
+        {
+            "data_date": "20221101",
+            "data_time": "",
+            "open_price": "5525",
+            "high_price": "5550",
+            "low_price": "5525",
+            "last_price": "5525",
+            "last_qntt": "",
+            "vol": "150",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "425",
+            "prev_diff_rate": "-7.14"
+        },
+        {
+            "data_date": "20221201",
+            "data_time": "",
+            "open_price": "3650",
+            "high_price": "3650",
+            "low_price": "3650",
+            "last_price": "3650",
+            "last_qntt": "",
+            "vol": "25",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "1875",
+            "prev_diff_rate": "-33.94"
+        },
+        {
+            "data_date": "20230101",
+            "data_time": "",
+            "open_price": "2900",
+            "high_price": "2900",
+            "low_price": "2825",
+            "last_price": "2875",
+            "last_qntt": "",
+            "vol": "225",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "775",
+            "prev_diff_rate": "-21.23"
+        },
+        {
+            "data_date": "20230901",
+            "data_time": "",
+            "open_price": "750",
+            "high_price": "750",
+            "low_price": "750",
+            "last_price": "750",
+            "last_qntt": "",
+            "vol": "2",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "2125",
+            "prev_diff_rate": "-73.91"
+        },
+        {
+            "data_date": "20231001",
+            "data_time": "",
+            "open_price": "630",
+            "high_price": "645",
+            "low_price": "320",
+            "last_price": "330",
+            "last_qntt": "",
+            "vol": "357",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "420",
+            "prev_diff_rate": "-56.00"
+        },
+        {
+            "data_date": "20231101",
+            "data_time": "",
+            "open_price": "360",
+            "high_price": "815",
+            "low_price": "360",
+            "last_price": "800",
+            "last_qntt": "",
+            "vol": "1230",
+            "prev_diff_flag": "2",
+            "prev_diff_price": "470",
+            "prev_diff_rate": "142.42"
+        },
+		...
+        {
+            "data_date": "20240901",
+            "data_time": "",
+            "open_price": "9400",
+            "high_price": "10250",
+            "low_price": "805",
+            "last_price": "900",
+            "last_qntt": "",
+            "vol": "3985",
+            "prev_diff_flag": "5",
+            "prev_diff_price": "9000",
+            "prev_diff_rate": "-90.91"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,194 @@
+# 해외옵션 상품기본정보
+
+- 원본 시트명: 해외옵션 상품기본정보
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-041
+- HTTP Method: GET
+- 실전 TR_ID: HHDFO55200000
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/search-opt-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외옵션 상품기본정보 API입니다.
+한국투자 HTS(eFriend Plus) &gt; [0054] 관심종목 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+(중요) 해외옵션시세 출력값을 해석하실 때 focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
+
+- focode.mst(해외지수옵션 종목마스터파일), (해외주식옵션 종목마스터파일) 다운로드 방법
+  1) focode.mst(해외지수옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외지수옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외옵션정보.h)를 참고하여 해석
+  2) fostkcode.mst(해외주식옵션 종목마스터파일)
+     : 포럼 &gt; FAQ &gt; 종목정보 다운로드(해외) - 해외주식옵션 클릭하여 다운로드 후
+       Github의 헤더정보(https://github.com/koreainvestment/open-trading-api/blob/main/stocks_info/해외주식옵션정보.h)를 참고하여 해석
+
+- 소수점 계산 시, focode.mst(해외지수옵션 종목마스터파일), fostkcode.mst(해외주식옵션 종목마스터파일)의 sCalcDesz(계산 소수점) 값 참고
+  EX) focode.mst 파일의 sCalcDesz(계산 소수점) 값
+       품목코드 OES 계산소수점 -2 → 시세 7525 수신 시 75.25 로 해석
+       품목코드 O6E 계산소수점 -4 → 시세 54.0 수신 시 0.0054 로 해석
+
+## 레이아웃
+
+### 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 | HHDFO55200000 |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| QRY_CNT | 요청개수 | string | Y | 32 | 입력한 코드 개수 |
+| SRS_CD_01 | 종목코드1 | string | Y | 32 | SRS_CD_01부터 차례로 입력(ex ) OESU24 C5500<br>최대 30개 까지 가능 |
+| SRS_CD_02... | 종목코드2 | string | Y | 32 |  |
+| SRS_CD_30 | 종목코드30 | string | Y | 32 |  |
+
+### 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 |  |
+| output2 | 응답상세 | object array | Y |  | array |
+| exch_cd | 거래소코드 | string | Y | 10 |  |
+| clas_cd | 품목종류 | string | Y | 1 |  |
+| crc_cd | 거래통화 | string | Y | 10 |  |
+| sttl_price | 정산가 | string | Y | 15 | 정산가<br>※ focode.mst, fostkcode.mst* 의 sCalcDesz(계산 소수점) 값 참고<br>* 포럼 > FAQ > 종목정보 다운로드(해외) - 해외지수옵션/해외주식옵션 |
+| sttl_date | 정산일 | string | Y | 8 |  |
+| trst_mgn | 증거금 | string | Y | 19 |  |
+| disp_digit | 가격표시진법 | string | Y | 10 |  |
+| tick_sz | 틱사이즈 | string | Y | 19 |  |
+| tick_val | 틱가치 | string | Y | 19 |  |
+| mrkt_open_date | 장개시일자 | string | Y | 8 |  |
+| mrkt_open_time | 장개시시각 | string | Y | 6 |  |
+| mrkt_close_date | 장마감일자 | string | Y | 8 |  |
+| mrkt_close_time | 장마감시각 | string | Y | 6 |  |
+| trd_fr_date | 상장일 | string | Y | 8 |  |
+| expr_date | 만기일 | string | Y | 8 |  |
+| trd_to_date | 최종거래일 | string | Y | 8 |  |
+| remn_cnt | 잔존일수 | string | Y | 4 |  |
+| stat_tp | 매매여부 | string | Y | 1 |  |
+| ctrt_size | 계약크기 | string | Y | 19 |  |
+| stl_tp | 최종결제구분 | string | Y | 20 |  |
+| frst_noti_date | 최초식별일 | string | Y | 8 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+QRY_CNT:3
+SRS_CD_01:OESU24 C5600
+SRS_CD_02:OESU24 C5590
+SRS_CD_03:OESU24 C5580
+```
+
+### Response Example
+
+```text
+{
+    "output2": [
+        {
+            "exch_cd": "CME",
+            "clas_cd": "4",
+            "crc_cd": "USD",
+            "sttl_price": "          11000",
+            "sttl_date": "20240826",
+            "trst_mgn": "               7788",
+            "disp_digit": "        10",
+            "tick_sz": "                  0",
+            "tick_val": "                2.5",
+            "mrkt_open_date": "20240826",
+            "mrkt_open_time": "000700",
+            "mrkt_close_date": "20240827",
+            "mrkt_close_time": "000600",
+            "trd_fr_date": "20240610",
+            "expr_date": "20240920",
+            "trd_to_date": "20240920",
+            "remn_cnt": "0026",
+            "stat_tp": "",
+            "ctrt_size": "                 50",
+            "stl_tp": "현금결제",
+            "frst_noti_date": ""
+        },
+        {
+            "exch_cd": "CME",
+            "clas_cd": "4",
+            "crc_cd": "USD",
+            "sttl_price": "          11675",
+            "sttl_date": "20240826",
+            "trst_mgn": "               7788",
+            "disp_digit": "        10",
+            "tick_sz": "                  0",
+            "tick_val": "                2.5",
+            "mrkt_open_date": "20240826",
+            "mrkt_open_time": "000700",
+            "mrkt_close_date": "20240827",
+            "mrkt_close_time": "000600",
+            "trd_fr_date": "20240610",
+            "expr_date": "20240920",
+            "trd_to_date": "20240920",
+            "remn_cnt": "0026",
+            "stat_tp": "",
+            "ctrt_size": "                 50",
+            "stl_tp": "현금결제",
+            "frst_noti_date": ""
+        },
+        {
+            "exch_cd": "CME",
+            "clas_cd": "4",
+            "crc_cd": "USD",
+            "sttl_price": "          12400",
+            "sttl_date": "20240826",
+            "trst_mgn": "               7788",
+            "disp_digit": "        10",
+            "tick_sz": "                  0",
+            "tick_val": "                2.5",
+            "mrkt_open_date": "20240826",
+            "mrkt_open_time": "000700",
+            "mrkt_close_date": "20240827",
+            "mrkt_close_time": "000600",
+            "trd_fr_date": "20240718",
+            "expr_date": "20240920",
+            "trd_to_date": "20240920",
+            "remn_cnt": "0026",
+            "stat_tp": "",
+            "ctrt_size": "                 50",
+            "stl_tp": "현금결제",
+            "frst_noti_date": ""
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "MCA00000",
+    "msg1": "정상처리 되었습니다."
+}
+```
@@ -0,0 +1,399 @@
+# 해외선물옵션 장운영시간
+
+- 원본 시트명: 해외선물옵션 장운영시간
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 기본시세
+- API ID: 해외선물-030
+- HTTP Method: GET
+- 실전 TR_ID: OTFM2229R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/quotations/market-time
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물 장운영시간 API입니다.
+한국투자 HTS(eFriend Plus) &gt; [6773] 해외선물 장운영시간 화면 의 기능을 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 | OTFM2229R |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| FM_PDGR_CD | FM상품군코드 | string | Y | 10 | 공백 |
+| FM_CLAS_CD | FM클래스코드 | string | Y | 3 | '공백(전체), 001(통화), 002(금리), 003(지수),<br>004(농산물),005(축산물),006(금속),007(에너지)' |
+| FM_EXCG_CD | FM거래소코드 | string | Y | 10 | 'CME(CME), EUREX(EUREX), HKEx(HKEx),<br>ICE(ICE), SGX(SGX), OSE(OSE), ASX(ASX),<br>CBOE(CBOE), MDEX(MDEX), NYSE(NYSE),<br>BMF(BMF),FTX(FTX), HNX(HNX), ETC(기타)' |
+| OPT_YN | 옵션여부 | string | Y | 1 | %(전체), N(선물), Y(옵션) |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 200 |  |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 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 | 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 array | Y |  |  |
+| fm_pdgr_cd | FM상품군코드 | string | Y | 10 |  |
+| fm_pdgr_name | FM상품군명 | string | Y | 60 |  |
+| fm_excg_cd | FM거래소코드 | string | Y | 10 |  |
+| fm_excg_name | FM거래소명 | string | Y | 60 |  |
+| fuop_dvsn_name | 선물옵션구분명 | string | Y | 60 |  |
+| fm_clas_cd | FM클래스코드 | string | Y | 3 |  |
+| fm_clas_name | FM클래스명 | string | Y | 30 |  |
+| am_mkmn_strt_tmd | 오전장운영시작시각 | string | Y | 6 |  |
+| am_mkmn_end_tmd | 오전장운영종료시각 | string | Y | 6 |  |
+| pm_mkmn_strt_tmd | 오후장운영시작시각 | string | Y | 6 |  |
+| pm_mkmn_end_tmd | 오후장운영종료시각 | string | Y | 6 |  |
+| mkmn_nxdy_strt_tmd | 장운영익일시작시각 | string | Y | 6 |  |
+| mkmn_nxdy_end_tmd | 장운영익일종료시각 | string | Y | 6 |  |
+| base_mket_strt_tmd | 기본시장시작시각 | string | Y | 6 |  |
+| base_mket_end_tmd | 기본시장종료시각 | string | Y | 6 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+FM_PDGR_CD:
+FM_CLAS_CD:
+FM_EXCG_CD:CME
+OPT_YN:%
+CTX_AREA_NK200:
+CTX_AREA_FK200:
+```
+
+### Response Example
+
+```text
+{
+    "ctx_area_nk200": "CME^003^2ES^                                                                                                                                                                                            ",
+    "ctx_area_fk200": "^CME^%^                                                                                                                                                                                                 ",
+    "output": [
+        {
+            "fm_pdgr_cd": "6A",
+            "fm_pdgr_name": "Australian Dollar",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6B",
+            "fm_pdgr_name": "British pounds",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6C",
+            "fm_pdgr_name": "Canadian Dollar",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6E",
+            "fm_pdgr_name": "Euro FX",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6J",
+            "fm_pdgr_name": "Japanese Yen",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6L",
+            "fm_pdgr_name": "Brazilian Real",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6M",
+            "fm_pdgr_name": "Mexican PESO",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6N",
+            "fm_pdgr_name": "NewZealand Dollars",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6S",
+            "fm_pdgr_name": "Swiss Franc",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "6Z",
+            "fm_pdgr_name": "South African Rand",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "E7",
+            "fm_pdgr_name": "E-mini Euro FX",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "J7",
+            "fm_pdgr_name": "E-Mini YEN",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "M6A",
+            "fm_pdgr_name": "E-micro AUD",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "M6B",
+            "fm_pdgr_name": "E-micro GBP",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "M6E",
+            "fm_pdgr_name": "E-micro EUR",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "MCD",
+            "fm_pdgr_name": "E-micro CAD",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },
+        {
+            "fm_pdgr_cd": "MJY",
+            "fm_pdgr_name": "E-micro JPY",
+            "fm_excg_cd": "CME",
+            "fm_excg_name": "Chicago Mercantile Exchange",
+            "fuop_dvsn_name": "선물",
+            "fm_clas_cd": "001",
+            "fm_clas_name": "통화",
+            "am_mkmn_strt_tmd": "070000",
+            "am_mkmn_end_tmd": "060000",
+            "pm_mkmn_strt_tmd": "",
+            "pm_mkmn_end_tmd": "",
+            "mkmn_nxdy_strt_tmd": "",
+            "mkmn_nxdy_end_tmd": "",
+            "base_mket_strt_tmd": "070000",
+            "base_mket_end_tmd": "060000"
+        },...
+    ],
+    "rt_cd": "0",
+    "msg_cd": "KIOK0500",
+    "msg1": "조회가 계속됩니다..다음버튼을 Click 하십시오.                                   "
+}
+```
@@ -0,0 +1,121 @@
+# 해외선물옵션 주문
+
+- 원본 시트명: 해외선물옵션 주문
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-001
+- HTTP Method: POST
+- 실전 TR_ID: OTFM3001U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/order
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 주문 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 | 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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]<br>OTFM3001U : ASFM선물옵션주문신규 |
+| 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 Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| OVRS_FUTR_FX_PDNO | 해외선물FX상품번호 | string | Y | 32 |  |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도<br>02 : 매수 |
+| FM_LQD_USTL_CCLD_DT | FM청산미결제체결일자 | string | N | 8 | 빈칸 (hedge청산만 이용) |
+| FM_LQD_USTL_CCNO | FM청산미결제체결번호 | string | N | 10 | 빈칸 (hedge청산만 이용) |
+| PRIC_DVSN_CD | 가격구분코드 | string | Y | 1 | 1.지정, 2. 시장, 3. STOP, 4 S/L |
+| FM_LIMIT_ORD_PRIC | FMLIMIT주문가격 | string | Y | 20 | 지정가인 경우 가격 입력<br>* 시장가, STOP주문인 경우, 빈칸("") 입력 |
+| FM_STOP_ORD_PRIC | FMSTOP주문가격 | string | Y | 20 | STOP 주문 가격 입력<br>* 시장가, 지정가인 경우, 빈칸("") 입력 |
+| FM_ORD_QTY | FM주문수량 | string | Y | 10 |  |
+| FM_LQD_LMT_ORD_PRIC | FM청산LIMIT주문가격 | string | N | 20 | 빈칸 (hedge청산만 이용) |
+| FM_LQD_STOP_ORD_PRIC | FM청산STOP주문가격 | string | N | 20 | 빈칸 (hedge청산만 이용) |
+| CCLD_CNDT_CD | 체결조건코드 | string | Y | 1 | 일반적으로 6 (EOD, 지정가) <br>GTD인 경우 5, 시장가인 경우만 2 |
+| CPLX_ORD_DVSN_CD | 복합주문구분코드 | string | Y | 1 | 0 (hedge청산만 이용) |
+| ECIS_RSVN_ORD_YN | 행사예약주문여부 | string | Y | 1 | N |
+| FM_HDGE_ORD_SCRN_YN | FM_HEDGE주문화면여부 | string | Y | 1 | N |
+
+### 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 |  | object | N |  |  |
+| ORD_DT | 주문일자 | string | N | 8 |  |
+| ODNO | 주문번호 | string | N | 8 | 접수한 주문의 일련번호(ex. 00360686)<br>* 정정/취소시 문자열처럼 "0"을 포함해서 전송 <br>  (ex. ORGN_ODNO : 00360686) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+    "CANO": "81012345",
+    "ACNT_PRDT_CD": "08",
+    "OVRS_FUTR_FX_PDNO": "6BZ22",
+    "SLL_BUY_DVSN_CD": "02",
+    "FM_LQD_USTL_CCLD_DT": "",
+    "FM_LQD_USTL_CCNO": "",
+    "PRIC_DVSN_CD": "1",
+    "FM_LIMIT_ORD_PRIC": "1.17",
+    "FM_STOP_ORD_PRIC": "",
+    "FM_ORD_QTY": "1",
+    "FM_LQD_LMT_ORD_PRIC": "",
+    "FM_LQD_STOP_ORD_PRIC": "",
+    "CCLD_CNDT_CD": "6",
+    "CPLX_ORD_DVSN_CD": "0",
+    "ECIS_RSVN_ORD_YN": "N",
+    "FM_HDGE_ORD_SCRN_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+    "rt_cd": "0",
+    "msg_cd": "APBK0013",
+    "msg1": "주문 전송 완료 되었습니다.",
+    "output": {
+        "ORD_DT": "20221214",
+        "ODNO": "00298040"
+    }
+}
+```
@@ -0,0 +1,102 @@
+# 해외선물옵션 정정취소주문
+
+- 원본 시트명: 해외선물옵션 정정취소주문
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-002, 003
+- HTTP Method: POST
+- 실전 TR_ID: (정정) OTFM3002U (취소) OTFM3003U
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-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 | 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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | [실전투자]<br>OTFM3002U : 해외선물옵션주문정정<br>OTFM3003U : 해외선물옵션주문취소 |
+| 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 Body
+
+| Element | 한글명 | Type | Required | Length | Description |
+| --- | --- | --- | --- | --- | --- |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| ORGN_ORD_DT | 원주문일자 | string | Y | 8 | 원 주문 시 출력되는 ORD_DT 값을 입력 (현지거래일) |
+| ORGN_ODNO | 원주문번호 | string | Y | 8 | 정정/취소시 주문번호(ODNO) 8자리를 문자열처럼 "0"을 포함해서 전송 (원 주문 시 출력된 ODNO 값 활용)<br>(ex. ORGN_ODNO : 00360686) |
+| FM_LIMIT_ORD_PRIC | FMLIMIT주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_STOP_ORD_PRIC | FMSTOP주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_LQD_LMT_ORD_PRIC | FM청산LIMIT주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_LQD_STOP_ORD_PRIC | FM청산STOP주문가격 | string | N | 20 | OTFM3002U(해외선물옵션주문정정)만 사용 |
+| FM_HDGE_ORD_SCRN_YN | FM_HEDGE주문화면여부 | string | Y | 1 | N |
+| FM_MKPR_CVSN_YN | FM시장가전환여부 | string | N | 1 | OTFM3003U(해외선물옵션주문취소)만 사용<br><br>※ FM_MKPR_CVSN_YN 항목에 'Y'로 설정하여 취소주문을 접수할 경우, 주문 취소확인이 들어오면 원장에서 시장가주문을 하나 또 내줌 |
+
+### 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 |  | object | N |  |  |
+| ORD_DT | 주문일자 | string | N | 8 | YYYYMMDD(ex. 20230811) |
+| ODNO | 주문번호 | string | N | 8 | 접수한 주문의 일련번호(ex. 00360686)<br>* 정정/취소시 문자열처럼 "0"을 포함해서 전송 <br>  (ex. ORGN_ODNO : 00360686) |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+    "CANO": "81012345",
+    "ACNT_PRDT_CD": "08",
+    "ORGN_ORD_DT": "20221214",
+    "ORGN_ODNO": "00298044",
+    "FM_MKPR_CVSN_YN": "N",
+    "FM_HDGE_ORD_SCRN_YN": "N"
+}
+```
+
+### Response Example
+
+```text
+{
+    "rt_cd": "0",
+    "msg_cd": "APBK0013",
+    "msg1": "주문 전송 완료 되었습니다.",
+    "output": {
+        "ORD_DT": "20221214",
+        "ODNO": "00298045"
+    }
+}
+```
@@ -0,0 +1,261 @@
+# 해외선물옵션 당일주문내역조회
+
+- 원본 시트명: 해외선물옵션 당일주문내역조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-004
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3116R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈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 | OTFM3116R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default   개인: "" |
+| 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자리 |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 01:전체 / 02:체결 / 03:미체결 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | %%:전체 / 01:매도 / 02:매수 |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 |  |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 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 |  |
+| output | 응답상세1 | object array | N |  | Array |
+| cano | 종합계좌번호 | string | N | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 |  |
+| ord_dt | 주문일자 | string | N | 8 |  |
+| odno | 주문번호 | string | N | 8 | 접수한 주문의 일련번호(ex. 00360686)<br>* 정정/취소시 문자열처럼 "0"을 포함해서 전송 <br>  (ex. ORGN_ODNO : 00360686) |
+| orgn_ord_dt | 원주문일자 | string | N | 8 |  |
+| orgn_odno | 원주문번호 | string | N | 8 | 원주문번호(ex. 00360685) |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | N | 32 |  |
+| rcit_dvsn_cd | 접수구분코드 | string | N | 2 | 05	온라인 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 | 01:매도, 02:매수 |
+| trad_stgy_dvsn_cd | 매매전략구분코드 | string | N | 2 |  |
+| bass_pric_type_cd | 기준가격유형코드 | string | N | 2 | 01	시가평가<br>02	액면가<br>03	기준가격<br>04	대용가 |
+| ord_stat_cd | 주문상태코드 | string | N | 2 |  |
+| fm_ord_qty | FM주문수량 | string | N | 10 |  |
+| fm_ord_pric | FM주문가격 | string | N | 20 |  |
+| fm_stop_ord_pric | FMSTOP주문가격 | string | N | 20 |  |
+| rsvn_dvsn | 예약구분 | string | N | 2 |  |
+| fm_ccld_qty | FM체결수량 | string | N | 10 |  |
+| fm_ccld_pric | FM체결가격 | string | N | 20 |  |
+| fm_ord_rmn_qty | FM주문잔여수량 | string | N | 10 |  |
+| ord_grp_name | 주문그룹명 | string | N | 60 |  |
+| erlm_dtl_dtime | 등록상세일시 | string | N | 17 |  |
+| ccld_dtl_dtime | 체결상세일시 | string | N | 17 |  |
+| ord_stfno | 주문직원번호 | string | N | 6 |  |
+| rmks1 | 비고1 | string | N | 100 |  |
+| new_lqd_dvsn_cd | 신규청산구분코드 | string | N | 2 | 01	신규<br>02	청산 |
+| fm_lqd_lmt_ord_pric | FM청산LIMIT주문가격 | string | N | 20 |  |
+| fm_lqd_stop_pric | FM청산STOP가격 | string | N | 20 |  |
+| ccld_cndt_cd | 체결조건코드 | string | N | 1 |  |
+| noti_vald_dt | 게시유효일자 | string | N | 8 |  |
+| acnt_type_cd | 계좌유형코드 | string | N | 2 |  |
+| fuop_dvsn | 선물옵션구분 | string | N | 2 | 01:선물, 02: 옵션 |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"CANO":"80012345",
+	"ACNT_PRDT_CD":"08",
+	"CCLD_NCCS_DVSN":"01",
+	"SLL_BUY_DVSN_CD":"01",
+	"FUOP_DVSN":"00",
+	"CTX_AREA_FK100":"",
+	"CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+    "ctx_area_fk200": "81012345^08^01^02^00^                                                                                                                                                                                   ",
+    "ctx_area_nk200": "                                                                                                                                                                                                        ",
+    "output": [
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ord_dt": "20221214",
+            "odno": "00298048",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6BZ22",
+            "rcit_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "trad_stgy_dvsn_cd": "00",
+            "bass_pric_type_cd": "1",
+            "ord_stat_cd": "02",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "1.1700",
+            "fm_stop_ord_pric": "0.0000",
+            "rsvn_dvsn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.0000",
+            "fm_ord_rmn_qty": "1",
+            "ord_grp_name": "",
+            "erlm_dtl_dtime": "20221214134455791",
+            "ccld_dtl_dtime": "",
+            "ord_stfno": "invent",
+            "rmks1": "",
+            "new_lqd_dvsn_cd": "1",
+            "fm_lqd_lmt_ord_pric": "0.0000",
+            "fm_lqd_stop_pric": "0.0000",
+            "ccld_cndt_cd": "6",
+            "noti_vald_dt": "",
+            "acnt_type_cd": "1",
+            "fuop_dvsn": "01"
+        },
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ord_dt": "20221214",
+            "odno": "00298045",
+            "orgn_ord_dt": "20221214",
+            "orgn_odno": "00298044",
+            "ovrs_futr_fx_pdno": "6BZ22",
+            "rcit_dvsn_cd": "02",
+            "sll_buy_dvsn_cd": "02",
+            "trad_stgy_dvsn_cd": "00",
+            "bass_pric_type_cd": "1",
+            "ord_stat_cd": "02",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "0.0000",
+            "fm_stop_ord_pric": "0.0000",
+            "rsvn_dvsn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.0000",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "erlm_dtl_dtime": "20221214134356649",
+            "ccld_dtl_dtime": "",
+            "ord_stfno": "invent",
+            "rmks1": "",
+            "new_lqd_dvsn_cd": "1",
+            "fm_lqd_lmt_ord_pric": "0.0000",
+            "fm_lqd_stop_pric": "0.0000",
+            "ccld_cndt_cd": "6",
+            "noti_vald_dt": "",
+            "acnt_type_cd": "1",
+            "fuop_dvsn": "01"
+        },
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ord_dt": "20221214",
+            "odno": "00298044",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6BZ22",
+            "rcit_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "trad_stgy_dvsn_cd": "00",
+            "bass_pric_type_cd": "1",
+            "ord_stat_cd": "02",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "1.1700",
+            "fm_stop_ord_pric": "0.0000",
+            "rsvn_dvsn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.0000",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "erlm_dtl_dtime": "20221214134351411",
+            "ccld_dtl_dtime": "",
+            "ord_stfno": "invent",
+            "rmks1": "",
+            "new_lqd_dvsn_cd": "1",
+            "fm_lqd_lmt_ord_pric": "0.0000",
+            "fm_lqd_stop_pric": "0.0000",
+            "ccld_cndt_cd": "6",
+            "noti_vald_dt": "",
+            "acnt_type_cd": "1",
+            "fuop_dvsn": "01"
+        },
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ord_dt": "20221214",
+            "odno": "00298040",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6BZ22",
+            "rcit_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "trad_stgy_dvsn_cd": "00",
+            "bass_pric_type_cd": "1",
+            "ord_stat_cd": "02",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "1.1700",
+            "fm_stop_ord_pric": "0.0000",
+            "rsvn_dvsn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.0000",
+            "fm_ord_rmn_qty": "1",
+            "ord_grp_name": "",
+            "erlm_dtl_dtime": "20221214134100992",
+            "ccld_dtl_dtime": "",
+            "ord_stfno": "invent",
+            "rmks1": "",
+            "new_lqd_dvsn_cd": "1",
+            "fm_lqd_lmt_ord_pric": "0.0000",
+            "fm_lqd_stop_pric": "0.0000",
+            "ccld_cndt_cd": "6",
+            "noti_vald_dt": "",
+            "acnt_type_cd": "1",
+            "fuop_dvsn": "01"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+    "msg1": "조회가 완료되었습니다                                                           "
+}
+```
@@ -0,0 +1,177 @@
+# 해외선물옵션 미결제내역조회(잔고)
+
+- 원본 시트명: 해외선물옵션 미결제내역조회(잔고)
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-005
+- HTTP Method: GET
+- 실전 TR_ID: OTFM1412R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-unpd
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈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 | OTFM1412R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회<br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default   개인: "" |
+| 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자리 |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00: 전체 / 01:선물 / 02: 옵션 |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 |  |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 |  |
+
+### 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 array | N |  | Array |
+| cano | 종합계좌번호 | string | N | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 |  |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | N | 32 |  |
+| prdt_type_cd | 상품유형코드 | string | N | 3 |  |
+| crcy_cd | 통화코드 | string | N | 3 |  |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 |  |
+| fm_ustl_qty | FM미결제수량 | string | N | 10 |  |
+| fm_ccld_avg_pric | FM체결평균가격 | string | N | 20 |  |
+| fm_now_pric | FM현재가격 | string | N | 20 |  |
+| fm_evlu_pfls_amt | FM평가손익금액 | string | N | 20 |  |
+| fm_opt_evlu_amt | FM옵션평가금액 | string | N | 20 |  |
+| fm_otp_evlu_pfls_amt | FM옵션평가손익금액 | string | N | 20 |  |
+| fuop_dvsn | 선물옵션구분 | string | N | 2 |  |
+| ecis_rsvn_ord_yn | 행사예약주문여부 | string | N | 1 |  |
+| fm_lqd_psbl_qty | FM청산가능수량 | string | N | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"CANO":"80012345",
+	"ACNT_PRDT_CD":"08",
+	"FUOP_DVSN":"00",
+	"CTX_AREA_FK100":"",
+	"CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+    "ctx_area_fk100": "81012345^08^00^                                                                                     ",
+    "ctx_area_nk100": "                                                                                                    ",
+    "output": [
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "6AZ22",
+            "prdt_type_cd": "600",
+            "crcy_cd": "USD",
+            "sll_buy_dvsn_cd": "02",
+            "fm_ustl_qty": "2",
+            "fm_ccld_avg_pric": "0.62950",
+            "fm_now_pric": "0.68320",
+            "fm_evlu_pfls_amt": "10740.00",
+            "fm_opt_evlu_amt": "",
+            "fm_otp_evlu_pfls_amt": "",
+            "fuop_dvsn": "01",
+            "ecis_rsvn_ord_yn": "",
+            "fm_lqd_psbl_qty": "2"
+        },
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "6BZ22",
+            "prdt_type_cd": "600",
+            "crcy_cd": "USD",
+            "sll_buy_dvsn_cd": "02",
+            "fm_ustl_qty": "2",
+            "fm_ccld_avg_pric": "1.1898",
+            "fm_now_pric": "1.2350",
+            "fm_evlu_pfls_amt": "5656.24",
+            "fm_opt_evlu_amt": "",
+            "fm_otp_evlu_pfls_amt": "",
+            "fuop_dvsn": "01",
+            "ecis_rsvn_ord_yn": "",
+            "fm_lqd_psbl_qty": "2"
+        },
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "6JZ22",
+            "prdt_type_cd": "600",
+            "crcy_cd": "USD",
+            "sll_buy_dvsn_cd": "02",
+            "fm_ustl_qty": "1",
+            "fm_ccld_avg_pric": "6925.0",
+            "fm_now_pric": "7383.0",
+            "fm_evlu_pfls_amt": "5725.00",
+            "fm_opt_evlu_amt": "",
+            "fm_otp_evlu_pfls_amt": "",
+            "fuop_dvsn": "01",
+            "ecis_rsvn_ord_yn": "",
+            "fm_lqd_psbl_qty": "1"
+        },
+        {
+            "cano": "81012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "ZBZ22",
+            "prdt_type_cd": "600",
+            "crcy_cd": "USD",
+            "sll_buy_dvsn_cd": "01",
+            "fm_ustl_qty": "100",
+            "fm_ccld_avg_pric": "132.293125",
+            "fm_now_pric": "131.218750",
+            "fm_evlu_pfls_amt": "107438.00",
+            "fm_opt_evlu_amt": "",
+            "fm_otp_evlu_pfls_amt": "",
+            "fuop_dvsn": "01",
+            "ecis_rsvn_ord_yn": "",
+            "fm_lqd_psbl_qty": "100"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+    "msg1": "조회가 완료되었습니다                                                           "
+}
+```
@@ -0,0 +1,114 @@
+# 해외선물옵션 주문가능조회
+
+- 원본 시트명: 해외선물옵션 주문가능조회
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: v1_해외선물-006
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3304R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-psamount
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈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 | OTFM3304R |
+| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
+| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
+| seq_no | 일련번호 | string | N | 2 | 법인 : "001" / default   개인: "" |
+| 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자리 |
+| OVRS_FUTR_FX_PDNO | 해외선물FX상품번호 | string | Y | 32 |  |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | 01 : 매도 / 02 : 매수 |
+| FM_ORD_PRIC | FM주문가격 | string | Y | 20 |  |
+| ECIS_RSVN_ORD_YN | 행사예약주문여부 | string | Y | 1 | 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 | 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 | 응답상세1 | object | N |  |  |
+| cano | 종합계좌번호 | string | N | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 |  |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | N | 32 |  |
+| crcy_cd | 통화코드 | string | N | 3 |  |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | N | 2 |  |
+| fm_ustl_qty | FM미결제수량 | string | N | 10 |  |
+| fm_lqd_psbl_qty | FM청산가능수량 | string | N | 10 |  |
+| fm_new_ord_psbl_qty | FM신규주문가능수량 | string | N | 10 |  |
+| fm_tot_ord_psbl_qty | FM총주문가능수량 | string | N | 10 |  |
+| fm_mkpr_tot_ord_psbl_qty | FM시장가총주문가능수량 | string | N | 10 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"CANO":"80012345",
+	"ACNT_PRDT_CD":"08",
+	"OVRS_FUTR_FX_PDNO":"6AU22",
+	"SLL_BUY_DVSN_CD":"02",
+	"FM_ORD_PRIC":"",
+	"ECIS_RSVN_ORD_YN":""
+}
+```
+
+### Response Example
+
+```text
+{
+    "output": {
+        "cano": "80012345",
+        "acnt_prdt_cd": "08",
+        "ovrs_futr_fx_pdno": "6AU22",
+        "crcy_cd": "",
+        "sll_buy_dvsn_cd": "02",
+        "fm_ustl_qty": "0",
+        "fm_lqd_psbl_qty": "0",
+        "fm_new_ord_psbl_qty": "3717",
+        "fm_tot_ord_psbl_qty": "3717",
+        "fm_mkpr_tot_ord_psbl_qty": "3717"
+    },
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+    "msg1": "조회가 완료되었습니다                                                           "
+}
+```
@@ -0,0 +1,230 @@
+# 해외선물옵션 기간계좌손익 일별
+
+- 원본 시트명: 해외선물옵션 기간계좌손익 일별
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-010
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3118R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-period-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3118R |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| INQR_TERM_FROM_DT | 조회기간FROM일자 | string | Y | 8 |  |
+| INQR_TERM_TO_DT | 조회기간TO일자 | string | Y | 8 |  |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| CRCY_CD | 통화코드 | string | Y | 3 | '%%% : 전체<br>TUS: TOT_USD  / TKR: TOT_KRW<br>KRW: 한국  / USD: 미국<br>EUR: EUR   / HKD: 홍콩<br>CNY: 중국  / JPY: 일본' |
+| WHOL_TRSL_YN | 전체환산여부 | string | Y | 1 | N |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 |  |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 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 | 응답상세1 | object array | Y |  | Array |
+| cano | 종합계좌번호 | string | Y | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | N | 2 |  |
+| crcy_cd | 통화코드 | string | Y | 3 |  |
+| fm_buy_qty | FM매수수량 | string | Y | 10 |  |
+| fm_sll_qty | FM매도수량 | string | Y | 10 |  |
+| fm_lqd_pfls_amt | FM청산손익금액 | string | Y | 20 |  |
+| fm_fee | FM수수료 | string | Y | 20 |  |
+| fm_net_pfls_amt | FM순손익금액 | string | Y | 20 |  |
+| fm_ustl_buy_qty | FM미결제매수수량 | string | Y | 10 |  |
+| fm_ustl_sll_qty | FM미결제매도수량 | string | Y | 10 |  |
+| fm_ustl_evlu_pfls_amt | FM미결제평가손익금액 | string | Y | 20 |  |
+| fm_ustl_evlu_pfls_amt2 | FM미결제평가손익금액2 | string | Y | 20 |  |
+| fm_ustl_evlu_pfls_icdc_amt | FM미결제평가손익증감금액 | string | Y | 20 |  |
+| fm_ustl_agrm_amt | FM미결제약정금액 | string | Y | 20 |  |
+| fm_opt_lqd_amt | FM옵션청산금액 | string | Y | 20 |  |
+| output2 | 응답상세2 | object array | Y |  | Array |
+| cano | 종합계좌번호 | string | Y | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 |  |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | Y | 32 |  |
+| crcy_cd | 통화코드 | string | Y | 3 |  |
+| fm_buy_qty | FM매수수량 | string | Y | 10 |  |
+| fm_sll_qty | FM매도수량 | string | Y | 10 |  |
+| fm_lqd_pfls_amt | FM청산손익금액 | string | Y | 20 |  |
+| fm_fee | FM수수료 | string | Y | 20 |  |
+| fm_net_pfls_amt | FM순손익금액 | string | Y | 20 |  |
+| fm_ustl_buy_qty | FM미결제매수수량 | string | Y | 10 |  |
+| fm_ustl_sll_qty | FM미결제매도수량 | string | Y | 10 |  |
+| fm_ustl_evlu_pfls_amt | FM미결제평가손익금액 | string | Y | 20 |  |
+| fm_ustl_evlu_pfls_amt2 | FM미결제평가손익금액2 | string | Y | 20 |  |
+| fm_ustl_evlu_pfls_icdc_amt | FM미결제평가손익증감금액 | string | Y | 20 |  |
+| fm_ccld_avg_pric | FM체결평균가격 | string | Y | 20 |  |
+| fm_ustl_agrm_amt | FM미결제약정금액 | string | Y | 20 |  |
+| fm_opt_lqd_amt | FM옵션청산금액 | string | Y | 20 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"CANO":"80012345",
+	"ACNT_PRDT_CD":"08",
+	"INQR_TERM_FROM_DT":"20220901",
+	"INQR_TERM_TO_DT":"20221117",
+	"CRCY_CD":"%%%",
+	"WHOL_TRSL_YN":"N",
+	"FUOP_DVSN":"00",
+	"CTX_AREA_FK100":"",
+	"CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+    "ctx_area_fk200": "                                                                                                                                                                                                        ",
+    "ctx_area_nk200": "                                                                                                                                                                                                        ",
+    "output1": [
+        {
+            "cano": "80012345",
+            "acnt_prdt_cd": "08",
+            "crcy_cd": "USD",
+            "fm_buy_qty": "",
+            "fm_sll_qty": "",
+            "fm_lqd_pfls_amt": "0.00",
+            "fm_fee": "0.00",
+            "fm_net_pfls_amt": "129650.00",
+            "fm_ustl_buy_qty": "5",
+            "fm_ustl_sll_qty": "100",
+            "fm_ustl_evlu_pfls_amt": "129650.00",
+            "fm_ustl_evlu_pfls_amt2": "0.00",
+            "fm_ustl_evlu_pfls_icdc_amt": "129650.00",
+            "fm_ustl_agrm_amt": "13590493.75",
+            "fm_opt_lqd_amt": "0.00"
+        }
+    ],
+    "output2": [
+        {
+            "cano": "80012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "6AZ22",
+            "crcy_cd": "USD",
+            "fm_buy_qty": "",
+            "fm_sll_qty": "",
+            "fm_lqd_pfls_amt": "0.00",
+            "fm_fee": "0.00",
+            "fm_net_pfls_amt": "10850.00",
+            "fm_ustl_buy_qty": "2",
+            "fm_ustl_sll_qty": "",
+            "fm_ustl_evlu_pfls_amt": "10850.00",
+            "fm_ustl_evlu_pfls_amt2": "0.00",
+            "fm_ustl_evlu_pfls_icdc_amt": "10850.00",
+            "fm_ccld_avg_pric": "0.62950",
+            "fm_ustl_agrm_amt": "125900.00",
+            "fm_opt_lqd_amt": "0.00"
+        },
+        {
+            "cano": "80012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "6BZ22",
+            "crcy_cd": "USD",
+            "fm_buy_qty": "",
+            "fm_sll_qty": "",
+            "fm_lqd_pfls_amt": "0.00",
+            "fm_fee": "0.00",
+            "fm_net_pfls_amt": "5656.25",
+            "fm_ustl_buy_qty": "2",
+            "fm_ustl_sll_qty": "",
+            "fm_ustl_evlu_pfls_amt": "5656.25",
+            "fm_ustl_evlu_pfls_amt2": "0.00",
+            "fm_ustl_evlu_pfls_icdc_amt": "5656.25",
+            "fm_ccld_avg_pric": "1.1898",
+            "fm_ustl_agrm_amt": "148718.75",
+            "fm_opt_lqd_amt": "0.00"
+        },
+        {
+            "cano": "80012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "6JZ22",
+            "crcy_cd": "USD",
+            "fm_buy_qty": "",
+            "fm_sll_qty": "",
+            "fm_lqd_pfls_amt": "0.00",
+            "fm_fee": "0.00",
+            "fm_net_pfls_amt": "5706.25",
+            "fm_ustl_buy_qty": "1",
+            "fm_ustl_sll_qty": "",
+            "fm_ustl_evlu_pfls_amt": "5706.25",
+            "fm_ustl_evlu_pfls_amt2": "0.00",
+            "fm_ustl_evlu_pfls_icdc_amt": "5706.25",
+            "fm_ccld_avg_pric": "6925.0",
+            "fm_ustl_agrm_amt": "86562.50",
+            "fm_opt_lqd_amt": "0.00"
+        },
+        {
+            "cano": "80012345",
+            "acnt_prdt_cd": "08",
+            "ovrs_futr_fx_pdno": "ZBZ22",
+            "crcy_cd": "USD",
+            "fm_buy_qty": "",
+            "fm_sll_qty": "",
+            "fm_lqd_pfls_amt": "0.00",
+            "fm_fee": "0.00",
+            "fm_net_pfls_amt": "107437.50",
+            "fm_ustl_buy_qty": "",
+            "fm_ustl_sll_qty": "100",
+            "fm_ustl_evlu_pfls_amt": "107437.50",
+            "fm_ustl_evlu_pfls_amt2": "0.00",
+            "fm_ustl_evlu_pfls_icdc_amt": "107437.50",
+            "fm_ccld_avg_pric": "132.293125",
+            "fm_ustl_agrm_amt": "13229312.50",
+            "fm_opt_lqd_amt": "0.00"
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+    "msg1": "조회가 완료되었습니다                                                           "
+}
+```
@@ -0,0 +1,170 @@
+# 해외선물옵션 일별 체결내역
+
+- 원본 시트명: 해외선물옵션 일별 체결내역
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-011
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3122R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-daily-ccld
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 일별 체결내역 API입니다.
+거래소 체결 내역에 따라 , output1에 동일한 주문번호의 데이터들이 수신될 수 있습니다.
+
+## 레이아웃
+
+### 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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3122R |
+| 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_DT | 시작일자 | string | Y | 8 | 시작일자(YYYYMMDD) |
+| END_DT | 종료일자 | string | Y | 8 | 종료일자(YYYYMMDD) |
+| FUOP_DVSN_CD | 선물옵션구분코드 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| FM_PDGR_CD | FM상품군코드 | string | Y | 10 | 공란(Default) |
+| CRCY_CD | 통화코드 | string | Y | 3 | %%% : 전체<br>TUS: TOT_USD  / TKR: TOT_KRW<br>KRW: 한국  / USD: 미국<br>EUR: EUR   / HKD: 홍콩<br>CNY: 중국  / JPY: 일본<br>VND: 베트남 |
+| FM_ITEM_FTNG_YN | FM종목합산여부 | string | Y | 1 | "N"(Default) |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | %%: 전체 / 01 : 매도 / 02 : 매수 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 |  |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 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 | 응답상세2 | object | Y |  |  |
+| fm_tot_ccld_qty | FM총체결수량 | string | Y | 10 |  |
+| fm_tot_futr_agrm_amt | FM총선물약정금액 | string | Y | 20 |  |
+| fm_tot_opt_agrm_amt | FM총옵션약정금액 | string | Y | 20 |  |
+| fm_fee_smtl | FM수수료합계 | string | Y | 20 |  |
+| output1 | 응답상세1 | object array | Y |  | Array |
+| dt | 일자 | string | Y | 8 |  |
+| ccno | 체결번호 | string | Y | 8 |  |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | Y | 32 |  |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 3 |  |
+| fm_ccld_qty | FM체결수량 | string | Y | 10 |  |
+| fm_ccld_amt | FM체결금액 | string | Y | 20 |  |
+| fm_futr_ccld_amt | FM선물체결금액 | string | Y | 20 |  |
+| fm_opt_ccld_amt | FM옵션체결금액 | string | Y | 20 |  |
+| crcy_cd | 통화코드 | string | Y | 3 |  |
+| fm_fee | FM수수료 | string | Y | 20 |  |
+| fm_futr_pure_agrm_amt | FM선물순약정금액 | string | Y | 20 |  |
+| fm_opt_pure_agrm_amt | FM옵션순약정금액 | string | Y | 20 |  |
+| ccld_dtl_dtime | 체결상세일시 | string | Y | 17 |  |
+| ord_dt | 주문일자 | string | Y | 8 |  |
+| odno | 주문번호 | string | Y | 8 | 접수한 주문의 일련번호(ex. 00360686) |
+| ord_mdia_dvsn_name | 주문매체구분명 | string | Y | 60 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"CANO":"80012345",
+	"ACNT_PRDT_CD":"08",
+	"STRT_DT":"20221010",
+	"END_DT":"20221216",
+	"FUOP_DVSN":"00",
+	"FM_PDGR_CD":"",
+	"CRCY_CD":"%%%",
+	"FM_ITEM_FTNG_YN":"N",
+	"SLL_BUY_DVSN_CD":"%%",
+	"CTX_AREA_FK100":"",
+	"CTX_AREA_NK100":"",
+}
+```
+
+### Response Example
+
+```text
+{
+    "ctx_area_fk200": "80012345^08^20221010^20221216^00^^%%%^N^%%^                                                                                                                                                             ",
+    "ctx_area_nk200": "                                                                                                                                                                                                        ",
+    "output1": [
+        {
+            "dt": "20221020",
+            "ccno": "00004090",
+            "ovrs_futr_fx_pdno": "6AZ22",
+            "sll_buy_dvsn_cd": "02",
+            "fm_ccld_qty": "1",
+            "fm_ccld_amt": ".62955",
+            "fm_futr_ccld_amt": "62955",
+            "fm_opt_ccld_amt": "0",
+            "crcy_cd": "USD",
+            "fm_fee": "12.5",
+            "fm_futr_pure_agrm_amt": "62967.5",
+            "fm_opt_pure_agrm_amt": "0",
+            "ccld_dtl_dtime": "20221020132204282",
+            "ord_dt": "20221020",
+            "odno": "00284471",
+            "ord_mdia_dvsn_name": "일반"
+        },
+        {
+            "dt": "20221020",
+            "ccno": "00004089",
+            "ovrs_futr_fx_pdno": "6AZ22",
+            "sll_buy_dvsn_cd": "02",
+            "fm_ccld_qty": "1",
+            "fm_ccld_amt": ".62945",
+            "fm_futr_ccld_amt": "62945",
+            "fm_opt_ccld_amt": "0",
+            "crcy_cd": "USD",
+            "fm_fee": "12.5",
+            "fm_futr_pure_agrm_amt": "62957.5",
+            "fm_opt_pure_agrm_amt": "0",
+            "ccld_dtl_dtime": "20221020125948252",
+            "ord_dt": "20221020",
+            "odno": "00284466",
+            "ord_mdia_dvsn_name": "일반"
+        }
+    ],
+    "output2": {
+        "fm_tot_ccld_qty": "2",
+        "fm_tot_futr_agrm_amt": "125900",
+        "fm_tot_opt_agrm_amt": "0",
+        "fm_fee_smtl": "25"
+    },
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+    "msg1": "조회가 완료되었습니다                                                           "
+}
+```
@@ -0,0 +1,140 @@
+# 해외선물옵션 예수금현황
+
+- 원본 시트명: 해외선물옵션 예수금현황
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-012
+- HTTP Method: GET
+- 실전 TR_ID: OTFM1411R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM1411R |
+| 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자리 |
+| CRCY_CD | 통화코드 | string | Y | 3 | TUS: TOT_USD  / TKR: TOT_KRW<br>KRW: 한국  / USD: 미국<br>EUR: EUR   / HKD: 홍콩<br>CNY: 중국  / JPY: 일본<br>VND: 베트남 |
+| INQR_DT | 조회일자 | string | Y | 8 |  |
+
+### 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 | 응답상세1 | object | Y |  |  |
+| fm_nxdy_dncl_amt | FM익일예수금액 | string | Y | 20 |  |
+| fm_tot_asst_evlu_amt | FM총자산평가금액 | string | Y | 20 |  |
+| cano | 종합계좌번호 | string | Y | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 |  |
+| crcy_cd | 통화코드 | string | Y | 3 |  |
+| resp_dt | 응답일자 | string | Y | 8 |  |
+| fm_dnca_rmnd | FM예수금잔액 | string | Y | 20 |  |
+| fm_lqd_pfls_amt | FM청산손익금액 | string | Y | 20 |  |
+| fm_fee | FM수수료 | string | Y | 20 |  |
+| fm_fuop_evlu_pfls_amt | FM선물옵션평가손익금액 | string | Y | 20 |  |
+| fm_rcvb_amt | FM미수금액 | string | Y | 20 |  |
+| fm_brkg_mgn_amt | FM위탁증거금액 | string | Y | 20 |  |
+| fm_mntn_mgn_amt | FM유지증거금액 | string | Y | 20 |  |
+| fm_add_mgn_amt | FM추가증거금액 | string | Y | 20 |  |
+| fm_risk_rt | FM위험율 | string | Y | 10 |  |
+| fm_ord_psbl_amt | FM주문가능금액 | string | Y | 20 |  |
+| fm_drwg_psbl_amt | FM출금가능금액 | string | Y | 20 |  |
+| fm_echm_rqrm_amt | FM환전요청금액 | string | Y | 20 |  |
+| fm_drwg_prar_amt | FM출금예정금액 | string | Y | 20 |  |
+| fm_opt_tr_chgs | FM옵션거래대금 | string | Y | 20 |  |
+| fm_opt_icld_asst_evlu_amt | FM옵션포함자산평가금액 | string | Y | 20 |  |
+| fm_opt_evlu_amt | FM옵션평가금액 | string | Y | 20 |  |
+| fm_crcy_sbst_amt | FM통화대용금액 | string | Y | 20 |  |
+| fm_crcy_sbst_use_amt | FM통화대용사용금액 | string | Y | 20 |  |
+| fm_crcy_sbst_stup_amt | FM통화대용설정금액 | string | Y | 20 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"CANO":"80012345",
+	"ACNT_PRDT_CD":"08",
+	"CRCY_CD":":"KRW",
+	"INQR_DT":"20221214"
+}
+```
+
+### Response Example
+
+```text
+{
+    "output": {
+        "cano": "81012345",
+        "acnt_prdt_cd": "08",
+        "crcy_cd": "KRW",
+        "resp_dt": "20230104",
+        "fm_dnca_rmnd": "9990000012",
+        "fm_lqd_pfls_amt": "0",
+        "fm_fee": "0",
+        "fm_nxdy_dncl_amt": "9990000012",
+        "fm_tot_asst_evlu_amt": "9990000012",
+        "fm_fuop_evlu_pfls_amt": "0",
+        "fm_rcvb_amt": "0",
+        "fm_brkg_mgn_amt": "0",
+        "fm_mntn_mgn_amt": "0",
+        "fm_add_mgn_amt": "0",
+        "fm_risk_rt": "0.00",
+        "fm_ord_psbl_amt": "9718323936",
+        "fm_drwg_psbl_amt": "9704739489",
+        "fm_echm_rqrm_amt": "0",
+        "fm_drwg_prar_amt": "0",
+        "fm_opt_tr_chgs": "0",
+        "fm_opt_icld_asst_evlu_amt": "9990000012",
+        "fm_opt_evlu_amt": "0",
+        "fm_crcy_sbst_amt": "0",
+        "fm_crcy_sbst_use_amt": "0",
+        "fm_crcy_sbst_stup_amt": "0"
+    },
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+    "msg1": "조회가 완료되었습니다                                                           "
+}
+```
@@ -0,0 +1,390 @@
+# 해외선물옵션 일별 주문내역
+
+- 원본 시트명: 해외선물옵션 일별 주문내역
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-013
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3120R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-daily-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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3120R |
+| 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_DT | 시작일자 | string | Y | 8 |  |
+| END_DT | 종료일자 | string | Y | 8 |  |
+| FM_PDGR_CD | FM상품군코드 | string | Y | 10 |  |
+| CCLD_NCCS_DVSN | 체결미체결구분 | string | Y | 2 | 01:전체 / 02:체결 / 03:미체결 |
+| SLL_BUY_DVSN_CD | 매도매수구분코드 | string | Y | 2 | %%전체 / 01 : 매도 / 02 : 매수 |
+| FUOP_DVSN | 선물옵션구분 | string | Y | 2 | 00:전체 / 01:선물 / 02:옵션 |
+| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 |  |
+| CTX_AREA_NK200 | 연속조회키200 | string | Y | 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 |  |
+| output | 응답상세1 | object array | Y |  | Array |
+| cano | 종합계좌번호 | string | Y | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 |  |
+| dt | 일자 | string | Y | 8 |  |
+| ord_dt | 주문일자 | string | Y | 8 |  |
+| odno | 주문번호 | string | Y | 8 | 접수한 주문의 일련번호(ex. 00360686)<br>* 정정/취소시 문자열처럼 "0"을 포함해서 전송 <br>  (ex. ORGN_ODNO : 00360686)<br>* 정정/취소시 문자열처럼 "0"을 포함해서 전송 <br>  (ex. ORGN_ODNO : 00360686) |
+| orgn_ord_dt | 원주문일자 | string | Y | 8 |  |
+| orgn_odno | 원주문번호 | string | Y | 8 | 원주문번호(ex. 00360685) |
+| ovrs_futr_fx_pdno | 해외선물FX상품번호 | string | Y | 32 |  |
+| rvse_cncl_dvsn_cd | 정정취소구분코드 | string | Y | 2 | 청산체결이 없는 신규	00<br>청산체결이 없는 정정	01<br>청산체결이 없는 취소	02<br>청산체결이 있는 취소	02<br>청산체결이 있는 신규	03<br>청산체결이 있는 정정	04<br>행사	05<br>배정	06<br>소멸	07<br>만기	08 |
+| sll_buy_dvsn_cd | 매도매수구분코드 | string | Y | 2 |  |
+| cplx_ord_dvsn_cd | 복합주문구분코드 | string | Y | 1 |  |
+| pric_dvsn_cd | 가격구분코드 | string | Y | 1 |  |
+| rcit_dvsn_cd | 접수구분코드 | string | Y | 2 |  |
+| fm_ord_qty | FM주문수량 | string | Y | 10 |  |
+| fm_ord_pric | FM주문가격 | string | Y | 20 |  |
+| fm_stop_ord_pric | FMSTOP주문가격 | string | Y | 20 |  |
+| ecis_rsvn_ord_yn | 행사예약주문여부 | string | Y | 1 |  |
+| fm_ccld_qty | FM체결수량 | string | Y | 10 |  |
+| fm_ccld_pric | FM체결가격 | string | Y | 20 |  |
+| fm_ord_rmn_qty | FM주문잔여수량 | string | Y | 10 |  |
+| ord_grp_name | 주문그룹명 | string | Y | 60 |  |
+| rcit_dtl_dtime | 접수상세일시 | string | Y | 17 |  |
+| ccld_dtl_dtime | 체결상세일시 | string | Y | 17 |  |
+| ordr_emp_no | 주문자사원번호 | string | Y | 6 |  |
+| rjct_rson_name | 거부사유명 | string | Y | 60 |  |
+| ccld_cndt_cd | 체결조건코드 | string | Y | 1 |  |
+| trad_end_dt | 매매종료일자 | string | Y | 8 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"CANO":"12345678",
+	"ACNT_PRDT_CD":"08",
+	"STRT_DT":"20220101",
+	"END_DT":"20221214",
+	"FM_PDGR_CD":"",
+	"CCLD_NCCS_DVSN":"01",
+	"SLL_BUY_DVSN_CD":"%%",
+	"FUOP_DVSN":"00",
+	"CTX_AREA_FK200":"",
+	"CTX_AREA_NK200":"",
+}
+```
+
+### Response Example
+
+```text
+{
+    "ctx_area_fk200": "12345678^08^20231206^20231206^^01^%%^00^                                                                                                                                                                ",
+    "ctx_area_nk200": "                                                                                                                                                                                                        ",
+    "output": [
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362398",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6CZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "2",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "3",
+            "fm_ord_pric": "0.00000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "3",
+            "fm_ccld_pric": "0.73935",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206092306005",
+            "ccld_dtl_dtime": "20231206092306005",
+            "ordr_emp_no": "109171",
+            "rjct_rson_name": "",
+            "ccld_cndt_cd": "2",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362397",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6CZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "2",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "0.00000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "1",
+            "fm_ccld_pric": "0.73925",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206092247252",
+            "ccld_dtl_dtime": "20231206092247252",
+            "ordr_emp_no": "109171",
+            "rjct_rson_name": "",
+            "ccld_cndt_cd": "2",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362396",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6CZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "2",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "0.00000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "1",
+            "fm_ccld_pric": "0.73920",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206092123893",
+            "ccld_dtl_dtime": "20231206092123893",
+            "ordr_emp_no": "109171",
+            "rjct_rson_name": "",
+            "ccld_cndt_cd": "2",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362395",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6CZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "2",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "0.00000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "1",
+            "fm_ccld_pric": "0.73915",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206092039261",
+            "ccld_dtl_dtime": "20231206092039261",
+            "ordr_emp_no": "109171",
+            "rjct_rson_name": "",
+            "ccld_cndt_cd": "2",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362394",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "10YZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "2",
+            "rcit_dvsn_cd": "03",
+            "fm_ord_qty": "1",
+            "fm_ord_pric": "0.000",
+            "fm_stop_ord_pric": "0.000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.000",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "",
+            "ccld_dtl_dtime": "",
+            "ordr_emp_no": "109171",
+            "rjct_rson_name": "[정상적인거부]Text[Order price is outside bands 'Bid of 4269",
+            "ccld_cndt_cd": "2",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362393",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6AZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "1",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "2",
+            "fm_ord_pric": "0.65000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.00000",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206091838237",
+            "ccld_dtl_dtime": "",
+            "ordr_emp_no": "45TesT",
+            "rjct_rson_name": "FCM 거부됨",
+            "ccld_cndt_cd": "6",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362392",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6AZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "1",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "2",
+            "fm_ord_pric": "0.65000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.00000",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206091835180",
+            "ccld_dtl_dtime": "",
+            "ordr_emp_no": "45TesT",
+            "rjct_rson_name": "FCM 거부됨",
+            "ccld_cndt_cd": "6",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362391",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6AZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "1",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "2",
+            "fm_ord_pric": "0.65000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.00000",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206083023955",
+            "ccld_dtl_dtime": "",
+            "ordr_emp_no": "45TesT",
+            "rjct_rson_name": "FCM 거부됨",
+            "ccld_cndt_cd": "6",
+            "trad_end_dt": ""
+        },
+        {
+            "cano": "12345678",
+            "acnt_prdt_cd": "08",
+            "dt": "20231206",
+            "ord_dt": "20231206",
+            "odno": "00362390",
+            "orgn_ord_dt": "",
+            "orgn_odno": "",
+            "ovrs_futr_fx_pdno": "6AZ23",
+            "rvse_cncl_dvsn_cd": "00",
+            "sll_buy_dvsn_cd": "02",
+            "cplx_ord_dvsn_cd": "0",
+            "pric_dvsn_cd": "1",
+            "rcit_dvsn_cd": "02",
+            "fm_ord_qty": "2",
+            "fm_ord_pric": "0.65000",
+            "fm_stop_ord_pric": "0.00000",
+            "ecis_rsvn_ord_yn": "N",
+            "fm_ccld_qty": "0",
+            "fm_ccld_pric": "0.00000",
+            "fm_ord_rmn_qty": "0",
+            "ord_grp_name": "",
+            "rcit_dtl_dtime": "20231206082401404",
+            "ccld_dtl_dtime": "",
+            "ordr_emp_no": "45TesT",
+            "rjct_rson_name": "FCM 거부됨",
+            "ccld_cndt_cd": "6",
+            "trad_end_dt": ""
+        }
+    ],
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+```
@@ -0,0 +1,118 @@
+# 해외선물옵션 기간계좌거래내역
+
+- 원본 시트명: 해외선물옵션 기간계좌거래내역
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-014
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3114R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 모의투자 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/inquire-period-trans
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈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 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
+| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
+| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
+| tr_id | 거래ID | string | Y | 13 | OTFM3114R |
+| 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 |
+| --- | --- | --- | --- | --- | --- |
+| INQR_TERM_FROM_DT | 조회기간FROM일자 | string | Y | 8 |  |
+| INQR_TERM_TO_DT | 조회기간TO일자 | string | Y | 8 |  |
+| CANO | 종합계좌번호 | string | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
+| ACNT_PRDT_CD | 계좌상품코드 | string | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
+| ACNT_TR_TYPE_CD | 계좌거래유형코드 | string | Y | 2 | 1: 전체, 2:입출금 , 3: 결제 |
+| CRCY_CD | 통화코드 | string | Y | 3 | '%%% : 전체<br>TUS: TOT_USD  / TKR: TOT_KRW<br>KRW: 한국  / USD: 미국<br>EUR: EUR   / HKD: 홍콩<br>CNY: 중국  / JPY: 일본<br>VND: 베트남  ' |
+| CTX_AREA_FK100 | 연속조회검색조건100 | string | Y | 100 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_FK100값 : 다음페이지 조회시(2번째부터) |
+| CTX_AREA_NK100 | 연속조회키100 | string | Y | 100 | 공란 : 최초 조회시<br>이전 조회 Output CTX_AREA_NK100값 : 다음페이지 조회시(2번째부터) |
+| PWD_CHK_YN | 비밀번호체크여부 | string | Y | 1 | 공란(Default) |
+
+### 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 array | Y |  | Array |
+| bass_dt | 기준일자 | string | Y | 8 |  |
+| cano | 종합계좌번호 | string | Y | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 |  |
+| fm_ldgr_inog_seq | FM원장출납순번 | string | Y | 10 |  |
+| acnt_tr_type_name | 계좌거래유형명 | string | Y | 60 |  |
+| crcy_cd | 통화코드 | string | Y | 3 |  |
+| tr_itm_name | 거래항목명 | string | Y | 60 |  |
+| fm_iofw_amt | FM입출금액 | string | Y | 20 |  |
+| fm_fee | FM수수료 | string | Y | 20 |  |
+| fm_tax_amt | FM세금금액 | string | Y | 20 |  |
+| fm_sttl_amt | FM결제금액 | string | Y | 20 |  |
+| fm_bf_dncl_amt | FM이전예수금액 | string | Y | 20 |  |
+| fm_dncl_amt | FM예수금액 | string | Y | 20 |  |
+| fm_rcvb_occr_amt | FM미수발생금액 | string | Y | 20 |  |
+| fm_rcvb_pybk_amt | FM미수변제금액 | string | Y | 20 |  |
+| ovdu_int_pybk_amt | 연체이자변제금액 | string | Y | 20 |  |
+| rmks_text | 비고내용 | string | Y | 500 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+{
+	"INQR_TERM_FROM_DT":"20220101",
+	"INQR_TERM_TO_DT":"20221214",
+	"CANO":"80012345",
+	"ACNT_PRDT_CD":"08",
+	"ACNT_TR_TYPE_CD":"%%",
+	"CRCY_CD":"%%%",
+	"CTX_AREA_FK100":"",
+	"CTX_AREA_NK100":"",
+	"PWD_CHK_YN":""
+}
+```
+
+### Response Example
+
+```text
+{
+    "ctx_area_fk100": "20220101^20221214^81012345^08^%%^%%%^                                                               ",
+    "ctx_area_nk100": "                                                                                                    ",
+    "output": [],
+    "rt_cd": "0",
+    "msg_cd": "KIOK0560",
+    "msg1": "조회할 내용이 없습니다                                                          "
+}
+```
@@ -0,0 +1,215 @@
+# 해외선물옵션 증거금상세
+
+- 원본 시트명: 해외선물옵션 증거금상세
+- API 통신방식: REST
+- 메뉴 위치: [해외선물옵션] 주문/계좌
+- API ID: 해외선물-032
+- HTTP Method: GET
+- 실전 TR_ID: OTFM3115R
+- 모의 TR_ID: 모의투자 미지원
+- 실전 Domain: https://openapi.koreainvestment.com:9443
+- 모의 Domain: 미지원
+- URL 명: /uapi/overseas-futureoption/v1/trading/margin-detail
+- 모의투자 지원: 미지원
+- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
+
+## 개요
+
+해외선물옵션 증거금상세 API입니다.
+한국투자 HTS(eFriend Plus) &gt; [2711] 해외선물옵션 증거금상세 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
+
+[증거금 상세설명]
+- SPAN, EUREX 증거금
+1. 가격변동증거금 : 보유하고 있는 미결제를 Product Class 별로 구간[SPAN-16구간, EUREX-29구간)손익 합계액 산출하며 최대손실구간의 금액을 해당 Class의 증거금으로 산정
+2. 스프레드증거금 : 보유하고 있는 미결제를 Product Class 별로 스프레드 산정하며 스프레드 증거금 적용
+** 스프레드 산정방법 : SPAN은 선물+옵션의 Delta Spread로 계산, EUREX는 선물의 Spread만 산정 보유중인 옵선가치를 평가하며 청산가치가 양수(고객미 수취할 금액이 있는 경우)에 해당하는 금액을 증거금에서 할인
+3. 옵션가격증거금 : 보유중인 옵션가치를 평가하여 청산가치가 양수(고객이 수취할 금액이 있는 경우)에 해당하는 금액을 증거금에서 할인
+**계산식 : MAXID, 온선평가대금 Class별 합계액) ** 산출된 값을 음수처리함 옵션 미결제약정에 대해 최소로 징구하는 증거금
+4. 옵선최소증거금 증거금 : 옵션 미결제약정에 대해 최소로 징구하는 증거금
+** SPAN : 매도옵선회소증거금(행사가별로 상미)과 매수옵선최소증거금(계약당 1Tick에 해당하는 금액)
+** EUREX : 매수옵선최소증거금(계약당 1Tick에 해당하는 금액)(EUREX는 매도옵션최소증거금이 가격변동증거금에 포함되어 있음)
+5. 일방해소증거금 : (기본개념)보유중인 포트폴리오 중에서 머느 일방향을 전량 청산했을 경우 잔존하는 미결제 약정의 최대손실가능액을 사전에 징구함
+가격상승포지션과 가격하락포지션에 대해 최불리증거금을 각각 산정하며 큰 금액을 증거금으로 장구
+* 가격장승포지션 : 선물매수포지션, 풋옵션매도포지션
+* 가격하락포지션 : 선물매도포지션, 콜옵션매도포지선
+
+- 일반 증거금
+1. 선물미결제증거금 : 선물미결제약정에 대해 계약당증거금율 적용
+2. 매도옵션미결제증거금 : 매도옵션미결제약정에 대해 옵선계약당 증거금을 적용
+** 옵션계약당증거금 : 각 종목별 최불리증거금액으로 해외 거래소에서 계산하며 제공되는 데이터임
+3. 매수옵션미결제증거금 : 매수옵션최소증거금으로 1Tick에 해당하는 금액을 적용
+
+- 주문 증거금
+1. 선물 주문증거금 : 선물 미체결주문에 대해 계약당 증거금을 적용(신규주문에 한해 징수)
+2. 매도옵션 주문증거금 : 옵션매도 미체결주문에 대해 계약당증거금을 적용(신규주문에 한해 징수)
+3. 매수옵션 주문증거금 : 옵션매수 미체결주문에 대해 최소증거금(Tick Value와 10 중에서 큰 금액)과 만기행사예약한 미체결주문에 대한 행사예약증거금을 징수
+4. 매수옵션 주문대금 : 옵션매수 미체결주문의 매수대금(주문가격을 기준으로 대금 산정, 시장가주문시 현재가 +50틱으로 매수대금 산정)
+5. 매수옵선행사예약증거금 : 옵선매수 미결제약정 중에서 행사예약한 수량에 대해 기초자산선물의 계약당 증거금을 징수
+
+## 레이아웃
+
+### 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 | OTFM3115R |
+| 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 |  |
+| CRCY_CD | 통화코드 | string | Y | 3 | 'TKR(TOT_KRW), TUS(TOT_USD), <br>USD(미국달러), HKD(홍콩달러),<br>CNY(중국위안화), JPY )일본엔화), VND(베트남동)' |
+| INQR_DT | 조회일자 | string | Y | 8 |  |
+
+### 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 | 응답상세 | object | Y |  |  |
+| cano | 종합계좌번호 | string | Y | 8 |  |
+| acnt_prdt_cd | 계좌상품코드 | string | Y | 2 |  |
+| crcy_cd | 통화코드 | string | Y | 3 |  |
+| resp_dt | 응답일자 | string | Y | 8 |  |
+| acnt_net_risk_mgna_aply_yn | 계좌순위험증거금적용여부 | string | Y | 1 |  |
+| fm_ord_psbl_amt | FM주문가능금액 | string | Y | 20 |  |
+| fm_add_mgn_amt | FM추가증거금액 | string | Y | 20 |  |
+| fm_brkg_mgn_amt | FM위탁증거금액 | string | Y | 20 |  |
+| fm_excc_brkg_mgn_amt | FM정산위탁증거금액 | string | Y | 20 |  |
+| fm_ustl_mgn_amt | FM미결제증거금액 | string | Y | 20 |  |
+| fm_mntn_mgn_amt | FM유지증거금액 | string | Y | 20 |  |
+| fm_ord_mgn_amt | FM주문증거금액 | string | Y | 20 |  |
+| fm_futr_ord_mgn_amt | FM선물주문증거금액 | string | Y | 20 |  |
+| fm_opt_buy_ord_amt | FM옵션매수주문금액 | string | Y | 20 |  |
+| fm_opt_sll_ord_mgn_amt | FM옵션매도주문증거금액 | string | Y | 20 |  |
+| fm_opt_buy_ord_mgn_amt | FM옵션매수주문증거금액 | string | Y | 20 |  |
+| fm_ecis_rsvn_mgn_amt | FM행사예약증거금액 | string | Y | 20 |  |
+| fm_span_brkg_mgn_amt | FMSPAN위탁증거금액 | string | Y | 20 |  |
+| fm_span_pric_altr_mgn_amt | FMSPAN가격변동증거금액 | string | Y | 20 |  |
+| fm_span_term_sprd_mgn_amt | FMSPAN기간스프레드증거금액 | string | Y | 20 |  |
+| fm_span_buy_opt_min_mgn_amt | FMSPAN옵션가격증거금액 | string | Y | 20 |  |
+| fm_span_opt_min_mgn_amt | FMSPAN옵션최소증거금액 | string | Y | 20 |  |
+| fm_span_tot_risk_mgn_amt | FMSPAN총위험증거금액 | string | Y | 20 |  |
+| fm_span_mntn_mgn_amt | FMSPAN유지증거금액 | string | Y | 20 |  |
+| fm_span_mntn_pric_altr_mgn_amt | FMSPAN유지가격변동증거금액 | string | Y | 20 |  |
+| fm_span_mntn_term_sprd_mgn_amt | FMSPAN유지기간스프레드증거금액 | string | Y | 20 |  |
+| fm_span_mntn_opt_pric_mgn_amt | FMSPAN유지옵션가격증거금액 | string | Y | 20 |  |
+| fm_span_mntn_opt_min_mgn_amt | FMSPAN유지옵션최소증거금액 | string | Y | 20 |  |
+| fm_span_mntn_tot_risk_mgn_amt | FMSPAN유지총위험증거금액 | string | Y | 20 |  |
+| fm_eurx_brkg_mgn_amt | FMEUREX위탁증거금액 | string | Y | 20 |  |
+| fm_eurx_pric_altr_mgn_amt | FMEUREX가격변동증거금액 | string | Y | 20 |  |
+| fm_eurx_term_sprd_mgn_amt | FMEUREX기간스프레드증거금액 | string | Y | 20 |  |
+| fm_eurx_opt_pric_mgn_amt | FMEUREX옵션가격증거금액 | string | Y | 20 |  |
+| fm_eurx_buy_opt_min_mgn_amt | FMEUREX매수옵션최소증거금액 | string | Y | 20 |  |
+| fm_eurx_tot_risk_mgn_amt | FMEUREX총위험증거금액 | string | Y | 20 |  |
+| fm_eurx_mntn_mgn_amt | FMEUREX유지증거금액 | string | Y | 20 |  |
+| fm_eurx_mntn_pric_altr_mgn_amt | FMEUREX유지가격변동증거금액 | string | Y | 20 |  |
+| fm_eurx_mntn_term_sprd_mgn_amt | FMEUREX기간스프레드증거금액 | string | Y | 20 |  |
+| fm_eurx_mntn_opt_pric_mgn_amt | FMEUREX유지옵션가격증거금액 | string | Y | 20 |  |
+| fm_eurx_mntn_tot_risk_mgn_amt | FMEUREX유지총위험증거금액 | string | Y | 20 |  |
+| fm_gnrl_brkg_mgn_amt | FM일반위탁증거금액 | string | Y | 20 |  |
+| fm_futr_ustl_mgn_amt | FM선물미결제증거금액 | string | Y | 20 |  |
+| fm_sll_opt_ustl_mgn_amt | FM매도옵션미결제증거금액 | string | Y | 20 |  |
+| fm_buy_opt_ustl_mgn_amt | FM매수옵션미결제증거금액 | string | Y | 20 |  |
+| fm_sprd_ustl_mgn_amt | FM스프레드미결제증거금액 | string | Y | 20 |  |
+| fm_avg_dsct_mgn_amt | FMAVG할인증거금액 | string | Y | 20 |  |
+| fm_gnrl_mntn_mgn_amt | FM일반유지증거금액 | string | Y | 20 |  |
+| fm_futr_mntn_mgn_amt | FM선물유지증거금액 | string | Y | 20 |  |
+| fm_opt_mntn_mgn_amt | FM옵션유지증거금액 | string | Y | 20 |  |
+
+## 예제
+
+### Request Example (Python)
+
+```text
+CANO:12345678
+ACNT_PRDT_CD:08
+CRCY_CD:TKR
+INQR_DT:20240522
+```
+
+### Response Example
+
+```text
+{
+    "output": {
+        "cano": "12345678",
+        "acnt_prdt_cd": "08",
+        "crcy_cd": "TKR",
+        "resp_dt": "20240522",
+        "acnt_net_risk_mgna_aply_yn": "Y",
+        "fm_ord_psbl_amt": "86128052",
+        "fm_add_mgn_amt": "0",
+        "fm_brkg_mgn_amt": "49082990",
+        "fm_excc_brkg_mgn_amt": "49082990",
+        "fm_ustl_mgn_amt": "49082990",
+        "fm_mntn_mgn_amt": "44620900",
+        "fm_ord_mgn_amt": "0",
+        "fm_futr_ord_mgn_amt": "0",
+        "fm_opt_buy_ord_amt": "0",
+        "fm_opt_sll_ord_mgn_amt": "0",
+        "fm_opt_buy_ord_mgn_amt": "0",
+        "fm_ecis_rsvn_mgn_amt": "0",
+        "fm_span_brkg_mgn_amt": "49082990",
+        "fm_span_pric_altr_mgn_amt": "49082990",
+        "fm_span_term_sprd_mgn_amt": "0",
+        "fm_span_buy_opt_min_mgn_amt": "0",
+        "fm_span_opt_min_mgn_amt": "0",
+        "fm_span_tot_risk_mgn_amt": "49082990",
+        "fm_span_mntn_mgn_amt": "44620900",
+        "fm_span_mntn_pric_altr_mgn_amt": "44620900",
+        "fm_span_mntn_term_sprd_mgn_amt": "0",
+        "fm_span_mntn_opt_pric_mgn_amt": "0",
+        "fm_span_mntn_opt_min_mgn_amt": "0",
+        "fm_span_mntn_tot_risk_mgn_amt": "44620900",
+        "fm_eurx_brkg_mgn_amt": "0",
+        "fm_eurx_pric_altr_mgn_amt": "0",
+        "fm_eurx_term_sprd_mgn_amt": "0",
+        "fm_eurx_opt_pric_mgn_amt": "0",
+        "fm_eurx_buy_opt_min_mgn_amt": "0",
+        "fm_eurx_tot_risk_mgn_amt": "0",
+        "fm_eurx_mntn_mgn_amt": "0",
+        "fm_eurx_mntn_pric_altr_mgn_amt": "0",
+        "fm_eurx_mntn_term_sprd_mgn_amt": "0",
+        "fm_eurx_mntn_opt_pric_mgn_amt": "0",
+        "fm_eurx_mntn_tot_risk_mgn_amt": "0",
+        "fm_gnrl_brkg_mgn_amt": "0",
+        "fm_futr_ustl_mgn_amt": "0",
+        "fm_sll_opt_ustl_mgn_amt": "0",
+        "fm_buy_opt_ustl_mgn_amt": "0",
+        "fm_sprd_ustl_mgn_amt": "0",
+        "fm_avg_dsct_mgn_amt": "0",
+        "fm_gnrl_mntn_mgn_amt": "0",
+        "fm_futr_mntn_mgn_amt": "0",
+        "fm_opt_mntn_mgn_amt": "0"
+    },
+    "rt_cd": "0",
+    "msg_cd": "KIOK0510",
+    "msg1": "조회가 완료되었습니다                                                           "
+}
+```