{ "openapi": "3.0.3", "info": { "title": "NH투자증권 Open API — 해외파생 (Global Derivatives)", "version": "v1", "description": "NH투자증권 Open API 중 **해외파생 (Global Derivatives)** 자산군의 REST 및 실시간(WebSocket) API 문서입니다. (기준: API명세서 260730 / 나무 환경 · 필드명은 명세서 C열 기준)\n\n- REST: POST + JSON, 요청 Input_0 / 응답 Output_0(+Output_1·Output_2 …) + message. 응답 블록의 타입은 API 마다 다릅니다(객체=집계 / 배열=목록). 블록은 데이터가 있을 때만 내려옵니다.\n- 실시간: WebSocket, 푸시=JSON. x-realtime-channels.protocol 참조.\n- 📄 종목마스터: 전 종목 목록·종목명 조회 REST API 는 없습니다. 정적 종목정보는 https://www.nhplug.com/instruments/<파일명>.mst (CP949 고정길이, 인증 불필요). 상세는 x-instruments 참조.\n- 🏦 계좌 선택: /n2/acctinfo 의 acct_type 이 01(일반)·02(주문대리인) 이면 운영(api.nhplug.com:8443) 전용, 03 이면 모의투자(moapi.nhplug.com:8443) 전용 계좌입니다. 대상 환경과 맞는 계좌를 사용하세요.\n- 🔑 토큰 재사용: access token 은 24시간(expires_in=86400) 유효. 매 호출 재발급 금지 — 공유 캐시에 저장해 재사용(재발급은 보안 알림 유발). 재발급은 401 일 때만, 429 재시도엔 기존 토큰 사용.\n- 인증: POST /oauth2/token → REST 는 Authorization/x-client-id/x-client-secret, WS 는 header.token.\n- 환경 제공: 이 자산군 API 는 **모의투자·운영 모두 제공**. (접근토큰발급만 공통에서 운영 전용)" }, "servers": [ { "url": "https://api.nhplug.com:8443", "description": "🔴 운영 (Live) — 실제 주문 체결 [기본]" }, { "url": "https://moapi.nhplug.com:8443", "description": "🟢 모의투자 (Mock) — 교육이수·개발·검증" } ], "security": [ { "BearerAuth": [], "ClientId": [], "ClientSecret": [] } ], "x-environments": { "portal": "https://www.nhplug.com", "note": "기본 환경은 **운영(live)** 입니다. 운영은 주문이 실제로 체결됩니다. 테스트·검증은 모의투자(mock)를 사용하세요. 나무(Namuh) 기준(N2 추후).", "mock": { "desc": "모의투자 — 교육이수·개발검증", "rest": "https://moapi.nhplug.com:8443", "websocket": "wss://moapi.nhplug.com:17070" }, "live": { "desc": "운영 — 실제 주문 체결", "rest": "https://api.nhplug.com:8443", "websocket": "wss://api.nhplug.com:7080" } }, "tags": [ { "name": "주문 (Order)" }, { "name": "조회 (Inquiry)" }, { "name": "시세 (Market Data)" }, { "name": "실시간 (Realtime)" } ], "paths": { "/gbfuture/order/v1/buy": { "post": { "tags": [ "주문 (Order)" ], "operationId": "gbfutureOrderBuy", "summary": "해외선물옵션 주문", "description": "해외선물옵션 주문(매수/매도) API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "sll_byn_tp_cd": { "type": "string", "description": "매도매수유형코드 / 길이 1 / 1.매도 2.매수" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "fdv_orr_pr": { "type": "number", "format": "double", "description": "해외파생주문가격 / 길이 24.9" }, "fdv_stop_pr": { "type": "number", "format": "double", "description": "해외파생STOP가격 / 길이 24.9" }, "fdv_orr_dit_cd": { "type": "string", "description": "해외파생주문구분코드 / 길이 1 / 0.DAY 2.GTD" }, "fdv_orr_tp_cd": { "type": "string", "description": "해외파생주문유형코드 / 길이 1 / 1.시장가 2.지정가 3.스탑마켓 4.스탑리밋" }, "end_dt": { "type": "string", "description": "종료일자 / 길이 8 / YYYYMMDD" } }, "required": [ "act_no", "sll_byn_tp_cd", "iem_cd", "orr_qty", "fdv_orr_dit_cd", "fdv_orr_tp_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "amn_tab_cd": { "type": "string", "description": "관리팀점코드 / 길이 4" }, "fdv_orr_no": { "type": "integer", "format": "int64", "description": "해외파생주문번호 / 길이 18" }, "fdv_orr_pr": { "type": "number", "format": "double", "description": "해외파생주문가격 / 길이 24.9" }, "err_msg_cd": { "type": "string", "description": "오류메시지코드 / 길이 5" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/order/v1/modify": { "post": { "tags": [ "주문 (Order)" ], "operationId": "gbfutureOrderModify", "summary": "해외선물옵션 정정취소주문정정", "description": "해외선물옵션 정정주문 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "fdv_fr_orr_no": { "type": "integer", "format": "int64", "description": "해외파생원주문번호 / 길이 18" }, "fdv_orr_pr": { "type": "number", "format": "double", "description": "해외파생주문가격 / 길이 24.9" }, "fdv_stop_pr": { "type": "number", "format": "double", "description": "해외파생STOP가격 / 길이 24.9" }, "fdv_orr_tp_cd": { "type": "string", "description": "해외파생주문유형코드 / 길이 1 / 1.시장가 2.지정가 3.스탑마켓 4.스탑리밋" } }, "required": [ "act_no", "iem_cd", "fdv_fr_orr_no", "fdv_orr_tp_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "amn_tab_cd": { "type": "string", "description": "관리팀점코드 / 길이 4" }, "fdv_orr_no": { "type": "integer", "format": "int64", "description": "해외파생주문번호 / 길이 18" }, "fdv_orr_pr": { "type": "number", "format": "double", "description": "해외파생주문가격 / 길이 24.9" }, "err_msg_cd": { "type": "string", "description": "오류메시지코드 / 길이 5" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/order/v1/cancel": { "post": { "tags": [ "주문 (Order)" ], "operationId": "gbfutureOrderCancel", "summary": "해외선물옵션 정정취소주문취소", "description": "해외선물옵션 취소주문 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "fdv_fr_orr_no": { "type": "integer", "format": "int64", "description": "해외파생원주문번호 / 길이 18" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "fdv_orr_tp_cd": { "type": "string", "description": "해외파생주문유형코드 / 길이 1 / 1.시장가 2.지정가 3.스탑마켓 4.스탑리밋" } }, "required": [ "act_no", "fdv_fr_orr_no", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "amn_tab_cd": { "type": "string", "description": "관리팀점코드 / 길이 4" }, "fdv_orr_no": { "type": "integer", "format": "int64", "description": "해외파생주문번호 / 길이 18" }, "err_msg_cd": { "type": "string", "description": "오류메시지코드 / 길이 5" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/inquiry/v1/todayOrderHistory": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "gbfutureInquiryTodayOrderHistory", "summary": "해외선물옵션 주문체결조회", "description": "해외선물옵션 주문체결내역 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "sta_dt": { "type": "string", "description": "시작일자 / 길이 8 / YYYYMMDD" }, "end_dt": { "type": "string", "description": "종료일자 / 길이 8 / YYYYMMDD" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "cns_dit_cd": { "type": "string", "description": "체결구분코드 / 길이 1 / 0.전체 1.체결 2.미체결" }, "fdv_fno_dit_cd": { "type": "string", "description": "해외파생선물옵션구분코드 / 길이 1 / A.전체 F.선물 O.옵션 S.주식옵션" }, "sll_byn_tp_cd": { "type": "string", "description": "매도매수유형코드 / 길이 1 / 0.전체 1.매도 2.매수" }, "cur_cd": { "type": "string", "description": "통화코드 / 길이 3 / USD.달러 KRW.원화" }, "fdv_orr_no": { "type": "integer", "format": "int64", "description": "해외파생주문번호 / 길이 18" }, "iqr_bse": { "type": "string", "description": "조회기준 / 길이 1 / 1.주문기준 2.체결기준" }, "sot_dit": { "type": "string", "description": "정렬구분 / 길이 1 / 1.주문번호순 2.역순" }, "fdv_excg_cd": { "type": "string", "description": "해외파생거래소코드 / 길이 10 / .전체조회 CBOE.Chicago Board Options Exchange CME.Chicago Mercantile Exchange HKEX.Hong Kong Exchanges OPRA.OPRA" } }, "required": [ "act_no", "sta_dt", "end_dt" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "orr_dt": { "type": "string", "description": "주문일자 / 길이 8 / YYYYMMDD" }, "act_amn_tab_cd": { "type": "string", "description": "계좌관리팀점코드 / 길이 4" }, "act_amn_tab_cd_nm": { "type": "string", "description": "계좌관리팀점코드명 / 길이 40" }, "fdv_orr_no": { "type": "integer", "format": "int64", "description": "해외파생주문번호 / 길이 18" }, "fdv_fr_orr_no": { "type": "integer", "format": "int64", "description": "해외파생원주문번호 / 길이 18" }, "fdv_mo_orr_no": { "type": "integer", "format": "int64", "description": "해외파생모주문번호 / 길이 18" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "act_nm": { "type": "string", "description": "계좌명 / 길이 60" }, "fdv_cns_no": { "type": "integer", "format": "int64", "description": "해외파생체결번호 / 길이 18" }, "fdv_pdt_cd": { "type": "string", "description": "해외파생상품코드 / 길이 10" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "cur_cd": { "type": "string", "description": "통화코드 / 길이 3" }, "sll_byn_tp_cd": { "type": "string", "description": "매도매수유형코드 / 길이 1 / 1.매도 2.매수" }, "sll_byn_tp_nm": { "type": "string", "description": "매도매수유형명 / 길이 50" }, "fdv_orr_tp_cd": { "type": "string", "description": "해외파생주문유형코드 / 길이 1 / 1.시장가 2.지정가 3.스탑마켓 4.스탑리밋 5.MOC" }, "fdv_orr_tp_cd_nm": { "type": "string", "description": "해외파생주문유형코드명 / 길이 20" }, "fdv_orr_dit_cd": { "type": "string", "description": "해외파생주문구분코드 / 길이 1 / 0:DAY 1:GTC 2:GTD" }, "fdv_orr_dit_cd_nm": { "type": "string", "description": "해외파생주문구분코드명 / 길이 20" }, "nmn_pr_sts_dit_cd": { "type": "string", "description": "호가상태구분코드 / 길이 1 / 1:신규 2:정정 3:취소" }, "nmn_pr_sts_dit_cd_nm": { "type": "string", "description": "호가상태구분코드명 / 길이 20" }, "sgy_orr_dit_cd": { "type": "string", "description": "전략주문구분코드 / 길이 1 / 1:일반, \n2:OCO" }, "sgy_orr_dit_cd_nm": { "type": "string", "description": "전략주문구분코드명 / 길이 20" }, "fdv_orr_pcs_sts_cd": { "type": "string", "description": "해외파생주문처리상태코드 / 길이 1 / 0.접수전 1.정상접수 2.접수거부 3.처리완료" }, "fdv_orr_pcs_sts_cd_nm": { "type": "string", "description": "해외파생주문처리상태코드명 / 길이 20" }, "trd_orn_dit_cd": { "type": "string", "description": "거래발생구분코드 / 길이 2 / 00.일반 01.관리자주문 11.장중반대매매 12.추가증거금반대매매 13.FND반대매매 21.머니매니지먼트주문(취소및청산) 31.포지션이관 32.포지션수관 40.타임슬라이스 41.옵션조기행사 42.옵션조기배정 43.옵션만기행사 44.옵션만기배정 45.옵션소멸 46.선물만기 47.실물인수도 48.선물인수도 49.선물만기네팅 51.착오매매 61.주식옵션권리입고 62.주식옵션권리출고" }, "trd_orn_dit_cd_nm": { "type": "string", "description": "거래발생구분코드명 / 길이 40" }, "cuc_mdi_cd": { "type": "string", "description": "통신매체코드 / 길이 2" }, "cuc_mdi_cd_nm": { "type": "string", "description": "통신매체코드명 / 길이 50" }, "orr_mdi_dit_cd": { "type": "string", "description": "주문매체구분코드 / 길이 2" }, "orr_mdi_dit_cd_nm": { "type": "string", "description": "주문매체구분코드명 / 길이 50" }, "fdv_pr_idc_dit_cd": { "type": "string", "description": "해외파생가격표시구분코드 / 길이 1 / 0.1/1 1.1/10 2.1/100 3.1/1000 4.1/10000 5.1/100000 6.1/1000000 7.1/10000000 8.1/100000000 A.1/2 B.1/4 C.1/8 D.1/16 E.1/32 F.1/64 G.1/128 H.1/256 I.0.5/32 J.0.5/64 K.0.25/32 L.0.125/32" }, "fdv_orr_pr": { "type": "number", "format": "double", "description": "해외파생주문가격 / 길이 24.9" }, "fdv_orr_pr_idc_cts": { "type": "string", "description": "해외파생주문가격표시내용 / 길이 30" }, "fdv_stop_pr": { "type": "number", "format": "double", "description": "해외파생STOP가격 / 길이 24.9" }, "fdv_stop_pr_idc_cts": { "type": "string", "description": "해외파생STOP가격표시내용 / 길이 30" }, "fdv_cns_pr": { "type": "number", "format": "double", "description": "해외파생체결가격 / 길이 24.9" }, "fdv_cns_pr_idc_cts": { "type": "string", "description": "해외파생체결가격표시내용 / 길이 30" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "fdv_orr_amt": { "type": "number", "format": "double", "description": "해외파생주문금액 / 길이 24.9" }, "cns_qty": { "type": "integer", "format": "int64", "description": "체결수량 / 길이 18" }, "fdv_cns_amt": { "type": "number", "format": "double", "description": "해외파생체결금액 / 길이 21.3" }, "acl_cns_qty": { "type": "integer", "format": "int64", "description": "누적체결수량 / 길이 18" }, "fdv_cor_can_orr_qty": { "type": "integer", "format": "int64", "description": "해외파생정정취소주문수량 / 길이 18" }, "can_cfm_qty": { "type": "integer", "format": "int64", "description": "취소확인수량 / 길이 18" }, "rmn_orr_qty": { "type": "integer", "format": "int64", "description": "잔여주문수량 / 길이 18" }, "orr_vdt_dt": { "type": "string", "description": "주문유효일자 / 길이 8 / YYYYMMDD" }, "xrn_dt": { "type": "string", "description": "만기일자 / 길이 8 / YYYYMMDD" }, "org_orr_dt": { "type": "string", "description": "원주문일자 / 길이 8 / YYYYMMDD" }, "orr_pbl_yn": { "type": "string", "description": "주문가능여부 / 길이 1" }, "opt_sby_cst": { "type": "number", "format": "double", "description": "옵션매매대금 / 길이 21.3" }, "fdv_brg_fee": { "type": "number", "format": "double", "description": "해외파생위탁수수료 / 길이 21.3" }, "fdv_fcm_fee": { "type": "string", "description": "해외파생FCM수수료 / 길이 21.3" }, "fdv_tco_fee": { "type": "string", "description": "해외파생당사수수료 / 길이 21.3" }, "fcm_cd": { "type": "string", "description": "FCM코드 / 길이 10" }, "fdv_pcs_sts_cd": { "type": "string", "description": "해외파생처리상태코드 / 길이 1 / 0.정상 1.취소(오류)" }, "fdv_pcs_sts_cd_nm": { "type": "string", "description": "해외파생처리상태코드명 / 길이 20" }, "apm_lqd_dit_cd": { "type": "string", "description": "지정청산구분코드 / 길이 1 / 0.미해당 1.가격지정" }, "apm_lqd_dit_cd_nm": { "type": "string", "description": "지정청산구분코드명 / 길이 20" }, "apm_lqd_cns_pr": { "type": "number", "format": "double", "description": "지정청산체결가격 / 길이 24.9" }, "apm_lqd_cns_pr_idc_cts": { "type": "string", "description": "지정청산체결가격표시내용 / 길이 30" }, "twap_orr_sts_cd": { "type": "string", "description": "TWAP주문상태코드 / 길이 1 / 0.정상 1.종료" }, "twap_orr_sts_cd_nm": { "type": "string", "description": "TWAP주문상태코드명 / 길이 20" }, "twap_cns_dit_cd": { "type": "string", "description": "TWAP체결구분코드 / 길이 1" }, "twap_sta_dt": { "type": "string", "description": "TWAP시작일자 / 길이 8 / YYYYMMDD" }, "twap_sta_hur": { "type": "string", "description": "TWAP시작시간 / 길이 9" }, "twap_end_dt": { "type": "string", "description": "TWAP종료일자 / 길이 8 / YYYYMMDD" }, "twap_end_hur": { "type": "string", "description": "TWAP종료시간 / 길이 9" }, "twap_cns_rt": { "type": "number", "format": "double", "description": "TWAP체결비율 / 길이 24.9" }, "rjt_msg_cts": { "type": "string", "description": "거부메시지내용 / 길이 200" }, "rks": { "type": "string", "description": "비고 / 길이 100" }, "usr_ip_adr": { "type": "string", "description": "사용자IP주소 / 길이 32" }, "pcs_tab_cd": { "type": "string", "description": "처리팀점코드 / 길이 4" }, "pcs_tab_cd_nm": { "type": "string", "description": "처리팀점코드명 / 길이 50" }, "ode_id": { "type": "string", "description": "주문자ID / 길이 6" }, "orr_dtm": { "type": "string", "description": "주문일시 / 길이 20 / YYYYMMDDHHMMSS" }, "cns_dtm": { "type": "string", "description": "체결일시 / 길이 20 / YYYYMMDDHHMMSS" }, "fdv_excg_cd": { "type": "string", "description": "해외파생거래소코드 / 길이 10 / CBOE.Chicago Board Options Exchange CME.Chicago Mercantile Exchange HKEX.Hong Kong Exchanges OPRA.OPRA" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/gbfuture/inquiry/v1/orderable": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "gbfutureInquiryOrderable", "summary": "해외선물옵션 주문가능수량조회", "description": "해외선물옵션 주문가능수량/금액 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: `Output_0` 는 명세상 **Array** 로 선언되어 있으나 예시 응답은 **Object** 입니다. 실제 응답 타입을 확인 후 사용하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "sll_byn_tp_cd": { "type": "string", "description": "매도매수유형코드 / 길이 1 / 1.매도 2.매수" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "fdv_orr_pr": { "type": "number", "format": "double", "description": "해외파생주문가격 / 길이 24.9" }, "fdv_stop_pr": { "type": "number", "format": "double", "description": "해외파생STOP가격 / 길이 24.9" }, "fdv_orr_tp_cd": { "type": "string", "description": "해외파생주문유형코드 / 길이 1 / 1.시장가 2.지정가 3.스탑마켓 4.스탑리밋" }, "opt_byn_erc_bkg_yn": { "type": "string", "description": "옵션매수행사예약여부 / 길이 1" }, "bnc_pr": { "type": "number", "format": "double", "description": "잔고가격 / 길이 24.9" } }, "required": [ "act_no", "sll_byn_tp_cd", "iem_cd", "fdv_orr_tp_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "fdv_orr_pbl_qty": { "type": "integer", "format": "int64", "description": "해외파생주문가능수량 / 길이 18" }, "fdv_orr_pbl_amt": { "type": "number", "format": "double", "description": "해외파생주문가능금액 / 길이 21.3" }, "orr_pbl_qty": { "type": "integer", "format": "int64", "description": "주문가능수량 / 길이 10" }, "lqd_pbl_qty": { "type": "integer", "format": "int64", "description": "청산가능수량 / 길이 15" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ], "x-schema-warning": [ { "block": "Output_0", "declared": "Array", "sample": "Object" } ] } }, "/gbfuture/inquiry/v1/pnl": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "gbfutureInquiryPnl", "summary": "해외선물옵션 기간계좌손익 일별", "description": "해외선물옵션 기간 손익 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iqr_dit_cd": { "type": "string", "description": "조회구분코드 / 길이 2 / 10.종목별 20.상품별" }, "sta_dt": { "type": "string", "description": "시작일자 / 길이 8 / YYYYMMDD" }, "end_dt": { "type": "string", "description": "종료일자 / 길이 8 / YYYYMMDD" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "fdv_pdt_cd": { "type": "string", "description": "해외파생상품코드 / 길이 10" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "cur_cd": { "type": "string", "description": "통화코드 / 길이 3 / USD.달러 KRW.원화" }, "fdv_fno_dit_cd": { "type": "string", "description": "해외파생선물옵션구분코드 / 길이 1 / A.전체 F.선물 O.옵션 S.주식옵션" }, "sum_iqr_yn": { "type": "string", "description": "합계조회여부 / 길이 1" }, "fdv_excg_cd": { "type": "string", "description": "해외파생거래소코드 / 길이 10 / .전체조회 CBOE.Chicago Board Options Exchange CME.Chicago Mercantile Exchange HKEX.Hong Kong Exchanges OPRA.OPRA" } }, "required": [ "iqr_dit_cd", "sta_dt", "end_dt", "act_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "fdv_lqd_pls": { "type": "number", "format": "double", "description": "해외파생청산손익 / 길이 21.3" }, "fdv_eal_ind_amt": { "type": "number", "format": "double", "description": "해외파생평가증감금액 / 길이 21.3" }, "fdv_fee": { "type": "number", "format": "double", "description": "해외파생수수료 / 길이 21.3" }, "fdv_tot_pls": { "type": "number", "format": "double", "description": "해외파생총손익 / 길이 21.3" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "fdv_pdt_cd": { "type": "string", "description": "해외파생상품코드 / 길이 10" }, "pdt_nm": { "type": "string", "description": "상품명 / 길이 50" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "cur_cd": { "type": "string", "description": "통화코드 / 길이 3" }, "fdv_lqd_pls": { "type": "number", "format": "double", "description": "해외파생청산손익 / 길이 21.3" }, "fdv_eal_ind_amt": { "type": "number", "format": "double", "description": "해외파생평가증감금액 / 길이 21.3" }, "fdv_fee": { "type": "number", "format": "double", "description": "해외파생수수료 / 길이 21.3" }, "fdv_tot_pls": { "type": "number", "format": "double", "description": "해외파생총손익 / 길이 21.3" }, "fdv_tot_pls_krw_tsl_amt": { "type": "number", "format": "double", "description": "해외파생총손익원화환산금액 / 길이 21.3" }, "bse_xcg_rt": { "type": "number", "format": "double", "description": "기준환율 / 길이 12.6" }, "fdv_excg_cd": { "type": "string", "description": "해외파생거래소코드 / 길이 10 / CBOE.Chicago Board Options Exchange CME.Chicago Mercantile Exchange ECBOT.Chicago Board of Trade EUREX.Eurex Exchange HKEX.Hong Kong Exchanges ICE EU.Inter Continental Exchange ICE US.Inter Continental Exchange LME.London Metal Exchange MSE.Montreal Exchange OPRA.OPRA OSE.Osaka Exchange SGX.Singapore Exchange" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/gbfuture/inquiry/v1/deposit": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "gbfutureInquiryDeposit", "summary": "해외선물옵션 예수금현황", "description": "해외선물옵션 예수금 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "cur_cd": { "type": "string", "description": "통화코드 / 길이 3 / USD.달러 TKR.원화환산" }, "sls_dt": { "type": "string", "description": "영업일자 / 길이 8 / YYYYMMDD" } }, "required": [ "act_no", "cur_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "cur_cd": { "type": "string", "description": "통화코드 / 길이 3" }, "fdv_dsg_amt": { "type": "number", "format": "double", "description": "해외파생예탁금액 / 길이 21.3" }, "fdv_stl_xpn_amt": { "type": "number", "format": "double", "description": "해외파생결제예정금액 / 길이 21.3" }, "fdv_lqd_pls": { "type": "number", "format": "double", "description": "해외파생청산손익 / 길이 21.3" }, "fdv_opt_sby_cst": { "type": "number", "format": "double", "description": "해외파생옵션매매대금 / 길이 21.3" }, "fdv_fee": { "type": "number", "format": "double", "description": "해외파생수수료 / 길이 21.3" }, "nxt_dd_dga_rnd": { "type": "number", "format": "double", "description": "익일예탁금잔액 / 길이 21.3" }, "frs_ny_stl_eal_pls": { "type": "number", "format": "double", "description": "선물미결제평가손익 / 길이 21.3" }, "fdv_fopt_eal_pls_amt": { "type": "number", "format": "double", "description": "해외파생선물형옵션평가손익금액 / 길이 21.3" }, "fdv_byn_opt_eal_amt": { "type": "number", "format": "double", "description": "해외파생매수옵션평가금액 / 길이 21.3" }, "fdv_sll_opt_eal_amt": { "type": "number", "format": "double", "description": "해외파생매도옵션평가금액 / 길이 21.3" }, "fdv_dsg_aet_tot_eal_amt": { "type": "number", "format": "double", "description": "해외파생예탁자산총평가금액 / 길이 21.3" }, "fdv_brg_wtm": { "type": "number", "format": "double", "description": "해외파생위탁증거금 / 길이 21.3" }, "fdv_mnc_wtm": { "type": "number", "format": "double", "description": "해외파생유지증거금 / 길이 21.3" }, "fdv_apd_wtm": { "type": "number", "format": "double", "description": "해외파생추가증거금 / 길이 21.3" }, "fdv_orr_pbl_amt": { "type": "number", "format": "double", "description": "해외파생주문가능금액 / 길이 21.3" }, "fdv_wrw_pbl_amt": { "type": "number", "format": "double", "description": "해외파생인출가능금액 / 길이 21.3" }, "sby_bse_xcg_rt": { "type": "number", "format": "double", "description": "매매기준환율 / 길이 12.6" }, "krw_sba_fc_eal_amt": { "type": "number", "format": "double", "description": "원화대용외화평가금액 / 길이 21.3" }, "fdv_xny_xpn_amt": { "type": "number", "format": "double", "description": "해외파생환전예정금액 / 길이 21.3" }, "fdv_rvb_amt": { "type": "number", "format": "double", "description": "해외파생미수금액 / 길이 21.3" }, "fdv_rpm_amt": { "type": "string", "description": "해외파생입금금액 / 길이 21.3" }, "fdv_drn_amt": { "type": "string", "description": "해외파생출금금액 / 길이 21.3" }, "fdvf_amt": { "type": "string", "description": "해외파생입출금액 / 길이 21.3" }, "fdv_ny_stl_eal_pls": { "type": "string", "description": "해외파생미결제평가손익 / 길이 21.3" }, "fdv_opt_eal_amt": { "type": "string", "description": "해외파생옵션평가금액 / 길이 21.3" }, "atf_wtm_use_krw_amt": { "type": "string", "description": "사후증거금사용원화금액 / 길이 21.3" }, "fdv_tot_rsk_rt": { "type": "string", "description": "해외파생총위험율 / 길이 24.9" }, "brg_osf_dit_cd": { "type": "string", "description": "위탁자기구분코드 / 길이 1" }, "atf_wtm_dit_cd": { "type": "string", "description": "사후증거금구분코드 / 길이 1" }, "fdv_oln_ofl_dit_cd": { "type": "string", "description": "해외파생온라인오프라인구분코드 / 길이 1" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/gbfuture/inquiry/v1/margin": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "gbfutureInquiryMargin", "summary": "해외선물옵션 증거금상세", "description": "해외선물옵션 증거금 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "sls_dt": { "type": "string", "description": "영업일자 / 길이 8" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "cur_cd": { "type": "string", "description": "통화코드 / 길이 3 / USD.달러 KRW.원화" } }, "required": [ "sls_dt", "act_no", "cur_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "fdv_hge_dit_cd": { "type": "string", "description": "해외파생헤지구분코드 / 길이 1 / 0.일반 1.헤지" }, "fdv_brg_wtm": { "type": "number", "format": "double", "description": "해외파생위탁증거금 / 길이 21.3" }, "fdv_ny_stl_wtm": { "type": "number", "format": "double", "description": "해외파생미결제증거금 / 길이 21.3" }, "fdv_orr_wtm": { "type": "number", "format": "double", "description": "해외파생주문증거금 / 길이 21.3" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "cur_cd": { "type": "string", "description": "통화코드 / 길이 3" }, "iem_cd": { "type": "string", "description": "해외종목코드 / 길이 32" }, "fdv_byn_ny_cns_qty": { "type": "integer", "format": "int64", "description": "해외파생매수미체결수량 / 길이 18" }, "fdv_sll_ny_cns_qty": { "type": "integer", "format": "int64", "description": "해외파생매도미체결수량 / 길이 18" }, "ny_cns_orr_qty": { "type": "integer", "format": "int64", "description": "미체결주문수량 / 길이 18" }, "byn_ny_stl_bnc_qty": { "type": "integer", "format": "int64", "description": "매수미결제잔고수량 / 길이 18" }, "sll_ny_stl_bnc_qty": { "type": "integer", "format": "int64", "description": "매도미결제잔고수량 / 길이 18" }, "ny_stl_qty": { "type": "integer", "format": "int64", "description": "미결제수량 / 길이 18" }, "opt_byn_orr_amt": { "type": "number", "format": "double", "description": "옵션매수주문금액 / 길이 21.3" }, "fdv_edn_amt": { "type": "number", "format": "double", "description": "해외파생증거금액 / 길이 21.3" }, "fdv_brg_wtm": { "type": "number", "format": "double", "description": "해외파생위탁증거금 / 길이 21.3" }, "fdv_ny_stl_wtm": { "type": "number", "format": "double", "description": "해외파생미결제증거금 / 길이 21.3" }, "fdv_orr_wtm": { "type": "number", "format": "double", "description": "해외파생주문증거금 / 길이 21.3" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/gbfuture/quote/v1/current": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteCurrent", "summary": "해외선물종목현재가", "description": "해외선물옵션 현재가 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" } }, "required": [ "exnm", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8" }, "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "inrt": { "type": "string", "description": "실시간종목코드 / 길이 32" }, "iem_nm": { "type": "string", "description": "영문종목명 / 길이 80" }, "snam_notuse": { "type": "string", "description": "축약종목명 / 길이 80" }, "knam": { "type": "string", "description": "한글종목명 / 길이 80" }, "pind": { "type": "string", "description": "가격표시 / 길이 1" }, "last": { "type": "number", "format": "double", "description": "체결가격 / 길이 17" }, "diff": { "type": "number", "format": "double", "description": "전일대비 / 길이 17" }, "sign": { "type": "string", "description": "전일대비구분 / 길이 1" }, "rate": { "type": "number", "format": "double", "description": "전일대비등락율 / 길이 17" }, "open": { "type": "number", "format": "double", "description": "시가 / 길이 17" }, "high": { "type": "number", "format": "double", "description": "고가 / 길이 17" }, "low": { "type": "number", "format": "double", "description": "저가 / 길이 17" }, "ropen": { "type": "number", "format": "double", "description": "시가대비등락율 / 길이 17" }, "rhigh": { "type": "number", "format": "double", "description": "고가대비등락율 / 길이 17" }, "rlow": { "type": "number", "format": "double", "description": "저가대비등락율 / 길이 17" }, "pbid": { "type": "number", "format": "double", "description": "최우선매수호가 / 길이 17" }, "pask": { "type": "number", "format": "double", "description": "최우선매도호가 / 길이 17" }, "bvol": { "type": "number", "format": "double", "description": "매수체결수량합계 / 길이 17" }, "svol": { "type": "number", "format": "double", "description": "매도체결수량합계 / 길이 17" }, "tvol": { "type": "number", "format": "double", "description": "누적체결수량 / 길이 17" }, "setp": { "type": "number", "format": "double", "description": "정산가격 / 길이 17" }, "sday": { "type": "string", "description": "정산일자 / 길이 8" }, "bday": { "type": "string", "description": "기준일자 / 길이 8" }, "tdtm": { "type": "string", "description": "거래시간 / 길이 6" }, "hipr_notuse": { "type": "number", "format": "double", "description": "최고가 / 길이 17" }, "hidy_notuse": { "type": "string", "description": "최고가일 / 길이 8" }, "lopr_notuse": { "type": "number", "format": "double", "description": "최저가 / 길이 17" }, "lody_notuse": { "type": "string", "description": "최저가일 / 길이 8" }, "pcls": { "type": "number", "format": "double", "description": "전일종가 / 길이 17" }, "cur": { "type": "string", "description": "거래통화 / 길이 3" }, "exch": { "type": "string", "description": "거래소명 / 길이 8" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/quote/v1/symbolDetail": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteSymbolDetail", "summary": "해외선물종목상세", "description": "해외선물옵션 종목상세정보 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" } }, "required": [ "exnm", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "seqn": { "type": "string", "description": "순번 / 길이 10" }, "inrt": { "type": "string", "description": "내부루트종목코드 / 길이 32" }, "root": { "type": "string", "description": "루트종목코드 / 길이 32" }, "gsym_notuse": { "type": "string", "description": "그룹코드 / 길이 32" }, "clrs_notuse": { "type": "string", "description": "청산코드 / 길이 32" }, "csym": { "type": "string", "description": "원장종목코드 / 길이 12" }, "cfic_notuse": { "type": "string", "description": "CFI코드 / 길이 7" }, "iem_nm": { "type": "string", "description": "영문종목명 / 길이 80" }, "snam_notuse": { "type": "string", "description": "축약종목명 / 길이 80" }, "knam": { "type": "string", "description": "한글종목명 / 길이 80" }, "ecym": { "type": "string", "description": "영문약정년월 / 길이 8" }, "kcym": { "type": "string", "description": "한글약정년월 / 길이 8" }, "exid": { "type": "string", "description": "거래소ID / 길이 3" }, "exnm": { "type": "string", "description": "거래소코드 / 길이 8" }, "stat_notuse": { "type": "string", "description": "거래상태 / 길이 1" }, "trdf": { "type": "string", "description": "거래가능여부 / 길이 1" }, "unpd": { "type": "string", "description": "기초자산상품그룹코드 / 길이 2" }, "unps": { "type": "string", "description": "기초자산코드 / 길이 32" }, "pmul": { "type": "number", "format": "double", "description": "가격환산승수 / 길이 17" }, "xdiv": { "type": "integer", "format": "int32", "description": "분모 / 길이 10" }, "ydiv": { "type": "integer", "format": "int32", "description": "분자 / 길이 10" }, "zdiv": { "type": "integer", "format": "int32", "description": "소수점자릿수 / 길이 10" }, "pind": { "type": "string", "description": "가격표시자 / 길이 1" }, "aval": { "type": "integer", "format": "int32", "description": "가격조정계수 / 길이 10" }, "sect": { "type": "string", "description": "상품그룹코드 / 길이 2" }, "styp": { "type": "string", "description": "선물옵션구분 / 길이 1" }, "cur1": { "type": "string", "description": "거래통화 / 길이 3" }, "cur2": { "type": "string", "description": "청산통화 / 길이 3" }, "cur3": { "type": "string", "description": "행사통화 / 길이 3" }, "exym": { "type": "string", "description": "만기년월 / 길이 8 / YYYYMMDD" }, "lymd": { "type": "string", "description": "최초거래일 / 길이 8 / YYYYMMDD" }, "zymd": { "type": "string", "description": "최종거래일 / 길이 8 / YYYYMMDD" }, "jjis": { "type": "integer", "format": "int32", "description": "거래일수 / 길이 10" }, "minv_notuse": { "type": "integer", "format": "int32", "description": "최소거래량 / 길이 10" }, "maxv_notuse": { "type": "integer", "format": "int32", "description": "최소대거래량 / 길이 10" }, "csiz_notuse": { "type": "integer", "format": "int32", "description": "약정단위 / 길이 10" }, "ndpt": { "type": "integer", "format": "int32", "description": "호가레벨 / 길이 10" }, "adjv": { "type": "number", "format": "double", "description": "가격조정계수값 / 길이 17" }, "tval": { "type": "number", "format": "double", "description": "틱가치 / 길이 17" }, "pinc": { "type": "number", "format": "double", "description": "최소가격변동폭 / 길이 17" }, "uplp": { "type": "number", "format": "double", "description": "상한가 / 길이 17" }, "dnlp": { "type": "number", "format": "double", "description": "하한가 / 길이 17" }, "base": { "type": "number", "format": "double", "description": "기준가 / 길이 17" }, "clos_notuse": { "type": "number", "format": "double", "description": "종가 / 길이 17" }, "hipr_notuse": { "type": "number", "format": "double", "description": "최고가 / 길이 17" }, "hidy_notuse": { "type": "string", "description": "최고가일 / 길이 8 / YYYYMMDD" }, "lopr_notuse": { "type": "number", "format": "double", "description": "최저가 / 길이 17" }, "lody_notuse": { "type": "string", "description": "최저가일 / 길이 8 / YYYYMMDD" }, "hian_notuse": { "type": "number", "format": "double", "description": "연중최고가 / 길이 17" }, "hdan_notuse": { "type": "string", "description": "연중최고일 / 길이 8 / YYYYMMDD" }, "loan_notuse": { "type": "number", "format": "double", "description": "연중최저가 / 길이 17" }, "ldan_notuse": { "type": "string", "description": "연중최저일 / 길이 8 / YYYYMMDD" }, "opts": { "type": "string", "description": "옵션행사유형 / 길이 1" }, "corp": { "type": "string", "description": "옵션유형 / 길이 1" }, "atmf": { "type": "string", "description": "행사가능유무 / 길이 1" }, "strk": { "type": "number", "format": "double", "description": "행사가 / 길이 17" }, "conv_notuse": { "type": "number", "format": "double", "description": "전환비율 / 길이 17" }, "impv_notuse": { "type": "number", "format": "double", "description": "내재변동성 / 길이 17" }, "levg_notuse": { "type": "number", "format": "double", "description": "레버리지인수 / 길이 17" }, "gear_notuse": { "type": "number", "format": "double", "description": "레버리지 / 길이 17" }, "delt_notuse": { "type": "number", "format": "double", "description": "델타 / 길이 17" }, "gama_notuse": { "type": "number", "format": "double", "description": "감마 / 길이 17" }, "vega_notuse": { "type": "number", "format": "double", "description": "베가 / 길이 17" }, "thet_notuse": { "type": "number", "format": "double", "description": "세타 / 길이 17" }, "lreg_notuse": { "type": "integer", "format": "int32", "description": "품목등록임시변수 / 길이 10" }, "kfrhm": { "type": "string", "description": "한국거래시작시간 / 길이 12" }, "psect_notuse": { "type": "string", "description": "전일정산가구분코드 / 길이 2" }, "psymd": { "type": "string", "description": "전일거래일자 / 길이 8 / YYYYMMDD" }, "ppymd_notuse": { "type": "string", "description": "전전일거래일자 / 길이 8 / YYYYMMDD" }, "pbase_notuse": { "type": "number", "format": "double", "description": "전일기준가 / 길이 17" }, "popen": { "type": "number", "format": "double", "description": "전일시가 / 길이 17" }, "phigh": { "type": "number", "format": "double", "description": "전일고가 / 길이 17" }, "plow": { "type": "number", "format": "double", "description": "전일저가 / 길이 17" }, "plast": { "type": "number", "format": "double", "description": "전일체결가 / 길이 17" }, "psetp": { "type": "number", "format": "double", "description": "전일정산가 / 길이 17" }, "psign_notuse": { "type": "string", "description": "전전일대비구분 / 길이 1" }, "pdiff_notuse": { "type": "number", "format": "double", "description": "전전일대비 / 길이 17" }, "prate_notuse": { "type": "number", "format": "double", "description": "전전일대비등락율 / 길이 17" }, "ptvol": { "type": "number", "format": "double", "description": "전일누적체결수량 / 길이 17" }, "popin_notuse": { "type": "integer", "format": "int32", "description": "전일미결제약정수량 / 길이 10" }, "pcvol": { "type": "number", "format": "double", "description": "전일누적거래량 / 길이 17" }, "puymd_notuse": { "type": "string", "description": "전일업데이트일자 / 길이 8 / YYYYMMDD" }, "puhms_notuse": { "type": "string", "description": "전일업데이트시간 / 길이 12" }, "upvo_notuse": { "type": "integer", "format": "int32", "description": "전일상승거래량 / 길이 10" }, "dnvo_notuse": { "type": "integer", "format": "int32", "description": "전일하락거래량 / 길이 10" }, "upno_notuse": { "type": "integer", "format": "int32", "description": "전일상승수량 / 길이 10" }, "dnno_notuse": { "type": "integer", "format": "int32", "description": "전일하락수량 / 길이 10" }, "frhm": { "type": "string", "description": "거래시작시간 / 길이 12" }, "tohm": { "type": "string", "description": "거래종료시간 / 길이 12" }, "hfhm_notuse": { "type": "string", "description": "거래중단시작시간 / 길이 12" }, "hthm_notuse": { "type": "string", "description": "거래중단종료시간 / 길이 12" }, "fwdy": { "type": "string", "description": "주의거래시작일 / 길이 8 / YYYYMMDD" }, "twdy": { "type": "string", "description": "주의거래종료일 / 길이 8 / YYYYMMDD" }, "tfhm_notuse": { "type": "string", "description": "티세션시작시간 / 길이 12" }, "feed_notuse": { "type": "integer", "format": "int32", "description": "피딩아이디 / 길이 10" }, "pymd": { "type": "string", "description": "전영업일 / 길이 8 / YYYYMMDD" }, "tymd": { "type": "string", "description": "거래일자 / 길이 8 / YYYYMMDD" }, "oymd": { "type": "string", "description": "장시작일 / 길이 8 / YYYYMMDD" }, "cymd": { "type": "string", "description": "장종료일 / 길이 8 / YYYYMMDD" }, "uymd": { "type": "string", "description": "업데이트일자 / 길이 8 / YYYYMMDD" }, "uhms": { "type": "string", "description": "업데이트시간 / 길이 12" }, "jchk_notuse": { "type": "integer", "format": "int32", "description": "종목체크 / 길이 10" }, "sind": { "type": "integer", "format": "int32", "description": "행사가격소숫점자리수 / 길이 10" }, "sad1": { "type": "integer", "format": "int32", "description": "행사가격승수 / 길이 10" }, "sad2": { "type": "integer", "format": "int32", "description": "행사가격승수2 / 길이 10" }, "sfmt": { "type": "integer", "format": "int32", "description": "행사가격포맷 / 길이 10" }, "sdiv": { "type": "integer", "format": "int32", "description": "행사가격소숫점자릿수(내부용) / 길이 10" }, "kymda1": { "type": "string", "description": "예비정산가수신일자 / 길이 8 / YYYYMMDD" }, "khmsa1": { "type": "string", "description": "예비정산가수신시간 / 길이 12" }, "datea1": { "type": "string", "description": "예비정산가일자 / 길이 8" }, "basea1": { "type": "number", "format": "double", "description": "예비정산가 / 길이 17" }, "kymda2_notuse": { "type": "string", "description": "틱사이즈예비정산가수신일자 / 길이 8 / YYYYMMDD" }, "khmsa2_notuse": { "type": "string", "description": "틱사이즈예비정산가수신시간 / 길이 12" }, "datea2_notuse": { "type": "string", "description": "틱사이즈예비정산가일자 / 길이 8" }, "basea2_notuse": { "type": "number", "format": "double", "description": "틱사이즈예비정산가 / 길이 17" }, "kymdb1": { "type": "string", "description": "실제정산가수신일자 / 길이 8 / YYYYMMDD" }, "khmsb1": { "type": "string", "description": "실제정산가수신시간 / 길이 12" }, "dateb1": { "type": "string", "description": "실제정산가일자 / 길이 8 / YYYYMMDD" }, "baseb1": { "type": "number", "format": "double", "description": "실제정산가 / 길이 17" }, "kymdb2_notuse": { "type": "string", "description": "틱사이즈실제정산가수신일자 / 길이 8 / YYYYMMDD" }, "khmsb2_notuse": { "type": "string", "description": "틱사이즈실제정산가수신시간 / 길이 12" }, "dateb2_notuse": { "type": "string", "description": "틱사이즈실제정산가일자 / 길이 8 / YYYYMMDD" }, "baseb2_notuse": { "type": "number", "format": "double", "description": "틱사이즈실제정산가 / 길이 17" }, "unps2": { "type": "string", "description": "기초자산코드2 / 길이 15" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/quote/v1/quote": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteQuote", "summary": "해외선물 호가", "description": "해외선물옵션 호가 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" } }, "required": [ "exnm", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8" }, "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "inrt": { "type": "string", "description": "내부루트종목코드 / 길이 32" }, "pind": { "type": "string", "description": "가격표시자 / 길이 1" }, "last": { "type": "number", "format": "double", "description": "체결가격 / 길이 17" }, "diff": { "type": "number", "format": "double", "description": "전일대비 / 길이 17" }, "sign": { "type": "string", "description": "전일대비구분 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "rate": { "type": "number", "format": "double", "description": "전일대비등락율 / 길이 17" }, "open": { "type": "number", "format": "double", "description": "시가 / 길이 17" }, "high": { "type": "number", "format": "double", "description": "고가 / 길이 17" }, "low": { "type": "number", "format": "double", "description": "저가 / 길이 17" }, "setp": { "type": "number", "format": "double", "description": "정산가격 / 길이 17" }, "pcls": { "type": "number", "format": "double", "description": "전일종가 / 길이 17" }, "tvol": { "type": "number", "format": "double", "description": "누적체결수량 / 길이 17" }, "cvol": { "type": "number", "format": "double", "description": "누적거래량 / 길이 17" }, "htim": { "type": "string", "description": "호가시간 / 길이 6" }, "pask1": { "type": "number", "format": "double", "description": "매도1호가 / 길이 17" }, "vask1": { "type": "integer", "format": "int32", "description": "매도1호가잔량 / 길이 10" }, "nask1": { "type": "integer", "format": "int32", "description": "매도1호가총건수 / 길이 10" }, "cask1": { "type": "integer", "format": "int32", "description": "매도1호가잔량직전대비 / 길이 10" }, "rask1": { "type": "number", "format": "double", "description": "매도1호가등락율 / 길이 17" }, "pbid1": { "type": "number", "format": "double", "description": "매수1호가 / 길이 17" }, "vbid1": { "type": "integer", "format": "int32", "description": "매수1호가잔량 / 길이 10" }, "nbid1": { "type": "integer", "format": "int32", "description": "매수1호가총건수 / 길이 10" }, "cbid1": { "type": "integer", "format": "int32", "description": "매수1호가잔량직전대비 / 길이 10" }, "rbid1": { "type": "number", "format": "double", "description": "매수1호가등락율 / 길이 17" }, "pask2": { "type": "number", "format": "double", "description": "매도2호가 / 길이 17" }, "vask2": { "type": "integer", "format": "int32", "description": "매도2호가잔량 / 길이 10" }, "nask2": { "type": "integer", "format": "int32", "description": "매도2호가총건수 / 길이 10" }, "cask2": { "type": "integer", "format": "int32", "description": "매도2호가잔량직전대비 / 길이 10" }, "rask2": { "type": "number", "format": "double", "description": "매도2호가등락율 / 길이 17" }, "pbid2": { "type": "number", "format": "double", "description": "매수2호가 / 길이 17" }, "vbid2": { "type": "integer", "format": "int32", "description": "매수2호가잔량 / 길이 10" }, "nbid2": { "type": "integer", "format": "int32", "description": "매수2호가총건수 / 길이 10" }, "cbid2": { "type": "integer", "format": "int32", "description": "매수2호가잔량직전대비 / 길이 10" }, "rbid2": { "type": "number", "format": "double", "description": "매수2호가등락율 / 길이 17" }, "pask3": { "type": "number", "format": "double", "description": "매도3호가 / 길이 17" }, "vask3": { "type": "integer", "format": "int32", "description": "매도3호가잔량 / 길이 10" }, "nask3": { "type": "integer", "format": "int32", "description": "매도3호가총건수 / 길이 10" }, "cask3": { "type": "integer", "format": "int32", "description": "매도3호가잔량직전대비 / 길이 10" }, "rask3": { "type": "number", "format": "double", "description": "매도3호가등락율 / 길이 17" }, "pbid3": { "type": "number", "format": "double", "description": "매수3호가 / 길이 17" }, "vbid3": { "type": "integer", "format": "int32", "description": "매수3호가잔량 / 길이 10" }, "nbid3": { "type": "integer", "format": "int32", "description": "매수3호가총건수 / 길이 10" }, "cbid3": { "type": "integer", "format": "int32", "description": "매수3호가잔량직전대비 / 길이 10" }, "rbid3": { "type": "number", "format": "double", "description": "매수3호가등락율 / 길이 17" }, "pask4": { "type": "number", "format": "double", "description": "매도4호가 / 길이 17" }, "vask4": { "type": "integer", "format": "int32", "description": "매도4호가잔량 / 길이 10" }, "nask4": { "type": "integer", "format": "int32", "description": "매도4호가총건수 / 길이 10" }, "cask4": { "type": "integer", "format": "int32", "description": "매도4호가잔량직전대비 / 길이 10" }, "rask4": { "type": "number", "format": "double", "description": "매도4호가등락율 / 길이 17" }, "pbid4": { "type": "number", "format": "double", "description": "매수4호가 / 길이 17" }, "vbid4": { "type": "integer", "format": "int32", "description": "매수4호가잔량 / 길이 10" }, "nbid4": { "type": "integer", "format": "int32", "description": "매수4호가총건수 / 길이 10" }, "cbid4": { "type": "integer", "format": "int32", "description": "매수4호가잔량직전대비 / 길이 10" }, "rbid4": { "type": "number", "format": "double", "description": "매수4호가등락율 / 길이 17" }, "pask5": { "type": "number", "format": "double", "description": "매도5호가 / 길이 17" }, "vask5": { "type": "integer", "format": "int32", "description": "매도5호가잔량 / 길이 10" }, "nask5": { "type": "integer", "format": "int32", "description": "매도5호가총건수 / 길이 10" }, "cask5": { "type": "integer", "format": "int32", "description": "매도5호가잔량직전대비 / 길이 10" }, "rask5": { "type": "number", "format": "double", "description": "매도5호가등락율 / 길이 17" }, "pbid5": { "type": "number", "format": "double", "description": "매수5호가 / 길이 17" }, "vbid5": { "type": "integer", "format": "int32", "description": "매수5호가잔량 / 길이 10" }, "nbid5": { "type": "integer", "format": "int32", "description": "매수5호가총건수 / 길이 10" }, "cbid5": { "type": "integer", "format": "int32", "description": "매수5호가잔량직전대비 / 길이 10" }, "rbid5": { "type": "number", "format": "double", "description": "매수5호가등락율 / 길이 17" }, "vask": { "type": "integer", "format": "int32", "description": "매도호가총잔량 / 길이 10" }, "nask": { "type": "integer", "format": "int32", "description": "매도호가총건수 / 길이 10" }, "cask": { "type": "integer", "format": "int32", "description": "매도호가총잔량직전대비 / 길이 10" }, "vbid": { "type": "integer", "format": "int32", "description": "매수호가총잔량 / 길이 10" }, "nbid": { "type": "integer", "format": "int32", "description": "매수호가총건수 / 길이 10" }, "cbid": { "type": "integer", "format": "int32", "description": "매수호가총잔량직전대비 / 길이 10" }, "fprc_notuse": { "type": "number", "format": "double", "description": "예상체결가 / 길이 17" }, "exch": { "type": "string", "description": "거래소명 / 길이 8" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/quote/v1/minute": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteMinute", "summary": "해외선물 분봉조회", "description": "해외선물옵션 분봉 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "kymd": { "type": "string", "description": "한국일자 / 길이 8 / YYYYMMDD" }, "req_cnt": { "type": "string", "description": "요청건수 / 길이 4" } }, "required": [ "exnm", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "kymd": { "type": "string", "description": "한국일자 / 길이 8 / YYYYMMDD" }, "khms": { "type": "string", "description": "한국시간 / 길이 12 / HHMMSS" }, "xymd": { "type": "string", "description": "거래소일자 / 길이 8 / YYYYMMDD" }, "xhms": { "type": "string", "description": "거래소시간 / 길이 12 / HHMMSS" }, "tymd": { "type": "string", "description": "거래일자 / 길이 8 / YYYYMMDD" }, "open": { "type": "string", "description": "시가 / 길이 17" }, "high": { "type": "string", "description": "고가 / 길이 17" }, "low": { "type": "string", "description": "저가 / 길이 17" }, "clos": { "type": "string", "description": "종가 / 길이 17" }, "cvol": { "type": "string", "description": "누적거래량 / 길이 17" }, "tvol": { "type": "string", "description": "누적체결수량 / 길이 17" }, "tamt": { "type": "string", "description": "누적거래대금 / 길이 17" }, "flush_notuse": { "type": "string", "description": "동기화구분 / 길이 10" }, "bvol": { "type": "string", "description": "매수체결수량합계 / 길이 17" }, "svol": { "type": "string", "description": "매도체결수량합계 / 길이 17" }, "upvo": { "type": "string", "description": "전일상승거래량 / 길이 17" }, "dnvo": { "type": "string", "description": "전일하락거래량 / 길이 17" }, "upno": { "type": "string", "description": "전일상승수량 / 길이 10" }, "dnno": { "type": "string", "description": "전일하락수량 / 길이 10" }, "pcls": { "type": "string", "description": "전일종가 / 길이 17" }, "opin_notuse": { "type": "string", "description": "미결제잔량 / 길이 10" }, "seqn_notuse": { "type": "string", "description": "순번 / 길이 10" }, "sseq_notuse": { "type": "string", "description": "초당순번 / 길이 10" }, "kfrhm": { "type": "string", "description": "한국거래시작시간 / 길이 12" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" }, "ctsz52": { "type": "string", "description": "ctsz52 / 길이 52 / Symb(32)+Kymd(8)+Khms(12)" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/quote/v1/executionTrendTick": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteExecutionTrendTick", "summary": "해외선물 체결추이(틱)", "description": "해외선물옵션 틱봉 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: `Output_0` 는 명세상 **Array** 로 선언되어 있으나 예시 응답은 **Object** 입니다. 실제 응답 타입을 확인 후 사용하세요.\n\n⚠️ **명세 검증 필요**: 예시 응답에는 명세에 없는 블록(Output_1)이 포함되어 있습니다.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "kymd": { "type": "string", "description": "한국일자 / 길이 8 / YYYYMMDD" }, "req_cnt": { "type": "string", "description": "요청건수 / 길이 4" } }, "required": [ "exnm", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "kymd": { "type": "string", "description": "한국일자 / 길이 8 / YYYYMMDD" }, "khms": { "type": "string", "description": "한국시간 / 길이 12 / HHMMSS" }, "sseq": { "type": "string", "description": "초당순번 / 길이 10" }, "tymd": { "type": "string", "description": "거래일자 / 길이 8 / YYYYMMDD" }, "seqn": { "type": "string", "description": "순번 / 길이 10" }, "xymd": { "type": "string", "description": "거래소일자 / 길이 8 / YYYYMMDD" }, "xhms": { "type": "string", "description": "거래소시간 / 길이 12 / HHMMSS" }, "last": { "type": "string", "description": "체결가 / 길이 17" }, "sign": { "type": "string", "description": "전일대비구분 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "diff": { "type": "string", "description": "전일대비 / 길이 17" }, "rate": { "type": "string", "description": "전일대비등락율 / 길이 17" }, "cvol": { "type": "string", "description": "누적거래량 / 길이 17" }, "tvol": { "type": "string", "description": "누적체결수량 / 길이 17" }, "tamt": { "type": "string", "description": "누적거래대금 / 길이 17" }, "side": { "type": "string", "description": "매도매수구분 / 길이 1 / +.매수\n-.매도" }, "dirf": { "type": "string", "description": "직전대비가격방향 / 길이 10 / 43.+\n45.-" }, "pask": { "type": "string", "description": "최우선매도호가 / 길이 17" }, "pbid": { "type": "string", "description": "최우선매수호가 / 길이 17" }, "bvol": { "type": "string", "description": "매수체결수량합계 / 길이 17" }, "svol": { "type": "string", "description": "매도체결수량합계 / 길이 17" }, "opin_notuse": { "type": "string", "description": "미결제잔량 / 길이 10" }, "pcls": { "type": "string", "description": "전일종가 / 길이 17" }, "udtx": { "type": "string", "description": "최종상승하락타입 / 길이 10 / 43.+\n45.-" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" }, "ctsz52": { "type": "string", "description": "ctsz52 / 길이 52 / Symb(32)+Kymd(8)+Khms(12)" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "block": "Output_0", "declared": "Array", "sample": "Object" }, { "missing_blocks": [ "Output_1" ] } ] } }, "/gbfuture/quote/v1/executionTrendDaily": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteExecutionTrendDaily", "summary": "해외선물 체결추이(일간)", "description": "해외선물옵션 일봉 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: 예시 응답에는 명세에 없는 블록(Output_0)이 포함되어 있습니다.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "ssymd": { "type": "string", "description": "검색시작일자 / 길이 8 / YYYYMMDD" }, "quotyn": { "type": "string", "description": "현재가포함여부 / 길이 1 / Y.포함 N.미포함" }, "req_cnt": { "type": "string", "description": "요청건수 / 길이 4" } }, "required": [ "exnm", "iem_cd", "ssymd", "quotyn" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "tymd": { "type": "string", "description": "거래일자 / 길이 8" }, "zdiv": { "type": "string", "description": "소수점자리수 / 길이 10" }, "open": { "type": "string", "description": "시가 / 길이 17" }, "high": { "type": "string", "description": "고가 / 길이 17" }, "low": { "type": "string", "description": "저가 / 길이 17" }, "last": { "type": "string", "description": "체결가 / 길이 17" }, "setp": { "type": "string", "description": "정산가 / 길이 17 / CME만제공" }, "clos": { "type": "string", "description": "종가 / 길이 17" }, "sign": { "type": "string", "description": "전일대비구분 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "diff": { "type": "string", "description": "전일대비 / 길이 17" }, "rate": { "type": "string", "description": "전일대비등락율 / 길이 17" }, "tvol": { "type": "string", "description": "누적체결수량 / 길이 17" }, "tamt": { "type": "string", "description": "누적거래대금 / 길이 17" }, "opin_notuse": { "type": "string", "description": "미결제잔량 / 길이 15" }, "seqn_notuse": { "type": "string", "description": "순번 / 길이 10" }, "upvo": { "type": "string", "description": "전일상승거래량 / 길이 10" }, "dnvo": { "type": "string", "description": "전일하락거래량 / 길이 10" }, "upno": { "type": "string", "description": "전일상승수량 / 길이 10" }, "dnno": { "type": "string", "description": "전일하락수량 / 길이 10" }, "shms": { "type": "string", "description": "시작시간 / 길이 12" }, "ehms": { "type": "string", "description": "종료시간 / 길이 12" }, "sseq_notuse": { "type": "string", "description": "초당순번 / 길이 10" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" }, "ctsz40": { "type": "string", "description": "ctsz40 / 길이 40 / Symb(32)+Kymd(8)" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "missing_blocks": [ "Output_0" ] }, { "note": "일부 블록의 Data Type 이 명세에 미기재 → 예시 응답 기준으로 추정 적용" } ] } }, "/gbfuture/quote/v1/executionTrendWeekly": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteExecutionTrendWeekly", "summary": "해외선물 체결추이(주간)", "description": "해외선물옵션 주봉 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "kymd": { "type": "string", "description": "한국일자 / 길이 8 / YYYYMMDD" }, "req_cnt": { "type": "string", "description": "요청건수 / 길이 4" } }, "required": [ "exnm", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "wsymd": { "type": "string", "description": "주초일자 / 길이 8 / YYYYMMDD" }, "weymd": { "type": "string", "description": "주말일자 / 길이 8 / YYYYMMDD" }, "nday": { "type": "string", "description": "입회일수 / 길이 10" }, "open": { "type": "string", "description": "시가 / 길이 17" }, "high": { "type": "string", "description": "고가 / 길이 17" }, "low": { "type": "string", "description": "저가 / 길이 17" }, "clos": { "type": "string", "description": "종가 / 길이 17" }, "sign": { "type": "string", "description": "전주대비구분 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "diff": { "type": "string", "description": "전주대비 / 길이 17" }, "rate": { "type": "string", "description": "전주대비등락율 / 길이 17" }, "tvol": { "type": "string", "description": "누적체결수량 / 길이 17" }, "tamt": { "type": "string", "description": "누적거래대금 / 길이 17" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" }, "ctsz40": { "type": "string", "description": "ctsz40 / 길이 40 / Symb(32)+Kymd(8)" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/quote/v1/executionTrendMonthly": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteExecutionTrendMonthly", "summary": "해외선물 체결추이(월간)", "description": "해외선물옵션 월봉 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32 / 예시> E-mini S&P 500 -2609인 경우, ESU26" }, "kymd": { "type": "string", "description": "한국일자 / 길이 8 / YYYYMMDD" }, "req_cnt": { "type": "string", "description": "요청건수 / 길이 4" } }, "required": [ "exnm", "iem_cd", "kymd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "symb": { "type": "string", "description": "종목코드 / 길이 32" }, "iem_cd": { "type": "string", "description": "내부종목코드 / 길이 32" }, "msymd": { "type": "string", "description": "월초일자 / 길이 8 / YYYYMMDD" }, "nday": { "type": "string", "description": "입회일수 / 길이 10" }, "open": { "type": "string", "description": "시가 / 길이 17" }, "high": { "type": "string", "description": "고가 / 길이 17" }, "low": { "type": "string", "description": "저가 / 길이 17" }, "clos": { "type": "string", "description": "종가 / 길이 17" }, "sign": { "type": "string", "description": "전월대비구분 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "diff": { "type": "string", "description": "전월대비 / 길이 17" }, "rate": { "type": "string", "description": "전월대비등락율 / 길이 17" }, "tvol": { "type": "string", "description": "누적체결수량 / 길이 17" }, "tamt": { "type": "string", "description": "누적거래대금 / 길이 17" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" }, "ctsz40": { "type": "string", "description": "ctsz40 / 길이 40 / Symb(32)+Kymd(8)" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/quote/v1/productInfo": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteProductInfo", "summary": "해외선물 상품기본정보", "description": "해외선물옵션 상품기본정보 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "exid": { "type": "string", "description": "거래소ID / 길이 3 / ALL.전체 E01.CME E16.OPRA E03.HKEX" }, "sect": { "type": "string", "description": "상품그룹코드 / 길이 2 / 00.전체 30.지수 80.주식옵션 90.지수옵션" }, "exnm": { "type": "string", "description": "거래소코드 / 길이 8 / ALL.전체 FCME.CME지수선물 OOPR.OPRA주식옵션 OCME.CME지수옵션 FHKE.HKEX선물 OHKE.HKEX옵션" }, "req_cnt": { "type": "string", "description": "요청건수 / 길이 4" } }, "required": [ "exid", "sect", "exnm" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "exnm": { "type": "string", "description": "거래소코드 / 길이 8" }, "root": { "type": "string", "description": "루트종목코드 / 길이 32" }, "inrt": { "type": "string", "description": "내부루트종목코드 / 길이 32" }, "exid": { "type": "string", "description": "거래소ID / 길이 3" }, "iem_cd": { "type": "string", "description": "영문종목명 / 길이 80" }, "knam": { "type": "string", "description": "한글종목명 / 길이 80" }, "styp": { "type": "string", "description": "선물옵션구분 / 길이 1 / F.선물 O.옵션" }, "sect": { "type": "string", "description": "상품그룹코드 / 길이 2 / 00.전체 30.지수 50.금속 60.에너지 80.주식옵션 90.지수옵션" }, "pind": { "type": "string", "description": "가격표시 / 길이 1" }, "pinc": { "type": "number", "format": "double", "description": "최소가격변동폭 / 길이 17" }, "tval": { "type": "number", "format": "double", "description": "틱가치 / 길이 17" }, "bsnsd": { "type": "string", "description": "영업일자 / 길이 8 / YYYYMMDD" }, "skhms": { "type": "string", "description": "장시작한국시간 / 길이 6 / HHMMSS" }, "ekhms": { "type": "string", "description": "장마감한국시간 / 길이 6 / HHMMSS" }, "opbr": { "type": "number", "format": "double", "description": "옵션프리미엄기준가격 / 길이 17" }, "oppb": { "type": "number", "format": "double", "description": "옵션프리미엄이하틱사이즈 / 길이 17" }, "oppo": { "type": "number", "format": "double", "description": "옵션프리미엄이상틱사이즈 / 길이 17" }, "opbv": { "type": "number", "format": "double", "description": "옵션프리미엄이하틱가치 / 길이 17" }, "opov": { "type": "number", "format": "double", "description": "옵션프리미엄이상틱가치 / 길이 17" }, "fsmc": { "type": "string", "description": "결제방식 / 길이 1 / 1.현금결제 2.실물인수도" }, "feamt": { "type": "number", "format": "double", "description": "해외파생증거금액 / 길이 17" }, "curcd": { "type": "string", "description": "통화코드 / 길이 3" }, "exch": { "type": "string", "description": "거래소명 / 길이 8" }, "apamt": { "type": "number", "format": "double", "description": "해외파생계약당금액 / 길이 17" }, "npup": { "type": "number", "format": "double", "description": "해외파생호가단위가격 / 길이 17" }, "npua": { "type": "number", "format": "double", "description": "해외파생호가단위금액 / 길이 17" }, "pgcef": { "type": "number", "format": "double", "description": "해외파생가격조정계수 / 길이 17" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" }, "ctsz40": { "type": "string", "description": "ctsz40 / 길이 40 / exnm(8)+root(32)" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/gbfuture/quote/v1/marketOperationInfo": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "gbfutureQuoteMarketOperationInfo", "summary": "해외선물옵션 장운영시간", "description": "해외선물옵션 장운영시간 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "fdv_excg_cd": { "type": "string", "description": "해외파생거래소코드 / 길이 10 / CME CBOE HKEX OPRA" }, "fdv_pdt_cd": { "type": "string", "description": "해외파생상품코드 / 길이 10" } } } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "fdv_excg_cd": { "type": "string", "description": "해외파생거래소코드 / 길이 10" }, "fdv_pdt_cd": { "type": "string", "description": "해외파생상품코드 / 길이 10" }, "pdt_nm": { "type": "string", "description": "상품명 / 길이 50" }, "smi_yn": { "type": "string", "description": "서머타임여부 / 길이 1" }, "mpn_kor_hur": { "type": "string", "description": "장개시한국시간 / 길이 9" }, "mls_kor_hur": { "type": "string", "description": "장마감한국시간 / 길이 9" }, "mpn_kor_smi_hur": { "type": "string", "description": "장개시한국서머타임시간 / 길이 9" }, "mls_kor_smi_hur": { "type": "string", "description": "장마감한국서머타임시간 / 길이 9" }, "mpn_lcl_hur": { "type": "string", "description": "장개시로컬시간 / 길이 9" }, "mls_lcl_hur": { "type": "string", "description": "장마감로컬시간 / 길이 9" }, "nxt_dd_trd_sta_kor_hur": { "type": "string", "description": "익일거래시작한국시간 / 길이 9" }, "nxt_dd_trd_end_kor_hur": { "type": "string", "description": "익일거래종료한국시간 / 길이 9" }, "nxt_dd_trd_sta_kor_smi_hur": { "type": "string", "description": "익일거래시작한국서머타임시간 / 길이 9" }, "nxt_dd_trd_end_kor_smi_hur": { "type": "string", "description": "익일거래종료한국서머타임시간 / 길이 9" }, "nxt_dd_trd_lcl_sta_hur": { "type": "string", "description": "익일거래로컬시작시간 / 길이 9" }, "nxt_dd_trd_lcl_end_hur": { "type": "string", "description": "익일거래로컬종료시간 / 길이 9" }, "nom_mpn_kor_hur": { "type": "string", "description": "정규장개시한국시장 / 길이 9" }, "nom_mls_kor_hur": { "type": "string", "description": "정규장마감한국시장 / 길이 9" }, "nom_mpn_kor_smi_hur": { "type": "string", "description": "정규장개시한국서머타임시간 / 길이 9" }, "nom_mls_kor_smi_hur": { "type": "string", "description": "정규장마감한국서머타임시간 / 길이 9" }, "nom_mpn_lcl_hur": { "type": "string", "description": "정규장개시로컬시간 / 길이 9" }, "nom_mls_lcl_hur": { "type": "string", "description": "정규장마감로컬시간 / 길이 9" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } } }, "x-realtime-channels": { "endpoint": "wss://api.nhplug.com:7080", "endpoints": { "live": "wss://api.nhplug.com:7080", "mock": "wss://moapi.nhplug.com:17070" }, "protocol": { "transport": "WebSocket", "connection": "wss 접속(국내 :7070 / 해외 :7080, 모의투자 :17070) 후 구독 메시지 전송. URI 는 /websocket.", "auth": "메시지 header 의 token 필드에 access token(POST /oauth2/token) 전달. REST 와 달리 Authorization/x-client-id/x-client-secret 헤더는 미사용.", "subscribe_message": { "header": { "token": "{access_token}", "tr_type": "1" }, "body": { "tr_cd": "<채널코드>", "tr_key": "<구독키>" } }, "unsubscribe": "동일 메시지에서 tr_type 을 '2' 로 전송", "tr_type": { "1": "등록(구독)", "2": "해제" }, "push_message": { "format": "JSON", "delivery": "비정기적 — 데이터 발생 시마다 서버가 push (요청/응답 1:1 아님)", "structure": { "header": { "tr_cd": "채널코드", "tr_key": "구독키" }, "body": { "<응답필드>": "..." } } }, "heartbeat": "불필요 — 연결 유지 신호(ping/pong) 없음", "encryption": "없음 — 체결/주문 통보 포함 모두 평문 JSON" }, "note": "실시간 시세·통보는 WebSocket. 구독=protocol.subscribe_message, 서버 푸시=JSON {header,body}. 채널별 실제 예시는 channels[].subscribe_example / push_example.", "channels": [ { "name": "해외선물옵션 실시간호가", "sheet": "API_해외_파생_실시간_호가", "tr_cd": "FH", "tr_key": { "name": "isym", "kor": "종목코드", "length": "32" }, "fields": [ "isym", "trxc", "exid", "dven", "date", "time", "mseq", "trdt", "trtm", "nbid1", "vbid1", "pbid1", "nask1", "vask1", "pask1", "nbid2", "vbid2", "pbid2", "nask2", "vask2", "pask2", "nbid3", "vbid3", "pbid3", "nask3", "vask3", "pask3", "nbid4", "vbid4", "pbid4", "nask4", "vask4", "pask4", "nbid5", "vbid5", "pbid5", "nask5", "vask5", "pask5", "nbid", "vbid", "nask", "vask" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "FH", "tr_key": "ESU26" } }, "push_example": { "header": { "tr_cd": "FH", "tr_key": "ESU26" }, "body": { "isym": "ESU26", "trxc": "T31", "exid": "E01", "dven": "", "date": "20260710", "time": "103647665751", "mseq": "", "trdt": "20260710", "trtm": "103647665630", "nbid1": "17", "vbid1": "21", "pbid1": "7579.25", "nask1": "12", "vask1": "14", "pask1": "7579.75", "nbid2": "10", "vbid2": "12", "pbid2": "7579.00", "nask2": "11", "vask2": "26", "pask2": "7580.00", "nbid3": "11", "vbid3": "15", "pbid3": "7578.75", "nask3": "11", "vask3": "13", "pask3": "7580.25", "nbid4": "9", "vbid4": "12", "pbid4": "7578.50", "nask4": "13", "vask4": "20", "pask4": "7580.50", "nbid5": "17", "vbid5": "24", "pbid5": "7578.25", "nask5": "11", "vask5": "17", "pask5": "7580.75", "nbid": "64", "vbid": "84", "nask": "58", "vask": "90" } }, "description": "유료시세 사용 약정 고객만 이용 가능합니다." }, { "name": "해외선물옵션 지연호가", "sheet": "API_해외_파생_실시간_호가(지연)", "tr_cd": "fh", "tr_key": { "name": "isym", "kor": "종목코드", "length": "32" }, "fields": [ "isym", "trxc", "exid", "dven", "date", "time", "mseq", "trdt", "trtm", "nbid1", "vbid1", "pbid1", "nask1", "vask1", "pask1", "nbid2", "vbid2", "pbid2", "nask2", "vask2", "pask2", "nbid3", "vbid3", "pbid3", "nask3", "vask3", "pask3", "nbid4", "vbid4", "pbid4", "nask4", "vask4", "pask4", "nbid5", "vbid5", "pbid5", "nask5", "vask5", "pask5", "nbid", "vbid", "nask", "vask" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "fh", "tr_key": "ESU26" } }, "push_example": { "header": { "tr_cd": "fh", "tr_key": "ESU26" }, "body": { "isym": "ESU26", "trxc": "T31", "exid": "E01", "dven": "", "date": "20260710", "time": "103647665751", "mseq": "", "trdt": "20260710", "trtm": "103647665630", "nbid1": "17", "vbid1": "21", "pbid1": "7579.25", "nask1": "12", "vask1": "14", "pask1": "7579.75", "nbid2": "10", "vbid2": "12", "pbid2": "7579.00", "nask2": "11", "vask2": "26", "pask2": "7580.00", "nbid3": "11", "vbid3": "15", "pbid3": "7578.75", "nask3": "11", "vask3": "13", "pask3": "7580.25", "nbid4": "9", "vbid4": "12", "pbid4": "7578.50", "nask4": "13", "vask4": "20", "pask4": "7580.50", "nbid5": "17", "vbid5": "24", "pbid5": "7578.25", "nask5": "11", "vask5": "17", "pask5": "7580.75", "nbid": "64", "vbid": "84", "nask": "58", "vask": "90" } } }, { "name": "해외선물옵션 실시간체결가", "sheet": "API_해외_파생_실시간_체결가", "tr_cd": "FC", "tr_key": { "name": "isym", "kor": "종목코드", "length": "32" }, "fields": [ "isym", "trxc", "exid", "dven", "date", "time", "mseq", "trdt", "trtm", "last", "tqty", "tvol", "open", "high", "low", "sign", "diff", "rate", "bsnsd" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "FC", "tr_key": "ESU26" } }, "push_example": { "header": { "tr_cd": "FC", "tr_key": "ESU26" }, "body": { "isym": "ESU26", "trxc": "T21", "exid": "E01", "dven": "0", "date": "20260710", "time": "115832830451", "mseq": "", "trdt": "20260710", "trtm": "115832830214", "last": "7585.00", "tqty": "1", "tvol": "37592", "open": "7587.25", "high": "7591.75", "low": "7574.50", "sign": "5", "diff": "-3.75", "rate": "-0.05", "bsnsd": "20260707" } }, "description": "유료시세 사용 약정 고객만 이용 가능합니다." }, { "name": "해외선물옵션 지연체결가", "sheet": "API_해외_파생_실시간_체결가(지연)", "tr_cd": "fc", "tr_key": { "name": "isym", "kor": "종목코드", "length": "32" }, "fields": [ "isym", "trxc", "exid", "dven", "date", "time", "mseq", "trdt", "trtm", "last", "tqty", "tvol", "open", "high", "low", "sign", "diff", "rate", "bsnsd" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "fc", "tr_key": "ESU26" } }, "push_example": { "header": { "tr_cd": "fc", "tr_key": "ESU26" }, "body": { "isym": "ESU26", "trxc": "T21", "exid": "E01", "dven": "0", "date": "20260710", "time": "115832830451", "mseq": "", "trdt": "20260710", "trtm": "115832830214", "last": "7585.00", "tqty": "1", "tvol": "37592", "open": "7587.25", "high": "7591.75", "low": "7574.50", "sign": "5", "diff": "-3.75", "rate": "-0.05", "bsnsd": "20260707" } } }, { "name": "해외선물옵션 실시간체결통보", "sheet": "API_해외_파생_실시간_체결통보", "tr_cd": "dk", "tr_key": { "name": "userid", "kor": "사용자ID", "length": "8" }, "fields": [ "userid", "pdt_dit_cd", "act_no", "orr_sno", "iem_cd", "s_iem_cd", "sby_dit_cd", "cns_qty", "cns_pr", "cns_tm", "cor_can_dit_cd", "ost_rjt_cfc", "cns_no", "cur_cd", "orr_dt", "iem_nm", "indicator", "apm_lqd_dit_cd", "apm_lqd_cns_pr", "act_amn_tab_cd", "filler" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "dk", "tr_key": "" } }, "push_example": { "header": { "tr_cd": "dk" }, "body": { "userid": "ID", "pdt_dit_cd": "", "act_no": "ACCOUNT NUMBER", "orr_sno": "26070700000015", "iem_cd": "NQU26", "s_iem_cd": "FDF000001148", "sby_dit_cd": "1", "cns_qty": "0000000001", "cns_pr": "29742.00", "cns_tm": "143305", "cor_can_dit_cd": "0", "ost_rjt_cfc": "0", "cns_no": "202607070000000005", "cur_cd": "USD", "orr_dt": "20260707", "iem_nm": "E-mini NASDAQ-100 -2609", "indicator": "2", "apm_lqd_dit_cd": "0", "apm_lqd_cns_pr": "0.00", "act_amn_tab_cd": "0202", "filler": "" } }, "description": "해외파생 주문 체결 시 실시간으로 수신됩니다." }, { "name": "해외선물옵션 실시간주문내역통보", "sheet": "API_해외_파생_실시간_주문내역통보", "tr_cd": "dj", "tr_key": { "name": "userid", "kor": "사용자ID", "length": "8" }, "fields": [ "userid", "pdt_dit_cd", "act_no", "orr_sno", "org_orr_no", "ost_orr_dit", "iem_cd", "s_iem_cd", "iem_nm", "sby_dit_cd", "nmn_pr_tp_cd", "orr_qty", "orr_pr", "pcs_dit_cd", "cuc_mdi_cd", "ost_orr_cnd", "ost_grp_no", "orr_tm", "cur_cd", "indicator", "fdv_stop_pr", "end_dt", "apm_lqd_dit_cd", "apm_lqd_cns_pr", "act_amn_tab_cd", "filler" ], "subscribe_example": "{\n \"header\": {\n \"token\": \"TOKEN\",\n \"tr_type\": \"1\"\n },\n \"body\": {\n \"tr_cd\": \"dj\"\",\n \"tr_key\": \"\"\n }\n}", "push_example": { "header": { "tr_cd": "dj" }, "body": { "userid": "ID", "pdt_dit_cd": "", "act_no": "ACCOUNT NUMBER", "orr_sno": "26070700000015", "org_orr_no": "", "ost_orr_dit": "11", "iem_cd": "NQU26", "s_iem_cd": "FDF000001148", "iem_nm": "E-mini NASDAQ-100 -2609", "sby_dit_cd": "1", "nmn_pr_tp_cd": "2", "orr_qty": "0000000001", "orr_pr": "29611.00", "pcs_dit_cd": "00", "cuc_mdi_cd": "F5", "ost_orr_cnd": "", "ost_grp_no": "", "orr_tm": "143305", "cur_cd": "USD", "indicator": "2", "fdv_stop_pr": "0.00", "end_dt": "", "apm_lqd_dit_cd": "0", "apm_lqd_cns_pr": "0.00", "act_amn_tab_cd": "0202", "filler": "" } }, "description": "해외파생 주문 접수 시 실시간으로 수신됩니다." } ] }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "POST /oauth2/token 으로 발급받은 access token" }, "ClientId": { "type": "apiKey", "in": "header", "name": "x-client-id" }, "ClientSecret": { "type": "apiKey", "in": "header", "name": "x-client-secret" } }, "parameters": { "CtsHeader": { "name": "cts", "in": "header", "required": false, "schema": { "type": "string" }, "description": "연속조회 키. 목록 조회 응답 연속키를 다음 요청 헤더에 세팅" } }, "schemas": { "Message": { "type": "object", "description": "공통 응답 메시지 봉투", "properties": { "msg_code": { "type": "string" }, "usr_msg": { "type": "string" }, "msg_lv_code": { "type": "string" }, "dvlp_msg_yn": { "type": "string" }, "svc_nm": { "type": "string" }, "func_nm": { "type": "string" }, "line_no": { "type": "string" }, "dvlp_msg": { "type": "string" } } } } }, "x-instruments": { "available": true, "note": "이 자산군의 정적 종목정보는 종목마스터 파일(.mst)로 제공됩니다. 전체 정의는 common/openapi.json 의 x-instruments 참조.", "files": [ "해외파생 마스터 — 전체 목록은 headers 참조" ], "download_url_pattern": "https://www.nhplug.com/instruments/<파일명>.mst", "auth_required": false, "format_key_points": [ "CP949", "고정길이 레코드 + LF(0x0A) 종단", "바이너리 모드(\"rb\") 필수", "파일크기 % 레코드크기 == 0 검증" ], "struct_definition_url_pattern": "https://www.nhplug.com/instruments/<파일명>.h", "struct_definition_note": "마스터 파일(.mst)과 1:1 대응하는 .h 파일에 오프셋·길이·코드값·레코드크기가 정의되어 있습니다. 인증 불필요." } }