{ "openapi": "3.0.3", "info": { "title": "NH투자증권 Open API — 국내파생 (KR Derivatives)", "version": "v1", "description": "NH투자증권 Open API 중 **국내파생 (KR 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:7070" } }, "tags": [ { "name": "주문 (Order)" }, { "name": "조회 (Inquiry)" }, { "name": "시세 (Market Data)" }, { "name": "실시간 (Realtime)" } ], "paths": { "/krfuture/order/v1/day": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krfutureOrderDay", "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 계좌만 유효)" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 1.매도 2.매수" }, "iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3" }, "fno_nmn_pr_tp_cd": { "type": "string", "description": "선물옵션호가유형코드 / 길이 1 / L.지정가 M.시장가 B.최유리지정가 C.조건부지정가" }, "frs_orr_cnd_dit_cd": { "type": "string", "description": "선물주문조건구분코드 / 길이 1 / 0.일반주문 1.일부충족(IOC) 2.전량충족(FOK)" } }, "required": [ "act_no", "sby_dit_cd", "iem_cd", "orr_qty" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "ost_pcs_rlt": { "type": "integer", "format": "int64", "description": "처리결과 / 길이 4" }, "msg_cd": { "type": "string", "description": "메시지코드 / 길이 5" }, "orr_no": { "type": "integer", "format": "int64", "description": "주문번호 / 길이 10" }, "orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문가능현금 / 길이 18" }, "orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문가능총액 / 길이 18" }, "dsg_csh_isf_amt": { "type": "integer", "format": "int64", "description": "예탁현금부족금액 / 길이 18" }, "dsg_tal_isf_amt": { "type": "integer", "format": "int64", "description": "예탁총액부족금액 / 길이 18" }, "orr_pbl_qty": { "type": "string", "description": "주문가능수량 / 길이 10" }, "act_fnm": { "type": "string", "description": "계좌성명 / 길이 40" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "frs_fnd_orr_no": { "type": "string", "description": "선물펀드주문번호 / 길이 10" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "ost_pwd": { "type": "string", "description": "비밀번호 / 길이 8" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "orr_qty": { "type": "string", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "string", "description": "주문가격 / 길이 15.3" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 40" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/order/v1/night": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krfutureOrderNight", "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 계좌만 유효)" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 1.매도 2.매수" }, "iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3" }, "fno_nmn_pr_tp_cd": { "type": "string", "description": "선물옵션호가유형코드 / 길이 1 / L.지정가 M.시장가 B.최유리지정가 C.조건부지정가" }, "frs_orr_cnd_dit_cd": { "type": "string", "description": "선물주문조건구분코드 / 길이 1 / 0.일반주문 1.일부충족(IOC) 2.전량충족(FOK)" } }, "required": [ "act_no", "sby_dit_cd", "iem_cd", "orr_qty" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "ost_pcs_rlt": { "type": "integer", "format": "int64", "description": "처리결과 / 길이 4" }, "msg_cd": { "type": "string", "description": "메시지코드 / 길이 5" }, "orr_no": { "type": "integer", "format": "int64", "description": "주문번호 / 길이 10" }, "orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문가능현금 / 길이 18" }, "orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문가능총액 / 길이 18" }, "dsg_csh_isf_amt": { "type": "integer", "format": "int64", "description": "예탁현금부족금액 / 길이 18" }, "dsg_tal_isf_amt": { "type": "integer", "format": "int64", "description": "예탁총액부족금액 / 길이 18" }, "orr_pbl_qty": { "type": "string", "description": "주문가능수량 / 길이 10" }, "act_fnm": { "type": "string", "description": "계좌성명 / 길이 40" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "frs_fnd_orr_no": { "type": "string", "description": "선물펀드주문번호 / 길이 10" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "ost_pwd": { "type": "string", "description": "비밀번호 / 길이 8" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "orr_qty": { "type": "string", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "string", "description": "주문가격 / 길이 15.3" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 40" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/order/v1/dayModify": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krfutureOrderDayModify", "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": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3" }, "fno_nmn_pr_tp_cd": { "type": "string", "description": "선물옵션호가유형코드 / 길이 1 / L.지정가 M.시장가 B.최유리지정가 C.조건부지정가" }, "frs_orr_cnd_dit_cd": { "type": "string", "description": "선물주문조건구분코드 / 길이 1 / 0.일반주문 1.일부충족(IOC) 2.전량충족(FOK)" }, "org_orr_no": { "type": "integer", "format": "int64", "description": "원주문번호 / 길이 10 / 정정/취소 시 사용" } }, "required": [ "act_no", "iem_cd", "orr_qty", "orr_pr", "fno_nmn_pr_tp_cd", "frs_orr_cnd_dit_cd", "org_orr_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "msg_cd": { "type": "string", "description": "메시지코드 / 길이 5" }, "orr_no": { "type": "integer", "format": "int64", "description": "주문번호 / 길이 10" }, "orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문가능현금 / 길이 18" }, "orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문가능총액 / 길이 18" }, "dsg_csh_isf_amt": { "type": "integer", "format": "int64", "description": "예탁현금부족금액 / 길이 18" }, "dsg_tal_isf_amt": { "type": "integer", "format": "int64", "description": "예탁총액부족금액 / 길이 18" }, "orr_pbl_qty": { "type": "string", "description": "주문가능수량 / 길이 10" }, "act_fnm": { "type": "string", "description": "계좌성명 / 길이 40" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "frs_fnd_orr_no": { "type": "string", "description": "선물펀드주문번호 / 길이 10" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "ost_pwd": { "type": "string", "description": "비밀번호 / 길이 8" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "orr_qty": { "type": "string", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "string", "description": "주문가격 / 길이 15.3" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 40" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/order/v1/nightModify": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krfutureOrderNightModify", "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": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3" }, "fno_nmn_pr_tp_cd": { "type": "string", "description": "선물옵션호가유형코드 / 길이 1 / L.지정가 M.시장가 B.최유리지정가 C.조건부지정가" }, "frs_orr_cnd_dit_cd": { "type": "string", "description": "선물주문조건구분코드 / 길이 1 / 0.일반주문 1.일부충족(IOC) 2.전량충족(FOK)" }, "org_orr_no": { "type": "integer", "format": "int64", "description": "원주문번호 / 길이 10 / 정정/취소 시 사용" } }, "required": [ "act_no", "iem_cd", "orr_qty", "orr_pr", "fno_nmn_pr_tp_cd", "frs_orr_cnd_dit_cd", "org_orr_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "msg_cd": { "type": "string", "description": "메시지코드 / 길이 5" }, "orr_no": { "type": "integer", "format": "int64", "description": "주문번호 / 길이 10" }, "orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문가능현금 / 길이 18" }, "orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문가능총액 / 길이 18" }, "dsg_csh_isf_amt": { "type": "integer", "format": "int64", "description": "예탁현금부족금액 / 길이 18" }, "dsg_tal_isf_amt": { "type": "integer", "format": "int64", "description": "예탁총액부족금액 / 길이 18" }, "orr_pbl_qty": { "type": "string", "description": "주문가능수량 / 길이 10" }, "act_fnm": { "type": "string", "description": "계좌성명 / 길이 40" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "frs_fnd_orr_no": { "type": "string", "description": "선물펀드주문번호 / 길이 10" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "ost_pwd": { "type": "string", "description": "비밀번호 / 길이 8" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "orr_qty": { "type": "string", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "string", "description": "주문가격 / 길이 15.3" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 40" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/order/v1/dayCancel": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krfutureOrderDayCancel", "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": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "org_orr_no": { "type": "integer", "format": "int64", "description": "원주문번호 / 길이 10 / 정정/취소 시 사용" } }, "required": [ "act_no", "iem_cd", "org_orr_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "msg_cd": { "type": "string", "description": "메시지코드 / 길이 5" }, "orr_no": { "type": "integer", "format": "int64", "description": "주문번호 / 길이 10" }, "orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문가능현금 / 길이 18" }, "orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문가능총액 / 길이 18" }, "dsg_csh_isf_amt": { "type": "integer", "format": "int64", "description": "예탁현금부족금액 / 길이 18" }, "dsg_tal_isf_amt": { "type": "integer", "format": "int64", "description": "예탁총액부족금액 / 길이 18" }, "orr_pbl_qty": { "type": "string", "description": "주문가능수량 / 길이 10" }, "act_fnm": { "type": "string", "description": "계좌성명 / 길이 40" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "frs_fnd_orr_no": { "type": "string", "description": "선물펀드주문번호 / 길이 10" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "ost_pwd": { "type": "string", "description": "비밀번호 / 길이 8" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "orr_qty": { "type": "string", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "string", "description": "주문가격 / 길이 15.3" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 40" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/order/v1/nightCancel": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krfutureOrderNightCancel", "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": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "org_orr_no": { "type": "integer", "format": "int64", "description": "원주문번호 / 길이 10 / 정정/취소 시 사용" } }, "required": [ "act_no", "iem_cd", "org_orr_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "msg_cd": { "type": "string", "description": "메시지코드 / 길이 5" }, "orr_no": { "type": "integer", "format": "int64", "description": "주문번호 / 길이 10" }, "orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문가능현금 / 길이 18" }, "orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문가능총액 / 길이 18" }, "dsg_csh_isf_amt": { "type": "integer", "format": "int64", "description": "예탁현금부족금액 / 길이 18" }, "dsg_tal_isf_amt": { "type": "integer", "format": "int64", "description": "예탁총액부족금액 / 길이 18" }, "orr_pbl_qty": { "type": "string", "description": "주문가능수량 / 길이 10" }, "act_fnm": { "type": "string", "description": "계좌성명 / 길이 40" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "frs_fnd_orr_no": { "type": "string", "description": "선물펀드주문번호 / 길이 10" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "ost_pwd": { "type": "string", "description": "비밀번호 / 길이 8" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "orr_qty": { "type": "string", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "string", "description": "주문가격 / 길이 15.3" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 40" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/inquiry/v1/orderExecutionHistory": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryOrderExecutionHistory", "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 계좌만 유효)" }, "orr_dt": { "type": "string", "description": "시작주문일자 / 길이 8 / YYYYMMDD" }, "cns_dit_cd": { "type": "string", "description": "체결구분코드 / 길이 1 / 0.전체 1.체결 2.미체결" }, "sot_dit": { "type": "string", "description": "정렬구분 / 길이 1 / 1.주문번호역순 2.주문번호순" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 0.전체 1.매도 2.매수" }, "iem_dit": { "type": "string", "description": "종목구분 / 길이 1 / 9.전체 1.코스피200선물 2.코스피200옵션 7.주식선물 8.주식옵션 A.변동지수선물 B.섹터지수선물 D.미니코스피200선물 E.미니코스피200옵션 F.코스닥150선물 G.유로스톡스50선물 K.KRX300선물 L.코스닥150옵션 N.위클리옵션 P.코스닥글로벌 Q.코리아밸류업 R.코스닥150위클리옵션" } }, "required": [ "act_no", "orr_dt", "cns_dit_cd", "sot_dit", "sby_dit_cd", "iem_dit" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "fno_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션주문번호 / 길이 10" }, "fno_org_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션원주문번호 / 길이 10" }, "frs_ctc_no": { "type": "string", "description": "선물약정번호 / 길이 9" }, "frs_orr_cnd_dit_cd": { "type": "string", "description": "선물주문조건구분코드 / 길이 1" }, "orr_cnd_dit_cd_nm": { "type": "string", "description": "주문조건구분코드명 / 길이 60" }, "nmn_pr_tp_cd_nm": { "type": "string", "description": "호가유형코드명 / 길이 30" }, "fno_nmn_pr_tp_cd": { "type": "string", "description": "선물옵션호가유형코드 / 길이 1" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.2" }, "frs_cns_qty": { "type": "integer", "format": "int64", "description": "선물체결수량 / 길이 18" }, "fno_cns_pr": { "type": "number", "format": "double", "description": "선물옵션체결가격 / 길이 15.2" }, "ny_cns_qty": { "type": "integer", "format": "int64", "description": "미체결수량 / 길이 18" }, "pcs_rlt_msg_cd": { "type": "string", "description": "처리결과메시지코드 / 길이 4" }, "cns_pcs_hur": { "type": "string", "description": "체결처리시간 / 길이 9" }, "orr_rtn_hur": { "type": "string", "description": "주문접수시간 / 길이 9" }, "orr_pcs_hur": { "type": "string", "description": "주문처리시간 / 길이 9" }, "orr_cfm_hur": { "type": "string", "description": "주문확인시간 / 길이 9" }, "ost_orr_cnd": { "type": "string", "description": "주문조건 / 길이 1" }, "sby_dit_nm": { "type": "string", "description": "매매구분명 / 길이 4" }, "cor_can_dit_cd": { "type": "string", "description": "정정취소구분코드 / 길이 1" }, "orr_dt": { "type": "string", "description": "주문일자 / 길이 8" }, "cuc_mdi_cd": { "type": "string", "description": "통신매체코드 / 길이 2" }, "cuc_mdi_cd_nm": { "type": "string", "description": "통신매체코드명 / 길이 50" }, "fno_rjt_rsn_cd": { "type": "string", "description": "선물옵션거부사유코드 / 길이 4" }, "orr_rjt_rsn_cd_nm": { "type": "string", "description": "주문거부사유코드명 / 길이 50" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/balance": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryBalance", "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 계좌만 유효)" } }, "required": [ "act_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "sby_dit_nm": { "type": "string", "description": "매매구분명 / 길이 4" }, "tdy_ny_stl_qty": { "type": "string", "description": "금일미결제수량 / 길이 18" }, "byn_cns_qty": { "type": "integer", "format": "int64", "description": "매수체결수량 / 길이 18" }, "sll_cns_qty": { "type": "integer", "format": "int64", "description": "매도체결수량 / 길이 18" }, "ny_cns_byn_orr_qty": { "type": "string", "description": "미체결매수주문수량 / 길이 18" }, "ny_cns_sll_orr_qty": { "type": "string", "description": "미체결매도주문수량 / 길이 18" }, "avg_pr": { "type": "number", "format": "double", "description": "평균가격 / 길이 15.3" }, "pti_uit_pr": { "type": "number", "format": "double", "description": "진입단가 / 길이 15.3" }, "now_pr": { "type": "number", "format": "double", "description": "현재가격 / 길이 15.3" }, "tdt_cns_byn_avg_pr": { "type": "string", "description": "당일체결매수평균가격 / 길이 15.3" }, "tdt_cns_sll_avg_pr": { "type": "string", "description": "당일체결매도평균가격 / 길이 15.3" }, "eal_pls_amt": { "type": "integer", "format": "int64", "description": "평가손익금액 / 길이 18" }, "frs_pti_eal_pls": { "type": "integer", "format": "int64", "description": "선물진입평가손익 / 길이 15" }, "sby_pls_amt": { "type": "integer", "format": "int64", "description": "매매손익금액 / 길이 18" }, "frs_pti_sby_pls": { "type": "integer", "format": "int64", "description": "선물진입매매손익 / 길이 15" }, "tot_pls_sum": { "type": "integer", "format": "int64", "description": "총손익합계 / 길이 15" }, "lqd_qty": { "type": "string", "description": "청산수량 / 길이 15" }, "lqd_pbl_qty": { "type": "integer", "format": "int64", "description": "청산가능수량 / 길이 15" }, "opt_eal_amt": { "type": "integer", "format": "int64", "description": "옵션평가금액 / 길이 18" }, "fno_fee": { "type": "integer", "format": "int64", "description": "선물옵션수수료 / 길이 18" }, "byn_cns_amt": { "type": "integer", "format": "int64", "description": "매수체결금액 / 길이 18" }, "sll_cns_amt": { "type": "integer", "format": "int64", "description": "매도체결금액 / 길이 18" }, "abk_amt": { "type": "integer", "format": "int64", "description": "장부금액 / 길이 18" }, "pti_abk_amt": { "type": "integer", "format": "int64", "description": "진입장부금액 / 길이 15" }, "sby_pls_rt": { "type": "number", "format": "double", "description": "매매손익율 / 길이 10.3" }, "pti_eal_pft_rt": { "type": "number", "format": "double", "description": "진입평가수익율 / 길이 5.2" }, "pti_eal_pls": { "type": "integer", "format": "int64", "description": "진입평가손익 / 길이 15" }, "frs_fee": { "type": "integer", "format": "int64", "description": "선물수수료 / 길이 18" }, "pti_fee": { "type": "integer", "format": "int64", "description": "진입수수료 / 길이 18" }, "lqd_fee": { "type": "integer", "format": "int64", "description": "청산수수료 / 길이 18" }, "sby_dit_nm2": { "type": "string", "description": "매매구분명2 / 길이 4" }, "bf_dd_ny_stl_qty": { "type": "integer", "format": "int64", "description": "전일미결제수량 / 길이 18" }, "bnc_ind_qty": { "type": "integer", "format": "int64", "description": "잔고증감수량 / 길이 15" } } } }, "Output_1": { "type": "object", "properties": { "ral_pls_sum": { "type": "integer", "format": "int64", "description": "실손익합계 / 길이 15" }, "tot_pls_sum": { "type": "integer", "format": "int64", "description": "총손익합계 / 길이 15" }, "sby_pls_sum": { "type": "integer", "format": "int64", "description": "매매손익합계 / 길이 18" }, "tot_eal_pls": { "type": "integer", "format": "int64", "description": "총평가손익 / 길이 15" }, "pti_tot_pls_sum": { "type": "integer", "format": "int64", "description": "진입총손익합계 / 길이 15" }, "pti_sby_pls_sum": { "type": "integer", "format": "int64", "description": "진입매매손익합계 / 길이 15" }, "pti_eal_pls_sum": { "type": "integer", "format": "int64", "description": "진입평가손익합계 / 길이 15" }, "pti_eal_pls": { "type": "integer", "format": "int64", "description": "진입평가손익 / 길이 15" }, "ral_frs_pls": { "type": "integer", "format": "int64", "description": "실선물손익 / 길이 15" }, "frs_tot_pls": { "type": "integer", "format": "int64", "description": "선물총손익 / 길이 15" }, "frs_sby_pls": { "type": "integer", "format": "int64", "description": "선물매매손익 / 길이 15" }, "frs_eal_pls": { "type": "integer", "format": "int64", "description": "선물평가손익 / 길이 15" }, "pti_frs_eal_pls": { "type": "integer", "format": "int64", "description": "진입선물평가손익 / 길이 15" }, "frs_pti_sby_pls": { "type": "integer", "format": "int64", "description": "선물진입매매손익 / 길이 15" }, "frs_pti_eal_pls": { "type": "integer", "format": "int64", "description": "선물진입평가손익 / 길이 15" }, "ral_opt_pls": { "type": "integer", "format": "int64", "description": "실옵션손익 / 길이 15" }, "opt_tot_pls": { "type": "integer", "format": "int64", "description": "옵션총손익 / 길이 15" }, "opt_sby_pls": { "type": "integer", "format": "int64", "description": "옵션매매손익 / 길이 15" }, "opt_eal_pls": { "type": "integer", "format": "int64", "description": "옵션평가손익 / 길이 15" }, "idx_opt_pls_amt": { "type": "integer", "format": "int64", "description": "지수옵션손익금액 / 길이 18" }, "pti_sby_pls": { "type": "integer", "format": "int64", "description": "진입매매손익 / 길이 15" }, "eal_pls_amt": { "type": "integer", "format": "int64", "description": "평가손익금액 / 길이 18" }, "fno_eal_amt": { "type": "integer", "format": "int64", "description": "선물옵션평가금액 / 길이 18" }, "byn_cst_sum1": { "type": "integer", "format": "int64", "description": "매수대금합계1 / 길이 18" }, "sum_qty1": { "type": "integer", "format": "int64", "description": "합계수량1 / 길이 18" }, "sll_cst_sum1": { "type": "integer", "format": "int64", "description": "매도대금합계1 / 길이 18" }, "sum_qty2": { "type": "integer", "format": "int64", "description": "합계수량2 / 길이 18" }, "fee_sum": { "type": "integer", "format": "int64", "description": "수수료합계 / 길이 18" }, "fee_sum_amt": { "type": "integer", "format": "int64", "description": "수수료합계금액 / 길이 18" }, "frs_byn_amt": { "type": "integer", "format": "int64", "description": "선물매수금액 / 길이 18" }, "frs_qty": { "type": "string", "description": "선물수량 / 길이 18" }, "frs_sll_amt": { "type": "integer", "format": "int64", "description": "선물매도금액 / 길이 18" }, "qty_sum": { "type": "integer", "format": "int64", "description": "수량합계 / 길이 18" }, "frs_fee": { "type": "integer", "format": "int64", "description": "선물수수료 / 길이 18" }, "opt_byn_amt": { "type": "integer", "format": "int64", "description": "옵션매수금액 / 길이 18" }, "sby_qty": { "type": "string", "description": "매매수량 / 길이 18" }, "opt_sll_amt": { "type": "integer", "format": "int64", "description": "옵션매도금액 / 길이 18" }, "sby_qty1": { "type": "string", "description": "매매수량1 / 길이 18" }, "fno_fee": { "type": "integer", "format": "int64", "description": "선물옵션수수료 / 길이 18" }, "dsg_tal": { "type": "integer", "format": "int64", "description": "예탁총액 / 길이 18" }, "orr_pbl_amt_tal": { "type": "integer", "format": "int64", "description": "주문가능금액총액 / 길이 18" }, "brg_wtm_tal": { "type": "integer", "format": "int64", "description": "위탁증거금총액 / 길이 18" }, "nas_tal": { "type": "integer", "format": "int64", "description": "순자산총액 / 길이 18" }, "tot_eal_amt": { "type": "integer", "format": "int64", "description": "총평가금액 / 길이 18" }, "dsg_csh": { "type": "integer", "format": "int64", "description": "예탁현금 / 길이 18" }, "csh_dga": { "type": "integer", "format": "int64", "description": "현금예탁금 / 길이 18" }, "orr_pbl_amt_csh": { "type": "integer", "format": "int64", "description": "주문가능금액현금 / 길이 18" }, "brg_wtm_csh": { "type": "integer", "format": "int64", "description": "위탁증거금현금 / 길이 18" }, "nas_csh": { "type": "integer", "format": "int64", "description": "순자산현금 / 길이 18" }, "eal_amt_sum": { "type": "integer", "format": "int64", "description": "평가금액합계 / 길이 18" }, "dsg_sba_amt": { "type": "integer", "format": "int64", "description": "예탁대용금액 / 길이 18" }, "tot_aet_amt": { "type": "integer", "format": "int64", "description": "총자산금액 / 길이 18" }, "tot_byn_amt": { "type": "integer", "format": "int64", "description": "총매수금액 / 길이 18" }, "eal_amt": { "type": "integer", "format": "int64", "description": "평가금액 / 길이 18" }, "eal_pls1": { "type": "integer", "format": "int64", "description": "평가손익1 / 길이 18" }, "xcl_dpa_sum": { "type": "integer", "format": "int64", "description": "정산차금합계 / 길이 15" }, "lst_dfa_amt": { "type": "integer", "format": "int64", "description": "최종차액금액 / 길이 18" }, "opt_eal_pls_amt": { "type": "integer", "format": "int64", "description": "옵션평가손익금액 / 길이 18" }, "opt_aloc_amt": { "type": "integer", "format": "int64", "description": "옵션배정금액 / 길이 18" }, "opt_erc_amt": { "type": "integer", "format": "int64", "description": "옵션행사금액 / 길이 18" }, "bf_dd_sba_sll_amt": { "type": "integer", "format": "int64", "description": "전일대용매도금액 / 길이 18" }, "tdt_sba_sll_amt": { "type": "integer", "format": "int64", "description": "당일대용매도금액 / 길이 18" }, "drn_pbl_amt": { "type": "integer", "format": "int64", "description": "출금가능금액 / 길이 18" }, "amn_emp_fnm": { "type": "string", "description": "관리사원성명 / 길이 40" }, "trd_act_nm": { "type": "string", "description": "거래계좌명 / 길이 20" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/orderable": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryOrderable", "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 계좌만 유효)" }, "ost_sby_dit": { "type": "string", "description": "매매구분 / 길이 1 / 1.매도 2.매수" }, "iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_uit_pr": { "type": "number", "format": "double", "description": "주문단가 / 길이 15.3" }, "ost_orr_tp": { "type": "string", "description": "주문유형 / 길이 1 / L.지정가 M.시장가 B.최유리지정가 C.조건부지정가" } }, "required": [ "act_no", "ost_sby_dit", "iem_cd", "ost_orr_tp" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "tot_eal_amt": { "type": "string", "description": "총평가금액 / 길이 18" }, "dsg_tal": { "type": "string", "description": "예탁총액 / 길이 18" }, "dsg_csh": { "type": "string", "description": "예탁현금 / 길이 18" }, "dsg_sba_amt": { "type": "string", "description": "예탁대용금액 / 길이 18" }, "csh_rba": { "type": "string", "description": "현금미수금 / 길이 18" }, "brg_wtm_tal": { "type": "string", "description": "위탁증거금총액 / 길이 18" }, "brg_wtm_csh": { "type": "string", "description": "위탁증거금현금 / 길이 18" }, "orr_pbl_tal": { "type": "string", "description": "주문가능총액 / 길이 18" }, "orr_pbl_csh": { "type": "string", "description": "주문가능현금 / 길이 18" }, "frs_xcl_dpa": { "type": "string", "description": "선물정산차금 / 길이 18" }, "frs_tdt_dpa": { "type": "string", "description": "선물당일차금 / 길이 18" }, "frs_rwl_dpa": { "type": "string", "description": "선물갱신차금 / 길이 18" }, "opt_sll_amt": { "type": "string", "description": "옵션매도금액 / 길이 18" }, "opt_byn_amt": { "type": "string", "description": "옵션매수금액 / 길이 18" }, "opt_eal_amt": { "type": "string", "description": "옵션평가금액 / 길이 18" }, "ned_dsg_tal": { "type": "string", "description": "필요예탁총액 / 길이 18" }, "ned_dsg_csh": { "type": "string", "description": "필요예탁현금 / 길이 18" }, "wtm_lvy_qty": { "type": "string", "description": "증거금징수수량 / 길이 18" }, "wtm_iny_qty": { "type": "string", "description": "증거금면제수량 / 길이 18" }, "wtm_lvy_uit_pr": { "type": "string", "description": "증거금징수단가 / 길이 18.3" }, "anw_qty": { "type": "integer", "format": "int64", "description": "신규수량 / 길이 18" }, "lqd_pbl_qty": { "type": "integer", "format": "int64", "description": "청산가능수량 / 길이 18" }, "all_orr_qty": { "type": "integer", "format": "int64", "description": "전체주문수량 / 길이 18" }, "ftn_aet_iem_end_pr": { "type": "string", "description": "기초자산종목종가 / 길이 15.3" }, "nas_rt": { "type": "string", "description": "순자산비율 / 길이 11.8" }, "sum_stl_amt": { "type": "string", "description": "합계결제금액 / 길이 18" }, "max_pbl_bse_qty": { "type": "string", "description": "최대가능기준수량 / 길이 18" }, "copt_sll_ny_stl_qty": { "type": "integer", "format": "int64", "description": "콜옵션매도미결제수량 / 길이 18" }, "popt_sll_ny_stl_qty": { "type": "integer", "format": "int64", "description": "풋옵션매도미결제수량 / 길이 18" }, "krx1_cal_sll_qty": { "type": "integer", "format": "int64", "description": "KRX_콜매도수량 / 길이 12" }, "krx1_popt_sll_qty": { "type": "integer", "format": "int64", "description": "KRX_풋매도수량 / 길이 12" }, "orr_pbl_qty": { "type": "integer", "format": "int64", "description": "주문가능수량 / 길이 10" }, "orr_pbl_qty1": { "type": "integer", "format": "int64", "description": "주문가능수량1 / 길이 18" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_amt": { "type": "string", "description": "주문금액 / 길이 18" }, "anw_orr_qty": { "type": "integer", "format": "int64", "description": "신규주문수량 / 길이 18" }, "orr_af_dsg_tal": { "type": "string", "description": "주문후예탁총액 / 길이 18" }, "orr_af_dsg_csh": { "type": "string", "description": "주문후예탁현금 / 길이 18" }, "orr_af_brg_wtm_tal": { "type": "string", "description": "주문후위탁증거금총액 / 길이 18" }, "orr_af_brg_wtm_csh": { "type": "string", "description": "주문후위탁증거금현금 / 길이 18" }, "orr_af_orr_pbl_tal": { "type": "string", "description": "주문후주문가능총액 / 길이 18" }, "orr_af_orr_pbl_csh": { "type": "string", "description": "주문후주문가능현금 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/margin": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryMargin", "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 계좌만 유효)" } }, "required": [ "act_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "dsg_csh": { "type": "integer", "format": "int64", "description": "예탁현금 / 길이 18" }, "nxt_dd_amp_dsg_csh": { "type": "integer", "format": "int64", "description": "익일추정예탁현금 / 길이 18" }, "nxt2_dd_amp_dsg_csh": { "type": "integer", "format": "int64", "description": "익익일추정예탁현금 / 길이 18" }, "dsg_sba_amt": { "type": "integer", "format": "int64", "description": "예탁대용금액 / 길이 18" }, "dsg_tal": { "type": "integer", "format": "int64", "description": "예탁총액 / 길이 18" }, "brg_wtm_csh": { "type": "integer", "format": "int64", "description": "위탁증거금현금 / 길이 18" }, "brg_wtm_tal": { "type": "integer", "format": "int64", "description": "위탁증거금총액 / 길이 18" }, "orr_pbl_amt_csh": { "type": "integer", "format": "int64", "description": "주문가능금액현금 / 길이 18" }, "orr_pbl_amt_tal": { "type": "integer", "format": "int64", "description": "주문가능금액총액 / 길이 18" }, "wrw_pbl_amt_csh": { "type": "integer", "format": "int64", "description": "인출가능금액현금 / 길이 18" }, "mnc_wtm_csh": { "type": "integer", "format": "int64", "description": "유지증거금현금 / 길이 18" }, "mnc_wtm_tal": { "type": "integer", "format": "int64", "description": "유지증거금총액 / 길이 18" }, "apd_wtm_csh": { "type": "integer", "format": "int64", "description": "추가증거금현금 / 길이 18" }, "apd_wtm_tal": { "type": "integer", "format": "int64", "description": "추가증거금총액 / 길이 18" }, "orr_wtm_tal": { "type": "integer", "format": "int64", "description": "주문증거금총액 / 길이 18" }, "orr_wtm_csh": { "type": "integer", "format": "int64", "description": "주문증거금현금 / 길이 18" }, "opt_pr_wtm": { "type": "integer", "format": "int64", "description": "옵션가격증거금 / 길이 18" }, "rrv_wtm": { "type": "integer", "format": "int64", "description": "예비증거금 / 길이 18" }, "sby_pls_amt": { "type": "integer", "format": "int64", "description": "매매손익금액 / 길이 18" }, "opt_byn_cst": { "type": "integer", "format": "int64", "description": "옵션매수대금 / 길이 18" }, "opt_sll_cst": { "type": "integer", "format": "int64", "description": "옵션매도대금 / 길이 18" }, "frs_xcl_dpa": { "type": "integer", "format": "int64", "description": "선물정산차금 / 길이 18" }, "frs_lst_dpa": { "type": "integer", "format": "int64", "description": "선물최종차금 / 길이 18" }, "rba": { "type": "integer", "format": "int64", "description": "미수금 / 길이 18" }, "rvb_fee": { "type": "integer", "format": "int64", "description": "미수수수료 / 길이 18" }, "rvb_odu_fee": { "type": "integer", "format": "int64", "description": "미수연체료 / 길이 18" }, "bf_dd_jin_amt": { "type": "integer", "format": "int64", "description": "전일가입금액 / 길이 18" }, "tdy_jin_amt": { "type": "integer", "format": "int64", "description": "금일가입금액 / 길이 18" }, "bf_dd_rrs_sba": { "type": "integer", "format": "int64", "description": "전일반대대용 / 길이 18" }, "tdy_rrs_sba": { "type": "integer", "format": "int64", "description": "금일반대대용 / 길이 18" }, "opt_stl_amt": { "type": "integer", "format": "int64", "description": "옵션결제금액 / 길이 18" }, "rls_pbl_sba": { "type": "integer", "format": "int64", "description": "해제가능대용 / 길이 18" }, "opt_ant_amt": { "type": "integer", "format": "int64", "description": "옵션배분금액 / 길이 18" }, "opt_erc_pr": { "type": "integer", "format": "int64", "description": "옵션행사가격 / 길이 18" }, "men_af_csh_rpm_amt": { "type": "integer", "format": "int64", "description": "장종료후현금입금금액 / 길이 18" }, "men_af_sba_rpm_amt": { "type": "integer", "format": "int64", "description": "장종료후대용입금금액 / 길이 18" }, "men_af_rpm_tal": { "type": "integer", "format": "int64", "description": "장종료후입금총액 / 길이 18" }, "frs_nsk_wtm_tal": { "type": "integer", "format": "int64", "description": "선물순위험증거금총액 / 길이 18" }, "frs_nsk_wtm_csh": { "type": "integer", "format": "int64", "description": "선물순위험증거금현금 / 길이 18" }, "fno_nsk_wtm_tal": { "type": "integer", "format": "int64", "description": "선물옵션순위험증거금총액 / 길이 18" }, "fno_nsk_wtm_csh": { "type": "integer", "format": "int64", "description": "선물옵션순위험증거금현금 / 길이 18" }, "opt_pr_wtm_tal": { "type": "integer", "format": "int64", "description": "옵션가격증거금총액 / 길이 18" }, "pr_cng_wtm_tal": { "type": "integer", "format": "int64", "description": "가격변동증거금총액 / 길이 18" }, "pr_cng_wtm_csh": { "type": "integer", "format": "int64", "description": "가격변동증거금현금 / 길이 18" }, "srd_cns_wtm_tal": { "type": "integer", "format": "int64", "description": "스프레드체결증거금총액 / 길이 18" }, "srd_cns_wtm_csh": { "type": "integer", "format": "int64", "description": "스프레드체결증거금현금 / 길이 18" }, "min_wtm_tal": { "type": "integer", "format": "int64", "description": "최소증거금총액 / 길이 18" }, "min_wtm_csh": { "type": "integer", "format": "int64", "description": "최소증거금현금 / 길이 18" }, "frs_rzt_pls_tal": { "type": "integer", "format": "int64", "description": "선물실현손익총액 / 길이 18" }, "frs_rzt_pls_csh": { "type": "integer", "format": "int64", "description": "선물실현손익현금 / 길이 18" }, "sba_sec_sll_amt": { "type": "integer", "format": "int64", "description": "대용증권매도금액 / 길이 18" }, "sba_sec_sll_tal": { "type": "integer", "format": "int64", "description": "대용증권매도총액 / 길이 18" }, "wrw_pbl_amt_tal": { "type": "integer", "format": "int64", "description": "인출가능금액총액 / 길이 18" }, "cvc_apm_sba_amt": { "type": "integer", "format": "int64", "description": "커버드콜지정대용금액 / 길이 18" }, "ahi_stk_byn_gte_amt": { "type": "integer", "format": "int64", "description": "현물주식매수확보금액 / 길이 18" }, "rvb_sct_gte_amt": { "type": "integer", "format": "int64", "description": "미수유가증권확보금액 / 길이 18" }, "lst_stl_dpa": { "type": "integer", "format": "int64", "description": "최종결제차금 / 길이 18" }, "sll_amt": { "type": "integer", "format": "int64", "description": "매도금액 / 길이 18" }, "byn_amt": { "type": "integer", "format": "int64", "description": "매수금액 / 길이 18" }, "cal_erc_popt_aloc_rit_erc_cst": { "type": "integer", "format": "int64", "description": "콜행사풋옵션배정권리행사대금 / 길이 18" }, "cal_aloc_popt_erc_rit_erc_cst": { "type": "integer", "format": "int64", "description": "콜배정풋옵션행사권리행사대금 / 길이 18" }, "frs_orr_wtm": { "type": "integer", "format": "int64", "description": "선물주문증거금 / 길이 18" }, "srd_orr_wtm": { "type": "integer", "format": "int64", "description": "스프레드주문증거금 / 길이 18" }, "opt_byn_orr_wtm_csh": { "type": "integer", "format": "int64", "description": "옵션매수주문증거금현금 / 길이 18" }, "opt_sll_orr_wtm_csh": { "type": "integer", "format": "int64", "description": "옵션매도주문증거금현금 / 길이 18" }, "nby_cst": { "type": "integer", "format": "int64", "description": "순매수대금 / 길이 18" }, "nby_csh": { "type": "integer", "format": "int64", "description": "순매수현금 / 길이 18" }, "frs_fee": { "type": "integer", "format": "int64", "description": "선물수수료 / 길이 18" }, "tot_rsk_wtm_tal": { "type": "integer", "format": "int64", "description": "총위험증거금총액 / 길이 18" }, "tot_rsk_wtm_csh": { "type": "integer", "format": "int64", "description": "총위험증거금현금 / 길이 18" }, "tdt_frs_nlo_amt": { "type": "integer", "format": "int64", "description": "당일선물순손실금액 / 길이 18" }, "gar_dd_bf_nlo_stl_amt": { "type": "integer", "format": "int64", "description": "수수일전순손실결제금액 / 길이 18" }, "iopt_hld_lmt_qty": { "type": "integer", "format": "int64", "description": "주식옵션보유한도수량 / 길이 18" }, "opt_hld_lmt_qty": { "type": "integer", "format": "int64", "description": "옵션보유한도수량 / 길이 18" }, "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "lst_stl_pr_dfn_bf_wtm_tal": { "type": "integer", "format": "int64", "description": "최종결제가격확정전증거금총액 / 길이 18" }, "lst_stl_pr_dfn_bf_wtm_csh": { "type": "integer", "format": "int64", "description": "최종결제가격확정전증거금현금 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/nightOrderExecutionHistory": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryNightOrderExecutionHistory", "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 계좌만 유효)" }, "orr_dt": { "type": "string", "description": "주문일자 / 길이 8 / YYYYMMDD" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 0.전체 1.매도 2.매수" }, "cns_dit_cd": { "type": "string", "description": "체결구분코드 / 길이 1 / 0.전체 1.체결 2.미체결" }, "ost_dit": { "type": "string", "description": "구분 / 길이 1 / 1.주문번호순 2.주문번호역순" }, "ost_dit_cd": { "type": "string", "description": "구분코드 / 길이 1 / 9.전체 4.코스피200선물 5.코스피200옵션 D.미니코스피200선물 E.미니코스피200옵션 7.주식선물 8.주식옵션 F.코스닥150선물 L.코스닥150옵션 A.변동성지수선물 B.섹터지수선물 G.유로스톡스50선물 K.KRX300선물 N.위클리옵션 P.코스닥글로벌선물 Q.코리아밸류업선물 R.코스닥150위클리옵션" } }, "required": [ "act_no", "sby_dit_cd", "cns_dit_cd", "ost_dit", "ost_dit_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "fno_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션주문번호 / 길이 10" }, "fno_org_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션원주문번호 / 길이 10" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "act_amn_tab_cd": { "type": "string", "description": "계좌관리팀점코드 / 길이 4" }, "act_amn_mo_tab_cd": { "type": "string", "description": "계좌관리모팀점코드 / 길이 4" }, "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "frs_orr_cnd_dit_cd": { "type": "string", "description": "선물주문조건구분코드 / 길이 1" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1" }, "orr_dt": { "type": "string", "description": "주문일자 / 길이 8" }, "fno_mo_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션모주문번호 / 길이 10" }, "frs_fnd_orr_no": { "type": "integer", "format": "int64", "description": "선물펀드주문번호 / 길이 10" }, "cor_can_dit_cd": { "type": "string", "description": "정정취소구분코드 / 길이 1" }, "fno_nmn_pr_tp_cd": { "type": "string", "description": "선물옵션호가유형코드 / 길이 1" }, "fno_trd_tp_cd": { "type": "string", "description": "선물옵션거래유형코드 / 길이 1" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.2" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_amt": { "type": "integer", "format": "int64", "description": "주문금액 / 길이 18" }, "cor_can_qty": { "type": "integer", "format": "int64", "description": "정정취소수량 / 길이 18" }, "cor_can_cfm_qty": { "type": "integer", "format": "int64", "description": "정정취소확인수량 / 길이 18" }, "frs_ny_cns_qty": { "type": "integer", "format": "int64", "description": "선물미체결수량 / 길이 18" }, "frs_cns_qty": { "type": "integer", "format": "int64", "description": "선물체결수량 / 길이 18" }, "frs_cns_amt": { "type": "number", "format": "double", "description": "선물체결금액 / 길이 15" }, "fno_cns_pr": { "type": "number", "format": "double", "description": "선물옵션체결가격 / 길이 15.2" }, "fr_mct_cns_amt": { "type": "number", "format": "double", "description": "원월물체결금액 / 길이 15" }, "nr_mct_cns_amt": { "type": "number", "format": "double", "description": "근월물체결금액 / 길이 15" }, "frs_orr_mdi_dit_cd": { "type": "string", "description": "선물주문매체구분코드 / 길이 1" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 30" }, "ivs_sgy_cd": { "type": "string", "description": "투자전략코드 / 길이 2" }, "amn_emp_no": { "type": "string", "description": "관리사원번호 / 길이 6" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "fno_rjt_rsn_cd": { "type": "string", "description": "선물옵션거부사유코드 / 길이 4" }, "orr_orn_dit_cd": { "type": "string", "description": "주문발생구분코드 / 길이 1" }, "wtm_mpi_qty": { "type": "integer", "format": "int64", "description": "증거금부과수량 / 길이 18" }, "wtm_iny_qty": { "type": "integer", "format": "int64", "description": "증거금면제수량 / 길이 18" }, "pcs_rlt_msg_cd": { "type": "string", "description": "처리결과메시지코드 / 길이 4" }, "rsl_amn_tab_cd": { "type": "string", "description": "실적관리팀점코드 / 길이 4" }, "pcs_tab_cd": { "type": "string", "description": "처리팀점코드 / 길이 4" }, "hts_usr_id": { "type": "string", "description": "HTS사용자ID / 길이 20" }, "orr_rtn_tm": { "type": "string", "description": "주문접수시각 / 길이 9" }, "egc_orr_dit_cd": { "type": "string", "description": "비상주문구분코드 / 길이 1" }, "rgs_emp_no": { "type": "string", "description": "등록사원번호 / 길이 6" }, "act_amn_tab_nm": { "type": "string", "description": "계좌관리팀점명 / 길이 50" }, "orr_cnd_dit_cd_nm": { "type": "string", "description": "주문조건구분코드명 / 길이 60" }, "sby_dit_nm": { "type": "string", "description": "매매구분명 / 길이 4" }, "cor_can_dit_nm": { "type": "string", "description": "정정취소구분명 / 길이 4" }, "nmn_pr_tp_cd_nm": { "type": "string", "description": "호가유형코드명 / 길이 60" }, "trd_tp_nm": { "type": "string", "description": "거래유형명 / 길이 60" }, "orr_mdi_nm": { "type": "string", "description": "주문매체명 / 길이 20" }, "usr_ip_adr": { "type": "string", "description": "사용자IP주소 / 길이 32" } } } }, "Output_1": { "type": "object", "properties": { "frs_sll_amt": { "type": "integer", "format": "int64", "description": "선물매도금액 / 길이 18" }, "frs_sll_qty": { "type": "integer", "format": "int64", "description": "선물매도수량 / 길이 18" }, "frs_byn_qty": { "type": "integer", "format": "int64", "description": "선물매수수량 / 길이 18" }, "frs_byn_amt": { "type": "integer", "format": "int64", "description": "선물매수금액 / 길이 18" }, "opt_byn_amt": { "type": "integer", "format": "int64", "description": "옵션매수금액 / 길이 18" }, "opt_byn_qty": { "type": "integer", "format": "int64", "description": "옵션매수수량 / 길이 18" }, "opt_sll_qty": { "type": "integer", "format": "int64", "description": "옵션매도수량 / 길이 18" }, "opt_sll_amt": { "type": "integer", "format": "int64", "description": "옵션매도금액 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/nightBalance": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryNightBalance", "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 계좌만 유효)" }, "ost_dit_cd": { "type": "string", "description": "구분코드 / 길이 1 / 9.전체 4.코스피200선물 5.코스피200옵션 D.미니코스피200선물 E.미니코스피200옵션 7.주식선물 8.주식옵션 F.코스닥150선물 L.코스닥150옵션 A.변동성지수선물 B.섹터지수선물 G.유로스톡스50선물 K.KRX300선물 N.위클리옵션 P.코스닥글로벌선물 Q.코리아밸류업선물 R.코스닥150위클리옵션" }, "ost_dit_cd1": { "type": "string", "description": "구분코드1 / 길이 1 / 9.전체 1.보유" } }, "required": [ "act_no", "ost_dit_cd", "ost_dit_cd1" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "sby_dit_nm": { "type": "string", "description": "매매구분명 / 길이 4" }, "tdy_ny_stl_qty": { "type": "integer", "format": "int64", "description": "금일미결제수량 / 길이 18" }, "byn_cns_qty": { "type": "integer", "format": "int64", "description": "매수체결수량 / 길이 18" }, "sll_cns_qty": { "type": "integer", "format": "int64", "description": "매도체결수량 / 길이 18" }, "ny_cns_byn_orr_qty": { "type": "integer", "format": "int64", "description": "미체결매수주문수량 / 길이 18" }, "ny_cns_sll_orr_qty": { "type": "integer", "format": "int64", "description": "미체결매도주문수량 / 길이 18" }, "avg_pr": { "type": "number", "format": "double", "description": "평균가격 / 길이 15.3" }, "pti_uit_pr": { "type": "number", "format": "double", "description": "진입단가 / 길이 15.3" }, "now_pr": { "type": "number", "format": "double", "description": "현재가격 / 길이 15.3" }, "tdt_cns_byn_avg_pr": { "type": "number", "format": "double", "description": "당일체결매수평균가격 / 길이 15.3" }, "tdt_cns_sll_avg_pr": { "type": "number", "format": "double", "description": "당일체결매도평균가격 / 길이 15.3" }, "eal_pls_amt": { "type": "integer", "format": "int64", "description": "평가손익금액 / 길이 18" }, "frs_pti_eal_pls": { "type": "integer", "format": "int64", "description": "선물진입평가손익 / 길이 15" }, "sby_pls_amt": { "type": "integer", "format": "int64", "description": "매매손익금액 / 길이 18" }, "frs_pti_sby_pls": { "type": "integer", "format": "int64", "description": "선물진입매매손익 / 길이 15" }, "tot_pls_sum": { "type": "integer", "format": "int64", "description": "총손익합계 / 길이 15" }, "lqd_qty": { "type": "integer", "format": "int64", "description": "청산수량 / 길이 15" }, "lqd_pbl_qty": { "type": "integer", "format": "int64", "description": "청산가능수량 / 길이 15" }, "opt_eal_amt": { "type": "integer", "format": "int64", "description": "옵션평가금액 / 길이 18" }, "fno_fee": { "type": "integer", "format": "int64", "description": "선물옵션수수료 / 길이 18" }, "byn_cns_amt": { "type": "integer", "format": "int64", "description": "매수체결금액 / 길이 18" }, "sll_cns_amt": { "type": "integer", "format": "int64", "description": "매도체결금액 / 길이 18" }, "abk_amt": { "type": "integer", "format": "int64", "description": "장부금액 / 길이 18" }, "pti_abk_amt": { "type": "integer", "format": "int64", "description": "진입장부금액 / 길이 15" }, "sby_pls_rt": { "type": "number", "format": "double", "description": "매매손익율 / 길이 10.3" }, "pti_eal_pft_rt": { "type": "number", "format": "double", "description": "진입평가수익율 / 길이 5.2" }, "pti_eal_pls": { "type": "integer", "format": "int64", "description": "진입평가손익 / 길이 15" }, "frs_fee": { "type": "integer", "format": "int64", "description": "선물수수료 / 길이 18" }, "pti_fee": { "type": "integer", "format": "int64", "description": "진입수수료 / 길이 18" }, "lqd_fee": { "type": "integer", "format": "int64", "description": "청산수수료 / 길이 18" }, "sby_dit_nm2": { "type": "string", "description": "매매구분명2 / 길이 4" }, "bf_dd_ny_stl_qty": { "type": "integer", "format": "int64", "description": "전일미결제수량 / 길이 18" }, "bnc_ind_qty": { "type": "integer", "format": "int64", "description": "잔고증감수량 / 길이 15" } } } }, "Output_1": { "type": "object", "properties": { "ral_pls_sum": { "type": "integer", "format": "int64", "description": "실손익합계 / 길이 15" }, "tot_pls_sum": { "type": "integer", "format": "int64", "description": "총손익합계 / 길이 15" }, "sby_pls_sum": { "type": "integer", "format": "int64", "description": "매매손익합계 / 길이 18" }, "tot_eal_pls": { "type": "integer", "format": "int64", "description": "총평가손익 / 길이 15" }, "pti_tot_pls_sum": { "type": "integer", "format": "int64", "description": "진입총손익합계 / 길이 15" }, "pti_sby_pls_sum": { "type": "integer", "format": "int64", "description": "진입매매손익합계 / 길이 15" }, "pti_eal_pls_sum": { "type": "integer", "format": "int64", "description": "진입평가손익합계 / 길이 15" }, "pti_eal_pls": { "type": "integer", "format": "int64", "description": "진입평가손익 / 길이 15" }, "ral_frs_pls": { "type": "integer", "format": "int64", "description": "실선물손익 / 길이 15" }, "frs_tot_pls": { "type": "integer", "format": "int64", "description": "선물총손익 / 길이 15" }, "frs_sby_pls": { "type": "integer", "format": "int64", "description": "선물매매손익 / 길이 15" }, "frs_eal_pls": { "type": "integer", "format": "int64", "description": "선물평가손익 / 길이 15" }, "pti_frs_eal_pls": { "type": "integer", "format": "int64", "description": "진입선물평가손익 / 길이 15" }, "frs_pti_sby_pls": { "type": "integer", "format": "int64", "description": "선물진입매매손익 / 길이 15" }, "frs_pti_eal_pls": { "type": "integer", "format": "int64", "description": "선물진입평가손익 / 길이 15" }, "ral_opt_pls": { "type": "integer", "format": "int64", "description": "실옵션손익 / 길이 15" }, "opt_tot_pls": { "type": "integer", "format": "int64", "description": "옵션총손익 / 길이 15" }, "opt_sby_pls": { "type": "integer", "format": "int64", "description": "옵션매매손익 / 길이 15" }, "opt_eal_pls": { "type": "integer", "format": "int64", "description": "옵션평가손익 / 길이 15" }, "idx_opt_pls_amt": { "type": "integer", "format": "int64", "description": "지수옵션손익금액 / 길이 18" }, "pti_sby_pls": { "type": "integer", "format": "int64", "description": "진입매매손익 / 길이 15" }, "eal_pls_amt": { "type": "integer", "format": "int64", "description": "평가손익금액 / 길이 18" }, "fno_eal_amt": { "type": "integer", "format": "int64", "description": "선물옵션평가금액 / 길이 18" }, "byn_cst_sum1": { "type": "integer", "format": "int64", "description": "매수대금합계1 / 길이 18" }, "sum_qty1": { "type": "integer", "format": "int64", "description": "합계수량1 / 길이 18" }, "sll_cst_sum1": { "type": "integer", "format": "int64", "description": "매도대금합계1 / 길이 18" }, "sum_qty2": { "type": "integer", "format": "int64", "description": "합계수량2 / 길이 18" }, "fee_sum": { "type": "integer", "format": "int64", "description": "수수료합계 / 길이 18" }, "fee_sum_amt": { "type": "integer", "format": "int64", "description": "수수료합계금액 / 길이 18" }, "frs_byn_amt": { "type": "integer", "format": "int64", "description": "선물매수금액 / 길이 18" }, "frs_qty": { "type": "integer", "format": "int64", "description": "선물수량 / 길이 18" }, "frs_sll_amt": { "type": "integer", "format": "int64", "description": "선물매도금액 / 길이 18" }, "qty_sum": { "type": "integer", "format": "int64", "description": "수량합계 / 길이 18" }, "frs_fee": { "type": "integer", "format": "int64", "description": "선물수수료 / 길이 18" }, "opt_byn_amt": { "type": "integer", "format": "int64", "description": "옵션매수금액 / 길이 18" }, "sby_qty": { "type": "integer", "format": "int64", "description": "매매수량 / 길이 18" }, "opt_sll_amt": { "type": "integer", "format": "int64", "description": "옵션매도금액 / 길이 18" }, "sby_qty1": { "type": "integer", "format": "int64", "description": "매매수량1 / 길이 18" }, "fno_fee": { "type": "integer", "format": "int64", "description": "선물옵션수수료 / 길이 18" }, "dsg_tal": { "type": "integer", "format": "int64", "description": "예탁총액 / 길이 18" }, "orr_pbl_amt_tal": { "type": "integer", "format": "int64", "description": "주문가능금액총액 / 길이 18" }, "brg_wtm_tal": { "type": "integer", "format": "int64", "description": "위탁증거금총액 / 길이 18" }, "nas_tal": { "type": "integer", "format": "int64", "description": "순자산총액 / 길이 18" }, "tot_eal_amt": { "type": "integer", "format": "int64", "description": "총평가금액 / 길이 18" }, "dsg_csh": { "type": "integer", "format": "int64", "description": "예탁현금 / 길이 18" }, "csh_dga": { "type": "integer", "format": "int64", "description": "현금예탁금 / 길이 18" }, "orr_pbl_amt_csh": { "type": "integer", "format": "int64", "description": "주문가능금액현금 / 길이 18" }, "brg_wtm_csh": { "type": "integer", "format": "int64", "description": "위탁증거금현금 / 길이 18" }, "nas_csh": { "type": "integer", "format": "int64", "description": "순자산현금 / 길이 18" }, "eal_amt_sum": { "type": "integer", "format": "int64", "description": "평가금액합계 / 길이 18" }, "dsg_sba_amt": { "type": "integer", "format": "int64", "description": "예탁대용금액 / 길이 18" }, "tot_aet_amt": { "type": "integer", "format": "int64", "description": "총자산금액 / 길이 18" }, "tot_byn_amt": { "type": "integer", "format": "int64", "description": "총매수금액 / 길이 18" }, "eal_amt": { "type": "integer", "format": "int64", "description": "평가금액 / 길이 18" }, "eal_pls1": { "type": "integer", "format": "int64", "description": "평가손익1 / 길이 18" }, "xcl_dpa_sum": { "type": "integer", "format": "int64", "description": "정산차금합계 / 길이 15" }, "lst_dfa_amt": { "type": "integer", "format": "int64", "description": "최종차액금액 / 길이 18" }, "opt_eal_pls_amt": { "type": "integer", "format": "int64", "description": "옵션평가손익금액 / 길이 18" }, "opt_aloc_amt": { "type": "integer", "format": "int64", "description": "옵션배정금액 / 길이 18" }, "opt_erc_amt": { "type": "integer", "format": "int64", "description": "옵션행사금액 / 길이 18" }, "bf_dd_sba_sll_amt": { "type": "integer", "format": "int64", "description": "전일대용매도금액 / 길이 18" }, "tdt_sba_sll_amt": { "type": "integer", "format": "int64", "description": "당일대용매도금액 / 길이 18" }, "drn_pbl_amt": { "type": "integer", "format": "int64", "description": "출금가능금액 / 길이 18" }, "amn_emp_fnm": { "type": "string", "description": "관리사원성명 / 길이 40" }, "trd_act_nm": { "type": "string", "description": "거래계좌명 / 길이 20" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/nightOrderable": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryNightOrderable", "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 계좌만 유효)" }, "ost_sby_dit": { "type": "string", "description": "매매구분 / 길이 1 / 1.매도 2.매수" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "orr_uit_pr": { "type": "number", "format": "double", "description": "주문단가 / 길이 15.3" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "ost_orr_tp": { "type": "string", "description": "주문유형 / 길이 1 / B.최유리지정가 C.조건부지정가 L.지정가 M.시장가" } }, "required": [ "act_no", "ost_sby_dit", "fno_iem_cd", "ost_orr_tp" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "tot_eal_amt": { "type": "integer", "format": "int64", "description": "총평가금액 / 길이 18" }, "dsg_tal": { "type": "integer", "format": "int64", "description": "예탁총액 / 길이 18" }, "dsg_csh": { "type": "integer", "format": "int64", "description": "예탁현금 / 길이 18" }, "dsg_sba_amt": { "type": "integer", "format": "int64", "description": "예탁대용금액 / 길이 18" }, "csh_rba": { "type": "integer", "format": "int64", "description": "현금미수금 / 길이 18" }, "brg_wtm_tal": { "type": "integer", "format": "int64", "description": "위탁증거금총액 / 길이 18" }, "brg_wtm_csh": { "type": "integer", "format": "int64", "description": "위탁증거금현금 / 길이 18" }, "orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문가능총액 / 길이 18" }, "orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문가능현금 / 길이 18" }, "frs_xcl_dpa": { "type": "integer", "format": "int64", "description": "선물정산차금 / 길이 18" }, "frs_tdt_dpa": { "type": "integer", "format": "int64", "description": "선물당일차금 / 길이 18" }, "frs_rwl_dpa": { "type": "integer", "format": "int64", "description": "선물갱신차금 / 길이 18" }, "opt_sll_amt": { "type": "integer", "format": "int64", "description": "옵션매도금액 / 길이 18" }, "opt_byn_amt": { "type": "integer", "format": "int64", "description": "옵션매수금액 / 길이 18" }, "opt_eal_amt": { "type": "integer", "format": "int64", "description": "옵션평가금액 / 길이 18" }, "ned_dsg_tal": { "type": "integer", "format": "int64", "description": "필요예탁총액 / 길이 18" }, "ned_dsg_csh": { "type": "integer", "format": "int64", "description": "필요예탁현금 / 길이 18" }, "wtm_lvy_qty": { "type": "integer", "format": "int64", "description": "증거금징수수량 / 길이 18" }, "wtm_iny_qty": { "type": "integer", "format": "int64", "description": "증거금면제수량 / 길이 18" }, "wtm_lvy_uit_pr": { "type": "number", "format": "double", "description": "증거금징수단가 / 길이 18.3" }, "anw_qty": { "type": "integer", "format": "int64", "description": "신규수량 / 길이 18" }, "lqd_pbl_qty": { "type": "integer", "format": "int64", "description": "청산가능수량 / 길이 18" }, "all_orr_qty": { "type": "integer", "format": "int64", "description": "전체주문수량 / 길이 18" }, "ftn_aet_iem_end_pr": { "type": "number", "format": "double", "description": "기초자산종목종가 / 길이 15.3" }, "nas_rt": { "type": "number", "format": "double", "description": "순자산비율 / 길이 11.8" }, "sum_stl_amt": { "type": "integer", "format": "int64", "description": "합계결제금액 / 길이 18" }, "max_pbl_bse_qty": { "type": "integer", "format": "int64", "description": "최대가능기준수량 / 길이 18" }, "copt_sll_ny_stl_qty": { "type": "integer", "format": "int64", "description": "콜옵션매도미결제수량 / 길이 18" }, "popt_sll_ny_stl_qty": { "type": "integer", "format": "int64", "description": "풋옵션매도미결제수량 / 길이 18" }, "krx1_cal_sll_qty": { "type": "integer", "format": "int64", "description": "KRX_콜매도수량 / 길이 12" }, "krx1_popt_sll_qty": { "type": "integer", "format": "int64", "description": "KRX_풋매도수량 / 길이 12" }, "orr_pbl_qty": { "type": "integer", "format": "int64", "description": "주문가능수량 / 길이 10" }, "orr_pbl_qty1": { "type": "integer", "format": "int64", "description": "주문가능수량1 / 길이 18" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_amt": { "type": "integer", "format": "int64", "description": "주문금액 / 길이 18" }, "anw_orr_qty": { "type": "integer", "format": "int64", "description": "신규주문수량 / 길이 18" }, "orr_af_dsg_tal": { "type": "integer", "format": "int64", "description": "주문후예탁총액 / 길이 18" }, "orr_af_dsg_csh": { "type": "integer", "format": "int64", "description": "주문후예탁현금 / 길이 18" }, "orr_af_brg_wtm_tal": { "type": "integer", "format": "int64", "description": "주문후위탁증거금총액 / 길이 18" }, "orr_af_brg_wtm_csh": { "type": "integer", "format": "int64", "description": "주문후위탁증거금현금 / 길이 18" }, "orr_af_orr_pbl_tal": { "type": "integer", "format": "int64", "description": "주문후주문가능총액 / 길이 18" }, "orr_af_orr_pbl_csh": { "type": "integer", "format": "int64", "description": "주문후주문가능현금 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/nightMargin": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryNightMargin", "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 계좌만 유효)" } }, "required": [ "act_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "dsg_csh": { "type": "integer", "format": "int64", "description": "예탁현금 / 길이 18" }, "nxt_dd_amp_dsg_csh": { "type": "integer", "format": "int64", "description": "익일추정예탁현금 / 길이 18" }, "nxt2_dd_amp_dsg_csh": { "type": "integer", "format": "int64", "description": "익익일추정예탁현금 / 길이 18" }, "dsg_sba_amt": { "type": "integer", "format": "int64", "description": "예탁대용금액 / 길이 18" }, "dsg_tal": { "type": "integer", "format": "int64", "description": "예탁총액 / 길이 18" }, "brg_wtm_csh": { "type": "integer", "format": "int64", "description": "위탁증거금현금 / 길이 18" }, "brg_wtm_tal": { "type": "integer", "format": "int64", "description": "위탁증거금총액 / 길이 18" }, "orr_pbl_amt_csh": { "type": "integer", "format": "int64", "description": "주문가능금액현금 / 길이 18" }, "orr_pbl_amt_tal": { "type": "integer", "format": "int64", "description": "주문가능금액총액 / 길이 18" }, "wrw_pbl_amt_csh": { "type": "integer", "format": "int64", "description": "인출가능금액현금 / 길이 18" }, "mnc_wtm_csh": { "type": "integer", "format": "int64", "description": "유지증거금현금 / 길이 18" }, "mnc_wtm_tal": { "type": "integer", "format": "int64", "description": "유지증거금총액 / 길이 18" }, "apd_wtm_csh": { "type": "integer", "format": "int64", "description": "추가증거금현금 / 길이 18" }, "apd_wtm_tal": { "type": "integer", "format": "int64", "description": "추가증거금총액 / 길이 18" }, "orr_wtm_tal": { "type": "integer", "format": "int64", "description": "주문증거금총액 / 길이 18" }, "orr_wtm_csh": { "type": "integer", "format": "int64", "description": "주문증거금현금 / 길이 18" }, "opt_pr_wtm": { "type": "integer", "format": "int64", "description": "옵션가격증거금 / 길이 18" }, "rrv_wtm": { "type": "integer", "format": "int64", "description": "예비증거금 / 길이 18" }, "sby_pls_amt": { "type": "integer", "format": "int64", "description": "매매손익금액 / 길이 18" }, "opt_byn_cst": { "type": "integer", "format": "int64", "description": "옵션매수대금 / 길이 18" }, "opt_sll_cst": { "type": "integer", "format": "int64", "description": "옵션매도대금 / 길이 18" }, "frs_xcl_dpa": { "type": "integer", "format": "int64", "description": "선물정산차금 / 길이 18" }, "frs_lst_dpa": { "type": "integer", "format": "int64", "description": "선물최종차금 / 길이 18" }, "rba": { "type": "integer", "format": "int64", "description": "미수금 / 길이 18" }, "rvb_fee": { "type": "integer", "format": "int64", "description": "미수수수료 / 길이 18" }, "rvb_odu_fee": { "type": "integer", "format": "int64", "description": "미수연체료 / 길이 18" }, "bf_dd_jin_amt": { "type": "integer", "format": "int64", "description": "전일가입금액 / 길이 18" }, "tdy_jin_amt": { "type": "integer", "format": "int64", "description": "금일가입금액 / 길이 18" }, "bf_dd_rrs_sba": { "type": "integer", "format": "int64", "description": "전일반대대용 / 길이 18" }, "tdy_rrs_sba": { "type": "integer", "format": "int64", "description": "금일반대대용 / 길이 18" }, "opt_stl_amt": { "type": "integer", "format": "int64", "description": "옵션결제금액 / 길이 18" }, "rls_pbl_sba": { "type": "integer", "format": "int64", "description": "해제가능대용 / 길이 18" }, "opt_ant_amt": { "type": "integer", "format": "int64", "description": "옵션배분금액 / 길이 18" }, "opt_erc_pr": { "type": "integer", "format": "int64", "description": "옵션행사가격 / 길이 18" }, "men_af_csh_rpm_amt": { "type": "integer", "format": "int64", "description": "장종료후현금입금금액 / 길이 18" }, "men_af_sba_rpm_amt": { "type": "integer", "format": "int64", "description": "장종료후대용입금금액 / 길이 18" }, "men_af_rpm_tal": { "type": "integer", "format": "int64", "description": "장종료후입금총액 / 길이 18" }, "frs_nsk_wtm_tal": { "type": "integer", "format": "int64", "description": "선물순위험증거금총액 / 길이 18" }, "frs_nsk_wtm_csh": { "type": "integer", "format": "int64", "description": "선물순위험증거금현금 / 길이 18" }, "fno_nsk_wtm_tal": { "type": "integer", "format": "int64", "description": "선물옵션순위험증거금총액 / 길이 18" }, "fno_nsk_wtm_csh": { "type": "integer", "format": "int64", "description": "선물옵션순위험증거금현금 / 길이 18" }, "opt_pr_wtm_tal": { "type": "integer", "format": "int64", "description": "옵션가격증거금총액 / 길이 18" }, "pr_cng_wtm_tal": { "type": "integer", "format": "int64", "description": "가격변동증거금총액 / 길이 18" }, "pr_cng_wtm_csh": { "type": "integer", "format": "int64", "description": "가격변동증거금현금 / 길이 18" }, "srd_cns_wtm_tal": { "type": "integer", "format": "int64", "description": "스프레드체결증거금총액 / 길이 18" }, "srd_cns_wtm_csh": { "type": "integer", "format": "int64", "description": "스프레드체결증거금현금 / 길이 18" }, "min_wtm_tal": { "type": "integer", "format": "int64", "description": "최소증거금총액 / 길이 18" }, "min_wtm_csh": { "type": "integer", "format": "int64", "description": "최소증거금현금 / 길이 18" }, "frs_rzt_pls_tal": { "type": "integer", "format": "int64", "description": "선물실현손익총액 / 길이 18" }, "frs_rzt_pls_csh": { "type": "integer", "format": "int64", "description": "선물실현손익현금 / 길이 18" }, "sba_sec_sll_amt": { "type": "integer", "format": "int64", "description": "대용증권매도금액 / 길이 18" }, "sba_sec_sll_tal": { "type": "integer", "format": "int64", "description": "대용증권매도총액 / 길이 18" }, "wrw_pbl_amt_tal": { "type": "integer", "format": "int64", "description": "인출가능금액총액 / 길이 18" }, "cvc_apm_sba_amt": { "type": "integer", "format": "int64", "description": "커버드콜지정대용금액 / 길이 18" }, "ahi_stk_byn_gte_amt": { "type": "integer", "format": "int64", "description": "현물주식매수확보금액 / 길이 18" }, "rvb_sct_gte_amt": { "type": "integer", "format": "int64", "description": "미수유가증권확보금액 / 길이 18" }, "lst_stl_dpa": { "type": "integer", "format": "int64", "description": "최종결제차금 / 길이 18" }, "sll_amt": { "type": "integer", "format": "int64", "description": "매도금액 / 길이 18" }, "byn_amt": { "type": "integer", "format": "int64", "description": "매수금액 / 길이 18" }, "cal_erc_popt_aloc_rit_erc_cst": { "type": "integer", "format": "int64", "description": "콜행사풋옵션배정권리행사대금 / 길이 18" }, "cal_aloc_popt_erc_rit_erc_cst": { "type": "integer", "format": "int64", "description": "콜배정풋옵션행사권리행사대금 / 길이 18" }, "frs_orr_wtm": { "type": "integer", "format": "int64", "description": "선물주문증거금 / 길이 18" }, "srd_orr_wtm": { "type": "integer", "format": "int64", "description": "스프레드주문증거금 / 길이 18" }, "opt_byn_orr_wtm_csh": { "type": "integer", "format": "int64", "description": "옵션매수주문증거금현금 / 길이 18" }, "opt_sll_orr_wtm_csh": { "type": "integer", "format": "int64", "description": "옵션매도주문증거금현금 / 길이 18" }, "nby_cst": { "type": "integer", "format": "int64", "description": "순매수대금 / 길이 18" }, "nby_csh": { "type": "integer", "format": "int64", "description": "순매수현금 / 길이 18" }, "frs_fee": { "type": "integer", "format": "int64", "description": "선물수수료 / 길이 18" }, "tot_rsk_wtm_tal": { "type": "integer", "format": "int64", "description": "총위험증거금총액 / 길이 18" }, "tot_rsk_wtm_csh": { "type": "integer", "format": "int64", "description": "총위험증거금현금 / 길이 18" }, "tdt_frs_nlo_amt": { "type": "integer", "format": "int64", "description": "당일선물순손실금액 / 길이 18" }, "gar_dd_bf_nlo_stl_amt": { "type": "integer", "format": "int64", "description": "수수일전순손실결제금액 / 길이 18" }, "iopt_hld_lmt_qty": { "type": "integer", "format": "int64", "description": "주식옵션보유한도수량 / 길이 18" }, "opt_hld_lmt_qty": { "type": "integer", "format": "int64", "description": "옵션보유한도수량 / 길이 18" }, "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "lst_stl_pr_dfn_bf_wtm_tal": { "type": "integer", "format": "int64", "description": "최종결제가격확정전증거금총액 / 길이 18" }, "lst_stl_pr_dfn_bf_wtm_csh": { "type": "integer", "format": "int64", "description": "최종결제가격확정전증거금현금 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/evalPnl": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryEvalPnl", "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 계좌만 유효)" } }, "required": [ "act_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "ost_act_nm": { "type": "string", "description": "계좌명 / 길이 40" }, "ksp_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피선물매수약정수량 / 길이 18" }, "ksp_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피선물매도약정수량 / 길이 18" }, "ksp_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피선물매수약정금액 / 길이 18" }, "ksp_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피선물매도약정금액 / 길이 18" }, "ksp_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스피당일손익금액 / 길이 18" }, "ksp_frs_fee": { "type": "integer", "format": "int64", "description": "코스피선물수수료 / 길이 18" }, "ksp_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피옵션매수약정수량 / 길이 18" }, "ksp_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피옵션매도약정수량 / 길이 18" }, "ksp_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피옵션매수약정금액 / 길이 18" }, "ksp_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피옵션매도약정금액 / 길이 18" }, "iopt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "주식옵션매수약정수량 / 길이 18" }, "iopt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "주식옵션매도약정수량 / 길이 18" }, "iopt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "주식옵션매수약정금액 / 길이 18" }, "iopt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "주식옵션매도약정금액 / 길이 18" }, "pls_amt": { "type": "integer", "format": "int64", "description": "손익금액 / 길이 18" }, "iopt_pls_amt": { "type": "integer", "format": "int64", "description": "주식옵션손익금액 / 길이 18" }, "opt_byn_amt": { "type": "integer", "format": "int64", "description": "옵션매수금액 / 길이 18" }, "opt_sll_amt": { "type": "integer", "format": "int64", "description": "옵션매도금액 / 길이 18" }, "opt_eal_amt": { "type": "integer", "format": "int64", "description": "옵션평가금액 / 길이 18" }, "opt_fee": { "type": "integer", "format": "int64", "description": "옵션수수료 / 길이 18" }, "bf_dd_sba_sll_amt": { "type": "integer", "format": "int64", "description": "전일대용매도금액 / 길이 18" }, "tdt_sba_sll_amt": { "type": "integer", "format": "int64", "description": "당일대용매도금액 / 길이 18" }, "ctc_qty_sum": { "type": "integer", "format": "int64", "description": "약정수량합계 / 길이 18" }, "ctc_amt_sum": { "type": "integer", "format": "int64", "description": "약정금액합계 / 길이 18" }, "idx_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "지수옵션약정수량 / 길이 18" }, "idx_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "지수옵션약정금액 / 길이 18" }, "iopt_ctc_qty": { "type": "integer", "format": "int64", "description": "주식옵션약정수량 / 길이 18" }, "iopt_ctc_amt": { "type": "integer", "format": "int64", "description": "주식옵션약정금액 / 길이 18" }, "tdt_pls_sum": { "type": "integer", "format": "int64", "description": "당일손익합계 / 길이 18" }, "fee_sum": { "type": "integer", "format": "int64", "description": "수수료합계 / 길이 18" }, "dca": { "type": "integer", "format": "int64", "description": "예수금 / 길이 18" }, "nxt_dd_prv_xcl_dca": { "type": "integer", "format": "int64", "description": "익일가정산예수금 / 길이 18" }, "kar_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "스타지수선물매수약정수량 / 길이 18" }, "kar_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "스타지수선물매도약정수량 / 길이 18" }, "kar_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "스타지수선물매수약정금액 / 길이 18" }, "kar_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "스타지수선물매도약정금액 / 길이 18" }, "kar_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "스타지수선물당일손익금액 / 길이 18" }, "kar_frs_fee": { "type": "integer", "format": "int64", "description": "스타지수선물수수료 / 길이 18" }, "stk_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "주식선물매수약정수량 / 길이 18" }, "stk_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "주식선물매도약정수량 / 길이 18" }, "stk_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "주식선물매수약정금액 / 길이 18" }, "stk_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "주식선물매도약정금액 / 길이 18" }, "stk_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "주식선물당일손익금액 / 길이 18" }, "stk_frs_fee": { "type": "integer", "format": "int64", "description": "주식선물수수료 / 길이 18" }, "vty_idx_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "변동성지수선물매수약정수량 / 길이 18" }, "vty_idx_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "변동성지수선물매도약정수량 / 길이 18" }, "vty_idx_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "변동성지수선물매수약정금액 / 길이 18" }, "vty_idx_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "변동성지수선물매도약정금액 / 길이 18" }, "vty_idx_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "변동성지수선물당일손익금액 / 길이 18" }, "vty_idx_frs_fee": { "type": "integer", "format": "int64", "description": "변동성지수선물수수료 / 길이 18" }, "ser_idx_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "섹터지수선물매수약정수량 / 길이 18" }, "ser_idx_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "섹터지수선물매도약정수량 / 길이 18" }, "ser_idx_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "섹터지수선물매수약정금액 / 길이 18" }, "ser_idx_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "섹터지수선물매도약정금액 / 길이 18" }, "ser_idx_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "섹터지수선물당일손익금액 / 길이 18" }, "ser_idx_frs_fee": { "type": "integer", "format": "int64", "description": "섹터지수선물수수료 / 길이 18" }, "mini_ksp_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "미니코스피선물매수약정수량 / 길이 18" }, "mini_ksp_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "미니코스피선물매도약정수량 / 길이 18" }, "mini_ksp_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "미니코스피선물매수약정금액 / 길이 18" }, "mini_ksp_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "미니코스피선물매도약정금액 / 길이 18" }, "mini_ksp_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "미니코스피당일손익금액 / 길이 18" }, "mini_ksp_frs_fee": { "type": "integer", "format": "int64", "description": "미니코스피선물수수료 / 길이 18" }, "mini_ksp_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "미니코스피옵션매수약정수량 / 길이 18" }, "mini_ksp_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "미니코스피옵션매수약정금액 / 길이 18" }, "mini_ksp_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "미니코스피옵션매도약정수량 / 길이 18" }, "mini_ksp_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "미니코스피옵션매도약정금액 / 길이 18" }, "mini_ksp_opt_pls_amt": { "type": "integer", "format": "int64", "description": "미니코스피옵션손익금액 / 길이 18" }, "ksq150_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150선물매수약정수량 / 길이 18" }, "ksq150_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥150선물당일손익금액 / 길이 18" }, "ksq150_frs_fee": { "type": "integer", "format": "int64", "description": "코스닥150선물수수료 / 길이 18" }, "ksq150_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150선물매도약정금액 / 길이 18" }, "ksq150_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150선물매도약정수량 / 길이 18" }, "ksq150_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150선물매수약정금액 / 길이 18" }, "ero_50_idx_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "유로화50지수선물매수약정수량 / 길이 18" }, "ero_50_idx_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "유로화50지수선물매수약정금액 / 길이 18" }, "ero_50_idx_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "유로화50지수선물매도약정수량 / 길이 18" }, "ero_50_idx_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "유로화50지수선물매도약정금액 / 길이 18" }, "ero_50_idx_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "유로화50지수선물당일손익금액 / 길이 18" }, "ero_50_idx_frs_fee": { "type": "integer", "format": "int64", "description": "유로화50지수선물수수료 / 길이 18" }, "ksq150_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150옵션매수약정수량 / 길이 18" }, "ksq150_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150옵션매도약정수량 / 길이 18" }, "ksq150_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션매수약정금액 / 길이 18" }, "ksq150_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션매도약정금액 / 길이 18" }, "ksq150_opt_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션당일손익금액 / 길이 18" }, "ksq150_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션약정금액 / 길이 18" }, "ksq150_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150옵션약정수량 / 길이 18" }, "krx300_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "거래소300선물매수약정수량 / 길이 18" }, "krx300_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "거래소300선물매도약정수량 / 길이 18" }, "krx300_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "거래소300선물매수약정금액 / 길이 18" }, "krx300_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "거래소300선물매도약정금액 / 길이 18" }, "krx300_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "거래소300선물당일손익금액 / 길이 18" }, "krx300_frs_fee": { "type": "integer", "format": "int64", "description": "거래소300선물수수료 / 길이 18" }, "ksp200_wky_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매수약정수량 / 길이 18" }, "ksp200_wky_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매도약정수량 / 길이 18" }, "ksp200_wky_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매수약정금액 / 길이 18" }, "ksp200_wky_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매도약정금액 / 길이 18" }, "ksp200_wky_opt_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션당일손익금액 / 길이 18" }, "ksp200_wky_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션약정금액 / 길이 18" }, "ksp200_wky_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션약정수량 / 길이 18" }, "ksq_gbl_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매수약정수량 / 길이 18" }, "ksq_gbl_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매도약정수량 / 길이 18" }, "ksq_gbl_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매수약정금액 / 길이 18" }, "ksq_gbl_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매도약정금액 / 길이 18" }, "ksq_gbl_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물당일손익금액 / 길이 18" }, "ksq_gbl_frs_fee": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물수수료 / 길이 18" }, "kor_vup_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매수약정수량 / 길이 18" }, "kor_vup_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매도약정수량 / 길이 18" }, "kor_vup_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매수약정금액 / 길이 18" }, "kor_vup_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매도약정금액 / 길이 18" }, "kor_vup_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코리아밸류업선물당일손익금액 / 길이 18" }, "kor_vup_frs_fee": { "type": "integer", "format": "int64", "description": "코리아밸류업선물수수료 / 길이 18" }, "ksq150_wky_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매수약정수량 / 길이 18" }, "ksq150_wky_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매도약정수량 / 길이 18" }, "ksq150_wky_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매수약정금액 / 길이 18" }, "ksq150_wky_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매도약정금액 / 길이 18" }, "ksq150_wky_opt_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션당일손익금액 / 길이 18" }, "ksq150_wky_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션약정금액 / 길이 18" }, "ksq150_wky_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션약정수량 / 길이 18" }, "stk_wky_opt_byn_ctc_qty": { "type": "string", "description": "주식위클리옵션매수약정수량 / 길이 18" }, "stk_wky_opt_sll_ctc_qty": { "type": "string", "description": "주식위클리옵션매도약정수량 / 길이 18" }, "stk_wky_opt_byn_ctc_amt": { "type": "string", "description": "주식위클리옵션매수약정금액 / 길이 18" }, "stk_wky_opt_sll_ctc_amt": { "type": "string", "description": "주식위클리옵션매도약정금액 / 길이 18" }, "stk_wky_opt_tdt_pls_amt": { "type": "string", "description": "주식위클리옵션당일손익금액 / 길이 18" }, "stk_wky_opt_ctc_amt": { "type": "string", "description": "주식위클리옵션약정금액 / 길이 18" }, "stk_wky_opt_ctc_qty": { "type": "string", "description": "주식위클리옵션약정수량 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/inquiry/v1/executionHistory": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryExecutionHistory", "summary": "선물옵션 기준일체결내역", "description": "국내선물옵션 기준일자 체결내역 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: 예시 응답에는 명세에 없는 블록(Output_1)이 포함되어 있습니다.", "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 계좌만 유효)" }, "orr_dt": { "type": "string", "description": "주문일자 / 길이 8" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 0.전체 1.매도 2.매수" }, "cns_dit_cd": { "type": "string", "description": "체결구분코드 / 길이 1 / 0.전체 1.체결 2.미체결" }, "fno_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션주문번호 / 길이 10 / 미입력 시 전체" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "ost_dit": { "type": "string", "description": "구분 / 길이 1 / 1.주문번호순 2.주문번호역순" }, "ost_dit_cd": { "type": "string", "description": "구분코드 / 길이 1 / 9.전체 4.코스피200선물 5.코스피200옵션 D.미니코스피200선물 E.미니코스피200옵션 7.주식선물 8.주식옵션 F.코스닥150선물 L.코스닥150옵션 A.변동성지수선물 B.섹터지수선물 G.유로스톡스50선물 K.KRX300선물 N.위클리옵션 P.코스닥글로벌선물 Q.코리아밸류업선물 R.코스닥150위클리옵션" } }, "required": [ "act_no", "orr_dt", "sby_dit_cd", "cns_dit_cd", "ost_dit", "ost_dit_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "fno_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션주문번호 / 길이 10" }, "fno_org_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션원주문번호 / 길이 10" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "act_amn_tab_cd": { "type": "string", "description": "계좌관리팀점코드 / 길이 4" }, "act_amn_mo_tab_cd": { "type": "string", "description": "계좌관리모팀점코드 / 길이 4" }, "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "frs_orr_cnd_dit_cd": { "type": "string", "description": "선물주문조건구분코드 / 길이 1 / 0.조건없음 1.IOC 2.FOK 3.FAS" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 1.매도 2.매수" }, "orr_dt": { "type": "string", "description": "주문일자 / 길이 8" }, "fno_mo_orr_no": { "type": "integer", "format": "int64", "description": "선물옵션모주문번호 / 길이 10" }, "frs_fnd_orr_no": { "type": "integer", "format": "int64", "description": "선물펀드주문번호 / 길이 10" }, "cor_can_dit_cd": { "type": "string", "description": "정정취소구분코드 / 길이 1 / 0.정상 1.정정 2.취소 N.정상" }, "fno_nmn_pr_tp_cd": { "type": "string", "description": "선물옵션호가유형코드 / 길이 1 / 2.지정가(KRX용) B.최유리지정가 C.조건부지정가 I.조건부지정가(KRX용) L.지정가 M.시장가 T.가격제한시장가(KRX용) W.가격제한최유리지정가(KRX용)" }, "fno_trd_tp_cd": { "type": "string", "description": "선물옵션거래유형코드 / 길이 1 / 0.해당사항없음 1.사후위탁증거금 미적용계좌의 주가지수차익거래 및 주식차익거래 2.사후위탁증거금 미적용계좌의 주가지수헤지거래 및 주식헤지거래 3.사후위탁증거금 적용이외의 위탁거래중 사후위탁증거금 미적용계좌의 기타거래 4.사후위탁증거금 일반계좌의 주가지수차익거래 및 주식차익거래 5.사후위탁증거금 일반계좌의 주가지수헤지거래 및 주식헤지거래 6.사후위탁증거금 일반계좌의 기타거래 7.사후위탁증거금 할인계좌의 주가지수차익거래 및 주식차익거래 8.사후위탁증거금 할인계좌의 주가지수헤지거래 및 주식헤지거래 9.사후위탁증거금 할인계좌의 기타거래 A.옵션매수전용계좌 B.국채등전용계좌 _.해당사항없음" }, "fno_iem_cd": { "type": "string", "description": "선물옵션종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.2" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_amt": { "type": "integer", "format": "int64", "description": "주문금액 / 길이 18" }, "cor_can_qty": { "type": "integer", "format": "int64", "description": "정정취소수량 / 길이 18" }, "cor_can_cfm_qty": { "type": "integer", "format": "int64", "description": "정정취소확인수량 / 길이 18" }, "frs_ny_cns_qty": { "type": "integer", "format": "int64", "description": "선물미체결수량 / 길이 18" }, "frs_cns_qty": { "type": "integer", "format": "int64", "description": "선물체결수량 / 길이 18" }, "frs_cns_amt": { "type": "number", "format": "double", "description": "선물체결금액 / 길이 15" }, "fno_cns_pr": { "type": "number", "format": "double", "description": "선물옵션체결가격 / 길이 15.2" }, "fr_mct_cns_amt": { "type": "number", "format": "double", "description": "원월물체결금액 / 길이 15" }, "nr_mct_cns_amt": { "type": "number", "format": "double", "description": "근월물체결금액 / 길이 15" }, "frs_orr_mdi_dit_cd": { "type": "string", "description": "선물주문매체구분코드 / 길이 1 / 0.해당사항없음\n1.영업점단말\n2.유선단말\n3.무선단말\n4.HTS\n5.기타\n9.KRX 전문기준 기타\n_.해당사항없음" }, "mmb_pcs_hdn": { "type": "string", "description": "회원처리항목 / 길이 30" }, "ivs_sgy_cd": { "type": "string", "description": "투자전략코드 / 길이 2 / 20.차익거래 21.인덱스매매 22.PI 23.자산분배 24.헷지거래 25.기타 _.해당사항없음" }, "amn_emp_no": { "type": "string", "description": "관리사원번호 / 길이 6" }, "fnd_amn_emp_no": { "type": "string", "description": "펀드관리사원번호 / 길이 6" }, "frs_fnd_no": { "type": "string", "description": "선물펀드번호 / 길이 5" }, "fno_rjt_rsn_cd": { "type": "string", "description": "선물옵션거부사유코드 / 길이 4 / 0000.정상 0001.사용자 검증(ID, Password) 오류 0002.세션 Message 전문 순서 오류 0003.Header 회원번호 오류 0004.데이터 일련번호 오류 0005.데이터 건수 오류 0006.업무 기 마감 0007.온라인 개시 이전 0008.세션 전문 Message Type 오류 0009.업무 처리 중 0010.Header의 정의된 Msg 길이와 수신 길이가 틀린 경우 0011.암복호화관련오류 0012.수신된 Message Body내에 Null데이터가 존재할 경우 0013.호가접수정지중 0014.정의된 전문 길이와 상이 0016.과다호가 경고 해제 0017.과다호가 접수제한에 의한 호가거부 0018.전문 TR코드 오류 0019.최종마감 이후 주문 호가거부 0020.매매거래시간 종료 후(최종거래일 종목 마감시간은 해당사항 없음) 0021.해당 종목의 시장조성회원 아님 0022.시장조성대상종목 아님 0024.시장조성 적용계좌의 미등록 0025.시장조성호가 한도수량 초과 0026.협의대량거래의 취소호가중 일부취소 불가 0027.지정가외 주문유형 입력불가 0033.전체매매거래중단 0035.가격급변중단(주식C/B,선물C/B) 0036.당해회원 위탁주문 제한중 0037.당해회원 자기주문 제한중 0038.포지션한도 초과 0039.조건부지정가는 종가개시후 및 최종거래일 입력불가 0040.최유리지정가주문 단일호가시간 입력불가 0041.스프레드종목 단일가주문시간 입력불가 0042.시장가 주문 입력제한 0043.조건부지정가 주문 입력제한 0044.최유리지정가 주문 입력제한 0045.주문번호 등록 0046.최종거래일 종목마감후 입력불가 0047.거부호가에 대한 정정 및 취소 0048.주문조건 입력오류(2007.8) 0049.일부충족,전량충족 호가의 단일가 시간중 입력불가(2007.8) 0050.원호가가 일부충족, 전량충족인 호가의 정정/.취소 불가(2007.8) 0051.지정가이외 일부충족, 전량충족 입력불가(2007.8) 0053.시장조성호가의 주문조건을 일부충족, 전량충족으로 입력불가(2007.8) 0054.거래불가 상품(2007.8) 0055.대량거래 가능시간이 아님(2007.8) 0056.대량거래 가능상품이 아님(2007.8) 0057.협의대량거래 상대회원번호 입력 오류(2007.8) 0058.협의대량거래 상대계좌번호 입력 오류(2007.8) 0059.대량거래 협의완료시각 입력 오류(2007.8) 0060.주문구분 입력 오류(2007.8) 0061.대량거래호가 호가수량범위 위반(2007.8) 0062.대량거래 협의완료시각 초과(2007.8) 0063.시장조성계좌로 대량거래주문을 입력(2007.8) 0064.예상체결가관련 단일가 마감 1분전 호가 정정취소 불가(2007.8) 0080.협의대량거래 체결가격범위위반(2007.8) 0081.잔량없는 원주문에 대한 정정/취소 0082.접수된 대량거래호가 협의완료시각 초과(2007.8) 0083.단일가 매매시 매매체결 불성립으로 단일가 연장 중 최유리지정가 주문 0084.단일가 매매거래시간중 일부충족, 전량충족 입력(2007.8) 0085.전량충족의 전량체결 불가능, 일부충족의 일부체결 가능수량이 없는 경우(2007.8) 0086.일부충족 호가시 일부체결 및 일부취소되는 경우 취소건에 대한 코드(2007.8) 0087.특정시간 거래미형성으로 협의대량거래 불가(2007.8) 0089.MOC 전문항목 오류 0090.시스템 오류 0098.MOC 전문항목 오류 0101.호가접수 개시 전 0102.매매거래시간 종료 후 0103.호가접수정지중 0104.종목 호가접수정지중 0105.호가가격 Format 오류 0106.시장조성자호가구분번호 Format 오류 0107.협상번호 Format 오류 0108.협상상세번호 Format 오류 0109.호가수량 Format 오류 0110.주문수신 회선 오류 0111.정규/시간외시장 종료후 취소호가 0112.주문ID Format 오류 0113.현물가격 Format 오류 0114.호가수익률 Format 오류 0115.최소체결수량 Format 오류 0201.종목코드 오류 0202.매도매수구분 오류 0203.계좌번호 오류 0204.일자 오류 0205.주문매체구분코드 오류 0206.주문ID 오류 0207.주문ID 중복 0208.정규시간외구분 오류 0209.TR-Code 오류 0211.위탁사번호 오류 0212.대용주권계좌번호 오류 0213.주문 재송신에 의한 주문ID 중복 0214.거래시장선택구분코드 오류 0301.정상호가 범위 위반 0302.호가가격 오류 0303.호가가격단위 오류 0304.현물가격 오류 0305.현물가격단위 오류 0306.실시간가격제한 범위위반 0307.조건가격 오류 0401.호가 제한수량 초과 0402.호가수량 오류 0404.최소체결수량 오류 0501.거래정지 종목 0502.시장임시정지중 0503.최종거래일 종목마감 0504.예상체결가관련 단일가마감 1분전 호가 정정ㆍ취소 불가 0505.CB발동중 0506.선물스프레드종목 주문불가 시점 0507.종가개시후 조건부지정가 입력불가 0508.기준가 미산출종목 호가입력 불가 0509.기초자산소속시장거래정지중 0510.조기종료발생 매매거래정지 종목 0512.휴장일에 따른 호가접수 중지 0513.Shutdown 중 0514.중간가호가 효력배제중 0601.위탁자기 구분 오류 0602.국가코드 구분오류 0603.투자자구분코드 오류 0604.외국인투자자구분코드 오류 0605.Reg.S 미국국적 개인투자자 매수호가불가 0606.알고리즘거래자ID 오류 0607.호가그룹번호 오류 0608.자전거래방지코드 오류 0609.권리유형코드 오류 0701.호가유형 오류 0702.호가조건 오류 0703.종가미실시종목 조건부지정가 입력불가 0704.상하한가격 호가유형 오류 0705.단일가연장중 호가유형 오류 0706.단일가연장중 호가조건 오류 0707.실시간가격제한 해제중 호가유형 오류 0801.정정취소구분 오류 0802.원주문ID 누락 0803.원호가 없음 0804.정정취소잔량 없음 0805.정정취소수량 초과 0806.취소호가에 대한 정정, 취소 0807.거부호가에 대한 정정, 취소 0808.동일가격 정정불가 0809.특정 호가유형간 정정불가 0810.원주문ID 오류 0811.취소후 잔량 최소요건 위반 0812.정정취소 매도수구분 불일치 0813.정정취소 위탁상품 불일치 0814.정정취소 공매도구분 불일치 0815.정정취소 알고리즘거래자ID 불일치 0901.회원번호 오류 0902.해당 종목 거래불가 회원/계좌 0907.포지션한도 초과 0908.회원의 해당종목 매매 제한중 0911.회원 매매거래 제한중 0913.미등록 알고리즘거래자 오류 0998.보류주문 승인 취소 1001.지점번호 오류 1006.지점의 해당종목 매매 제한중 1007.지점 매매거래 제한중 1101.LP/MM호가구분번호 오류 1102.LP/MM 대상종목 아님 1103.해당 종목의 LP/MM 회원 아님 1104.LP/MM호가 호가유형오류 1105.LP/MM호가 호가조건오류 1106.LP/MM호가 위탁자기구분 오류 1107.LP호가 최소호가수량 위반 1108.LP호가 정상호가 범위 위반 1109.MM호가 단일가 주문시간 입력불가 1110.상장주식수 초과 1111.LP 보유수량 초과 1112.LP 상대호가 없음 1113.LP호가 상대최우선 호가수량 이상 1114.LP호가 상대최우선 LP호가 기제출 1115.LP호가 허용 방향 오류 1116.MM호가 신탁계좌 불가 1201.대량매매구분 오류 1202.대량매매 호가 중복 1203.협상서 불일치 1204.협상서 없음 1205.대량매매 불가 종목 1206.대량매매 불가 시점 1207.대량매매 호가수량 오류 1208.거래미형성으로 대량매매 불가 1209.협의대량거래 상대회원번호 입력 오류 1210.협의대량거래 상대계좌번호 입력 오류 1211.협의대량거래 협의완료시각 입력 오류 1212.협의대량거래 협의완료시각 초과 1214.대량매매 체결가격범위 위반 1215.협의대량거래 불가능 계좌 1216.대량매매 일부취소 불가 1217.대량거래 협상번호 입력오류 1218.대량거래 협의상세번호 입력오류 1219.대량거래 협상자ID 입력오류 1220.바스켓 구성종목중 일부종목 거래정지중 1221.대량거래 체결 완료 1222.정상협상에 대한 취소 1223.대량매매호가 협상무효 1224.대량매매호가 시장구분 오류 1225.협상서 불일치 매도매수구분코드 오류 1226.협상서 불일치 정규시간외구분코드 오류 1227.협상서 불일치 대량매매구분코드 오류 1228.협상서 불일치 회원번호 오류 1229.협상서 불일치 호가수량 오류 1230.협상서 불일치 호가일자 오류 1231.협상서 불일치 종목코드 오류 1232.EFP 현물가격 가격범위 위반 1233.EFP 미결제약정수량 초과 1234.EFP거래 불가 종목 1235.FLEX거래 불가 종목 1236.협의거래 거래리포트ID 오류 1237.협의거래 EUREX청산결제계좌 오류 1238.협의거래 불일치 종목코드 오류 1239.협의거래 불일치 회원번호 오류 1240.협의거래 불일치 계좌비밀번호 오류 1241.협의거래 호가제한수량 초과 1242.협의거래 계좌비밀번호 오류 1243.협의거래 수탁거부신고 불가시점 1244.협의거래 수탁거부신고및취소 수량없음 1245.협의거래 호가제한수량 미만 1246.협상서 불일치 자사주신고서ID 오류 1247.협상서 불일치 자사주매매방법코드 오류 1248.협상서 불일치 협상자ID 오류 1249.협상서 불일치 호가가격 오류 1250.협상서 불일치 매도유형코드 오류 1251.장중 경쟁대량매매 불가 시점 1252.시간외 경쟁대량매매 불가 시점 1253.경쟁대량매매 불가종목 1254.채권협상 협상수량 오류 1255.채권협상 협상금액 오류 1256.채권협상 매수협상주문건수 오류 1257.채권협상 매도협상주문건수 오류 1258.채권협상 바스켓종목수 오류 1259.채권협상 거래대금 오류 1260.채권협상 체결수량 오류 1261.채권협상 전송시각 범위 초과 1301.계좌구분코드 오류 1302.계좌증거금유형 오류 1303.사후위탁증거금 적용계좌의 미등록 1304.시장조성 적용계좌의 미등록 1401.시간외매매 불가 종목 1402.장개시전 시간외매매 불가 종목 1403.시간외종가매매 정정 불가 1404.임의종료 적용중 시간외매매 불가 1405.거래미형성으로 시간외매매 불가 1406.시간외 매매 정상호가 범위 위반 1407.BUY-IN 매매 불가종목 1408.일반 BUY-IN 호가접수 불가 시점 1409.당일 BUY-IN 호가접수 불가 시점 1501.신용구분 오류 1502.신용주문 불가종목 1503.신용주분 호가가격 오류 1504.신용주문 호가유형 오류 1505.신용주문 호가조건 오류 1506.신용주문 호가입력제한 1601.자사주신고서 ID 오류 1602.자사주 매매방법 구분 오류 1603.자사주 매도매수구분 오류 1604.자사주 호가수량 오류 1605.자사주 호가가격 오류 1606.자사주 호가제한 수량 초과 1607.자사주 호가유형 오류 1608.자사주 호가조건 오류 1609.자사주 호가 회원사 오류 1610.자사주 일반호가 불가 시점 1611.자사주 정정 불가 시점 1612.자사주 호가취소 불가 1613.자사주 불가 종목 1614.자사주호가 LP/MM호가구분번호 오류 1615.자사주호가 매도유형코드 오류 1616.자사주호가 투자자구분코드 오류 1701.프로그램매매 구분 오류 1702.프로그램매매 종목 오류 1801.매도유형코드 오류 1802.공매도 호가가격 오류 1803.공매도 호가유형 오류 1804.공매도 호가조건 오류 1805.공매도 호가입력제한 1806.차입증권 공매도 불가 종목 1901.프로그램호가 신고구분코드 오류 1902.종가단일가시 신고구분코드 오류 1903.불균형 미발생시 사후신고 불가 1904.매수호가 기준가 초과 오류 1905.매수호가 현재가 초과 오류 1906.매도 불균형시 매도호가 입력 불가 1907.매도호가 기준가 미만 오류 1908.매도호가 현재가 미만 오류 1909.매수 불균형시 매수호가 입력 불가 1910.지수차익거래 종목 오류 1911.지수비차익거래 종목 오류 1912.사후신고시 시장가호가 불가 2001.경매매호가 접수불가시점 2002.경매매 매도호가 정정불가 2003.경매매 불가종목 2004.시가기준가종목 경매매 불가 2005.경매매신청서에 대한 종목 불일치 2006.경매매신청서에 대한 회원번호 불일치 2007.경매매신청서에 대한 신청수량 불일치 2008.경매매신청서에 대한 가격 불일치 2009.경매매 미신청 종목에 대한 매수호가 불가 2010.경매매 최저입찰가격 미만 매수호가 불가 2011.경매매 매도잔량 존재시 매도호가 추가제출 불가 4001.복합호가 미적용 상품 4002.복합호가 구성종목별 기초자산 상이 4003.복합호가 구성종목별 거래승수 상이 4004.복합호가 선물스프레드종목과 동일 4005.복합호가 국채선물간 기초자산 동일 4006.복합호가 주문불가시점(단일가 중) 4007.복합호가 구성종목수 미달 4008.복합호가 정정취소 불가 4009.복합호가 구성종목 중복 4010.복합호가 제재대상 구성종목 포함 4011.복합호가 전종목 체결불가 4101.Kill Switch 발동계좌 호가거부 5101.USG호가접수불가*(장개시10분전까지) 5102.USG호가접수불가*(장마감후) 5103.CME호가접수불가*(장개시전/장마감후,장중단시) 5104.호가가격 Format 오류 5105.호가수량 Format 오류 5106.주문수신 회선 오류 5201.종목코드 오류 5202.매도매수구분 오류 5203.계좌번호 오류, 포맷오류+정정/취소 원호가계좌번호 상이 5204.일자 오류* 5205.주문매체구분코드 오류 5206.주문ID 오류 5207.주문ID 중복 5208.보드 ID 오류 5209.트랜잭션코드(TR CODE) 오류 5210.대용주권계좌번호 오류 5211.프로그램매매(PT)구분오류 5301.정상호가 범위 위반 5302.호가가격 오류 5303.호가가격단위 오류 5401.호가 제한수량 초과 5402.호가수량 오류 5501.위탁자기 구분 오류 5502.국가코드 구분오류 5503.투자자구분코드 오류 5504.외국인투자자구분코드 오류 5505.계좌구분코드 오류 5506.계좌증거금유형 오류 5507.신용구분코드오류 5601.호가유형 오류 5602.호가조건 오류 5701.정정취소구분 오류 5702.원주문번호 오류 5703.접수ID 오류 5704.원호가 없음 5705.정정취소잔량 없음 5706.거부호가에 대한 정정, 취소 5707.IFM옵션오류 5708.정정시 원주문IFM옵션 변경불가 5709.원주문의 종목과 다름 5710.원주문의 정정/취소 처리중 5711.정정시 IOC/FOK 호가조건 불가 5712.CME로부터 원주문 미접수 5801.회원번호 오류 5802.포지션한도 초과 5803.회원 매매거래 제한중 5804.API주문 불가회원 5805.GTS주문 불가회원 5806.지점번호 오류 5901.USG FIX엔진 로그아웃 5902.주문경과시간(30초) 초과* 5903.CME와 세션연결 단절 5904.CME와 세션연결 거부 5999.unknown 9001.거래소 직권호가 취소 9997.거래소 장애로 응답 대기중(정정,취소불가) 9998.개별 종목장애 9999.보류주문 승인 대기중 C998.실시간가격제한 범위제한에 따른 자동취소 C999.자동취소 COD_.COD 발동으로 자동취소 EURX.유렉스 부로커거부 GB00.구NH)FEP거부 J001.TRCODE입력 오류 및 순서위반 J002.주문일련번호 이상 J003.접속ID 입력오류 J004.입력형식 오류 J005.전송길이 오류 J006.전송길이대비 입력건수 오류 J011.주문수신 개시전 J012.매매거래시간 종료후 J013.주문수신 일시중지(거래소의 장중단 조치경우) J014.블록주문내역중 주문일련번호 오류 J015.블록주문내역중 입력형식 오류및 기타 J998.보류주문 승인 취소 KILL.KILL-SWITCH 발동으로 인한 자동취소 MOC_.MOC 발동으로 자동취소 TIME.DMA주문 타임아웃 FEP 거부" }, "orr_orn_dit_cd": { "type": "string", "description": "주문발생구분코드 / 길이 1 / 0.일반 1.자동반대매매 2.지점반대매매 3.Auto-Lock주문 4.예약주문 5.최종결제 6.착오매매정정 7.유렉스 8.착오거래구제 9.부산FEP주문 A.적립식자동주문 B.스마트인베스터주문 C.파생협의대량 D.자문사로보주문 E.NH로보주문 F.반대매매지점임의취소 G.지점반대매매(예약) H.장외파생CFD선택청산주문 I.분할주문 J.임의매매 K.장외파생CFD권리 L.장외파생CFD리셋 M.장외파생CFD실시간반대매매 N.권리전강제청산 O.소수점예약주문 P.소수점적립식자동주문 Q.소수점반대매매 R.소수점배분후잔량주문 S.소수점Book운용주문 T.Wrap주문 U.NH로보자동주문 V.비대면일임형주문 W.파생야간주문 X.대출반대매매 Y.소수점매매 선물하기 Z.파생야간협의대량 a.비대면주문대리인법인" }, "wtm_mpi_qty": { "type": "integer", "format": "int64", "description": "증거금부과수량 / 길이 18" }, "wtm_iny_qty": { "type": "integer", "format": "int64", "description": "증거금면제수량 / 길이 18" }, "pcs_rlt_msg_cd": { "type": "string", "description": "처리결과메시지코드 / 길이 4" }, "rsl_amn_tab_cd": { "type": "string", "description": "실적관리팀점코드 / 길이 4" }, "pcs_tab_cd": { "type": "string", "description": "처리팀점코드 / 길이 4" }, "hts_usr_id": { "type": "string", "description": "HTS사용자ID / 길이 20" }, "orr_rtn_tm": { "type": "string", "description": "주문접수시각 / 길이 9" }, "egc_orr_dit_cd": { "type": "string", "description": "비상주문구분코드 / 길이 1 / 0.정상주문 1.거래소단말비상주문 2.자체비상주문" }, "rgs_emp_no": { "type": "string", "description": "등록사원번호 / 길이 6" }, "act_amn_tab_nm": { "type": "string", "description": "계좌관리팀점명 / 길이 50" }, "orr_cnd_dit_cd_nm": { "type": "string", "description": "주문조건구분코드명 / 길이 60" }, "sby_dit_nm": { "type": "string", "description": "매매구분명 / 길이 4" }, "cor_can_dit_nm": { "type": "string", "description": "정정취소구분명 / 길이 4" }, "nmn_pr_tp_cd_nm": { "type": "string", "description": "호가유형코드명 / 길이 60" }, "trd_tp_nm": { "type": "string", "description": "거래유형명 / 길이 60" }, "orr_mdi_nm": { "type": "string", "description": "주문매체명 / 길이 20" }, "usr_ip_adr": { "type": "string", "description": "사용자IP주소 / 길이 32" } } } }, "Output_1": { "type": "object", "properties": { "frs_sll_amt": { "type": "integer", "format": "int64", "description": "선물매도금액 / 길이 18" }, "frs_sll_qty": { "type": "integer", "format": "int64", "description": "선물매도수량 / 길이 18" }, "frs_byn_qty": { "type": "integer", "format": "int64", "description": "선물매수수량 / 길이 18" }, "frs_byn_amt": { "type": "integer", "format": "int64", "description": "선물매수금액 / 길이 18" }, "opt_byn_amt": { "type": "integer", "format": "int64", "description": "옵션매수금액 / 길이 18" }, "opt_byn_qty": { "type": "integer", "format": "int64", "description": "옵션매수수량 / 길이 18" }, "opt_sll_qty": { "type": "integer", "format": "int64", "description": "옵션매도수량 / 길이 18" }, "opt_sll_amt": { "type": "integer", "format": "int64", "description": "옵션매도금액 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ], "x-schema-warning": [ { "missing_blocks": [ "Output_1" ] } ] } }, "/krfuture/inquiry/v1/commission": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krfutureInquiryCommission", "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" } }, "required": [ "act_no", "sta_dt", "end_dt" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "선물매수약정수량 / 길이 22" }, "frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "선물매도약정수량 / 길이 22" }, "frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "선물매수약정금액 / 길이 22" }, "frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "선물매도약정금액 / 길이 22" }, "frs_pls_amt": { "type": "integer", "format": "int64", "description": "선물손익금액 / 길이 22" }, "frs_fee": { "type": "integer", "format": "int64", "description": "선물수수료 / 길이 22" }, "kar_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "스타지수선물매수약정수량 / 길이 22" }, "kar_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "스타지수선물매도약정수량 / 길이 22" }, "kar_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "스타지수선물매수약정금액 / 길이 22" }, "kar_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "스타지수선물매도약정금액 / 길이 22" }, "kar_frs_pls_amt": { "type": "integer", "format": "int64", "description": "스타지수선물손익금액 / 길이 22" }, "kar_frs_fee": { "type": "integer", "format": "int64", "description": "스타지수선물수수료 / 길이 22" }, "stk_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "주식선물매수약정수량 / 길이 22" }, "stk_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "주식선물매도약정수량 / 길이 22" }, "stk_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "주식선물매수약정금액 / 길이 22" }, "stk_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "주식선물매도약정금액 / 길이 22" }, "stk_frs_pls_amt": { "type": "integer", "format": "int64", "description": "주식선물손익금액 / 길이 22" }, "stk_frs_fee": { "type": "integer", "format": "int64", "description": "주식선물수수료 / 길이 22" }, "idx_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "지수옵션매수약정수량 / 길이 22" }, "idx_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "지수옵션매도약정수량 / 길이 22" }, "idx_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "지수옵션매수약정금액 / 길이 22" }, "idx_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "지수옵션매도약정금액 / 길이 22" }, "iopt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "주식옵션매수약정수량 / 길이 22" }, "iopt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "주식옵션매도약정수량 / 길이 22" }, "iopt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "주식옵션매수약정금액 / 길이 22" }, "iopt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "주식옵션매도약정금액 / 길이 22" }, "idx_opt_pls_amt": { "type": "integer", "format": "int64", "description": "지수옵션손익금액 / 길이 22" }, "iopt_pls_amt": { "type": "integer", "format": "int64", "description": "주식옵션손익금액 / 길이 22" }, "opt_fee": { "type": "integer", "format": "int64", "description": "옵션수수료 / 길이 22" }, "ctc_qty_sum": { "type": "integer", "format": "int64", "description": "약정수량합계 / 길이 22" }, "ctc_amt_sum": { "type": "integer", "format": "int64", "description": "약정금액합계 / 길이 22" }, "idx_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "지수옵션약정수량 / 길이 22" }, "idx_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "지수옵션약정금액 / 길이 22" }, "iopt_ctc_qty": { "type": "integer", "format": "int64", "description": "주식옵션약정수량 / 길이 22" }, "iopt_ctc_amt": { "type": "integer", "format": "int64", "description": "주식옵션약정금액 / 길이 22" }, "pls_amt_sum": { "type": "integer", "format": "int64", "description": "손익금액합계 / 길이 22" }, "fee_sum": { "type": "integer", "format": "int64", "description": "수수료합계 / 길이 22" }, "act_atc_fnm": { "type": "string", "description": "계좌부속성명 / 길이 40" }, "byn_eal_amt": { "type": "integer", "format": "int64", "description": "매수평가금액 / 길이 18" }, "sll_eal_amt": { "type": "integer", "format": "int64", "description": "매도평가금액 / 길이 18" }, "frs_xcl_dpa": { "type": "integer", "format": "int64", "description": "선물정산차금 / 길이 18" }, "kar_xcl_dpa": { "type": "integer", "format": "int64", "description": "스타지수정산차금 / 길이 18" }, "stk_frs_xcl_dpa": { "type": "integer", "format": "int64", "description": "주식선물정산차금 / 길이 18" }, "opt_byn_amt": { "type": "integer", "format": "int64", "description": "옵션매수금액 / 길이 18" }, "opt_sll_amt": { "type": "integer", "format": "int64", "description": "옵션매도금액 / 길이 18" }, "opt_eal_amt": { "type": "integer", "format": "int64", "description": "옵션평가금액 / 길이 18" }, "vty_idx_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "변동성지수선물매수약정수량 / 길이 18" }, "vty_idx_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "변동성지수선물매도약정수량 / 길이 18" }, "vty_idx_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "변동성지수선물매수약정금액 / 길이 18" }, "vty_idx_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "변동성지수선물매도약정금액 / 길이 18" }, "vty_idx_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "변동성지수선물당일손익금액 / 길이 18" }, "vty_idx_frs_fee": { "type": "integer", "format": "int64", "description": "변동성지수선물수수료 / 길이 18" }, "ser_idx_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "섹터지수선물매수약정수량 / 길이 18" }, "ser_idx_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "섹터지수선물매도약정수량 / 길이 18" }, "ser_idx_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "섹터지수선물매수약정금액 / 길이 18" }, "ser_idx_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "섹터지수선물매도약정금액 / 길이 18" }, "ser_idx_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "섹터지수선물당일손익금액 / 길이 18" }, "ser_idx_frs_fee": { "type": "integer", "format": "int64", "description": "섹터지수선물수수료 / 길이 18" }, "mini_ksp_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "미니코스피선물매수약정수량 / 길이 18" }, "mini_ksp_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "미니코스피선물매도약정수량 / 길이 18" }, "mini_ksp_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "미니코스피선물매수약정금액 / 길이 18" }, "mini_ksp_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "미니코스피선물매도약정금액 / 길이 18" }, "mini_ksp_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "미니코스피당일손익금액 / 길이 18" }, "mini_ksp_frs_fee": { "type": "integer", "format": "int64", "description": "미니코스피선물수수료 / 길이 18" }, "ksq150_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150선물매수약정수량 / 길이 18" }, "ksq150_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150선물매도약정수량 / 길이 18" }, "ksq150_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150선물매수약정금액 / 길이 18" }, "ksq150_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150선물매도약정금액 / 길이 18" }, "ksq150_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥150선물당일손익금액 / 길이 18" }, "ksq150_frs_fee": { "type": "integer", "format": "int64", "description": "코스닥150선물수수료 / 길이 18" }, "ero_50_idx_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "유로화50지수선물매수약정수량 / 길이 18" }, "ero_50_idx_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "유로화50지수선물매수약정금액 / 길이 18" }, "ero_50_idx_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "유로화50지수선물매도약정수량 / 길이 18" }, "ero_50_idx_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "유로화50지수선물매도약정금액 / 길이 18" }, "ero_50_idx_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "유로화50지수선물당일손익금액 / 길이 18" }, "ero_50_idx_frs_fee": { "type": "integer", "format": "int64", "description": "유로화50지수선물수수료 / 길이 18" }, "ksq150_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150옵션매수약정수량 / 길이 18" }, "ksq150_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150옵션매도약정수량 / 길이 18" }, "ksq150_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션매수약정금액 / 길이 18" }, "ksq150_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션매도약정금액 / 길이 18" }, "ksq150_opt_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션당일손익금액 / 길이 18" }, "ksq150_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150옵션약정금액 / 길이 18" }, "ksq150_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150옵션약정수량 / 길이 18" }, "krx300_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "거래소300선물매수약정수량 / 길이 18" }, "krx300_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "거래소300선물매도약정수량 / 길이 18" }, "krx300_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "거래소300선물매수약정금액 / 길이 18" }, "krx300_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "거래소300선물매도약정금액 / 길이 18" }, "krx300_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "거래소300선물당일손익금액 / 길이 18" }, "krx300_frs_fee": { "type": "integer", "format": "int64", "description": "거래소300선물수수료 / 길이 18" }, "ksp200_wky_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매수약정수량 / 길이 18" }, "ksp200_wky_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매도약정수량 / 길이 18" }, "ksp200_wky_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매수약정금액 / 길이 18" }, "ksp200_wky_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션매도약정금액 / 길이 18" }, "ksp200_wky_opt_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션당일손익금액 / 길이 18" }, "ksp200_wky_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션약정금액 / 길이 18" }, "ksp200_wky_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "코스피200위클리옵션약정수량 / 길이 18" }, "ksq_gbl_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매수약정수량 / 길이 18" }, "ksq_gbl_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매도약정수량 / 길이 18" }, "ksq_gbl_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매수약정금액 / 길이 18" }, "ksq_gbl_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물매도약정금액 / 길이 18" }, "ksq_gbl_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물당일손익금액 / 길이 18" }, "ksq_gbl_frs_fee": { "type": "integer", "format": "int64", "description": "코스닥글로벌선물수수료 / 길이 18" }, "kor_vup_frs_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매수약정수량 / 길이 18" }, "kor_vup_frs_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매도약정수량 / 길이 18" }, "kor_vup_frs_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매수약정금액 / 길이 18" }, "kor_vup_frs_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코리아밸류업선물매도약정금액 / 길이 18" }, "kor_vup_frs_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코리아밸류업선물당일손익금액 / 길이 18" }, "kor_vup_frs_fee": { "type": "integer", "format": "int64", "description": "코리아밸류업선물수수료 / 길이 18" }, "ksq150_wky_opt_byn_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매수약정수량 / 길이 18" }, "ksq150_wky_opt_sll_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매도약정수량 / 길이 18" }, "ksq150_wky_opt_byn_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매수약정금액 / 길이 18" }, "ksq150_wky_opt_sll_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션매도약정금액 / 길이 18" }, "ksq150_wky_opt_tdt_pls_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션당일손익금액 / 길이 18" }, "ksq150_wky_opt_ctc_amt": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션약정금액 / 길이 18" }, "ksq150_wky_opt_ctc_qty": { "type": "integer", "format": "int64", "description": "코스닥150위클리옵션약정수량 / 길이 18" }, "stk_wky_opt_byn_ctc_qty": { "type": "string", "description": "주식위클리옵션매수약정수량 / 길이 18" }, "stk_wky_opt_sll_ctc_qty": { "type": "string", "description": "주식위클리옵션매도약정수량 / 길이 18" }, "stk_wky_opt_byn_ctc_amt": { "type": "string", "description": "주식위클리옵션매수약정금액 / 길이 18" }, "stk_wky_opt_sll_ctc_amt": { "type": "string", "description": "주식위클리옵션매도약정금액 / 길이 18" }, "stk_wky_opt_tdt_pls_amt": { "type": "string", "description": "주식위클리옵션당일손익금액 / 길이 18" }, "stk_wky_opt_ctc_amt": { "type": "string", "description": "주식위클리옵션약정금액 / 길이 18" }, "stk_wky_opt_ctc_qty": { "type": "string", "description": "주식위클리옵션약정수량 / 길이 18" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krfuture/quote/v1/day": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteDay", "summary": "선물옵션 시세주간", "description": "국내선물옵션 주간시세 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: 예시 응답에는 명세에 없는 블록(Output_2)이 포함되어 있습니다.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 9 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" } }, "required": [ "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 8" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 80" }, "prpr": { "type": "number", "format": "float", "description": "현재가 / 길이 10.2" }, "sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "vrss": { "type": "number", "format": "float", "description": "등락폭 / 길이 10.2" }, "ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "hts_thpr": { "type": "number", "format": "float", "description": "이론가 / 길이 10.2" }, "dprt_value": { "type": "number", "format": "float", "description": "괴리도 / 길이 10.2" }, "dprt": { "type": "number", "format": "float", "description": "괴리율 / 길이 5.2" }, "acml_vol": { "type": "integer", "format": "int64", "description": "거래량 / 길이 12" }, "volrate": { "type": "number", "format": "float", "description": "거래비율 / 길이 10.2" }, "dscs_lrqn_vol": { "type": "integer", "format": "int64", "description": "협의거래량 / 길이 12" }, "acml_tr_pbmn": { "type": "integer", "format": "int64", "description": "누적거래대금 / 길이 12 / 선물(백만) 옵션(십만)" }, "otst_qty": { "type": "integer", "format": "int64", "description": "미결제약정수량 / 길이 12" }, "prdy_otst_qty": { "type": "integer", "format": "int64", "description": "미결제약정전일 / 길이 12" }, "mxpr": { "type": "number", "format": "float", "description": "상한가 / 길이 10.2" }, "hgpr": { "type": "number", "format": "float", "description": "고가 / 길이 10.2" }, "oprc": { "type": "number", "format": "float", "description": "시가 / 길이 10.2" }, "lwpr": { "type": "number", "format": "float", "description": "저가 / 길이 10.2" }, "llam": { "type": "number", "format": "float", "description": "하한가 / 길이 10.2" }, "dmrs": { "type": "number", "format": "float", "description": "DEMARK저항 / 길이 10.2" }, "dmsp": { "type": "number", "format": "float", "description": "DEMARK지지 / 길이 10.2" }, "lstn_medm_hgpr": { "type": "number", "format": "float", "description": "상장후최고가 / 길이 10.2" }, "lstn_hgpr_date": { "type": "string", "description": "상장후최고일 / 길이 8" }, "lstn_medm_lwpr": { "type": "number", "format": "float", "description": "상장후최저가 / 길이 10.2" }, "lstn_lwpr_date": { "type": "string", "description": "상장후최저일 / 길이 8" }, "last_tr_date": { "type": "string", "description": "최종거래일 / 길이 8" }, "hts_rmnn_dynu": { "type": "integer", "format": "int32", "description": "잔존일 / 길이 4" }, "bsop_hour": { "type": "string", "description": "호가시간 / 길이 8" }, "askp1": { "type": "number", "format": "float", "description": "매도최우선호가 / 길이 10.2" }, "askp2": { "type": "number", "format": "float", "description": "매도차선호가 / 길이 10.2" }, "askp3": { "type": "number", "format": "float", "description": "매도차차선호가 / 길이 10.2" }, "askp4": { "type": "number", "format": "float", "description": "매도4차선호가 / 길이 10.2" }, "askp5": { "type": "number", "format": "float", "description": "매도5차선호가 / 길이 10.2" }, "bidp1": { "type": "number", "format": "float", "description": "매수최우선호가 / 길이 10.2" }, "bidp2": { "type": "number", "format": "float", "description": "매수차선호가 / 길이 10.2" }, "bidp3": { "type": "number", "format": "float", "description": "매수차차선호가 / 길이 10.2" }, "bidp4": { "type": "number", "format": "float", "description": "매수4차선호가 / 길이 10.2" }, "bidp5": { "type": "number", "format": "float", "description": "매수5차선호가 / 길이 10.2" }, "askp_rsqn1": { "type": "integer", "format": "int64", "description": "매도최우선잔량 / 길이 12" }, "askp_rsqn2": { "type": "integer", "format": "int64", "description": "매도차선잔량 / 길이 12" }, "askp_rsqn3": { "type": "integer", "format": "int64", "description": "매도차차선잔량 / 길이 12" }, "askp_rsqn4": { "type": "integer", "format": "int64", "description": "매도4차선잔량 / 길이 12" }, "askp_rsqn5": { "type": "integer", "format": "int64", "description": "매도5차선잔량 / 길이 12" }, "bidp_rsqn1": { "type": "integer", "format": "int64", "description": "매수최우선잔량 / 길이 12" }, "bidp_rsqn2": { "type": "integer", "format": "int64", "description": "매수차선잔량 / 길이 12" }, "bidp_rsqn3": { "type": "integer", "format": "int64", "description": "매수차차선잔량 / 길이 12" }, "bidp_rsqn4": { "type": "integer", "format": "int64", "description": "매수4차선잔량 / 길이 12" }, "bidp_rsqn5": { "type": "integer", "format": "int64", "description": "매수5차선잔량 / 길이 12" }, "total_askp_rsqn": { "type": "integer", "format": "int64", "description": "총매도잔량 / 길이 12" }, "total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "총매수잔량 / 길이 12" }, "askp_csnu1": { "type": "integer", "format": "int32", "description": "매도최우선건수 / 길이 10" }, "askp_csnu2": { "type": "integer", "format": "int32", "description": "매도차선건수 / 길이 10" }, "askp_csnu3": { "type": "integer", "format": "int32", "description": "매도차차선건수 / 길이 10" }, "askp_csnu4": { "type": "integer", "format": "int32", "description": "매도4차선건수 / 길이 10" }, "askp_csnu5": { "type": "integer", "format": "int32", "description": "매도5차선건수 / 길이 10" }, "bidp_csnu1": { "type": "integer", "format": "int32", "description": "매수최우선건수 / 길이 10" }, "bidp_csnu2": { "type": "integer", "format": "int32", "description": "매수차선건수 / 길이 10" }, "bidp_csnu3": { "type": "integer", "format": "int32", "description": "매수차차선건수 / 길이 10" }, "bidp_csnu4": { "type": "integer", "format": "int32", "description": "매수4차선건수 / 길이 10" }, "bidp_csnu5": { "type": "integer", "format": "int32", "description": "매수5차선건수 / 길이 10" }, "total_askp_csnu": { "type": "integer", "format": "int32", "description": "총매도건수 / 길이 10" }, "total_bidp_csnu": { "type": "integer", "format": "int32", "description": "총매수건수 / 길이 10" }, "pvt_scnd_dmrs": { "type": "number", "format": "float", "description": "피봇2차저항 / 길이 10.2" }, "pvt_frst_dmrs": { "type": "number", "format": "float", "description": "피봇1차저항 / 길이 10.2" }, "pvt_pont": { "type": "number", "format": "float", "description": "피봇가 / 길이 10.2" }, "pvt_frst_dmsp": { "type": "number", "format": "float", "description": "피봇1차지지 / 길이 10.2" }, "pvt_scnd_dmsp": { "type": "number", "format": "float", "description": "피봇2차지지 / 길이 10.2" }, "hts_ints_vltl": { "type": "number", "format": "float", "description": "내재변동성 / 길이 10.2" }, "unas_hist_vltl": { "type": "number", "format": "float", "description": "과거변동성90 / 길이 10.2" }, "delta": { "type": "number", "format": "float", "description": "델타지수 / 길이 10.4" }, "gama": { "type": "number", "format": "float", "description": "감마지수 / 길이 10.4" }, "vega": { "type": "number", "format": "float", "description": "베가변동성 / 길이 10.4" }, "theta": { "type": "number", "format": "float", "description": "쎄타시간 / 길이 10.4" }, "rho": { "type": "number", "format": "float", "description": "로이자율 / 길이 10.4" }, "sdpr": { "type": "number", "format": "float", "description": "기준가 / 길이 10.2" }, "cncc_cls_code": { "type": "string", "description": "동시호가구분 / 길이 1 / 1.동시호가 이외 정규시장" }, "antc_cnpr": { "type": "number", "format": "float", "description": "예상체결가 / 길이 10.2" }, "antc_sign": { "type": "string", "description": "예상체결부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "antc_vrss": { "type": "number", "format": "float", "description": "예상체결등락폭 / 길이 10.2" }, "antc_ctrt": { "type": "number", "format": "float", "description": "예상체결등락률 / 길이 5.2" }, "dynmc_uplmtprc": { "type": "number", "format": "float", "description": "실시간상한가 / 길이 10.2" }, "dynmc_lwlmtprc": { "type": "number", "format": "float", "description": "실시간하한가 / 길이 10.2" }, "dynmc_prc_lmt_yn": { "type": "string", "description": "동적가격제한여부 / 길이 1 / Y.제한 N.미제한" }, "prc_lmt_exlmtgb": { "type": "string", "description": "가격확대예정구분 / 길이 1" }, "prc_lmt_mx_step": { "type": "string", "description": "가격제한확대상한단계 / 길이 1" }, "prc_lmt_ll_step": { "type": "string", "description": "가격제한확대하한단계 / 길이 1" }, "mrkt_basis": { "type": "number", "format": "float", "description": "베이시스 / 길이 10.2" }, "ther_basis": { "type": "number", "format": "float", "description": "이론베이시스 / 길이 10.2" }, "cd_mnrt": { "type": "number", "format": "float", "description": "CD금리 / 길이 6.3" }, "unas_isnm": { "type": "string", "description": "기초지수한글명 / 길이 40" }, "prdy_hgpr": { "type": "number", "format": "float", "description": "전일고가 / 길이 10.2" }, "prdy_oprc": { "type": "number", "format": "float", "description": "전일시가 / 길이 10.2" }, "prdy_lwpr": { "type": "number", "format": "float", "description": "전일저가 / 길이 10.2" }, "dmix_wrth_val": { "type": "number", "format": "float", "description": "배당액지수 / 길이 9.6" }, "oprc_vrss_sign": { "type": "string", "description": "시가대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "oprc_vrss": { "type": "number", "format": "float", "description": "시가대비등락 / 길이 10.2" }, "cb_bhprice": { "type": "number", "format": "float", "description": "CB발동상한 / 길이 10.2" }, "cb_blprice": { "type": "number", "format": "float", "description": "CB발동하한 / 길이 10.2" }, "lstn_date": { "type": "integer", "format": "int32", "description": "최초상장일 / 길이 8" }, "antc_cnqn": { "type": "integer", "format": "int64", "description": "예상체결수량 / 길이 9" } } }, "Output_1": { "type": "object", "properties": { "jisucode": { "type": "string", "description": "기초자산지수코드 / 길이 6" }, "unas_prpr": { "type": "string", "description": "기초자산지수 / 길이 10.2" }, "unas_sign": { "type": "string", "description": "기초자산등락부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보합+리버스(기세)" }, "unas_vrss": { "type": "string", "description": "기초자산등락폭 / 길이 10.2" }, "unas_ctrt": { "type": "string", "description": "기초자산등락률 / 길이 5.2" }, "unas_vol": { "type": "string", "description": "기초자산거래량 / 길이 12" } } }, "Output_2": { "type": "object", "properties": { "starttime": { "type": "string", "description": "장시작시간 / 길이 6" }, "endtime": { "type": "string", "description": "장종료시간 / 길이 6" }, "svrtime": { "type": "string", "description": "서버타임 / 길이 14" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "missing_blocks": [ "Output_2" ] } ] } }, "/krfuture/quote/v1/night": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteNight", "summary": "선물옵션 시세야간", "description": "국내선물옵션 야간시세 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: 예시 응답에는 명세에 없는 블록(Output_2)이 포함되어 있습니다.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 9 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" } }, "required": [ "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 8" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 80" }, "prpr": { "type": "number", "format": "float", "description": "현재가 / 길이 10.2" }, "sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "vrss": { "type": "number", "format": "float", "description": "등락폭 / 길이 10.2" }, "ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "hts_thpr": { "type": "number", "format": "float", "description": "이론가 / 길이 10.2" }, "dprt_value": { "type": "number", "format": "float", "description": "괴리도 / 길이 10.2" }, "dprt": { "type": "number", "format": "float", "description": "괴리율 / 길이 5.2" }, "acml_vol": { "type": "integer", "format": "int64", "description": "거래량 / 길이 12" }, "volrate": { "type": "number", "format": "float", "description": "거래비율 / 길이 10.2" }, "dscs_lrqn_vol": { "type": "integer", "format": "int64", "description": "협의거래량 / 길이 12" }, "acml_tr_pbmn": { "type": "integer", "format": "int64", "description": "누적거래대금 / 길이 12 / 선물(백만) 옵션(십만)" }, "otst_qty": { "type": "integer", "format": "int64", "description": "미결제약정수량 / 길이 12" }, "prdy_otst_qty": { "type": "integer", "format": "int64", "description": "미결제약정전일 / 길이 12" }, "mxpr": { "type": "number", "format": "float", "description": "상한가 / 길이 10.2" }, "hgpr": { "type": "number", "format": "float", "description": "고가 / 길이 10.2" }, "oprc": { "type": "number", "format": "float", "description": "시가 / 길이 10.2" }, "lwpr": { "type": "number", "format": "float", "description": "저가 / 길이 10.2" }, "llam": { "type": "number", "format": "float", "description": "하한가 / 길이 10.2" }, "dmrs": { "type": "number", "format": "float", "description": "DEMARK저항 / 길이 10.2" }, "dmsp": { "type": "number", "format": "float", "description": "DEMARK지지 / 길이 10.2" }, "lstn_medm_hgpr": { "type": "number", "format": "float", "description": "상장후최고가 / 길이 10.2" }, "lstn_hgpr_date": { "type": "string", "description": "상장후최고일 / 길이 8" }, "lstn_medm_lwpr": { "type": "number", "format": "float", "description": "상장후최저가 / 길이 10.2" }, "lstn_lwpr_date": { "type": "string", "description": "상장후최저일 / 길이 8" }, "last_tr_date": { "type": "string", "description": "최종거래일 / 길이 8" }, "hts_rmnn_dynu": { "type": "integer", "format": "int32", "description": "잔존일 / 길이 4" }, "bsop_hour": { "type": "string", "description": "호가시간 / 길이 8" }, "askp1": { "type": "number", "format": "float", "description": "매도최우선호가 / 길이 10.2" }, "askp2": { "type": "number", "format": "float", "description": "매도차선호가 / 길이 10.2" }, "askp3": { "type": "number", "format": "float", "description": "매도차차선호가 / 길이 10.2" }, "askp4": { "type": "number", "format": "float", "description": "매도4차선호가 / 길이 10.2" }, "askp5": { "type": "number", "format": "float", "description": "매도5차선호가 / 길이 10.2" }, "bidp1": { "type": "number", "format": "float", "description": "매수최우선호가 / 길이 10.2" }, "bidp2": { "type": "number", "format": "float", "description": "매수차선호가 / 길이 10.2" }, "bidp3": { "type": "number", "format": "float", "description": "매수차차선호가 / 길이 10.2" }, "bidp4": { "type": "number", "format": "float", "description": "매수4차선호가 / 길이 10.2" }, "bidp5": { "type": "number", "format": "float", "description": "매수5차선호가 / 길이 10.2" }, "askp_rsqn1": { "type": "integer", "format": "int64", "description": "매도최우선잔량 / 길이 12" }, "askp_rsqn2": { "type": "integer", "format": "int64", "description": "매도차선잔량 / 길이 12" }, "askp_rsqn3": { "type": "integer", "format": "int64", "description": "매도차차선잔량 / 길이 12" }, "askp_rsqn4": { "type": "integer", "format": "int64", "description": "매도4차선잔량 / 길이 12" }, "askp_rsqn5": { "type": "integer", "format": "int64", "description": "매도5차선잔량 / 길이 12" }, "bidp_rsqn1": { "type": "integer", "format": "int64", "description": "매수최우선잔량 / 길이 12" }, "bidp_rsqn2": { "type": "integer", "format": "int64", "description": "매수차선잔량 / 길이 12" }, "bidp_rsqn3": { "type": "integer", "format": "int64", "description": "매수차차선잔량 / 길이 12" }, "bidp_rsqn4": { "type": "integer", "format": "int64", "description": "매수4차선잔량 / 길이 12" }, "bidp_rsqn5": { "type": "integer", "format": "int64", "description": "매수5차선잔량 / 길이 12" }, "total_askp_rsqn": { "type": "integer", "format": "int64", "description": "총매도잔량 / 길이 12" }, "total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "총매수잔량 / 길이 12" }, "askp_csnu1": { "type": "integer", "format": "int32", "description": "매도최우선건수 / 길이 10" }, "askp_csnu2": { "type": "integer", "format": "int32", "description": "매도차선건수 / 길이 10" }, "askp_csnu3": { "type": "integer", "format": "int32", "description": "매도차차선건수 / 길이 10" }, "askp_csnu4": { "type": "integer", "format": "int32", "description": "매도4차선건수 / 길이 10" }, "askp_csnu5": { "type": "integer", "format": "int32", "description": "매도5차선건수 / 길이 10" }, "bidp_csnu1": { "type": "integer", "format": "int32", "description": "매수최우선건수 / 길이 10" }, "bidp_csnu2": { "type": "integer", "format": "int32", "description": "매수차선건수 / 길이 10" }, "bidp_csnu3": { "type": "integer", "format": "int32", "description": "매수차차선건수 / 길이 10" }, "bidp_csnu4": { "type": "integer", "format": "int32", "description": "매수4차선건수 / 길이 10" }, "bidp_csnu5": { "type": "integer", "format": "int32", "description": "매수5차선건수 / 길이 10" }, "total_askp_csnu": { "type": "integer", "format": "int32", "description": "총매도건수 / 길이 10" }, "total_bidp_csnu": { "type": "integer", "format": "int32", "description": "총매수건수 / 길이 10" }, "pvt_scnd_dmrs": { "type": "number", "format": "float", "description": "피봇2차저항 / 길이 10.2" }, "pvt_frst_dmrs": { "type": "number", "format": "float", "description": "피봇1차저항 / 길이 10.2" }, "pvt_pont": { "type": "number", "format": "float", "description": "피봇가 / 길이 10.2" }, "pvt_frst_dmsp": { "type": "number", "format": "float", "description": "피봇1차지지 / 길이 10.2" }, "pvt_scnd_dmsp": { "type": "number", "format": "float", "description": "피봇2차지지 / 길이 10.2" }, "hts_ints_vltl": { "type": "number", "format": "float", "description": "내재변동성 / 길이 10.2" }, "unas_hist_vltl": { "type": "number", "format": "float", "description": "과거변동성90 / 길이 10.2" }, "delta": { "type": "number", "format": "float", "description": "델타지수 / 길이 10.4" }, "gama": { "type": "number", "format": "float", "description": "감마지수 / 길이 10.4" }, "vega": { "type": "number", "format": "float", "description": "베가변동성 / 길이 10.4" }, "theta": { "type": "number", "format": "float", "description": "쎄타시간 / 길이 10.4" }, "rho": { "type": "number", "format": "float", "description": "로이자율 / 길이 10.4" }, "sdpr": { "type": "number", "format": "float", "description": "기준가 / 길이 10.2" }, "cncc_cls_code": { "type": "string", "description": "동시호가구분 / 길이 1 / 1.동시호가 이외 정규시장" }, "antc_cnpr": { "type": "number", "format": "float", "description": "예상체결가 / 길이 10.2" }, "antc_sign": { "type": "string", "description": "예상체결부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "antc_vrss": { "type": "number", "format": "float", "description": "예상체결등락폭 / 길이 10.2" }, "antc_ctrt": { "type": "number", "format": "float", "description": "예상체결등락률 / 길이 5.2" }, "dynmc_uplmtprc": { "type": "number", "format": "float", "description": "실시간상한가 / 길이 10.2" }, "dynmc_lwlmtprc": { "type": "number", "format": "float", "description": "실시간하한가 / 길이 10.2" }, "dynmc_prc_lmt_yn": { "type": "string", "description": "동적가격제한여부 / 길이 1" }, "prc_lmt_exlmtgb": { "type": "string", "description": "가격확대예정구분 / 길이 1" }, "prc_lmt_mx_step": { "type": "string", "description": "가격제한확대상한단계 / 길이 1" }, "prc_lmt_ll_step": { "type": "string", "description": "가격제한확대하한단계 / 길이 1" }, "mrkt_basis": { "type": "number", "format": "float", "description": "베이시스 / 길이 10.2" }, "ther_basis": { "type": "number", "format": "float", "description": "이론베이시스 / 길이 10.2" }, "cd_mnrt": { "type": "number", "format": "float", "description": "CD금리 / 길이 6.3" }, "unas_isnm": { "type": "string", "description": "기초지수한글명 / 길이 40" }, "prdy_hgpr": { "type": "number", "format": "float", "description": "전일고가 / 길이 10.2" }, "prdy_oprc": { "type": "number", "format": "float", "description": "전일시가 / 길이 10.2" }, "prdy_lwpr": { "type": "number", "format": "float", "description": "전일저가 / 길이 10.2" }, "dmix_wrth_val": { "type": "number", "format": "float", "description": "배당액지수 / 길이 9.6" }, "oprc_vrss_sign": { "type": "string", "description": "시가대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "oprc_vrss": { "type": "number", "format": "float", "description": "시가대비등락 / 길이 10.2" }, "cb_bhprice": { "type": "number", "format": "float", "description": "CB발동상한 / 길이 10.2" }, "cb_blprice": { "type": "number", "format": "float", "description": "CB발동하한 / 길이 10.2" }, "lstn_date": { "type": "integer", "format": "int32", "description": "최초상장일 / 길이 8" }, "antc_cnqn": { "type": "integer", "format": "int64", "description": "예상체결수량 / 길이 9" } } }, "Output_1": { "type": "object", "properties": { "jisucode": { "type": "string", "description": "기초자산지수코드 / 길이 6" }, "unas_prpr": { "type": "string", "description": "기초자산지수 / 길이 10.2" }, "unas_sign": { "type": "string", "description": "기초자산등락부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "unas_vrss": { "type": "string", "description": "기초자산등락폭 / 길이 10.2" }, "unas_ctrt": { "type": "string", "description": "기초자산등락률 / 길이 5.2" }, "unas_vol": { "type": "string", "description": "기초자산거래량 / 길이 12" } } }, "Output_2": { "type": "object", "properties": { "starttime": { "type": "string", "description": "장시작시간 / 길이 6" }, "endtime": { "type": "string", "description": "장종료시간 / 길이 6" }, "svrtime": { "type": "string", "description": "서버타임 / 길이 14" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "missing_blocks": [ "Output_2" ] } ] } }, "/krfuture/quote/v1/dayPeriod": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteDayPeriod", "summary": "선물옵션기간별시세(일/주/월/년)주간", "description": "국내선물옵션 주기별 주간시세 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 9 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "mrkt_div_cls_code": { "type": "string", "description": "시장구분 / 길이 1 / F.지수선물 Z.주식선물 C.상품선물 V.변동성지수선물 X.섹터지수선물 K.미니지수선물 A.KRX300선물" }, "edate": { "type": "string", "description": "검색종료일 / 길이 8 / YYYYMMDD" }, "array_cnt": { "type": "string", "description": "조회건수 / 길이 4" }, "maxavg": { "type": "string", "description": "최대이평 / 길이 3" }, "gubun": { "type": "string", "description": "주기구분 / 길이 1 / 1.일 5.분 6.초 7.틱" }, "xtick": { "type": "string", "description": "조회단위 / 길이 3 / 주기구분 일인경우 001 분/초/틱에서는 별도 설정 가능" }, "today_cls_code": { "type": "string", "description": "당일조회 / 길이 1 / 1.당일만조회(분/초/틱에서 사용) 0.전체조회" }, "out1_scale_change": { "type": "string", "description": "Out1단위변경 / 길이 1 / Out1기준단위 0.변경안함 1.거래량천단위,거래대금백만단위 2.거래량단주,거래대금만백만단위" }, "out2_scale_change": { "type": "string", "description": "Out2단위변경 / 길이 1 / Out2기준단위 0.변경안함 1.거래량천단위,거래대금백만단위 2.거래량단주,거래대금만백만단위" } }, "required": [ "iem_cd", "mrkt_div_cls_code", "gubun", "today_cls_code", "out1_scale_change", "out2_scale_change" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "qry_date": { "type": "string", "description": "조회날짜 / 길이 8 / YYYYMMDD" }, "qry_time": { "type": "string", "description": "조회시간 / 길이 6 / HHmmSS" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 9" }, "iem_nm": { "type": "string", "description": "한글종목명 / 길이 41" }, "prpr": { "type": "string", "description": "현재가 / 길이 11 / float 11.2" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "string", "description": "대비 / 길이 11 / float 11.2" }, "prdy_ctrt": { "type": "string", "description": "대비율 / 길이 5 / float 5.2" }, "acml_vol": { "type": "string", "description": "거래량 / 길이 12" }, "acml_tr_pbmn": { "type": "string", "description": "거래대금 / 길이 18" }, "otst_qty": { "type": "string", "description": "미결제약정 / 길이 12" }, "otst_qty_vrss": { "type": "string", "description": "미결제증감 / 길이 12" }, "prdy_vol": { "type": "string", "description": "전일거래량 / 길이 12" }, "mrkt_basis": { "type": "string", "description": "Basis / 길이 5" }, "cttr": { "type": "string", "description": "체결강도 / 길이 6" }, "hts_thpr": { "type": "string", "description": "이론가 / 길이 11 / 당사정산이론가" }, "dprt": { "type": "string", "description": "괴리율 / 길이 8 / float 8.2" }, "mxpr": { "type": "string", "description": "상한가 / 길이 11 / float 11.2" }, "llam": { "type": "string", "description": "하한가 / 길이 11 / float 11.2" }, "oprc": { "type": "string", "description": "시가 / 길이 11 / float 11.2" }, "hgpr": { "type": "string", "description": "고가 / 길이 11 / float 11.2" }, "lwpr": { "type": "string", "description": "저가 / 길이 11 / float 11.2" }, "askp1": { "type": "string", "description": "최우선매도호가 / 길이 11 / float 11.2" }, "bidp1": { "type": "string", "description": "최우선매수호가 / 길이 11 / float 11.2" }, "unas_prpr": { "type": "string", "description": "기초자산현재가 / 길이 11 / float 11.2" }, "unas_prdy_vrss": { "type": "string", "description": "기초자산대비 / 길이 11 / float 11.2" }, "unas_prdy_ctrt": { "type": "string", "description": "기초자산대비율 / 길이 5 / float 5.2" }, "unas_prdy_sign": { "type": "string", "description": "기초자산대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_oprc": { "type": "string", "description": "전일시가 / 길이 11 / float 11.2" }, "prdy_high": { "type": "string", "description": "전일고가 / 길이 11 / float 11.2" }, "prdy_low": { "type": "string", "description": "전일저가 / 길이 11 / float 11.2" }, "prdy_clpr": { "type": "string", "description": "전일종가 / 길이 11 / float 11.2" }, "tdw_oprc": { "type": "string", "description": "이번주시가 / 길이 11 / float 11.2" }, "tdw_high": { "type": "string", "description": "이번주고가 / 길이 11 / float 11.2" }, "tdw_low": { "type": "string", "description": "이번주저가 / 길이 11 / float 11.2" }, "tdm_oprc": { "type": "string", "description": "이번달시가 / 길이 11 / float 11.2" }, "tdm_high": { "type": "string", "description": "이번달고가 / 길이 11 / float 11.2" }, "tdm_low": { "type": "string", "description": "이번달저가 / 길이 11 / float 11.2" }, "start_time": { "type": "string", "description": "장시작시간 / 길이 6 / HHmmSS" }, "end_time": { "type": "string", "description": "장마감시간 / 길이 6 / HHmmSS" }, "bsop_date": { "type": "string", "description": "영업일 / 길이 8 / YYYYMMDD" }, "sdpr": { "type": "string", "description": "기준가 / 길이 11 / float 11.2" }, "ctsz30": { "type": "string", "description": "이전키 / 길이 30" }, "lasttickcount": { "type": "string", "description": "마지막N틱봉의틱묶음갯수 / 길이 5 / 최근봉마지막틱갯수" }, "send_cnt": { "type": "string", "description": "봉개수 / 길이 5" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "영업일 / 길이 8 / YYYYMMDD" }, "bsop_time": { "type": "string", "description": "시간 / 길이 6 / HHmmSS" }, "oprc": { "type": "string", "description": "시가 / 길이 11 / float 11.2" }, "hgpr": { "type": "string", "description": "고가 / 길이 11 / float 11.2" }, "lwpr": { "type": "string", "description": "저가 / 길이 11 / float 11.2" }, "prpr": { "type": "string", "description": "현재가 / 길이 11 / float 11.2" }, "vol": { "type": "string", "description": "거래량 / 길이 12" }, "tr_pbmn": { "type": "string", "description": "거래대금 / 길이 18" }, "otst_qty": { "type": "string", "description": "미결제약정 / 길이 12" }, "otst_qty_vrss": { "type": "string", "description": "미결제증감 / 길이 12" }, "hts_thpr": { "type": "string", "description": "이론가 / 길이 11 / 당사정산이론가" }, "mrkt_basis": { "type": "string", "description": "Basis / 길이 5" }, "dprt": { "type": "string", "description": "괴리율 / 길이 8 / float 8.2" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/quote/v1/nightPeriod": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteNightPeriod", "summary": "선물옵션기간별시세(일/주/월/년)야간", "description": "국내선물옵션 주기별 야간시세 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 9 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "mrkt_div_cls_code": { "type": "string", "description": "시장구분 / 길이 1 / F.지수선물 Z.주식선물 C.상품선물 V.변동성지수선물 X.섹터지수선물 K.미니지수선물 A.KRX300선물" }, "edate": { "type": "string", "description": "검색종료일 / 길이 8 / YYYYMMDD" }, "array_cnt": { "type": "string", "description": "조회건수 / 길이 4" }, "maxavg": { "type": "string", "description": "최대이평 / 길이 3" }, "gubun": { "type": "string", "description": "주기구분 / 길이 1 / 1.일 5.분 6.초 7.틱" }, "xtick": { "type": "string", "description": "조회단위 / 길이 3 / 주기구분 일인경우 001 분/초/틱에서는 별도 설정 가능" }, "today_cls_code": { "type": "string", "description": "당일조회 / 길이 1 / 1.당일만조회(분/초/틱에서 사용) 0.전체조회" }, "out1_scale_change": { "type": "string", "description": "Out1단위변경 / 길이 1 / Out1기준단위 0.변경안함 1.거래량천단위,거래대금백만단위 2.거래량단주,거래대금만백만단위" }, "out2_scale_change": { "type": "string", "description": "Out2단위변경 / 길이 1 / Out2기준단위 0.변경안함 1.거래량천단위,거래대금백만단위 2.거래량단주,거래대금만백만단위" } }, "required": [ "mrkt_div_cls_code", "gubun", "today_cls_code", "out1_scale_change", "out2_scale_change" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "qry_date": { "type": "string", "description": "조회날짜 / 길이 8 / YYYYMMDD" }, "qry_time": { "type": "string", "description": "조회시간 / 길이 6 / HHmmSS" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 9" }, "iem_nm": { "type": "string", "description": "한글종목명 / 길이 41" }, "prpr": { "type": "string", "description": "현재가 / 길이 11 / float 11.2" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "string", "description": "대비 / 길이 11 / float 11.2" }, "prdy_ctrt": { "type": "string", "description": "대비율 / 길이 5 / float 5.2" }, "acml_vol": { "type": "string", "description": "거래량 / 길이 12" }, "acml_tr_pbmn": { "type": "string", "description": "거래대금 / 길이 18" }, "otst_qty": { "type": "string", "description": "미결제약정 / 길이 12" }, "otst_qty_vrss": { "type": "string", "description": "미결제증감 / 길이 12" }, "prdy_vol": { "type": "string", "description": "전일거래량 / 길이 12" }, "mrkt_basis": { "type": "string", "description": "Basis / 길이 5" }, "cttr": { "type": "string", "description": "체결강도 / 길이 6" }, "hts_thpr": { "type": "string", "description": "이론가 / 길이 11 / 당사정산이론가" }, "dprt": { "type": "string", "description": "괴리율 / 길이 8 / float 8.2" }, "mxpr": { "type": "string", "description": "상한가 / 길이 11 / float 11.2" }, "llam": { "type": "string", "description": "하한가 / 길이 11 / float 11.2" }, "oprc": { "type": "string", "description": "시가 / 길이 11 / float 11.2" }, "hgpr": { "type": "string", "description": "고가 / 길이 11 / float 11.2" }, "lwpr": { "type": "string", "description": "저가 / 길이 11 / float 11.2" }, "askp1": { "type": "string", "description": "최우선매도호가 / 길이 11 / float 11.2" }, "bidp1": { "type": "string", "description": "최우선매수호가 / 길이 11 / float 11.2" }, "unas_prpr": { "type": "string", "description": "기초자산현재가 / 길이 11 / float 11.2" }, "unas_prdy_vrss": { "type": "string", "description": "기초자산대비 / 길이 11 / float 11.2" }, "unas_prdy_ctrt": { "type": "string", "description": "기초자산대비율 / 길이 5 / float 5.2" }, "unas_prdy_sign": { "type": "string", "description": "기초자산대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_oprc": { "type": "string", "description": "전일시가 / 길이 11 / float 11.2" }, "prdy_high": { "type": "string", "description": "전일고가 / 길이 11 / float 11.2" }, "prdy_low": { "type": "string", "description": "전일저가 / 길이 11 / float 11.2" }, "prdy_clpr": { "type": "string", "description": "전일종가 / 길이 11 / float 11.2" }, "tdw_oprc": { "type": "string", "description": "이번주시가 / 길이 11 / float 11.2" }, "tdw_high": { "type": "string", "description": "이번주고가 / 길이 11 / float 11.2" }, "tdw_low": { "type": "string", "description": "이번주저가 / 길이 11 / float 11.2" }, "tdm_oprc": { "type": "string", "description": "이번달시가 / 길이 11 / float 11.2" }, "tdm_high": { "type": "string", "description": "이번달고가 / 길이 11 / float 11.2" }, "tdm_low": { "type": "string", "description": "이번달저가 / 길이 11 / float 11.2" }, "start_time": { "type": "string", "description": "장시작시간 / 길이 6 / HHmmSS" }, "end_time": { "type": "string", "description": "장마감시간 / 길이 6 / HHmmSS" }, "start_time_n": { "type": "string", "description": "장시작시간_야간 / 길이 6 / 야간HHmmSS, 기본18시시작" }, "end_time_n": { "type": "string", "description": "장마감시간_야간 / 길이 6 / 야간HHmmSS, 기본06시종료" }, "bsop_date": { "type": "string", "description": "영업일 / 길이 8 / YYYYMMDD" }, "sdpr": { "type": "string", "description": "기준가 / 길이 11 / float 11.2" }, "ctsz40": { "type": "string", "description": "이전키 / 길이 40" }, "lasttickcount": { "type": "string", "description": "마지막N틱봉의틱묶음갯수 / 길이 5 / 최근봉마지막틱갯수" }, "send_cnt": { "type": "string", "description": "봉개수 / 길이 5" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "영업일 / 길이 8 / YYYYMMDD" }, "bsop_time": { "type": "string", "description": "시간 / 길이 6 / 분:HHmm\n초,틱:HHmmSS" }, "oprc": { "type": "string", "description": "시가 / 길이 11 / float 11.2" }, "hgpr": { "type": "string", "description": "고가 / 길이 11 / float 11.2" }, "lwpr": { "type": "string", "description": "저가 / 길이 11 / float 11.2" }, "prpr": { "type": "string", "description": "현재가 / 길이 11 / float 11.2" }, "vol": { "type": "string", "description": "거래량 / 길이 12" }, "tr_pbmn": { "type": "string", "description": "거래대금 / 길이 18" }, "otst_qty": { "type": "string", "description": "미결제약정 / 길이 12" }, "otst_qty_vrss": { "type": "string", "description": "미결제증감 / 길이 12" }, "hts_thpr": { "type": "string", "description": "이론가 / 길이 11 / 당사정산이론가" }, "mrkt_basis": { "type": "string", "description": "Basis / 길이 5" }, "dprt": { "type": "string", "description": "괴리율 / 길이 8 / float 8.2" }, "work_bsop_date": { "type": "string", "description": "영업일 / 길이 8 / 야간시장기준영업일" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/quote/v1/intradayExpectedTrend": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteIntradayExpectedTrend", "summary": "선물옵션 변동거래량", "description": "국내선물옵션 변동거래량 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 9 / 예시> 코스피200 선물 26년9월물일 경우, KA0169000" }, "array_cnt": { "type": "string", "description": "읽을갯수 / 길이 3" } }, "required": [ "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 8" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 80" }, "prod_prpr": { "type": "number", "format": "double", "description": "현재가 / 길이 8.2" }, "prdy_vrss_sign": { "type": "string", "description": "전일대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "number", "format": "double", "description": "전일대비 / 길이 8.2" }, "prod_askp": { "type": "number", "format": "double", "description": "매도호가 / 길이 8.2" }, "prod_bidp": { "type": "number", "format": "double", "description": "매수호가 / 길이 8.2" }, "prod_hgpr": { "type": "number", "format": "double", "description": "고가 / 길이 8.2" }, "prod_lwpr": { "type": "number", "format": "double", "description": "저가 / 길이 8.2" }, "acml_vol": { "type": "number", "format": "double", "description": "누적거래량 / 길이 12 / 업종천주단위" }, "prod_sdpr": { "type": "number", "format": "double", "description": "기준가 / 길이 8.2" }, "filler": { "type": "string", "description": "FILLER / 길이 30" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "bsop_hour": { "type": "string", "description": "시간 / 길이 8 / HH:MM:SS" }, "prod_prpr": { "type": "number", "format": "double", "description": "현재가 / 길이 8.2" }, "prdy_vrss_sign": { "type": "string", "description": "전일대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "number", "format": "double", "description": "전일대비 / 길이 8.2" }, "prod_askp": { "type": "number", "format": "double", "description": "매도호가 / 길이 8.2" }, "prod_bidp": { "type": "number", "format": "double", "description": "매수호가 / 길이 8.2" }, "acml_vol": { "type": "number", "format": "double", "description": "누적거래량 / 길이 12 / 업종천주단위" }, "cnqn": { "type": "string", "description": "체결량 / 길이 12 / 업종천주단위" }, "prdy_ctrt": { "type": "string", "description": "등락률 / 길이 5.2" }, "otst_stpl_qty": { "type": "string", "description": "미결제약정수 / 길이 12" }, "filler": { "type": "string", "description": "FILLER / 길이 30" }, "next_button": { "type": "string", "description": "NEXT_BUTTION / 길이 1" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/quote/v1/daily": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteDaily", "summary": "선물옵션 일자별", "description": "국내선물옵션 주기별 거래정보 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 9" }, "sur_gb": { "type": "string", "description": "복기구분 / 길이 1 / 0.당일 1.전일" }, "bsop_date": { "type": "string", "description": "일자 / 길이 8 / YYYYMMDD" }, "maxavg": { "type": "string", "description": "최대이평 / 길이 3" }, "gubun": { "type": "string", "description": "조회구분 / 길이 1 / 0.초 1.분 2.일 3.틱" }, "xtick": { "type": "string", "description": "분구분 / 길이 3 / 0.30초 1.1분 2.3분 3.5분 4.10분 5.30분 6.60분" }, "array_cnt": { "type": "string", "description": "읽을갯수 / 길이 4" } }, "required": [ "iem_cd", "bsop_date", "gubun" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "일자 / 길이 8" }, "bsop_hour": { "type": "string", "description": "시간 / 길이 6" }, "prod_oprc": { "type": "string", "description": "시가 / 길이 15" }, "prod_hgpr": { "type": "string", "description": "고가 / 길이 15" }, "prod_lwpr": { "type": "string", "description": "저가 / 길이 15" } } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "prod_prpr": { "type": "string", "description": "현재가 / 길이 15" }, "prdy_vrss_sign": { "type": "string", "description": "전일대비부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "string", "description": "전일대비 / 길이 15" }, "acml_vol": { "type": "string", "description": "누적거래량 / 길이 11 / 업종천주단위" }, "acml_tr_pbmn": { "type": "string", "description": "누적거래대금 / 길이 12 / 천원단위" }, "cnqn": { "type": "string", "description": "체결량 / 길이 11 / 업종천주단위" }, "otst_stpl_qty": { "type": "string", "description": "미결제약정수 / 길이 9" }, "otst_stpl_icdc": { "type": "string", "description": "미결제약정수차 / 길이 9" }, "hts_thpr": { "type": "string", "description": "이론가 / 길이 15" }, "basis": { "type": "string", "description": "베이시스 / 길이 15 / 업종지수" }, "hts_ints_vltl": { "type": "string", "description": "내재변동성 / 길이 15" }, "next_key50": { "type": "string", "description": "NEXT_KEY50 / 길이 50" }, "next_button": { "type": "string", "description": "NEXT_BUTTION / 길이 1" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krfuture/quote/v1/tradingStatus": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteTradingStatus", "summary": "선물옵션 시간대별 투자자 매매현황", "description": "국내선물옵션 시간대별 투자자 매매현황 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: `Output_0` 는 명세상 **Object** 로 선언되어 있으나 예시 응답은 **Array** 입니다. 실제 응답 타입을 확인 후 사용하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "market_cd": { "type": "string", "description": "시장구분코드 / 길이 3 / KRX/NXT/UNT" }, "mrkt_cls_code": { "type": "string", "description": "시장구분 / 길이 1 / 1.코스피 2.코스닥 3.선물 4.콜옵션 5.풋옵션 6.코스닥150선물 8.위클리콜 9.위클리풋 J.주식선물 M.미니선물 O.미니콜옵션 P.미니풋옵션 H.코스닥150콜옵션 I.코스닥150풋옵션 Q.Q150위클리콜 R.Q150위클리풋" }, "cycle_cls_code": { "type": "string", "description": "시간구분 / 길이 1 / 1.30초 2.일별 3.일별누적 4.1분 5.5분(30분) 6.만기누적 7.1분당일것만(티커용)" }, "opt_cls_code": { "type": "string", "description": "옵션구분 / 길이 1 / 1.금액 2.수량" }, "cnt": { "type": "string", "description": "읽을갯수 / 길이 3" } }, "required": [ "market_cd", "mrkt_cls_code", "cycle_cls_code", "opt_cls_code" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "bsop_hour": { "type": "string", "description": "시간 / 길이 8" }, "timez12": { "type": "string", "description": "시계열 / 길이 12" }, "scrt_val": { "type": "integer", "format": "int64", "description": "증권 / 길이 12" }, "insu_val": { "type": "integer", "format": "int64", "description": "보험 / 길이 12" }, "ivtr_val": { "type": "integer", "format": "int64", "description": "투신 / 길이 12" }, "bank_val": { "type": "integer", "format": "int64", "description": "은행 / 길이 12" }, "mrbn_val": { "type": "integer", "format": "int64", "description": "종금 / 길이 12" }, "fund_val": { "type": "integer", "format": "int64", "description": "기금공제 / 길이 12" }, "etc_orgt_val": { "type": "integer", "format": "int64", "description": "기타법인1 / 길이 12" }, "prsn_val": { "type": "integer", "format": "int64", "description": "개인 / 길이 12" }, "frgn_val": { "type": "integer", "format": "int64", "description": "외국인 / 길이 12" }, "etc_corp_val": { "type": "integer", "format": "int64", "description": "기타법인2 / 길이 12" }, "orgn_val": { "type": "integer", "format": "int64", "description": "기관계 / 길이 12" }, "whol_val": { "type": "integer", "format": "int64", "description": "합계 / 길이 12" }, "pe_fund_val": { "type": "integer", "format": "int64", "description": "사모펀드 / 길이 12" }, "filler": { "type": "string", "description": "FILLER / 길이 30" }, "ctsz8": { "type": "string", "description": "CTSz8 / 길이 8" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "block": "Output_0", "declared": "Object", "sample": "Array" } ] } }, "/krfuture/quote/v1/timeProgramTrading": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krfutureQuoteTimeProgramTrading", "summary": "선물옵션 프로그램매매", "description": "국내선물옵션 시간대별 프로그램매매현황 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "market_cd": { "type": "string", "description": "시장구분코드 / 길이 3 / KRX/NXT/UNT" }, "cycle_cls_code": { "type": "string", "description": "주기구분 / 길이 1 / 1.1분 2.일별 3.5분 4.만기누적" }, "data_cls_code": { "type": "string", "description": "유형구분 / 길이 1 / 1.수치 2.차트" }, "opt_cls_code": { "type": "string", "description": "옵션구분 / 길이 1 / 1.거래량 2.거래대금" }, "mrkt_cls_code": { "type": "string", "description": "시장구분 / 길이 1 / 1.코스피 0.코스닥" }, "array_cnt": { "type": "string", "description": "읽을갯수 / 길이 3" } }, "required": [ "market_cd", "cycle_cls_code", "data_cls_code", "opt_cls_code", "mrkt_cls_code" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "일자 / 길이 8 / 유형구분 1(수치)일경우" }, "arbt_seln_qty": { "type": "number", "format": "double", "description": "차익매도합계 / 길이 16" }, "arbt_shnu_qty": { "type": "number", "format": "double", "description": "차익매수합계 / 길이 16" }, "arbt_ntby_qty": { "type": "number", "format": "double", "description": "차익순매수합계 / 길이 16" }, "nabt_seln_qty": { "type": "number", "format": "double", "description": "비차매도합계 / 길이 16" }, "nabt_shnu_qty": { "type": "number", "format": "double", "description": "비차매수합계 / 길이 16" }, "nabt_ntby_qty": { "type": "number", "format": "double", "description": "비차순매수합계 / 길이 16" }, "tot_seln_qty": { "type": "number", "format": "double", "description": "총매도합계 / 길이 16" }, "tot_shnu_qty": { "type": "number", "format": "double", "description": "총매수합계 / 길이 16" }, "tot_ntby_qty": { "type": "number", "format": "double", "description": "순매수 / 길이 16" }, "filler": { "type": "string", "description": "FILLER / 길이 30" } } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "일자 / 길이 8 / 유형구분 1(수치)일경우" }, "arbt_ntby_qty": { "type": "number", "format": "double", "description": "차익순매수합계 / 길이 16" }, "nabt_ntby_qty": { "type": "number", "format": "double", "description": "비차순매수합계 / 길이 16" }, "tot_ntby_qty": { "type": "number", "format": "double", "description": "순매수 / 길이 16" }, "filler": { "type": "string", "description": "FILLER / 길이 30" }, "next_key": { "type": "string", "description": "NEXT_KEY / 길이 14" }, "prevbutton": { "type": "string", "description": "PREVBUTTON / 길이 1" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" }, "out1_cnt": { "type": "string", "description": "Out1Cnt / 길이 6" }, "out2_cnt": { "type": "string", "description": "Out2Cnt / 길이 6" }, "outCts_cnt": { "type": "string", "description": "OutCtsCnt / 길이 6" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } } }, "x-realtime-channels": { "endpoint": "wss://api.nhplug.com:7070", "endpoints": { "live": "wss://api.nhplug.com:7070", "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": "지수선물 실시간호가KP200", "sheet": "API_국내_파생_실시간_지수선물호가(KP200)", "tr_cd": "f1", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuhotime", "fuoffer", "fubid", "fuofferjan", "fubidjan", "fujoffer", "fujbid", "fujofferjan", "fujbidjan", "fujjoffer", "fujjbid", "fujjofferjan", "fujjbidjan", "futofferjan", "futbidjan", "fuj4offer", "fuj4bid", "fuj4offerjan", "fuj4bidjan", "fuj5offer", "fuj5bid", "fuj5offerjan", "fuj5bidjan", "fuoffersu", "fujoffersu", "fujjoffersu", "fuj4offersu", "fuj5offersu", "futoffersu", "fubidsu", "fujbidsu", "fujjbidsu", "fuj4bidsu", "fuj5bidsu", "futbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "f1", "tr_key": "A0169000" } }, "push_example": { "header": { "tr_cd": "f1", "tr_key": "A0169000" }, "body": { "fuitem": "A0169000", "fuhotime": "14:31:23", "fuoffer": "1229.00", "fubid": "1228.65", "fuofferjan": "5", "fubidjan": "2", "fujoffer": "1229.05", "fujbid": "1228.60", "fujofferjan": "2", "fujbidjan": "1", "fujjoffer": "1229.10", "fujjbid": "1228.55", "fujjofferjan": "2", "fujjbidjan": "3", "futofferjan": "899", "futbidjan": "850", "fuj4offer": "1229.15", "fuj4bid": "1228.50", "fuj4offerjan": "3", "fuj4bidjan": "1", "fuj5offer": "1229.20", "fuj5bid": "1228.45", "fuj5offerjan": "2", "fuj5bidjan": "1", "fuoffersu": "5", "fujoffersu": "2", "fujjoffersu": "2", "fuj4offersu": "3", "fuj5offersu": "2", "futoffersu": "439", "fubidsu": "2", "fujbidsu": "1", "fujjbidsu": "2", "fuj4bidsu": "1", "fuj5bidsu": "1", "futbidsu": "495" } } }, { "name": "지수선물 실시간호가KQ150", "sheet": "API_국내_파생_실시간_지수선물호가(KQ150)", "tr_cd": "fH", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuhotime", "fuoffer", "fubid", "fuofferjan", "fubidjan", "fujoffer", "fujbid", "fujofferjan", "fujbidjan", "fujjoffer", "fujjbid", "fujjofferjan", "fujjbidjan", "futofferjan", "futbidjan", "fuj4offer", "fuj4bid", "fuj4offerjan", "fuj4bidjan", "fuj5offer", "fuj5bid", "fuj5offerjan", "fuj5bidjan", "fuoffersu", "fujoffersu", "fujjoffersu", "fuj4offersu", "fuj5offersu", "futoffersu", "fubidsu", "fujbidsu", "fujjbidsu", "fuj4bidsu", "fuj5bidsu", "futbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "fH", "tr_key": "A0669000" } }, "push_example": { "header": { "tr_cd": "fH", "tr_key": "A0669000" }, "body": { "fuitem": "A0669000", "fuhotime": "14:39:03", "fuoffer": "1470.80", "fubid": "1470.60", "fuofferjan": "1", "fubidjan": "1", "fujoffer": "1470.90", "fujbid": "1470.50", "fujofferjan": "6", "fujbidjan": "2", "fujjoffer": "1471.00", "fujjbid": "1470.40", "fujjofferjan": "5", "fujjbidjan": "7", "futofferjan": "1436", "futbidjan": "2873", "fuj4offer": "1471.10", "fuj4bid": "1470.30", "fuj4offerjan": "5", "fuj4bidjan": "6", "fuj5offer": "1471.20", "fuj5bid": "1470.20", "fuj5offerjan": "2", "fuj5bidjan": "5", "fuoffersu": "1", "fujoffersu": "6", "fujjoffersu": "5", "fuj4offersu": "5", "fuj5offersu": "2", "futoffersu": "508", "fubidsu": "1", "fujbidsu": "2", "fujjbidsu": "7", "fuj4bidsu": "6", "fuj5bidsu": "5", "futbidsu": "902" } } }, { "name": "지수선물 실시간호가미니", "sheet": "API_국내_파생_실시간_지수선물호가(미니)", "tr_cd": "hH", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuhotime", "fuoffer", "fubid", "fuofferjan", "fubidjan", "fujoffer", "fujbid", "fujofferjan", "fujbidjan", "fujjoffer", "fujjbid", "fujjofferjan", "fujjbidjan", "futofferjan", "futbidjan", "fuj4offer", "fuj4bid", "fuj4offerjan", "fuj4bidjan", "fuj5offer", "fuj5bid", "fuj5offerjan", "fuj5bidjan", "fuoffersu", "fujoffersu", "fujjoffersu", "fuj4offersu", "fuj5offersu", "futoffersu", "fubidsu", "fujbidsu", "fujjbidsu", "fuj4bidsu", "fuj5bidsu", "futbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "hH", "tr_key": "A0569000" } }, "push_example": { "header": { "tr_cd": "hH", "tr_key": "A0569000" }, "body": { "fuitem": "A0569000", "fuhotime": "14:48:14", "fuoffer": "1230.50", "fubid": "1229.96", "fuofferjan": "1", "fubidjan": "1", "fujoffer": "1234.14", "fujbid": "1227.24", "fujofferjan": "1", "fujbidjan": "1", "fujjoffer": "1234.16", "fujjbid": "1224.00", "fujjofferjan": "1", "fujjbidjan": "1", "futofferjan": "29", "futbidjan": "34", "fuj4offer": "1236.38", "fuj4bid": "1223.20", "fuj4offerjan": "4", "fuj4bidjan": "1", "fuj5offer": "1236.50", "fuj5bid": "1223.00", "fuj5offerjan": "2", "fuj5bidjan": "2", "fuoffersu": "1", "fujoffersu": "1", "fujjoffersu": "1", "fuj4offersu": "1", "fuj5offersu": "2", "futoffersu": "24", "fubidsu": "1", "fujbidsu": "1", "fujjbidsu": "1", "fuj4bidsu": "1", "fuj5bidsu": "2", "futbidsu": "34" } } }, { "name": "지수선물 실시간체결가KP200", "sheet": "API_국내_파생_실시간_지수선물체결가(KP200)", "tr_cd": "f8", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuchetime", "fusign", "fuchange", "fucurr", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "fuopenyak", "fuoffer", "fubid", "fuofferjan", "fubidjan", "futofferjan", "futbidjan", "fuoffersu", "fubidsu", "futoffersu", "futbidsu", "fuchrate", "fubasis", "fugrate", "fugratio", "fupreopenyak", "fuspvolall", "fuopen", "bulkvol" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "f8", "tr_key": "A0169000" } }, "push_example": { "header": { "tr_cd": "f8", "tr_key": "A0169000" }, "body": { "fuitem": "A0169000", "fuchetime": "14:33:06", "fusign": "2", "fuchange": "51.00", "fucurr": "1230.55", "fuhigh": "1248.90", "fulow": "1202.35", "fuvol": "1", "fuvolall": "87278", "fuvalall": "26778314", "fuopenyak": "160079", "fuoffer": "1230.75", "fubid": "1230.50", "fuofferjan": "2", "fubidjan": "1", "futofferjan": "882", "futbidjan": "917", "fuoffersu": "2", "fubidsu": "1", "futoffersu": "429", "futbidsu": "548", "fuchrate": "4.32", "fubasis": "9.66", "fugrate": "5.04", "fugratio": "0.41", "fupreopenyak": "-3110", "fuspvolall": "0", "fuopen": "1230.00", "bulkvol": "0" } } }, { "name": "지수선물 실시간체결가KQ150", "sheet": "API_국내_파생_실시간_지수선물체결가(KQ150)", "tr_cd": "fC", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuchetime", "fusign", "fuchange", "fucurr", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "fuopenyak", "fuoffer", "fubid", "fuofferjan", "fubidjan", "futofferjan", "futbidjan", "fuoffersu", "fubidsu", "futoffersu", "futbidsu", "fuchrate", "fubasis", "fugrate", "fugratio", "fupreopenyak", "fuspvolall", "fuopen", "bulkvol" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "fC", "tr_key": "A0669000" } }, "push_example": { "header": { "tr_cd": "fC", "tr_key": "A0669000" }, "body": { "fuitem": "A0669000", "fuchetime": "14:43:37", "fusign": "2", "fuchange": "67.00", "fucurr": "1469.60", "fuhigh": "1488.20", "fulow": "1384.60", "fuvol": "1", "fuvolall": "168362", "fuvalall": "2451185", "fuopenyak": "436041", "fuoffer": "1469.70", "fubid": "1469.60", "fuofferjan": "1", "fubidjan": "2", "futofferjan": "1495", "futbidjan": "2862", "fuoffersu": "1", "fubidsu": "2", "futoffersu": "516", "futbidsu": "883", "fuchrate": "4.78", "fubasis": "7.43", "fugrate": "0.64", "fugratio": "0.04", "fupreopenyak": "11669", "fuspvolall": "0", "fuopen": "1400.70", "bulkvol": " " } } }, { "name": "지수선물 실시간체결가미니", "sheet": "API_국내_파생_실시간_지수선물체결가(미니)", "tr_cd": "hC", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuchetime", "fusign", "fuchange", "fucurr", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "fuopenyak", "fuoffer", "fubid", "fuofferjan", "fubidjan", "futofferjan", "futbidjan", "fuoffersu", "fubidsu", "futoffersu", "futbidsu", "fuchrate", "fubasis", "fugrate", "fugratio", "fupreopenyak", "fuspvolall", "fuopen", "bulkvol" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "hC", "tr_key": "A0569000>" } }, "push_example": { "header": { "tr_cd": "hC", "tr_key": "A0569000" }, "body": { "fuitem": "A0569000", "fuchetime": "14:48:27", "fusign": "2", "fuchange": "49.74", "fucurr": "1229.30", "fuhigh": "1248.98", "fulow": "1202.56", "fuvol": "1", "fuvolall": "1790", "fuvalall": "110079", "fuopenyak": "5337", "fuoffer": "1229.68", "fubid": "1227.24", "fuofferjan": "1", "fubidjan": "1", "futofferjan": "29", "futbidjan": "33", "fuoffersu": "1", "fubidsu": "1", "futoffersu": "24", "futbidsu": "33", "fuchrate": "4.22", "fubasis": "9.29", "fugrate": "4.44", "fugratio": "0.36", "fupreopenyak": "1845", "fuspvolall": "0", "fuopen": "1233.24", "bulkvol": "0" } } }, { "name": "지수선물 실시간예상체결KP200", "sheet": "API_국내_파생_실시간_지수선물예상체결(KP200)", "tr_cd": "fE", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "fE", "tr_key": "A0169000" } }, "push_example": { "header": { "tr_cd": "fE", "tr_key": "A0169000" }, "body": { "fuitem": "A0169000", "time": "14:34:11", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "지수선물 실시간예상체결KQ150", "sheet": "API_국내_파생_실시간_지수선물예상체결(KQ150)", "tr_cd": "fP", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "fP", "tr_key": "A0669000" } }, "push_example": { "header": { "tr_cd": "fP", "tr_key": "A0669000" }, "body": { "fuitem": "A0669000", "time": "14:45:53", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "지수선물 실시간예상체결미니", "sheet": "API_국내_파생_실시간_지수선물예상체결(미니)", "tr_cd": "hE", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "hE", "tr_key": "A0569000" } }, "push_example": { "header": { "tr_cd": "hE", "tr_key": "A0569000" }, "body": { "fuitem": "A0569000", "futime": "14:52:40", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "지수옵션 실시간호가KP200", "sheet": "API_국내_파생_실시간_지수옵션호가(KP200)", "tr_cd": "o1", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "ophotime", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "o1", "tr_key": "B0168A69" } }, "push_example": { "header": { "tr_cd": "o1", "tr_key": "B0168A69" }, "body": { "opitem": "B0168A69", "ophotime": "15:22:29", "opoffer": "128.60", "opbid": "110.15", "opofferjan": "8", "opbidjan": "8", "opjoffer": "137.80", "opjbid": "104.90", "opjofferjan": "2", "opjbidjan": "1", "opjjoffer": "138.20", "opjjbid": "104.85", "opjjofferjan": "1", "opjjbidjan": "1", "optofferjan": "14", "optbidjan": "148", "opj4offer": "138.25", "opj4bid": "1.17", "opj4offerjan": "1", "opj4bidjan": "2", "opj5offer": "142.90", "opj5bid": "0.57", "opj5offerjan": "2", "opj5bidjan": "1", "opoffersu": "1", "opjoffersu": "1", "opjjoffersu": "1", "opj4offersu": "1", "opj5offersu": "1", "optoffersu": "5", "opbidsu": "1", "opjbidsu": "1", "opjjbidsu": "1", "opj4bidsu": "1", "opj5bidsu": "1", "optbidsu": "9" } } }, { "name": "지수옵션 실시간호가KQ150", "sheet": "API_국내_파생_실시간_지수옵션호가(KQ150)", "tr_cd": "xH", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "ophotime", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "xH", "tr_key": "C0668001" } }, "push_example": { "header": { "tr_cd": "xH", "tr_key": "C0668001" }, "body": { "opitem": "C0668001", "ophotime": "15:15:50", "opoffer": "43.00", "opbid": "42.10", "opofferjan": "45", "opbidjan": "40", "opjoffer": "43.10", "opjbid": "42.00", "opjofferjan": "10", "opjbidjan": "15", "opjjoffer": "0.00", "opjjbid": "0.20", "opjjofferjan": "0", "opjjbidjan": "20", "optofferjan": "55", "optbidjan": "75", "opj4offer": "0.00", "opj4bid": "0.00", "opj4offerjan": "0", "opj4bidjan": "0", "opj5offer": "0.00", "opj5bid": "0.00", "opj5offerjan": "0", "opj5bidjan": "0", "opoffersu": "5", "opjoffersu": "1", "opjjoffersu": "0", "opj4offersu": "0", "opj5offersu": "0", "optoffersu": "6", "opbidsu": "4", "opjbidsu": "2", "opjjbidsu": "1", "opj4bidsu": "0", "opj5bidsu": "0", "optbidsu": "7" } } }, { "name": "지수옵션 실시간호가미니", "sheet": "API_국내_파생_실시간_지수옵션호가(미니)", "tr_cd": "rH", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "ophotime", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "rH", "tr_key": "B0568A68" } }, "push_example": { "header": { "tr_cd": "rH", "tr_key": "B0568A68" }, "body": { "opitem": "B0568A68", "ophotime": "15:19:17", "opoffer": "130.95", "opbid": "122.85", "opofferjan": "8", "opbidjan": "8", "opjoffer": "131.10", "opjbid": "122.70", "opjofferjan": "5", "opjbidjan": "5", "opjjoffer": "131.20", "opjjbid": "122.60", "opjjofferjan": "5", "opjjbidjan": "5", "optofferjan": "18", "optbidjan": "117", "opj4offer": "0.00", "opj4bid": "0.04", "opj4offerjan": "0", "opj4bidjan": "99", "opj5offer": "0.00", "opj5bid": "0.00", "opj5offerjan": "0", "opj5bidjan": "0", "opoffersu": "1", "opjoffersu": "1", "opjjoffersu": "1", "opj4offersu": "0", "opj5offersu": "0", "optoffersu": "3", "opbidsu": "1", "opjbidsu": "1", "opjjbidsu": "1", "opj4bidsu": "1", "opj5bidsu": "0", "optbidsu": "4" } } }, { "name": "지수옵션 실시간체결가KP200", "sheet": "API_국내_파생_실시간_지수옵션체결가(KP200)", "tr_cd": "o2", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "opchetime", "opjgubun", "opsign", "opchange", "opcurr", "opopen", "ophigh", "oplow", "opvol", "opvolallz8", "opvalall", "opopenyak", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu", "opchrate", "opgrate", "opgratio", "oppreopenyak", "opbp_jgubun", "bulkvolz8" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "o2", "tr_key": "B0168A69" } }, "push_example": { "header": { "tr_cd": "o2", "tr_key": "B0168A69" }, "body": { "opitem": "B0168A69", "opchetime": "15:05:03", "opjgubun": "", "opsign": "2", "opchange": "14.20", "opcurr": "129.30", "opopen": "124.70", "ophigh": "146.95", "oplow": "122.15", "opvol": "1", "opvolallz8": "231", "opvalall": "78454", "opopenyak": "271", "opoffer": "137.90", "opbid": "126.35", "opofferjan": "8", "opbidjan": "8", "opjoffer": "142.90", "opjbid": "122.35", "opjofferjan": "2", "opjbidjan": "2", "opjjoffer": "143.40", "opjjbid": "1.17", "opjjofferjan": "1", "opjjbidjan": "2", "optofferjan": "12", "optbidjan": "148", "opj4offer": "143.45", "opj4bid": "0.57", "opj4offerjan": "1", "opj4bidjan": "1", "opj5offer": "0.00", "opj5bid": "0.28", "opj5offerjan": "0", "opj5bidjan": "2", "opoffersu": "1", "opjoffersu": "1", "opjjoffersu": "1", "opj4offersu": "1", "opj5offersu": "0", "optoffersu": "4", "opbidsu": "1", "opjbidsu": "1", "opjjbidsu": "1", "opj4bidsu": "1", "opj5bidsu": "1", "optbidsu": "8", "opchrate": "12.34", "opgrate": "5.80", "opgratio": "4.70", "oppreopenyak": "160", "opbp_jgubun": "", "bulkvolz8": "0" } } }, { "name": "지수옵션 실시간체결가KQ150", "sheet": "API_국내_파생_실시간_지수옵션체결가(KQ150)", "tr_cd": "xC", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "opchetime", "opjgubun", "opsign", "opchange", "opcurr", "opopen", "ophigh", "oplow", "opvol", "opvolallz8", "opvalall", "opopenyak", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu", "opchrate", "opgrate", "opgratio", "oppreopenyak", "opbp_jgubun", "filler" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "xC", "tr_key": "C0668001" } }, "push_example": { "header": { "tr_cd": "xC", "tr_key": "C0668001" }, "body": { "opitem": "C0668001", "opchetime": "99:99:00", "opjgubun": "", "opsign": "5", "opchange": "23.50", "opcurr": "42.50", "opopen": "51.50", "ophigh": "51.50", "oplow": "41.20", "opvol": "0", "opvolallz8": "518", "opvalall": "2317", "opopenyak": "59", "opoffer": "0.00", "opbid": "0.20", "opofferjan": "0", "opbidjan": "20", "opjoffer": "0.00", "opjbid": "0.00", "opjofferjan": "0", "opjbidjan": "0", "opjjoffer": "0.00", "opjjbid": "0.00", "opjjofferjan": "0", "opjjbidjan": "0", "optofferjan": "0", "optbidjan": "20", "opj4offer": "0.00", "opj4bid": "0.00", "opj4offerjan": "0", "opj4bidjan": "0", "opj5offer": "0.00", "opj5bid": "0.00", "opj5offerjan": "0", "opj5bidjan": "0", "opoffersu": "0", "opjoffersu": "0", "opjjoffersu": "0", "opj4offersu": "0", "opj5offersu": "0", "optoffersu": "0", "opbidsu": "1", "opjbidsu": "0", "opjjbidsu": "0", "opj4bidsu": "0", "opj5bidsu": "0", "optbidsu": "1", "opchrate": "35.61", "opgrate": "3.23", "opgratio": "8.23", "oppreopenyak": "26", "opbp_jgubun": "7", "filler": "0" } } }, { "name": "지수옵션 실시간체결가미니", "sheet": "API_국내_파생_실시간_지수옵션체결가(미니)", "tr_cd": "rC", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "opchetime", "opjgubun", "opsign", "opchange", "opcurr", "opopen", "ophigh", "oplow", "opvol", "opvolallz8", "opvalall", "opopenyak", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu", "opchrate", "opgrate", "opgratio", "oppreopenyak", "opbp_jgubun", "bulkvolz8" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "rC", "tr_key": "B0568C42" } }, "push_example": { "header": { "tr_cd": "rC", "tr_key": "B0568C42" }, "body": { "opitem": "B0568C42", "opchetime": "14:35:13", "opjgubun": "", "opsign": "5", "opchange": "1.27", "opcurr": "2.47", "opopen": "2.15", "ophigh": "3.38", "oplow": "2.11", "opvol": "2", "opvolallz8": "949", "opvalall": "1276", "opopenyak": "1555", "opoffer": "2.49", "opbid": "2.47", "opofferjan": "2", "opbidjan": "2", "opjoffer": "2.51", "opjbid": "2.41", "opjofferjan": "2", "opjbidjan": "7", "opjjoffer": "2.59", "opjjbid": "2.40", "opjjofferjan": "1", "opjjbidjan": "1", "optofferjan": "107", "optbidjan": "341", "opj4offer": "2.60", "opj4bid": "2.39", "opj4offerjan": "3", "opj4bidjan": "2", "opj5offer": "2.65", "opj5bid": "2.38", "opj5offerjan": "1", "opj5bidjan": "1", "opoffersu": "2", "opjoffersu": "1", "opjjoffersu": "1", "opj4offersu": "3", "opj5offersu": "1", "optoffersu": "99", "opbidsu": "1", "opjbidsu": "1", "opjjbidsu": "1", "opj4bidsu": "2", "opj5bidsu": "1", "optbidsu": "170", "opchrate": "33.96", "opgrate": "2.03", "opgratio": "461.36", "oppreopenyak": "92", "opbp_jgubun": "", "bulkvolz8": "0" } } }, { "name": "지수옵션 실시간예상체결KP200", "sheet": "API_국내_파생_실시간_지수옵션예상체결(KP200)", "tr_cd": "oE", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "oE", "tr_key": "B0168A69" } }, "push_example": { "header": { "tr_cd": "oE", "tr_key": "B0168A69" }, "body": { "opitem": "B0168A69", "time": "15:03:28", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "지수옵션 실시간예상체결KQ150", "sheet": "API_국내_파생_실시간_지수옵션예상체결(KQ150)", "tr_cd": "xE", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "optime", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "xE", "tr_key": "C0668001" } }, "push_example": { "header": { "tr_cd": "xE", "tr_key": "C0668001" }, "body": { "opitem": "C0668001", "optime": "15:35:00", "dongsi": "1", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "지수옵션 실시간예상체결미니", "sheet": "API_국내_파생_실시간_지수옵션예상체결(미니)", "tr_cd": "rE", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "optime", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "rE", "tr_key": "B0568A68" } }, "push_example": { "header": { "tr_cd": "rE", "tr_key": "B0568A68" }, "body": { "opitem": "B0568A68", "optime": "15:22:30", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "상품선물 실시간호가", "sheet": "API_국내_파생_실시간_상품선물호가", "tr_cd": "pH", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "futime", "offer", "bid", "offerjan", "bidjan", "joffer", "jbid", "jofferjan", "jbidjan", "jjoffer", "jjbid", "jjofferjan", "jjbidjan", "tofferjan", "tobidjan", "j4offer", "j4bid", "j4offerjan", "j4bidjan", "j5offer", "j5bid", "j5offerjan", "j5bidjan", "offersu", "joffersu", "jjoffersu", "j4offersu", "j5offersu", "toffersu", "bidsu", "jbidsu", "jjbidsu", "j4bidsu", "j5bidsu", "tbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "pH", "tr_key": "A6569000" } }, "push_example": { "header": { "tr_cd": "pH", "tr_key": "A6569000" }, "body": { "fuitem": "A6569000", "futime": "10:24:12", "offer": "102.980", "bid": "102.970", "offerjan": "97", "bidjan": "754", "joffer": "102.990", "jbid": "102.960", "jofferjan": "826", "jbidjan": "1781", "jjoffer": "103.000", "jjbid": "102.950", "jjofferjan": "1215", "jjbidjan": "2047", "tofferjan": "15496", "tobidjan": "13703", "j4offer": "103.010", "j4bid": "102.940", "j4offerjan": "1005", "j4bidjan": "1164", "j5offer": "103.020", "j5bid": "102.930", "j5offerjan": "1392", "j5bidjan": "992", "offersu": "11", "joffersu": "29", "jjoffersu": "47", "j4offersu": "35", "j5offersu": "38", "toffersu": "480", "bidsu": "33", "jbidsu": "45", "jjbidsu": "50", "j4bidsu": "48", "j5bidsu": "77", "tbidsu": "407", "dongsi": "0", "eqprice": "0.000" } } }, { "name": "상품선물 실시간체결가", "sheet": "API_국내_파생_실시간_상품선물체결가", "tr_cd": "pC", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "futime", "jgubun", "fusign", "fuchange", "fucurr", "fuopen", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "openyak", "filler", "offer", "bid", "offerjan", "bidjan", "joffer", "jbid", "jofferjan", "jbidjan", "jjoffer", "jjbid", "jjofferjan", "jjbidjan", "tofferjan", "tobidjan", "j4offer", "j4bid", "j4offerjan", "j4bidjan", "j5offer", "j5bid", "j5offerjan", "j5bidjan", "offersu", "joffersu", "jjoffersu", "j4offersu", "j5offersu", "toffersu", "bidsu", "jbidsu", "jjbidsu", "j4bidsu", "j5bidsu", "tbidsu", "chrate", "bp_jgubun", "fspvolall", "preopenyak", "grate", "gratio" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "pC", "tr_key": "A6569000" } }, "push_example": { "header": { "tr_cd": "pC", "tr_key": "A6569000" }, "body": { "fuitem": "A6569000", "futime": "10:25:12", "jgubun": "", "fusign": "5", "fuchange": "0.120", "fucurr": "102.980", "fuopen": "103.040", "fuhigh": "103.040", "fulow": "102.970", "fuvol": "1", "fuvolall": "48662", "fuvalall": "5012431100000", "openyak": "530845", "filler": "000", "offer": "102.990", "bid": "102.980", "offerjan": "753", "bidjan": "192", "joffer": "103.000", "jbid": "102.970", "jofferjan": "1194", "jbidjan": "924", "jjoffer": "103.010", "jjbid": "102.960", "jjofferjan": "1008", "jjbidjan": "1805", "tofferjan": "15304", "tobidjan": "13990", "j4offer": "103.020", "j4bid": "102.950", "j4offerjan": "1394", "j4bidjan": "2060", "j5offer": "103.030", "j5bid": "102.940", "j5offerjan": "677", "j5bidjan": "1113", "offersu": "30", "joffersu": "48", "jjoffersu": "38", "j4offersu": "39", "j5offersu": "36", "toffersu": "475", "bidsu": "7", "jbidsu": "46", "jjbidsu": "46", "j4bidsu": "52", "j5bidsu": "46", "tbidsu": "424", "chrate": "0.12", "bp_jgubun": "", "fspvolall": "0", "preopenyak": "-4356", "grate": "-0.230", "gratio": "-0.22" } } }, { "name": "상품선물 실시간예상체결", "sheet": "API_국내_파생_실시간_상품선물예상체결", "tr_cd": "pE", "tr_key": { "name": "code", "kor": "종목코드", "length": "8" }, "fields": [ "code", "time", "eqprice", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "pE", "tr_key": "A6569000" } }, "push_example": { "header": { "tr_cd": "pE", "tr_key": "A6569000" }, "body": { "code": "A6569000", "time": "10:25:37", "eqprice": "0.000", "eqvolume": "0" } } }, { "name": "주식선물 실시간호가", "sheet": "API_국내_파생_실시간_주식선물호가", "tr_cd": "vH", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "futime", "offer", "bid", "offerjan", "bidjan", "S2offer", "S2bid", "S2offerjan", "S2bidjan", "S3offer", "S3bid", "S3offerjan", "S3bidjan", "S4offer", "S4bid", "S4offerjan", "S4bidjan", "S5offer", "S5bid", "S5offerjan", "S5bidjan", "S6offer", "S6bid", "S6offerjan", "S6bidjan", "S7offer", "S7bid", "S7offerjan", "S7bidjan", "S8offer", "S8bid", "S8offerjan", "S8bidjan", "S9offer", "S9bid", "S9offerjan", "S9bidjan", "S0offer", "S0bid", "S0offerjan", "S0bidjan", "offersu", "bidsu", "S2offersu", "S2bidsu", "S3offersu", "S3bidsu", "S4offersu", "S4bidsu", "S5offersu", "S5bidsu", "S6offersu", "S6bidsu", "S7offersu", "S7bidsu", "S8offersu", "S8bidsu", "S9offersu", "S9bidsu", "S0offersu", "S0bidsu", "tofferjan", "tobidjan", "toffersu", "tbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "vH", "tr_key": "A2468000" } }, "push_example": { "header": { "tr_cd": "vH", "tr_key": "A2468000" }, "body": { "fuitem": "A2468000", "futime": "10:26:43", "offer": "193900", "bid": "193800", "offerjan": "2", "bidjan": "43", "S2offer": "194000", "S2bid": "193700", "S2offerjan": "21", "S2bidjan": "27", "S3offer": "194100", "S3bid": "193600", "S3offerjan": "69", "S3bidjan": "70", "S4offer": "194200", "S4bid": "193500", "S4offerjan": "35", "S4bidjan": "5", "S5offer": "194300", "S5bid": "193400", "S5offerjan": "79", "S5bidjan": "9", "S6offer": "194400", "S6bid": "193300", "S6offerjan": "16", "S6bidjan": "4", "S7offer": "194500", "S7bid": "193200", "S7offerjan": "15", "S7bidjan": "23", "S8offer": "194600", "S8bid": "193100", "S8offerjan": "20", "S8bidjan": "2", "S9offer": "194700", "S9bid": "193000", "S9offerjan": "19", "S9bidjan": "7", "S0offer": "194800", "S0bid": "192600", "S0offerjan": "24", "S0bidjan": "2", "offersu": "2", "bidsu": "7", "S2offersu": "8", "S2bidsu": "12", "S3offersu": "15", "S3bidsu": "3", "S4offersu": "11", "S4bidsu": "3", "S5offersu": "17", "S5bidsu": "3", "S6offersu": "7", "S6bidsu": "2", "S7offersu": "9", "S7bidsu": "2", "S8offersu": "7", "S8bidsu": "1", "S9offersu": "10", "S9bidsu": "3", "S0offersu": "7", "S0bidsu": "1", "tofferjan": "1451", "tobidjan": "661", "toffersu": "303", "tbidsu": "80" } } }, { "name": "주식선물 실시간체결가", "sheet": "API_국내_파생_실시간_주식선물체결가", "tr_cd": "vC", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "futime", "jgubun", "fusign", "fuchange", "fucurr", "fuopen", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "openyak", "jandatecnt", "offer", "bid", "offerjan", "bidjan", "S2offer", "S2bid", "S2offerjan", "S2bidjan", "S3offer", "S3bid", "S3offerjan", "S3bidjan", "S4offer", "S4bid", "S4offerjan", "S4bidjan", "S5offer", "S5bid", "S5offerjan", "S5bidjan", "S6offer", "S6bid", "S6offerjan", "S6bidjan", "S7offer", "S7bid", "S7offerjan", "S7bidjan", "S8offer", "S8bid", "S8offerjan", "S8bidjan", "S9offer", "S9bid", "S9offerjan", "S9bidjan", "S0offer", "S0bid", "S0offerjan", "S0bidjan", "offersu", "bidsu", "S2offersu", "S2bidsu", "S3offersu", "S3bidsu", "S4offersu", "S4bidsu", "S5offersu", "S5bidsu", "S6offersu", "S6bidsu", "S7offersu", "S7bidsu", "S8offersu", "S8bidsu", "S9offersu", "S9bidsu", "S0offersu", "S0bidsu", "tofferjan", "tobidjan", "toffersu", "tbidsu", "chrate", "basis", "grate", "gratio", "preopenyak", "bp_jgubun", "fspvolall" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "vC", "tr_key": "A2468000" } }, "push_example": { "header": { "tr_cd": "vC", "tr_key": "A2468000" }, "body": { "fuitem": "A2468000", "futime": "10:28:20", "jgubun": " ", "fusign": "2", "fuchange": "10900", "fucurr": "194600", "fuopen": "186800", "fuhigh": "208500", "fulow": "184200", "fuvol": "1", "fuvolall": "85974", "fuvalall": "169921999", "openyak": "38023", "jandatecnt": "32", "offer": "194700", "bid": "194500", "offerjan": "27", "bidjan": "17", "S2offer": "194800", "S2bid": "194400", "S2offerjan": "118", "S2bidjan": "20", "S3offer": "194900", "S3bid": "194300", "S3offerjan": "13", "S3bidjan": "79", "S4offer": "195000", "S4bid": "194200", "S4offerjan": "12", "S4bidjan": "34", "S5offer": "195100", "S5bid": "194100", "S5offerjan": "16", "S5bidjan": "51", "S6offer": "195200", "S6bid": "194000", "S6offerjan": "10", "S6bidjan": "18", "S7offer": "195300", "S7bid": "193900", "S7offerjan": "62", "S7bidjan": "23", "S8offer": "195400", "S8bid": "193800", "S8offerjan": "10", "S8bidjan": "16", "S9offer": "195500", "S9bid": "193700", "S9offerjan": "12", "S9bidjan": "36", "S0offer": "195600", "S0bid": "193600", "S0offerjan": "11", "S0bidjan": "13", "offersu": "9", "bidsu": "6", "S2offersu": "17", "S2bidsu": "9", "S3offersu": "5", "S3bidsu": "15", "S4offersu": "5", "S4bidsu": "16", "S5offersu": "5", "S5bidsu": "8", "S6offersu": "3", "S6bidsu": "10", "S7offersu": "5", "S7bidsu": "8", "S8offersu": "3", "S8bidsu": "8", "S9offersu": "4", "S9bidsu": "8", "S0offersu": "3", "S0bidsu": "4", "tofferjan": "1287", "tobidjan": "820", "toffersu": "233", "tbidsu": "153", "chrate": "5.93", "basis": "300", "grate": "343", "gratio": "0.18", "preopenyak": "-1066", "bp_jgubun": " ", "fspvolall": "0" } } }, { "name": "주식선물 실시간예상체결", "sheet": "API_국내_파생_실시간_주식선물예상체결", "tr_cd": "vE", "tr_key": { "name": "expcode", "kor": "종목코드", "length": "8" }, "fields": [ "expcode", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "vE", "tr_key": "A2468000" } }, "push_example": { "header": { "tr_cd": "vE", "tr_key": "A2468000" }, "body": { "expcode": "A2468000", "time": "10:28:56", "dongsi": "0", "eqsign": "0", "eqprice": "0", "eqchange": "0", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "주식옵션 실시간호가", "sheet": "API_국내_파생_실시간_주식옵션호가", "tr_cd": "v1", "tr_key": { "name": "ojitem", "kor": "종목코드", "length": "8" }, "fields": [ "ojitem", "ojtime", "ojoffer", "ojbid", "ojofferjan", "ojbidjan", "ojjoffer", "ojjbid", "ojjofferjan", "ojjbidjan", "ojjjoffer", "ojjjbid", "ojjjofferjan", "ojjjbidjan", "ojj4offer", "ojj4bid", "ojj4offerjan", "ojj4bidjan", "ojj5offer", "ojj5bid", "ojj5offerjan", "ojj5bidjan", "ojj6offer", "ojj6bid", "ojj6offerjan", "ojj6bidjan", "ojj7offer", "ojj7bid", "ojj7offerjan", "ojj7bidjan", "ojj8offer", "ojj8bid", "ojj8offerjan", "ojj8bidjan", "ojj9offer", "ojj9bid", "ojj9offerjan", "ojj9bidjan", "ojj10offer", "ojj10bid", "ojj10offerjan", "ojj10bidjan", "ojtofferjan", "ojtbidjan", "ojoffersu", "ojbidsu", "ojjoffersu", "ojjbidsu", "ojjjoffersu", "ojjjbidsu", "ojj4offersu", "ojj4bidsu", "ojj5offersu", "ojj5bidsu", "ojj6offersu", "ojj6bidsu", "ojj7offersu", "ojj7bidsu", "ojj8offersu", "ojj8bidsu", "ojj9offersu", "ojj9bidsu", "ojj10offersu", "ojj10bidsu", "ojtoffersu", "ojtbidsu", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "v1", "tr_key": "B2468061" } }, "push_example": { "header": { "tr_cd": "v1", "tr_key": "B2468061" }, "body": { "ojitem": "B2468061", "ojtime": "10:30:13", "ojoffer": "20000", "ojbid": "19600", "ojofferjan": "12", "ojbidjan": "12", "ojjoffer": "25600", "ojjbid": "0", "ojjofferjan": "1", "ojjbidjan": "0", "ojjjoffer": "27800", "ojjjbid": "0", "ojjjofferjan": "1", "ojjjbidjan": "0", "ojj4offer": "29400", "ojj4bid": "0", "ojj4offerjan": "1", "ojj4bidjan": "0", "ojj5offer": "0", "ojj5bid": "0", "ojj5offerjan": "0", "ojj5bidjan": "0", "ojj6offer": "0", "ojj6bid": "0", "ojj6offerjan": "0", "ojj6bidjan": "0", "ojj7offer": "0", "ojj7bid": "0", "ojj7offerjan": "0", "ojj7bidjan": "0", "ojj8offer": "0", "ojj8bid": "0", "ojj8offerjan": "0", "ojj8bidjan": "0", "ojj9offer": "0", "ojj9bid": "0", "ojj9offerjan": "0", "ojj9bidjan": "0", "ojj10offer": "0", "ojj10bid": "0", "ojj10offerjan": "0", "ojj10bidjan": "0", "ojtofferjan": "15", "ojtbidjan": "12", "ojoffersu": "2", "ojbidsu": "2", "ojjoffersu": "1", "ojjbidsu": "0", "ojjjoffersu": "1", "ojjjbidsu": "0", "ojj4offersu": "1", "ojj4bidsu": "0", "ojj5offersu": "0", "ojj5bidsu": "0", "ojj6offersu": "0", "ojj6bidsu": "0", "ojj7offersu": "0", "ojj7bidsu": "0", "ojj8offersu": "0", "ojj8bidsu": "0", "ojj9offersu": "0", "ojj9bidsu": "0", "ojj10offersu": "0", "ojj10bidsu": "0", "ojtoffersu": "5", "ojtbidsu": "2", "dongsi": "0", "eqsign": "0", "eqprice": "0", "eqchange": "0", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "주식옵션 실시간체결가", "sheet": "API_국내_파생_실시간_주식옵션체결가", "tr_cd": "v2", "tr_key": { "name": "ojitem", "kor": "종목코드", "length": "8" }, "fields": [ "ojitem", "ojtime", "ojsign", "ojchange", "ojcurr", "ojopen", "ojhigh", "ojlow", "ojvol", "ojvolall", "ojvalall", "ojoffer", "ojbid", "ojofferjan", "ojbidjan", "ojchrate", "ojgrate", "ojgratio", "ojopenyak", "ojpreopenyak", "ojbp_jgubun" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "v2", "tr_key": "B2468061" } }, "push_example": { "header": { "tr_cd": "v2", "tr_key": "B2468061" }, "body": { "ojitem": "B2468061", "ojtime": "10:33:23", "ojsign": "2", "ojchange": "4200", "ojcurr": "19400", "ojopen": "23400", "ojhigh": "28600", "ojlow": "19400", "ojvol": "5", "ojvolall": "332", "ojvalall": "809", "ojoffer": "19600", "ojbid": "19400", "ojofferjan": "6", "ojbidjan": "1", "ojchrate": "27.63", "ojgrate": "-3924", "ojgratio": "16.83", "ojopenyak": "505", "ojpreopenyak": "158", "ojbp_jgubun": "" } } }, { "name": "선물옵션 실시간체결통보", "sheet": "API_국내_파생_실시간_체결통보", "tr_cd": "d2", "tr_key": { "name": "userid", "kor": "사용자ID", "length": "8" }, "fields": [ "userid", "itemgb", "accountno", "orderno", "issuecd", "slbygb", "concgty", "concprc", "conctime", "ucgb", "rejgb", "fundcode", "sin_gb", "loan_date", "ato_ord_tpe_chg", "issue_nm", "rmt_mkt_cd", "snd_mkt_cd", "ord_cond_prc", "sor_orrgb", "stop_efforn_gb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "d2", "tr_key": "" } }, "push_example": { "header": { "tr_cd": "d2" }, "body": { "userid": "ID", "itemgb": "2", "accountno": "ACCOUNT NUMBER", "orderno": "0000000002", "issuecd": "KA0169000", "slbygb": "2", "concgty": "0000000001", "concprc": "00000117240", "conctime": "140955", "ucgb": "0", "rejgb": "0", "fundcode": "", "sin_gb": "", "loan_date": "", "ato_ord_tpe_chg": "0", "issue_nm": "선물2609월kp", "rmt_mkt_cd": "", "snd_mkt_cd": "", "ord_cond_prc": "", "sor_orrgb": "", "stop_efforn_gb": "" } }, "description": "국내파생 주문 체결 시 실시간으로 수신됩니다." }, { "name": "선물옵션 실시간주문내역통보", "sheet": "API_국내_파생_실시간_주문내역통보", "tr_cd": "d3", "tr_key": { "name": "userid", "kor": "사용자ID", "length": "8" }, "fields": [ "userid", "itemgb", "accountno", "orderno", "orgordno", "ordercd", "issuecd", "issuename", "slbygb", "order_type", "ordergty", "orderprc", "procnm", "commcd", "order_cond", "fundcode", "sin_gb", "order_time", "loan_date", "rmt_mkt_cd", "snd_mkt_cd", "ord_cond_prc", "sor_orrgb", "mkt_order_qty" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "d3", "tr_key": "" } }, "push_example": { "header": { "tr_cd": "d3" }, "body": { "userid": "ID", "itemgb": "2", "accountno": "ACCOUNT NUMBER", "orderno": "0000000002", "orgordno": "", "ordercd": "51", "issuecd": "KA0169000", "issuename": "선물2609월kp", "slbygb": "2", "order_type": "L", "ordergty": "0000000001", "orderprc": "00000117240", "procnm": "00", "commcd": "F5", "order_cond": "0", "fundcode": "", "sin_gb": "", "order_time": "140955", "loan_date": "", "rmt_mkt_cd": "", "snd_mkt_cd": "", "ord_cond_prc": "", "sor_orrgb": "", "mkt_order_qty": "" } }, "description": "국내파생 주문 접수 시 실시간으로 수신됩니다." }, { "name": "KRX야간선물 실시간호가KP200", "sheet": "API_국내_파생_실시간_야간선물호가(KP200)", "tr_cd": "1a", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuhotime", "fuoffer", "fubid", "fuofferjan", "fubidjan", "fujoffer", "fujbid", "fujofferjan", "fujbidjan", "fujjoffer", "fujjbid", "fujjofferjan", "fujjbidjan", "futofferjan", "futbidjan", "fuj4offer", "fuj4bid", "fuj4offerjan", "fuj4bidjan", "fuj5offer", "fuj5bid", "fuj5offerjan", "fuj5bidjan", "fuoffersu", "fujoffersu", "fujjoffersu", "fuj4offersu", "fuj5offersu", "futoffersu", "fubidsu", "fujbidsu", "fujjbidsu", "fuj4bidsu", "fuj5bidsu", "futbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "1a", "tr_key": "A0169000" } }, "push_example": { "header": { "tr_cd": "1a", "tr_key": "A0169000" }, "body": { "fuitem": "A0169000", "fuhotime": "18:21:58", "fuoffer": "1209.55", "fubid": "1209.20", "fuofferjan": "1", "fubidjan": "2", "fujoffer": "1209.60", "fujbid": "1209.15", "fujofferjan": "1", "fujbidjan": "2", "fujjoffer": "1209.65", "fujjbid": "1209.10", "fujjofferjan": "1", "fujjbidjan": "1", "futofferjan": "191", "futbidjan": "229", "fuj4offer": "1209.90", "fuj4bid": "1209.05", "fuj4offerjan": "2", "fuj4bidjan": "2", "fuj5offer": "1209.95", "fuj5bid": "1208.50", "fuj5offerjan": "1", "fuj5bidjan": "1", "fuoffersu": "1", "fujoffersu": "1", "fujjoffersu": "1", "fuj4offersu": "2", "fuj5offersu": "1", "futoffersu": "113", "fubidsu": "2", "fujbidsu": "2", "fujjbidsu": "1", "fuj4bidsu": "2", "fuj5bidsu": "1", "futbidsu": "140" } } }, { "name": "KRX야간선물 실시간호가KQ150", "sheet": "API_국내_파생_실시간_야간선물호가(KQ150)", "tr_cd": "2a", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuhotime", "fuoffer", "fubid", "fuofferjan", "fubidjan", "fujoffer", "fujbid", "fujofferjan", "fujbidjan", "fujjoffer", "fujjbid", "fujjofferjan", "fujjbidjan", "futofferjan", "futbidjan", "fuj4offer", "fuj4bid", "fuj4offerjan", "fuj4bidjan", "fuj5offer", "fuj5bid", "fuj5offerjan", "fuj5bidjan", "fuoffersu", "fujoffersu", "fujjoffersu", "fuj4offersu", "fuj5offersu", "futoffersu", "fubidsu", "fujbidsu", "fujjbidsu", "fuj4bidsu", "fuj5bidsu", "futbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "2a", "tr_key": "A0669000" } }, "push_example": { "header": { "tr_cd": "2a", "tr_key": "A0669000" }, "body": { "fuitem": "A0669000", "fuhotime": "18:30:59", "fuoffer": "1459.90", "fubid": "1459.20", "fuofferjan": "1", "fubidjan": "1", "fujoffer": "1460.00", "fujbid": "1459.10", "fujofferjan": "1", "fujbidjan": "2", "fujjoffer": "1460.10", "fujjbid": "1458.70", "fujjofferjan": "1", "fujjbidjan": "1", "futofferjan": "214", "futbidjan": "248", "fuj4offer": "1460.20", "fuj4bid": "1458.60", "fuj4offerjan": "1", "fuj4bidjan": "1", "fuj5offer": "1460.30", "fuj5bid": "1458.50", "fuj5offerjan": "1", "fuj5bidjan": "1", "fuoffersu": "1", "fujoffersu": "1", "fujjoffersu": "1", "fuj4offersu": "1", "fuj5offersu": "1", "futoffersu": "122", "fubidsu": "1", "fujbidsu": "2", "fujjbidsu": "1", "fuj4bidsu": "1", "fuj5bidsu": "1", "futbidsu": "134" } } }, { "name": "KRX야간선물 실시간호가미니", "sheet": "API_국내_파생_실시간_야간선물호가(미니)", "tr_cd": "4a", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuhotime", "fuoffer", "fubid", "fuofferjan", "fubidjan", "fujoffer", "fujbid", "fujofferjan", "fujbidjan", "fujjoffer", "fujjbid", "fujjofferjan", "fujjbidjan", "futofferjan", "futbidjan", "fuj4offer", "fuj4bid", "fuj4offerjan", "fuj4bidjan", "fuj5offer", "fuj5bid", "fuj5offerjan", "fuj5bidjan", "fuoffersu", "fujoffersu", "fujjoffersu", "fuj4offersu", "fuj5offersu", "futoffersu", "fubidsu", "fujbidsu", "fujjbidsu", "fuj4bidsu", "fuj5bidsu", "futbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "4a", "tr_key": "A0569000" } }, "push_example": { "header": { "tr_cd": "4a", "tr_key": "A0569000" }, "body": { "fuitem": "A0569000", "fuhotime": "18:35:18", "fuoffer": "1212.70", "fubid": "1208.86", "fuofferjan": "1", "fubidjan": "2", "fujoffer": "1212.72", "fujbid": "1198.02", "fujofferjan": "4", "fujbidjan": "4", "fujjoffer": "1212.76", "fujjbid": "1197.98", "fujjofferjan": "4", "fujjbidjan": "4", "futofferjan": "294", "futbidjan": "22", "fuj4offer": "1212.80", "fuj4bid": "1197.94", "fuj4offerjan": "4", "fuj4bidjan": "1", "fuj5offer": "1212.84", "fuj5bid": "1195.00", "fuj5offerjan": "4", "fuj5bidjan": "1", "fuoffersu": "1", "fujoffersu": "1", "fujjoffersu": "1", "fuj4offersu": "1", "fuj5offersu": "1", "futoffersu": "83", "fubidsu": "2", "fujbidsu": "1", "fujjbidsu": "1", "fuj4bidsu": "1", "fuj5bidsu": "1", "futbidsu": "16" } } }, { "name": "KRX야간선물 실시간체결가KP200", "sheet": "API_국내_파생_실시간_야간선물체결가(KP200)", "tr_cd": "1c", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuchetime", "fusign", "fuchange", "fucurr", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "fuopenyak", "fuoffer", "fubid", "fuofferjan", "fubidjan", "futofferjan", "futbidjan", "fuoffersu", "fubidsu", "futoffersu", "futbidsu", "fuchrate", "fubasis", "fugrate", "fugratio", "fupreopenyak", "fuspvolall", "fuopen", "bulkvol", "sysdate", "bsopdate" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "1c", "tr_key": "A0169000" } }, "push_example": { "header": { "tr_cd": "1c", "tr_key": "A0169000" }, "body": { "fuitem": "A0169000", "fuchetime": "18:23:11", "fusign": "5", "fuchange": "2.25", "fucurr": "1208.25", "fuhigh": "1211.20", "fulow": "1202.65", "fuvol": "1", "fuvolall": "1726", "fuvalall": "520734", "fuopenyak": "157832", "fuoffer": "1208.80", "fubid": "1208.25", "fuofferjan": "1", "fubidjan": "2", "futofferjan": "197", "futbidjan": "230", "fuoffersu": "1", "fubidsu": "2", "futoffersu": "118", "futbidsu": "141", "fuchrate": "0.19", "fubasis": "11.56", "fugrate": "6.89", "fugratio": "0.57", "fupreopenyak": "-37", "fuspvolall": "0", "fuopen": "1208.50", "bulkvol": "0", "sysdate": "20260710", "bsopdate": "20260713" } } }, { "name": "KRX야간선물 실시간체결가KQ150", "sheet": "API_국내_파생_실시간_야간선물체결가(KQ150)", "tr_cd": "2c", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuchetime", "fusign", "fuchange", "fucurr", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "fuopenyak", "fuoffer", "fubid", "fuofferjan", "fubidjan", "futofferjan", "futbidjan", "fuoffersu", "fubidsu", "futoffersu", "futbidsu", "fuchrate", "fubasis", "fugrate", "fugratio", "fupreopenyak", "fuspvolall", "fuopen", "bulkvol", "sysdate", "bsopdate" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "2c", "tr_key": "A0669000" } }, "push_example": { "header": { "tr_cd": "2c", "tr_key": "A0669000" }, "body": { "fuitem": "A0669000", "fuchetime": "18:31:24", "fusign": "5", "fuchange": "11.80", "fucurr": "1458.00", "fuhigh": "1469.80", "fulow": "1455.40", "fuvol": "1", "fuvolall": "228", "fuvalall": "3331", "fuopenyak": "437050", "fuoffer": "1463.00", "fubid": "1458.00", "fuofferjan": "2", "fubidjan": "1", "futofferjan": "215", "futbidjan": "239", "fuoffersu": "2", "fubidsu": "1", "futoffersu": "123", "futbidsu": "125", "fuchrate": "0.80", "fubasis": "1.88", "fugrate": "-4.80", "fugratio": "-0.33", "fupreopenyak": "-62", "fuspvolall": "0", "fuopen": "1469.80", "bulkvol": " ", "sysdate": "20260710", "bsopdate": "20260713" } } }, { "name": "KRX야간선물 실시간체결가미니", "sheet": "API_국내_파생_실시간_야간선물체결가(미니)", "tr_cd": "4c", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "fuchetime", "fusign", "fuchange", "fucurr", "fuhigh", "fulow", "fuvol", "fuvolall", "fuvalall", "fuopenyak", "fuoffer", "fubid", "fuofferjan", "fubidjan", "futofferjan", "futbidjan", "fuoffersu", "fubidsu", "futoffersu", "futbidsu", "fuchrate", "fubasis", "fugrate", "fugratio", "fupreopenyak", "fuspvolall", "fuopen", "bulkvol", "sysdate", "bsopdate" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "4c", "tr_key": "A0568000" } }, "push_example": { "header": { "tr_cd": "4c", "tr_key": "A0568000" }, "body": { "fuitem": "A0568000", "fuchetime": "18:38:32", "fusign": "2", "fuchange": "1.46", "fucurr": "1206.76", "fuhigh": "1207.38", "fulow": "1197.66", "fuvol": "1", "fuvolall": "1478", "fuvalall": "88873", "fuopenyak": "30330", "fuoffer": "1206.88", "fubid": "1206.52", "fuofferjan": "1", "fubidjan": "1", "futofferjan": "270", "futbidjan": "373", "fuoffersu": "1", "fubidsu": "1", "futoffersu": "218", "futbidsu": "264", "fuchrate": "0.12", "fubasis": "10.07", "fugrate": "7.66", "fugratio": "0.64", "fupreopenyak": "38", "fuspvolall": "0", "fuopen": "1203.62", "bulkvol": "0", "sysdate": "20260710", "bsopdate": "20260713" } } }, { "name": "KRX야간선물 실시간예상체결KP200", "sheet": "API_국내_파생_실시간_야간선물예상체결(KP200)", "tr_cd": "1b", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "1b", "tr_key": "A0169000" } }, "push_example": { "header": { "tr_cd": "1b", "tr_key": "A0169000" }, "body": { "fuitem": "A0169000", "time": "18:28:25", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "KRX야간선물 실시간예상체결KQ150", "sheet": "API_국내_파생_실시간_야간선물예상체결(KQ150)", "tr_cd": "2b", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "2b", "tr_key": "A0669000" } }, "push_example": { "header": { "tr_cd": "2b", "tr_key": "A0669000" }, "body": { "fuitem": "A0669000", "time": "18:32:55", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "KRX야간선물 실시간예상체결미니", "sheet": "API_국내_파생_실시간_야간선물예상체결(미니)", "tr_cd": "4b", "tr_key": { "name": "fuitem", "kor": "종목코드", "length": "8" }, "fields": [ "fuitem", "futime", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "4b", "tr_key": "A0569000" } }, "push_example": { "header": { "tr_cd": "4b", "tr_key": "A0569000" }, "body": { "fuitem": "A0569000", "futime": "18:52:56", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "KRX야간옵션 실시간호가KP200", "sheet": "API_국내_파생_실시간_야간옵션호가(KP200)", "tr_cd": "5a", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "ophotime", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "5a", "tr_key": "B0168A69" } }, "push_example": { "header": { "tr_cd": "5a", "tr_key": "B0168A69" }, "body": { "opitem": "B0168A69", "ophotime": "18:52:26", "opoffer": "143.10", "opbid": "100.90", "opofferjan": "5", "opbidjan": "5", "opjoffer": "143.15", "opjbid": "100.85", "opjofferjan": "2", "opjbidjan": "2", "opjjoffer": "145.30", "opjjbid": "100.70", "opjjofferjan": "1", "opjjbidjan": "2", "optofferjan": "9", "optbidjan": "119", "opj4offer": "145.35", "opj4bid": "100.55", "opj4offerjan": "1", "opj4bidjan": "2", "opj5offer": "0.00", "opj5bid": "100.40", "opj5offerjan": "0", "opj5bidjan": "1", "opoffersu": "1", "opjoffersu": "1", "opjjoffersu": "1", "opj4offersu": "1", "opj5offersu": "0", "optoffersu": "4", "opbidsu": "1", "opjbidsu": "1", "opjjbidsu": "1", "opj4bidsu": "1", "opj5bidsu": "1", "optbidsu": "13" } } }, { "name": "KRX야간옵션 실시간호가KQ150", "sheet": "API_국내_파생_실시간_야간옵션호가(KQ150)", "tr_cd": "7a", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "ophotime", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "7a", "tr_key": "C0668006" } }, "push_example": { "header": { "tr_cd": "7a", "tr_key": "C0668023" }, "body": { "opitem": "C0668023", "ophotime": "19:20:56", "opoffer": "0.00", "opbid": "53.50", "opofferjan": "0", "opbidjan": "1", "opjoffer": "0.00", "opjbid": "0.00", "opjofferjan": "0", "opjbidjan": "0", "opjjoffer": "0.00", "opjjbid": "0.00", "opjjofferjan": "0", "opjjbidjan": "0", "optofferjan": "0", "optbidjan": "1", "opj4offer": "0.00", "opj4bid": "0.00", "opj4offerjan": "0", "opj4bidjan": "0", "opj5offer": "0.00", "opj5bid": "0.00", "opj5offerjan": "0", "opj5bidjan": "0", "opoffersu": "0", "opjoffersu": "0", "opjjoffersu": "0", "opj4offersu": "0", "opj5offersu": "0", "optoffersu": "0", "opbidsu": "1", "opjbidsu": "0", "opjjbidsu": "0", "opj4bidsu": "0", "opj5bidsu": "0", "optbidsu": "1" } } }, { "name": "KRX야간옵션 실시간호가미니", "sheet": "API_국내_파생_실시간_야간옵션호가(미니)", "tr_cd": "6a", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "ophotime", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "6a", "tr_key": "B0568A81" } }, "push_example": { "header": { "tr_cd": "6a", "tr_key": "B0568A81" }, "body": { "opitem": "B0568A81", "ophotime": "19:45:54", "opoffer": "111.80", "opbid": "0.04", "opofferjan": "1", "opbidjan": "66", "opjoffer": "112.20", "opjbid": "0.02", "opjofferjan": "1", "opjbidjan": "1", "opjjoffer": "112.25", "opjjbid": "0.01", "opjjofferjan": "2", "opjjbidjan": "1", "optofferjan": "5", "optbidjan": "68", "opj4offer": "118.90", "opj4bid": "0.00", "opj4offerjan": "1", "opj4bidjan": "0", "opj5offer": "0.00", "opj5bid": "0.00", "opj5offerjan": "0", "opj5bidjan": "0", "opoffersu": "1", "opjoffersu": "1", "opjjoffersu": "2", "opj4offersu": "1", "opj5offersu": "0", "optoffersu": "5", "opbidsu": "1", "opjbidsu": "1", "opjjbidsu": "1", "opj4bidsu": "0", "opj5bidsu": "0", "optbidsu": "3" } } }, { "name": "KRX야간옵션 실시간체결가KP200", "sheet": "API_국내_파생_실시간_야간옵션체결가(KP200)", "tr_cd": "5c", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "opchetime", "opjgubun", "opsign", "opchange", "opcurr", "opopen", "ophigh", "oplow", "opvol", "opvolallz8", "opvalall", "opopenyak", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu", "opchrate", "opgrate", "opgratio", "oppreopenyak", "opbp_jgubun", "bulkvolz8", "sysdate", "bsopdate" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "5c", "tr_key": "B09F7B02" } }, "push_example": { "header": { "tr_cd": "5c", "tr_key": "B09F7B02" }, "body": { "opitem": "B09F7B02", "opchetime": "18:03:23", "opjgubun": "", "opsign": "2", "opchange": "0.07", "opcurr": "0.74", "opopen": "0.67", "ophigh": "0.78", "oplow": "0.67", "opvol": "1", "opvolallz8": "22", "opvalall": "40", "opopenyak": "101", "opoffer": "0.74", "opbid": "0.73", "opofferjan": "1", "opbidjan": "1", "opjoffer": "0.76", "opjbid": "0.69", "opjofferjan": "1", "opjbidjan": "2", "opjjoffer": "0.77", "opjjbid": "0.67", "opjjofferjan": "1", "opjjbidjan": "1", "optofferjan": "28", "optbidjan": "18", "opj4offer": "0.78", "opj4bid": "0.65", "opj4offerjan": "2", "opj4bidjan": "2", "opj5offer": "0.79", "opj5bid": "0.64", "opj5offerjan": "1", "opj5bidjan": "10", "opoffersu": "1", "opjoffersu": "1", "opjjoffersu": "1", "opj4offersu": "2", "opj5offersu": "1", "optoffersu": "23", "opbidsu": "1", "opjbidsu": "2", "opjjbidsu": "1", "opj4bidsu": "2", "opj5bidsu": "6", "optbidsu": "14", "opchrate": "10.45", "opgrate": "0.53", "opgratio": "252.38", "oppreopenyak": "12", "opbp_jgubun": "", "bulkvolz8": "0", "sysdate": "20260720", "bsopdate": "20260730" } } }, { "name": "KRX야간옵션 실시간체결가KQ150", "sheet": "API_국내_파생_실시간_야간옵션체결가(KQ150)", "tr_cd": "7c", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "opchetime", "opjgubun", "opsign", "opchange", "opcurr", "opopen", "ophigh", "oplow", "opvol", "opvolallz8", "opvalall", "opopenyak", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu", "opchrate", "opgrate", "opgratio", "oppreopenyak", "opbp_jgubun", "sysdate", "bsopdate", "filler" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "7c", "tr_key": "C0668006" } }, "push_example": "{\n \"Output_0\": [\n {\n \"\": \"\",\n \"\": \"\"\n },\n ....\n ],\n \"message\": {\n \"msg_code\": \"\",\n \"usr_msg\": \"\",\n \"msg_lv_code\": \"\",\n \"dvlp_msg_yn\": \"\",\n \"svc_nm\": \"\",\n \"func_nm\": \"\",\n \"line_no\": \"\",\n \"dvlp_msg\": \"\"\n }\n}" }, { "name": "KRX야간옵션 실시간체결가미니", "sheet": "API_국내_파생_실시간_야간옵션체결가(미니)", "tr_cd": "6c", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "opchetime", "opjgubun", "opsign", "opchange", "opcurr", "opopen", "ophigh", "oplow", "opvol", "opvolallz8", "opvalall", "opopenyak", "opoffer", "opbid", "opofferjan", "opbidjan", "opjoffer", "opjbid", "opjofferjan", "opjbidjan", "opjjoffer", "opjjbid", "opjjofferjan", "opjjbidjan", "optofferjan", "optbidjan", "opj4offer", "opj4bid", "opj4offerjan", "opj4bidjan", "opj5offer", "opj5bid", "opj5offerjan", "opj5bidjan", "opoffersu", "opjoffersu", "opjjoffersu", "opj4offersu", "opj5offersu", "optoffersu", "opbidsu", "opjbidsu", "opjjbidsu", "opj4bidsu", "opj5bidsu", "optbidsu", "opchrate", "opgrate", "opgratio", "oppreopenyak", "opbp_jgubun", "bulkvolz8", "sysdate", "bsopdate" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "6c", "tr_key": "B0568C42" } }, "push_example": { "header": { "tr_cd": "6c", "tr_key": "B0568C42" }, "body": { "opitem": "B0568C42", "opchetime": "18:05:21", "opjgubun": "", "opsign": "2", "opchange": "0.26", "opcurr": "2.46", "opopen": "2.29", "ophigh": "2.46", "oplow": "2.29", "opvol": "1", "opvolallz8": "14", "opvalall": "17", "opopenyak": "1547", "opoffer": "2.48", "opbid": "2.45", "opofferjan": "1", "opbidjan": "4", "opjoffer": "2.49", "opjbid": "2.40", "opjofferjan": "1", "opjbidjan": "1", "opjjoffer": "2.50", "opjjbid": "2.36", "opjjofferjan": "1", "opjjbidjan": "1", "optofferjan": "40", "optbidjan": "70", "opj4offer": "2.56", "opj4bid": "2.30", "opj4offerjan": "1", "opj4bidjan": "1", "opj5offer": "2.57", "opj5bid": "2.28", "opj5offerjan": "1", "opj5bidjan": "1", "opoffersu": "1", "opjoffersu": "1", "opjjoffersu": "1", "opj4offersu": "1", "opj5offersu": "1", "optoffersu": "40", "opbidsu": "1", "opjbidsu": "1", "opjjbidsu": "1", "opj4bidsu": "1", "opj5bidsu": "1", "optbidsu": "65", "opchrate": "11.82", "opgrate": "0.55", "opgratio": "28.80", "oppreopenyak": "-4", "opbp_jgubun": "", "bulkvolz8": "0", "sysdate": "20260720", "bsopdate": "20260730" } } }, { "name": "KRX야간옵션 실시간예상체결KP200", "sheet": "API_국내_파생_실시간_야간옵션예상체결(KP200)", "tr_cd": "5b", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "time", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "5b", "tr_key": "B0168A69" } }, "push_example": { "header": { "tr_cd": "5b", "tr_key": "B0168A69" }, "body": { "opitem": "B0168A69", "time": "18:53:12", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "KRX야간옵션 실시간예상체결KQ150", "sheet": "API_국내_파생_실시간_야간옵션예상체결(KQ150)", "tr_cd": "7b", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "optime", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "7b", "tr_key": "C0668006" } }, "push_example": { "header": { "tr_cd": "7b", "tr_key": "C0668023" }, "body": { "opitem": "C0668023", "optime": "19:45:18", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "KRX야간옵션 실시간예상체결미니", "sheet": "API_국내_파생_실시간_야간옵션예상체결(미니)", "tr_cd": "6b", "tr_key": { "name": "opitem", "kor": "종목코드", "length": "8" }, "fields": [ "opitem", "optime", "dongsi", "eqsign", "eqprice", "eqchange", "eqchrate", "eqvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "6b", "tr_key": "B0568A81" } }, "push_example": { "header": { "tr_cd": "6b", "tr_key": "B0568A81" }, "body": { "opitem": "B0568A81", "optime": "19:45:54", "dongsi": "0", "eqsign": "0", "eqprice": "0.00", "eqchange": "0.00", "eqchrate": "0.00", "eqvolume": "0" } } }, { "name": "국내야간선물옵션 실시간체결통보", "sheet": "API_국내_파생_실시간_야간체결통보", "tr_cd": "dv", "tr_key": { "name": "userid", "kor": "사용자ID", "length": "8" }, "fields": [ "userid", "itemgb", "accountno", "orderno", "issuecd", "slbygb", "concgty", "concprc", "conctime", "ucgb", "rejgb", "fundcode", "sin_gb", "loan_date", "ato_ord_tpe_chg", "issue_nm", "rmt_mkt_cd", "snd_mkt_cd", "ord_cond_prc", "sor_orrgb", "stop_efforn_gb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "dv", "tr_key": "" } }, "push_example": { "header": { "tr_cd": "dv" }, "body": { "userid": "ID", "itemgb": "2", "accountno": "ACCOUNT NUMBER", "orderno": "0000000004", "iem_cd": "KA0169000", "slbygb": "2", "concgty": "0000000001", "concprc": "00000139040", "conctime": "181520", "ucgb": "0", "rejgb": "0", "fundcode": "", "sin_gb": "", "loan_date": "", "ato_ord_tpe_chg": "0", "issue_nm": "선물2609월kp", "rmt_mkt_cd": "", "snd_mkt_cd": "", "ord_cond_prc": "", "sor_orrgb": "", "stop_efforn_gb": "" } }, "description": "국내파생 야간주문 체결 시 실시간으로 수신됩니다." }, { "name": "국내야간선물옵션 실시간주문내역통보", "sheet": "API_국내_파생_실시간_야간주문내역통보", "tr_cd": "dn", "tr_key": { "name": "userid", "kor": "사용자ID", "length": "8" }, "fields": [ "userid", "itemgb", "accountno", "orderno", "orgordno", "ordercd", "issuecd", "issuename", "slbygb", "order_type", "ordergty", "orderprc", "procnm", "commcd", "order_cond", "fundcode", "sin_gb", "order_time", "loan_date", "rmt_mkt_cd", "snd_mkt_cd", "ord_cond_prc", "sor_orrgb", "mkt_order_qty" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "dn", "tr_key": "" } }, "push_example": { "header": { "tr_cd": "dn" }, "body": { "userid": "ID", "itemgb": "2", "accountno": "ACCOUNT NUMBER", "orderno": "0000000003", "orgordno": "", "ordercd": "53", "issuecd": "KA0169000", "issuename": "선물2609월kp", "slbygb": "1", "order_type": "L", "ordergty": "0000000001", "orderprc": "00000139040", "procnm": "00", "commcd": "F5", "order_cond": "0", "fundcode": "", "sin_gb": "", "order_time": "181239", "loan_date": "", "rmt_mkt_cd": "", "snd_mkt_cd": "", "ord_cond_prc": "", "sor_orrgb": "", "mkt_order_qty": "" } }, "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": [ "m_optksp.mst (지수옵션)", "m_stkfut.mst (주식선물)", "m_optstp.mst (주식옵션)", "m_woption.mst·m_qoption.mst (위클리옵션)" ], "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 파일에 오프셋·길이·코드값·레코드크기가 정의되어 있습니다. 인증 불필요.", "struct_definition_files": [ "m_optksp.h", "m_stkfut.h", "m_optstp.h", "m_woption.h", "m_qoption.h" ] } }