{ "openapi": "3.0.3", "info": { "title": "NH투자증권 Open API — 국내주식 (Domestic Stock)", "version": "v1", "description": "NH투자증권 Open API 중 **국내주식 (Domestic Stock)** 자산군의 REST 및 실시간(WebSocket) API 문서입니다. (기준: API명세서 260730 / N2 환경 · 필드명은 명세서 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.n2plug.com/instruments/<파일명>.mst (CP949 고정길이, 인증 불필요). 상세는 x-instruments 참조.\n- 🏦 계좌 선택: /n2/acctinfo 의 acct_type 이 01(일반)·02(주문대리인) 이면 운영(api.n2plug.com:8443) 전용, 03 이면 모의투자(moapi.n2plug.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.n2plug.com:8443", "description": "🔴 운영 (Live) — 실제 주문 체결 [기본]" }, { "url": "https://moapi.n2plug.com:8443", "description": "🟢 모의투자 (Mock) — 교육이수·개발·검증" } ], "security": [ { "BearerAuth": [], "ClientId": [], "ClientSecret": [] } ], "x-environments": { "portal": "https://www.n2plug.com", "note": "기본 환경은 **운영(live)** 입니다. 운영은 주문이 실제로 체결됩니다. 테스트·검증은 모의투자(mock)를 사용하세요. N2 기준(N2 추후).", "mock": { "desc": "모의투자 — 교육이수·개발검증", "rest": "https://moapi.n2plug.com:8443", "websocket": "wss://moapi.n2plug.com:17070" }, "live": { "desc": "운영 — 실제 주문 체결", "rest": "https://api.n2plug.com:8443", "websocket": "wss://api.n2plug.com:7070" } }, "tags": [ { "name": "주문 (Order)" }, { "name": "조회 (Inquiry)" }, { "name": "시세 (Market Data)" }, { "name": "실시간 (Realtime)" } ], "paths": { "/krstock/order/v1/cashBuy": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderCashBuy", "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 / 예시> NH투자증권인 경우, 005940" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3 / 예시> 12,345원인 경우, 12345" }, "orr_amt": { "type": "integer", "format": "int64", "description": "주문금액 / 길이 18" }, "nmn_pr_tp_cd": { "type": "string", "description": "호가유형코드 / 길이 2 / 01.보통가 05.시장가 06.조건부지정가 09.자기주식 10.S-OPTION자기주식 11.금전신탁자기주식 12.최유리지정가 13.최우선지정가 16.스톱지정가 17.중간가 61.장전시간외 71.장후시간외 81.시간외단일가 91.장전시간외경쟁대량 92.장중경쟁대량" }, "orr_cnd_dit_cd": { "type": "string", "description": "주문조건구분코드 / 길이 2 / 00.없음 01.IOC 02.FOK" }, "ssl_nmn_pr_dit_cd": { "type": "string", "description": "공매도호가구분코드 / 길이 2 / 00.정상 (기본값) 01.차입주식매도 02.기타공매도 99.권리공매도" }, "sop_cnd_pr": { "type": "number", "format": "double", "description": "정지조건가격 / 길이 15.3 / 호가유형코드 16(스톱지정가일때만 입력)" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / SOR/KRX/NXT" }, "sor_mkt_sli_yn": { "type": "string", "description": "SOR시장분할여부 / 길이 1 / SOR일경우에만 Y/N선택, KRX/NXT 면 무조건 N" } }, "required": [ "act_no", "iem_cd", "orr_qty", "nmn_pr_tp_cd", "orr_cnd_dit_cd", "ssl_nmn_pr_dit_cd", "rmt_mkt_cd", "sor_mkt_sli_yn" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "mkt_orr_no": { "type": "integer", "format": "int64", "description": "시장주문번호 / 길이 10 / 정정/취소시 필요한 주문번호" }, "sor_fle_id": { "type": "string", "description": "SOR파일ID / 길이 20 / SOR 증적파일ID ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt1": { "type": "number", "format": "double", "description": "SOR배분비율1 / 길이 11.8 / KRX 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt2": { "type": "number", "format": "double", "description": "SOR배분비율2 / 길이 11.8 / NXT 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "orr_qty1": { "type": "integer", "format": "int64", "description": "주문수량1 / 길이 18 / KRX 주문수량" }, "orr_qty2": { "type": "integer", "format": "int64", "description": "주문수량2 / 길이 18 / NXT 주문수량" }, "anw_cld_mkt_orr_no1": { "type": "integer", "format": "int64", "description": "신규자시장주문번호1 / 길이 10 / KRX 시장주문번호" }, "anw_cld_mkt_orr_no2": { "type": "integer", "format": "int64", "description": "신규자시장주문번호2 / 길이 10 / NXT 시장주문번호" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/order/v1/cashSell": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderCashSell", "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 / 예시> NH투자증권인 경우, 005940" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3 / 예시> 12,345원인 경우, 12345" }, "orr_amt": { "type": "integer", "format": "int64", "description": "주문금액 / 길이 18" }, "nmn_pr_tp_cd": { "type": "string", "description": "호가유형코드 / 길이 2 / 01.보통가 05.시장가 06.조건부지정가 09.자기주식 10.S-OPTION자기주식 11.금전신탁자기주식 12.최유리지정가 13.최우선지정가 16.스톱지정가 17.중간가 61.장전시간외 71.장후시간외 81.시간외단일가 91.장전시간외경쟁대량 92.장중경쟁대량" }, "orr_cnd_dit_cd": { "type": "string", "description": "주문조건구분코드 / 길이 2 / 00.없음 01.IOC 02.FOK" }, "ssl_nmn_pr_dit_cd": { "type": "string", "description": "공매도호가구분코드 / 길이 2 / 00.정상 (기본값) 01.차입주식매도 02.기타공매도 99.권리공매도" }, "sop_cnd_pr": { "type": "number", "format": "double", "description": "정지조건가격 / 길이 15.3 / 호가유형코드 16(스톱지정가일때만 입력)" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / SOR/KRX/NXT" }, "sor_mkt_sli_yn": { "type": "string", "description": "SOR시장분할여부 / 길이 1 / SOR일경우에만 Y/N선택, KRX/NXT 면 , 무조건 N" } }, "required": [ "act_no", "iem_cd", "orr_qty", "nmn_pr_tp_cd", "orr_cnd_dit_cd", "ssl_nmn_pr_dit_cd", "rmt_mkt_cd", "sor_mkt_sli_yn" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "mkt_orr_no": { "type": "integer", "format": "int64", "description": "시장주문번호 / 길이 10 / 정정/취소시 필요한 주문번호" }, "sor_fle_id": { "type": "string", "description": "SOR파일ID / 길이 20 / SOR 증적파일ID ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt1": { "type": "number", "format": "double", "description": "SOR배분비율1 / 길이 11.8 / KRX 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt2": { "type": "number", "format": "double", "description": "SOR배분비율2 / 길이 11.8 / NXT 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "orr_qty1": { "type": "integer", "format": "int64", "description": "주문수량1 / 길이 18 / KRX 주문수량" }, "orr_qty2": { "type": "integer", "format": "int64", "description": "주문수량2 / 길이 18 / NXT 주문수량" }, "anw_cld_mkt_orr_no1": { "type": "integer", "format": "int64", "description": "신규자시장주문번호1 / 길이 10 / KRX 시장주문번호" }, "anw_cld_mkt_orr_no2": { "type": "integer", "format": "int64", "description": "신규자시장주문번호2 / 길이 10 / NXT 시장주문번호" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/order/v1/creditBuy": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderCreditBuy", "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 / 예시> NH투자증권인 경우, 005940" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3 / 예시> 12,345원인 경우, 12345" }, "orr_amt": { "type": "integer", "format": "int64", "description": "주문금액 / 길이 18" }, "nmn_pr_tp_cd": { "type": "string", "description": "호가유형코드 / 길이 2 / 01.보통가 05.시장가 06.조건부지정가 09.자기주식 10.S-OPTION자기주식 11.금전신탁자기주식 12.최유리지정가 13.최우선지정가 16.스톱지정가 17.중간가 61.장전시간외 71.장후시간외 81.시간외단일가 91.장전시간외경쟁대량 92.장중경쟁대량" }, "orr_cnd_dit_cd": { "type": "string", "description": "주문조건구분코드 / 길이 2 / 00.없음 01.IOC 02.FOK" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 01.유통융자 02.자기융자 03.유통대주 04.자기대주 10.매입자금대출" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8 / 신용대출코드 03,04일 경우 필수" }, "sop_cnd_pr": { "type": "number", "format": "double", "description": "정지조건가격 / 길이 15.3 / 호가유형코드 16(스톱지정가일때만 입력)" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / SOR/KRX/NXT" }, "sor_mkt_sli_yn": { "type": "string", "description": "SOR시장분할여부 / 길이 1 / SOR일경우에만 Y/N선택, KRX/NXT 면 무조건 N" } }, "required": [ "act_no", "iem_cd", "orr_qty", "nmn_pr_tp_cd", "orr_cnd_dit_cd", "cfd_lon_cd", "rmt_mkt_cd", "sor_mkt_sli_yn" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "mkt_orr_no": { "type": "integer", "format": "int64", "description": "시장주문번호 / 길이 10 / 정정/취소시 필요한 주문번호" }, "sor_fle_id": { "type": "string", "description": "SOR파일ID / 길이 20 / SOR 증적파일ID ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt1": { "type": "number", "format": "double", "description": "SOR배분비율1 / 길이 11.8 / KRX 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt2": { "type": "number", "format": "double", "description": "SOR배분비율2 / 길이 11.8 / NXT 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "orr_qty1": { "type": "integer", "format": "int64", "description": "주문수량1 / 길이 18 / KRX 주문수량" }, "orr_qty2": { "type": "integer", "format": "int64", "description": "주문수량2 / 길이 18 / NXT 주문수량" }, "anw_cld_mkt_orr_no1": { "type": "integer", "format": "int64", "description": "신규자시장주문번호1 / 길이 10 / KRX 시장주문번호" }, "anw_cld_mkt_orr_no2": { "type": "integer", "format": "int64", "description": "신규자시장주문번호2 / 길이 10 / NXT 시장주문번호" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/order/v1/creditSell": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderCreditSell", "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 / 예시> NH투자증권인 경우, 005940" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3 / 예시> 12,345원인 경우, 12345" }, "orr_amt": { "type": "integer", "format": "int64", "description": "주문금액 / 길이 18" }, "nmn_pr_tp_cd": { "type": "string", "description": "호가유형코드 / 길이 2 / 01.보통가 05.시장가 06.조건부지정가 09.자기주식 10.S-OPTION자기주식 11.금전신탁자기주식 12.최유리지정가 13.최우선지정가 16.스톱지정가 17.중간가 61.장전시간외 71.장후시간외 81.시간외단일가 91.장전시간외경쟁대량 92.장중경쟁대량" }, "orr_cnd_dit_cd": { "type": "string", "description": "주문조건구분코드 / 길이 2 / 00.없음 01.IOC 02.FOK" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 01.유통융자 02.자기융자 03.유통대주 04.자기대주 10.매입자금대출" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8 / 신용대출코드 03,04일 경우 필수" }, "sop_cnd_pr": { "type": "number", "format": "double", "description": "정지조건가격 / 길이 15.3 / 호가유형코드 16(스톱지정가일때만 입력)" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / SOR/KRX/NXT" }, "sor_mkt_sli_yn": { "type": "string", "description": "SOR시장분할여부 / 길이 1 / SOR일경우에만 Y/N선택, KRX/NXT 면 , 무조건 N" } }, "required": [ "act_no", "iem_cd", "orr_qty", "nmn_pr_tp_cd", "orr_cnd_dit_cd", "cfd_lon_cd", "rmt_mkt_cd", "sor_mkt_sli_yn" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "mkt_orr_no": { "type": "integer", "format": "int64", "description": "시장주문번호 / 길이 10 / 정정/취소시 필요한 주문번호" }, "sor_fle_id": { "type": "string", "description": "SOR파일ID / 길이 20 / SOR 증적파일ID ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt1": { "type": "number", "format": "double", "description": "SOR배분비율1 / 길이 11.8 / KRX 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "sor_ant_rt2": { "type": "number", "format": "double", "description": "SOR배분비율2 / 길이 11.8 / NXT 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "orr_qty1": { "type": "integer", "format": "int64", "description": "주문수량1 / 길이 18 / KRX 주문수량" }, "orr_qty2": { "type": "integer", "format": "int64", "description": "주문수량2 / 길이 18 / NXT 주문수량" }, "anw_cld_mkt_orr_no1": { "type": "integer", "format": "int64", "description": "신규자시장주문번호1 / 길이 10 / KRX 시장주문번호" }, "anw_cld_mkt_orr_no2": { "type": "integer", "format": "int64", "description": "신규자시장주문번호2 / 길이 10 / NXT 시장주문번호" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/order/v1/modify": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderModify", "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 계좌만 유효)" }, "org_mkt_orr_no": { "type": "integer", "format": "int64", "description": "원시장주문번호 / 길이 10" }, "all_pat_dit_cd": { "type": "string", "description": "전체일부구분코드 / 길이 1 / 1.전체(전량) 2.일부(잔량)" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12 / 예시> NH투자증권인 경우, 005940" }, "cor_qty": { "type": "integer", "format": "int64", "description": "정정수량 / 길이 18 / 전체일부구분코드 \"2.일부(잔량)\"인 경우 셋팅" }, "cor_pr": { "type": "number", "format": "double", "description": "정정가격 / 길이 15.3 / 예시> 12,345원인 경우, 12345" }, "sop_cnd_pr": { "type": "number", "format": "double", "description": "정지조건가격 / 길이 15.3 / 원주문의 호가유형코드 16(스톱지정가일때) KRX는 효력발생전으로만 수정가능 NXT는 원주문의 스톱지정가 그대로입력" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / 원주문과 동일하게 입력(SOR/KRX/NXT)" }, "sor_mkt_sli_yn": { "type": "string", "description": "SOR시장분할여부 / 길이 1 / 원주문과 동일하게 입력 (SOR일경우에만 Y/N선택, KRX/NXT 면 , 무조건 N)" } }, "required": [ "act_no", "org_mkt_orr_no", "all_pat_dit_cd", "iem_cd", "cor_qty", "cor_pr", "sop_cnd_pr", "rmt_mkt_cd", "sor_mkt_sli_yn" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "mkt_orr_no": { "type": "integer", "format": "int64", "description": "시장주문번호 / 길이 10 / 정정/취소시 필요한 주문번호" }, "sor_fle_id": { "type": "string", "description": "SOR파일ID / 길이 20 / SOR 증적파일ID ＊요청시장코드 SOR 경우에만 세팅" }, "can_sor_ant_rt1": { "type": "number", "format": "double", "description": "취소SOR배분비율1 / 길이 11.8 / KRX 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "can_sor_ant_rt2": { "type": "number", "format": "double", "description": "취소SOR배분비율2 / 길이 11.8 / NXT 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "can_orr_qty1": { "type": "integer", "format": "int64", "description": "취소주문수량1 / 길이 18 / KRX 주문수량" }, "can_orr_qty2": { "type": "integer", "format": "int64", "description": "취소주문수량2 / 길이 18 / NXT 주문수량" }, "can_cld_mkt_orr_no1": { "type": "integer", "format": "int64", "description": "취소자시장주문번호1 / 길이 10 / KRX 시장주문번호" }, "can_cld_mkt_orr_no2": { "type": "integer", "format": "int64", "description": "취소자시장주문번호2 / 길이 10 / NXT 시장주문번호" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/order/v1/cancel": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderCancel", "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 계좌만 유효)" }, "org_mkt_orr_no": { "type": "integer", "format": "int64", "description": "원시장주문번호 / 길이 10" }, "all_pat_dit_cd": { "type": "string", "description": "전체일부구분코드 / 길이 1 / 1.전체(전량) 2.일부(잔량)" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12 / 예시> NH투자증권인 경우, 005940" }, "cor_qty": { "type": "integer", "format": "int64", "description": "정정수량 / 길이 18 / 전체일부구분코드 \"2.일부(잔량)\"인 경우 셋팅" } }, "required": [ "act_no", "org_mkt_orr_no", "all_pat_dit_cd", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "orr_gno_tab_cd": { "type": "string", "description": "주문채번팀점코드 / 길이 4" }, "mkt_orr_no": { "type": "integer", "format": "int64", "description": "시장주문번호 / 길이 10 / 정정/취소시 필요한 주문번호" }, "sor_fle_id": { "type": "string", "description": "SOR파일ID / 길이 20 / SOR 증적파일ID ＊요청시장코드 SOR 경우에만 세팅" }, "can_sor_ant_rt1": { "type": "number", "format": "double", "description": "취소SOR배분비율1 / 길이 11.8 / KRX 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "can_sor_ant_rt2": { "type": "number", "format": "double", "description": "취소SOR배분비율2 / 길이 11.8 / NXT 배분비율 ＊요청시장코드 SOR 경우에만 세팅" }, "can_orr_qty1": { "type": "integer", "format": "int64", "description": "취소주문수량1 / 길이 18 / KRX 주문수량" }, "can_orr_qty2": { "type": "integer", "format": "int64", "description": "취소주문수량2 / 길이 18 / NXT 주문수량" }, "can_cld_mkt_orr_no1": { "type": "integer", "format": "int64", "description": "취소자시장주문번호1 / 길이 10 / KRX 시장주문번호" }, "can_cld_mkt_orr_no2": { "type": "integer", "format": "int64", "description": "취소자시장주문번호2 / 길이 10 / NXT 시장주문번호" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/order/v1/reservedOrder": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderReservedOrder", "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 / 예시> NH투자증권인 경우, 005940" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 1.매도 2.매수" }, "frs_sba_orr_yn": { "type": "string", "description": "선물대용주문여부 / 길이 1 / Y.예 N.아니오" }, "nmn_pr_tp_cd": { "type": "string", "description": "호가유형코드 / 길이 2 / 01.지정가 05.시장가 06.조건부지정가 09.자기주식 61.장전시간외" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 00.일반거래 01.유통융자 02.자기융자 03.유통대주 04.자기대주 10.매입자금대출 11.매도담보대출 12.주식담보대출" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8 / YYYYMMDD" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_uit_pr": { "type": "integer", "format": "int64", "description": "주문단가 / 길이 18 / 예시> 12,345원인 경우, 12345" }, "bkg_orr_tp_cd": { "type": "string", "description": "예약주문유형코드 / 길이 1 / 1.일반예약 2.잔량주문 3.지정수량주문" }, "bkg_orr_sta_dt": { "type": "string", "description": "예약주문시작일자 / 길이 8 / 예약주문유형코드가 \"2\" 또는 \"3\"일 때 (최대 30일) YYYYMMDD" }, "bkg_orr_end_dt": { "type": "string", "description": "예약주문종료일자 / 길이 8 / 예약주문유형코드가 \"2\" 또는 \"3\"일 때 (최대 30일) YYYYMMDD" }, "bkg_orr_enf_tp_cd": { "type": "string", "description": "예약주문집행유형코드 / 길이 1 / 1.일반 2.기준가격대비" }, "end_pr_cmp_ftw_amt": { "type": "integer", "format": "int64", "description": "종가대비등락폭금액 / 길이 18 / 예약주문집행유형코드가 \"2\"일 때" }, "orr_pr_rge_hlm_pr": { "type": "integer", "format": "int64", "description": "주문가격범위상한가 / 길이 18 / 예약주문집행유형코드가 \"2\"일 때" }, "orr_pr_rge_llm_pr": { "type": "integer", "format": "int64", "description": "주문가격범위하한가 / 길이 18 / 예약주문집행유형코드가 \"2\"일 때" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / KRX.KRX NXT.NXT" } }, "required": [ "act_no", "iem_cd", "sby_dit_cd", "frs_sba_orr_yn", "nmn_pr_tp_cd", "cfd_lon_cd", "orr_qty", "orr_uit_pr", "bkg_orr_tp_cd", "bkg_orr_enf_tp_cd", "rmt_mkt_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "bkg_orr_no": { "type": "integer", "format": "int64", "description": "예약주문번호 / 길이 10 / 예약 접수된 번호" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / 입력값 표시" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12 / 입력값 표시" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 입력값 표시" }, "frs_sba_orr_yn": { "type": "string", "description": "선물대용주문여부 / 길이 1 / 입력값 표시" }, "nmn_pr_tp_cd": { "type": "string", "description": "호가유형코드 / 길이 2 / 입력값 표시" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 입력값 표시" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8 / 입력값 표시" }, "orr_qty": { "type": "string", "description": "주문수량 / 길이 18 / 입력값 표시" }, "orr_uit_pr": { "type": "string", "description": "주문단가 / 길이 18 / 입력값 표시" }, "aca_tel_no": { "type": "string", "description": "연락처전화번호 / 길이 20 / 입력값 표시" }, "bkg_orr_tp_cd": { "type": "string", "description": "예약주문유형코드 / 길이 1 / 입력값 표시" }, "bkg_orr_sta_dt": { "type": "string", "description": "예약주문시작일자 / 길이 8 / 입력값 표시" }, "bkg_orr_end_dt": { "type": "string", "description": "예약주문종료일자 / 길이 8 / 입력값 표시" }, "bkg_orr_enf_tp_cd": { "type": "string", "description": "예약주문집행유형코드 / 길이 1 / 입력값 표시" }, "end_pr_cmp_ftw_amt": { "type": "string", "description": "종가대비등락폭금액 / 길이 18 / 입력값 표시" }, "orr_pr_rge_hlm_pr": { "type": "string", "description": "주문가격범위상한가 / 길이 18 / 입력값 표시" }, "orr_pr_rge_llm_pr": { "type": "string", "description": "주문가격범위하한가 / 길이 18 / 입력값 표시" }, "pwd": { "type": "string", "description": "비밀번호 / 길이 8 / 입력값 표시" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/order/v1/reservedCancel": { "post": { "tags": [ "주문 (Order)" ], "operationId": "krstockOrderReservedCancel", "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 / 예시> NH투자증권인 경우, 005940" }, "bkg_orr_no": { "type": "integer", "format": "int64", "description": "예약주문번호 / 길이 10" }, "bkg_orr_tp_cd": { "type": "string", "description": "예약주문유형코드 / 길이 1 / 1.일반예약 2.잔량주문 3.지정수량주문" }, "bkg_rtn_dt": { "type": "string", "description": "예약접수일자 / 길이 8 / 예약주문유형코드가 \"2\" 또는 \"3\"일 때 YYYYMMDD" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / KRX.KRX NXT.NXT" } }, "required": [ "act_no", "sby_dit_cd", "iem_cd", "bkg_orr_no", "bkg_orr_tp_cd", "rmt_mkt_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / 입력값 표시" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 입력값 표시" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12 / 입력값 표시" }, "bkg_orr_no": { "type": "integer", "format": "int64", "description": "예약주문번호 / 길이 10 / 입력값 표시" }, "bkg_orr_tp_cd": { "type": "string", "description": "예약주문유형코드 / 길이 1 / 입력값 표시" }, "bkg_rtn_dt": { "type": "string", "description": "예약접수일자 / 길이 8 / 입력값 표시" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/inquiry/v1/dailyOrderExecution": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryDailyOrderExecution", "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": { "orr_dt": { "type": "string", "description": "주문일자 / 길이 8 / YYYYMMDD" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "itg_orr_no": { "type": "integer", "format": "int64", "description": "통합주문번호 / 길이 10" }, "orr_mkt_cd": { "type": "string", "description": "주문시장코드 / 길이 2 / 00.전체 01.거래소주식 02.코스닥 03.K-OTC 06.코넥스" }, "ost_cns_dit": { "type": "string", "description": "체결구분 / 길이 1 / 0.전체 1.미체결 2.체결" } }, "required": [ "orr_dt", "act_no", "ost_cns_dit" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "itg_orr_no": { "type": "integer", "format": "int64", "description": "통합주문번호 / 길이 11" }, "orr_mkt_cd_nm": { "type": "string", "description": "주문시장코드명 / 길이 50" }, "mo_itg_orr_no": { "type": "string", "description": "모통합주문번호 / 길이 11" }, "org_itg_orr_no": { "type": "integer", "format": "int64", "description": "원통합주문번호 / 길이 11" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 50" }, "sby_dit_cd_nm": { "type": "string", "description": "매매구분코드명 / 길이 50" }, "cor_can_dit_cd_nm": { "type": "string", "description": "정정취소구분코드명 / 길이 4" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 20 / 00.일반거래 01.유통융자 02.자기융자 03.유통대주 04.자기대주 10.매입자금대출" }, "nmn_pr_tp_cd_nm": { "type": "string", "description": "호가유형코드명 / 길이 30" }, "orr_cnd_dit_cd_nm": { "type": "string", "description": "주문조건구분코드명 / 길이 60" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 19" }, "orr_pr": { "type": "number", "format": "double", "description": "주문가격 / 길이 15.3" }, "tot_cns_qty": { "type": "integer", "format": "int64", "description": "총체결수량 / 길이 23" }, "cns_avg_uit_pr": { "type": "number", "format": "double", "description": "체결평균단가 / 길이 15.3" }, "cns_amt": { "type": "integer", "format": "int64", "description": "체결금액 / 길이 16" }, "cns_cnt": { "type": "integer", "format": "int64", "description": "체결건수 / 길이 19" }, "ny_cns_qty": { "type": "integer", "format": "int64", "description": "미체결수량 / 길이 23" }, "cor_qty": { "type": "string", "description": "정정수량 / 길이 19" }, "can_qty": { "type": "integer", "format": "int64", "description": "취소수량 / 길이 19" }, "orr_tm": { "type": "string", "description": "주문시각 / 길이 9" }, "orr_mdi": { "type": "string", "description": "주문매체 / 길이 20" }, "bnd_byn_dt": { "type": "string", "description": "채권매수일자 / 길이 8" }, "syn_ttn_dit_cd_nm": { "type": "string", "description": "종합과세구분코드명 / 길이 50" }, "orr_rjt_rsn_cd_nm": { "type": "string", "description": "주문거부사유코드명 / 길이 4" }, "pcs_emp_no": { "type": "string", "description": "처리사원번호 / 길이 6" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3 / SOR/KRX/NXT" }, "sor_mkt_sli_yn": { "type": "string", "description": "SOR시장분할여부 / 길이 1 / Y.분할 N.미분할" }, "krx_lnt_opi_sec_co_cd": { "type": "string", "description": "거래소대량상대증권회사코드 / 길이 5" }, "krx_lnt_opi_act_no": { "type": "string", "description": "거래소대량상대계좌번호 / 길이 12" }, "krx_lnt_cnf_cpl_hur": { "type": "string", "description": "거래소대량협의완료시간 / 길이 9" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ], "x-schema-warning": [ { "block": "Output_0", "declared": "Object", "sample": "Array" } ] } }, "/krstock/inquiry/v1/balance": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryBalance", "summary": "주식잔고조회", "description": "국내주식 잔고조회 API 입니다.\n순자산금액, 총자산금액, 총매수금액, 총평가금액, 총평가손익 정보는 보유한 잔고를 모두 조회한 이후에 제공됩니다.\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 계좌만 유효)" }, "bnc_bse_cd": { "type": "string", "description": "잔고기준코드 / 길이 1 / 1.주식관련 총 평가(체결기준) 5.주식잔고평가(현재가기준)" }, "ltg_aot_dit_cd": { "type": "string", "description": "상장폐지구분코드 / 길이 1 / 1.상장종목 9.전체" }, "aet_bse": { "type": "string", "description": "자산기준 / 길이 1 / 1.순자산 2.총자산" }, "qut_dit_cd": { "type": "string", "description": "시세구분코드 / 길이 3 / UNT/KRX/NXT 중 하나를 반드시 입력 (UNT=통합시세, KRX=KRX시세, NXT=NXT시세)" } }, "required": [ "act_no", "bnc_bse_cd", "ltg_aot_dit_cd", "aet_bse", "qut_dit_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "dca": { "type": "integer", "format": "int64", "description": "예수금 / 길이 18" }, "nxt_dd_dca": { "type": "integer", "format": "int64", "description": "익일예수금 / 길이 15 / D+1 예수금" }, "nxt2_dd_dca": { "type": "integer", "format": "int64", "description": "익익일예수금 / 길이 18 / D+2 예수금" }, "fc_dca": { "type": "string", "description": "외화예수금 / 길이 18" }, "fc_mgg_amt": { "type": "string", "description": "외화담보금액 / 길이 18" }, "fc_orr_pbl_amt": { "type": "string", "description": "외화주문가능금액 / 길이 18" }, "drn_pbl_amt": { "type": "integer", "format": "int64", "description": "출금가능금액 / 길이 18" }, "fnn_amt": { "type": "string", "description": "융자금액 / 길이 18" }, "mgg_rt": { "type": "number", "format": "double", "description": "담보비율 / 길이 11.8" }, "rit_eal_amt": { "type": "string", "description": "권리평가금액 / 길이 18" }, "orr_pbl_amt": { "type": "string", "description": "주문가능금액 / 길이 18" }, "nas_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" }, "tot_eal_amt": { "type": "integer", "format": "int64", "description": "총평가금액 / 길이 18" }, "tot_eal_pls": { "type": "integer", "format": "int64", "description": "총평가손익 / 길이 18" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "rba": { "type": "integer", "format": "int64", "description": "미수금 / 길이 18" }, "int_ny_pmt_amt": { "type": "integer", "format": "int64", "description": "이자미납부금액 / 길이 18" }, "ny_rdp_amt": { "type": "integer", "format": "int64", "description": "미상환금액 / 길이 18" }, "ect_lga": { "type": "integer", "format": "int64", "description": "기타대여금 / 길이 18" }, "lon_amt": { "type": "integer", "format": "int64", "description": "대출금액 / 길이 18" }, "sba_amt": { "type": "integer", "format": "int64", "description": "대용금액 / 길이 18" }, "orr_pbl_amt1": { "type": "string", "description": "주문가능금액1 / 길이 18 / 20%주문가능금액" }, "orr_pbl_amt2": { "type": "integer", "format": "int64", "description": "주문가능금액2 / 길이 18 / 30%주문가능금액" }, "orr_pbl_amt3": { "type": "integer", "format": "int64", "description": "주문가능금액3 / 길이 18 / 40%주문가능금액" }, "orr_pbl_amt4": { "type": "integer", "format": "int64", "description": "주문가능금액4 / 길이 18 / 100%주문가능금액" }, "slo_mgg_amt": { "type": "integer", "format": "int64", "description": "대주담보금액 / 길이 18" }, "csh_wtm": { "type": "integer", "format": "int64", "description": "현금증거금 / 길이 18" }, "sba_wtm": { "type": "integer", "format": "int64", "description": "대용증거금 / 길이 18" }, "sll_edn_amt": { "type": "integer", "format": "int64", "description": "매도증거금액 / 길이 18" }, "cfd_pdt_tp_nm": { "type": "string", "description": "신용상품유형명 / 길이 20" }, "act_atv_tp_dtl_cd": { "type": "string", "description": "계좌활동유형세부코드 / 길이 3 / 101: 활동 102: 휴면 401: 고객요청폐쇄" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "pdt_tp_nm": { "type": "string", "description": "상품유형명 / 길이 50" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "tp_cd_nm": { "type": "string", "description": "유형코드명 / 길이 30" }, "itg_bnc_qty": { "type": "number", "format": "double", "description": "통합잔고수량 / 길이 21.6" }, "ny_stl_qty": { "type": "number", "format": "double", "description": "미결제수량 / 길이 21.6" }, "rsdl_qty": { "type": "number", "format": "double", "description": "잔량수량 / 길이 21.6" }, "phs_pr": { "type": "integer", "format": "int64", "description": "매입가격 / 길이 18" }, "now_pr": { "type": "integer", "format": "int64", "description": "현재가격 / 길이 18" }, "byn_amt": { "type": "string", "description": "매수금액 / 길이 18" }, "eal_amt": { "type": "integer", "format": "int64", "description": "평가금액 / 길이 18" }, "eal_pls_amt": { "type": "integer", "format": "int64", "description": "평가손익금액 / 길이 18" }, "sll_amt": { "type": "integer", "format": "int64", "description": "매도금액 / 길이 18" }, "sll_pls_amt": { "type": "integer", "format": "int64", "description": "매도손익금액 / 길이 18" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "syn_ttn_dit_cd": { "type": "string", "description": "종합과세구분코드 / 길이 1" }, "syn_ttn_dit_cd_nm": { "type": "string", "description": "종합과세구분코드명 / 길이 20" }, "crm_aet_cfc_cd": { "type": "string", "description": "CRM자산분류코드 / 길이 2" }, "ctc_int_rt": { "type": "string", "description": "약정이자율 / 길이 11.8" }, "lon_byn_dt": { "type": "string", "description": "대출매수일자 / 길이 8" }, "xrn_dt": { "type": "string", "description": "만기일자 / 길이 8" }, "wtm_rt": { "type": "string", "description": "증거금율 / 길이 10" }, "lon_bnc_amt": { "type": "integer", "format": "int64", "description": "대출잔고금액 / 길이 18" }, "iem_mlf_cd": { "type": "string", "description": "종목중분류코드 / 길이 5" }, "itg_bnc_tp_cd": { "type": "string", "description": "통합잔고유형코드 / 길이 3" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/buyableQuantity": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryBuyableQuantity", "summary": "매수가능수량조회", "description": "국내주식 매수가능수량 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "ost_dit_cd": { "type": "string", "description": "구분코드 / 길이 1 / 1.현금 2.신용(융자대주) 3.매입자금대출" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12 / 예시> NH투자증권인 경우, 005940" }, "nmn_pr_tp_cd": { "type": "string", "description": "호가유형코드 / 길이 2 / 01.보통가 05.시장가 06.조건부지정가 09.자기주식 10.S-OPTION자기주식 11.금전신탁자기주식 12.최유리지정가 13.최우선지정가 16.스톱지정가 17.중간가 61.장전시간외 71.장후시간외 81.시간외단일가 91.장전시간외경쟁대량 92.장중경쟁대량" }, "orr_pr": { "type": "integer", "format": "int64", "description": "주문가격 / 길이 18 / 예시> 12,345원인 경우, 12345" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 구분코드가 \"2\"인 경우 01.유통융자 02.자기융자 03.유통대주 04.자기대주" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8 / 구분코드가 \"2\", \"3\"인 경우" } }, "required": [ "ost_dit_cd", "act_no", "iem_cd", "nmn_pr_tp_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "sll_ctc_amt1": { "type": "string", "description": "매도약정금액1 / 길이 18 / 전일 매도 약정금액" }, "byn_ctc_amt1": { "type": "string", "description": "매수약정금액1 / 길이 18 / 전일 매수 약정금액" }, "sdr_xps1": { "type": "string", "description": "제비용1 / 길이 18 / 전일 제비용" }, "dca": { "type": "integer", "format": "int64", "description": "예수금 / 길이 18 / 당일 예수금" }, "sll_ctc_amt": { "type": "string", "description": "매도약정금액 / 길이 18 / 당일 매도 약정금액" }, "ost_byn_ctc_amt": { "type": "string", "description": "매수약정금액 / 길이 18 / 당일 매수 약정금액" }, "sdr_xps": { "type": "string", "description": "제비용 / 길이 18 / 당일 제비용" }, "nxt_dd_dca": { "type": "integer", "format": "int64", "description": "익일예수금 / 길이 18 / D+1 예수금" }, "nxt2_dd_dca": { "type": "integer", "format": "int64", "description": "익익일예수금 / 길이 18 / D+2 예수금" }, "byn_ny_cns_orr_amt": { "type": "string", "description": "매수미체결주문금액 / 길이 18 / D+2 매수미체결 주문금액" }, "ost_fee": { "type": "integer", "format": "int64", "description": "수수료 / 길이 18 / D+2 수수료" }, "max_pbl_amt": { "type": "integer", "format": "int64", "description": "최대가능금액 / 길이 18 / 조회구분 1. 현금 선택시 출력 최대(미수) 가능금액" }, "max_pbl_qty": { "type": "integer", "format": "int64", "description": "최대가능수량 / 길이 18 / 최대(미수) 가능수량" }, "rvb_orn_max_pbl_fee": { "type": "integer", "format": "int64", "description": "미수발생최대가능수수료 / 길이 18 / 최대(미수) 수수료" }, "csh_orr_pbl_amt": { "type": "integer", "format": "int64", "description": "현금주문가능금액 / 길이 18 / 미수 미발생 현금 가능금액" }, "csh_orr_pbl_qty": { "type": "integer", "format": "int64", "description": "현금주문가능수량 / 길이 18 / 미수 미발생 현금 가능수량" }, "ost_fee1": { "type": "integer", "format": "int64", "description": "수수료1 / 길이 18 / 미수 미발생 현금 수수료" }, "cfd_rvb_orr_pbl_amt": { "type": "integer", "format": "int64", "description": "신용미수주문가능금액 / 길이 18 / 조회구분 2. 신용(융자대주) 선택시 출력 최대주문가능 매수주문 주문가능금액" }, "cfd_rvb_orr_pbl_qty": { "type": "integer", "format": "int64", "description": "신용미수주문가능수량 / 길이 18 / 최대주문가능 매수주문 주문가능수량" }, "cfd_max_pbl_fee": { "type": "integer", "format": "int64", "description": "신용최대가능수수료 / 길이 18 / 최대주문가능 매수주문 수수료" }, "cfd_orr_pbl_amt": { "type": "integer", "format": "int64", "description": "신용주문가능금액 / 길이 18 / 미수미발생 매수주문 주문가능금액" }, "cfd_orr_pbl_qty": { "type": "integer", "format": "int64", "description": "신용주문가능수량 / 길이 18 / 미수미발생 매수주문 주문가능수량" }, "ost_fee2": { "type": "integer", "format": "int64", "description": "수수료2 / 길이 18 / 미수미발생 매수주문 수수료" }, "lmt_amt": { "type": "integer", "format": "int64", "description": "한도금액 / 길이 18 / 미수 미발생 현금 개인한도금액" }, "use_lmt_amt": { "type": "integer", "format": "int64", "description": "사용한도금액 / 길이 18 / 미수 미발생 현금 시용한도" }, "rmn_lmt": { "type": "integer", "format": "int64", "description": "잔여한도 / 길이 18 / 미수 미발생 현금 잔여한도" }, "use_pbl_sba_amt": { "type": "integer", "format": "int64", "description": "사용가능대용금액 / 길이 18 / 미수 미발생 현금 사용가능대용(종가)" }, "use_pbl_csh": { "type": "integer", "format": "int64", "description": "사용가능현금 / 길이 18 / 미수 미발생 현금 사용가능현금" }, "orr_pbl_amt1": { "type": "integer", "format": "int64", "description": "주문가능금액1 / 길이 18 / 미수 미발생 현금 주문가능(한도적용전)" }, "lon_lmt_amt": { "type": "integer", "format": "int64", "description": "대출한도금액 / 길이 18 / 조회구분 3.매입자금대출 선택시 출력 대출한도" }, "lmt_use_amt": { "type": "integer", "format": "int64", "description": "한도사용금액 / 길이 18 / 한도사용금액" }, "rmn_lmt1": { "type": "integer", "format": "int64", "description": "잔여한도1 / 길이 18 / 잔여한도" }, "orr_pbl_sba_amt": { "type": "integer", "format": "int64", "description": "주문가능대용금액 / 길이 18 / 주문가능대용" }, "orr_pbl_amt2": { "type": "integer", "format": "int64", "description": "주문가능금액2 / 길이 18 / 주문가능금액(한도적용전)" }, "orr_pbl_amt3": { "type": "integer", "format": "int64", "description": "주문가능금액3 / 길이 18 / 주문가능금액(한도적용)" }, "orr_pbl_qty": { "type": "integer", "format": "int64", "description": "주문가능수량 / 길이 18 / 주문가능수량" }, "ost_fee3": { "type": "integer", "format": "int64", "description": "수수료3 / 길이 18 / 수수료" }, "int_rt": { "type": "number", "format": "double", "description": "이자율 / 길이 11.8 / 이자율" }, "orr_pr": { "type": "string", "description": "주문가격 / 길이 18" }, "rp_eal_amt": { "type": "string", "description": "RP평가금액 / 길이 18 / CMA 평가금" }, "ny_stl_qty": { "type": "string", "description": "미결제수량 / 길이 21.6" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/sellableQuantity": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquirySellableQuantity", "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 / 예시> NH투자증권인 경우, 005940" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8 / 신용대출코드가 '01.유통융자'일때 YYYYMMDD" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 00.일반거래 01.유통융자 02.자기융자 03.유통대주 04.자기대주" } }, "required": [ "act_no", "iem_cd", "cfd_lon_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "ost_dit_cd": { "type": "string", "description": "구분코드 / 길이 1 / 1.현금 또는 신용\n2.대출" }, "dit_nm": { "type": "string", "description": "구분명 / 길이 20" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 00.현금\n01.유통융자\n02.자기융자\n03.유통대주\n04.자기대주\n10.매입자금대출\n11.매도담보대출\n12.주식담보대출\n13.채권담보대출\n14.ELS/DLS담보대출\n15.수익증권대출\n16.수익환매대출\n17.청약자금대출\n18.ELS/DLS환매담보대출\n19.해외주식담보대출\n20.해외주식매도담보대출\n99.종합담보대출\n_.해당사항없음" }, "cfd_lon_cd_nm": { "type": "string", "description": "신용대출코드명 / 길이 40" }, "ttn_tp_cd": { "type": "string", "description": "과세유형코드 / 길이 2 / 01.일반과세\n02.비과세\n03.세금우대\n04.소액부징수\n_.해당사항없음" }, "ttn_tp_cd_nm": { "type": "string", "description": "과세유형코드명 / 길이 40" }, "bnc_qty": { "type": "integer", "format": "int64", "description": "잔고수량 / 길이 18" }, "sll_ny_stl_qty": { "type": "string", "description": "매도미결제수량 / 길이 18.0" }, "byn_ny_stl_qty": { "type": "string", "description": "매수미결제수량 / 길이 18.0" }, "tdt_sll_ny_cns_qty": { "type": "number", "format": "double", "description": "당일매도미체결수량 / 길이 18.0" }, "sll_pbl_qty": { "type": "number", "format": "double", "description": "매도가능수량 / 길이 18.0 / 장중(08:00-15:00)까지는 수량단위미만 절사" }, "phs_uit_pr": { "type": "string", "description": "매입단가 / 길이 18.0" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/reservedInquiry": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryReservedInquiry", "summary": "주식예약주문조회", "description": "국내주식 예약주문내역 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "bkg_orr_rtn_dt": { "type": "string", "description": "예약주문접수일자 / 길이 8 / YYYYMMDD" }, "act_no": { "type": "string", "description": "계좌번호 / 길이 11 / 조회구분 \"2\"일 때 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12 / 예시> NH투자증권인 경우, 005940" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 0.전체 1.매도 2.매수" }, "cfd_lon_cd": { "type": "string", "description": "신용대출코드 / 길이 2 / 00.일반거래 01.유통융자 02.자기융자 03.유통대주 04.자기대주 10.매입자금대출 11.매도담보대출 12.주식담보대출" }, "bkg_orr_tp_cd": { "type": "string", "description": "예약주문유형코드 / 길이 1 / 0.전체 1.일반예약(현금/대출예약) 2.기간예약(잔량예약) 3.기간예약(수량예약)" }, "bkg_orr_can_dit_cd": { "type": "string", "description": "예약주문취소구분코드 / 길이 1 / .전체 0.잔존주문 1.본인취소 2.직원취소" } }, "required": [ "act_no", "sby_dit_cd", "bkg_orr_tp_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "tab_nm": { "type": "string", "description": "팀점명 / 길이 50" }, "bkg_orr_rtn_dt": { "type": "string", "description": "예약주문접수일자 / 길이 8" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "act_no": { "type": "string", "description": "계좌번호 / 길이 11" }, "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "amn_tab_nm": { "type": "string", "description": "관리팀점명 / 길이 50" }, "act_pdt_nm": { "type": "string", "description": "계좌상품명 / 길이 60" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "sby_dit_cd_nm": { "type": "string", "description": "매매구분코드명 / 길이 50" }, "nmn_pr_tp_cd_nm": { "type": "string", "description": "호가유형코드명 / 길이 30" }, "cfd_lon_cd_nm": { "type": "string", "description": "신용대출코드명 / 길이 40" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8" }, "orr_qty": { "type": "integer", "format": "int64", "description": "주문수량 / 길이 18" }, "orr_pr": { "type": "integer", "format": "int64", "description": "주문가격 / 길이 18" }, "acl_cns_qty": { "type": "integer", "format": "int64", "description": "누적체결수량 / 길이 18" }, "orr_enf_sta_dt": { "type": "string", "description": "주문집행시작일자 / 길이 8" }, "orr_enf_end_dt": { "type": "string", "description": "주문집행종료일자 / 길이 8" }, "lst_orr_enf_dt": { "type": "string", "description": "최종주문집행일자 / 길이 8" }, "bkg_orr_tp_cd_nm": { "type": "string", "description": "예약주문유형코드명 / 길이 50" }, "bkg_orr_enf_tp_cd_nm": { "type": "string", "description": "예약주문집행유형코드명 / 길이 60" }, "end_pr_cmp_ftw_amt": { "type": "integer", "format": "int64", "description": "종가대비등락폭금액 / 길이 18" }, "orr_pr_rge_hlm_pr": { "type": "integer", "format": "int64", "description": "주문가격범위상한가 / 길이 18" }, "orr_pr_rge_llm_pr": { "type": "integer", "format": "int64", "description": "주문가격범위하한가 / 길이 18" }, "bkg_orr_can_dit_cd_nm": { "type": "string", "description": "예약주문취소구분코드명 / 길이 50" }, "rgs_dt": { "type": "string", "description": "등록일자 / 길이 8" }, "rgs_tm": { "type": "string", "description": "등록시각 / 길이 8" }, "rgs_emp_no": { "type": "string", "description": "등록사원번호 / 길이 6" }, "can_dt": { "type": "string", "description": "취소일자 / 길이 8" }, "can_tm": { "type": "string", "description": "취소시각 / 길이 8" }, "can_emp_no": { "type": "string", "description": "취소사원번호 / 길이 6" }, "bkg_orr_rtn_dt": { "type": "string", "description": "예약주문접수일자 / 길이 8" }, "bkg_rtn_orr_no": { "type": "integer", "format": "int64", "description": "예약접수주문번호 / 길이 10" }, "sby_dit_cd": { "type": "string", "description": "매매구분코드 / 길이 1 / 1.현금매도 2.현금매수 3.대용매도 4.신용매도 5.신용매수 6.대출매도 7.대출매수" }, "stk_now_pr": { "type": "integer", "format": "int64", "description": "주식현재가격 / 길이 18" }, "te_bkg_orr_ssp_yn": { "type": "string", "description": "기간예약주문중단여부 / 길이 1" }, "rmt_mkt_cd": { "type": "string", "description": "요청시장코드 / 길이 3" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/realizedPnl": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryRealizedPnl", "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 계좌만 유효)" }, "iqr_dit_cd1": { "type": "string", "description": "조회구분코드1 / 길이 1 / 0.전체 1.잔고종목 2.당일매매" }, "fee_dit_cd": { "type": "string", "description": "수수료구분코드 / 길이 1 / 1.온라인 2.영업점" }, "qut_dit_cd": { "type": "string", "description": "시세구분코드 / 길이 3 / UNT/KRX/NXT 중 하나를 반드시 입력 (UNT=통합시세, KRX=KRX시세, NXT=NXT시세)" } }, "required": [ "act_no", "iqr_dit_cd1", "fee_dit_cd", "qut_dit_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "rnm_cfm_no": { "type": "string", "description": "실명확인번호 / 길이 13" }, "act_atv_tp_dtl_cd": { "type": "string", "description": "계좌활동유형세부코드 / 길이 3" }, "act_amn_tab_cd": { "type": "string", "description": "계좌관리팀점코드 / 길이 4" }, "act_pdt_llf_cd": { "type": "string", "description": "계좌상품대분류코드 / 길이 2" }, "tdy_dca": { "type": "integer", "format": "int64", "description": "금일예수금 / 길이 18 / 예수금" }, "nxt_dd_dca": { "type": "integer", "format": "int64", "description": "익일예수금 / 길이 18 / D+1 예수금" }, "nxt2_dd_dca": { "type": "integer", "format": "int64", "description": "익익일예수금 / 길이 18 / D+2 예수금" }, "orr_pbl_amt1": { "type": "integer", "format": "int64", "description": "주문가능금액1 / 길이 18 / 100% 주문가능금액" }, "orr_pbl_amt2": { "type": "integer", "format": "int64", "description": "주문가능금액2 / 길이 18 / 20% 주문가능금액" }, "orr_pbl_amt3": { "type": "integer", "format": "int64", "description": "주문가능금액3 / 길이 18 / 30% 주문가능금액" }, "orr_pbl_amt4": { "type": "integer", "format": "int64", "description": "주문가능금액4 / 길이 18 / 40% 주문가능금액" }, "csh_wtm": { "type": "integer", "format": "int64", "description": "현금증거금 / 길이 18" }, "sba_wtm": { "type": "integer", "format": "int64", "description": "대용증거금 / 길이 18" }, "tdt_byn_amt": { "type": "integer", "format": "int64", "description": "당일매수금액 / 길이 18" }, "tdt_sll_amt": { "type": "integer", "format": "int64", "description": "당일매도금액 / 길이 18" }, "sdr_xps": { "type": "integer", "format": "int64", "description": "제비용 / 길이 18 / 당일매매제비용" }, "sby_pls_amt": { "type": "integer", "format": "int64", "description": "매매손익금액 / 길이 18 / 당일매매손익" }, "eal_amt_sum": { "type": "integer", "format": "int64", "description": "평가금액합계 / 길이 18" }, "eal_pls_amt": { "type": "integer", "format": "int64", "description": "평가손익금액 / 길이 18" }, "sll_edn_amt": { "type": "integer", "format": "int64", "description": "매도증거금액 / 길이 18 / (-)대용" }, "aet_amt": { "type": "integer", "format": "int64", "description": "자산금액 / 길이 18 / D+2 자산금액" }, "aet_drs_amt": { "type": "integer", "format": "int64", "description": "자산감소금액 / 길이 18 / 전체매도후자산" }, "pft_rt1": { "type": "number", "format": "double", "description": "수익율1 / 길이 15.9 / 총수익률" }, "pft_rt2": { "type": "number", "format": "double", "description": "수익율2 / 길이 15.9 / 당일실현수익률" }, "bf_dd_eal_amt2": { "type": "integer", "format": "int64", "description": "전일평가금액2 / 길이 18 / 전일잔고평가금액" }, "eal_pls2": { "type": "integer", "format": "int64", "description": "평가손익2 / 길이 18 / 전일대비손익" }, "pft_rt3": { "type": "number", "format": "double", "description": "수익율3 / 길이 15.9 / 전일대비수익률" }, "pna_sum_amt": { "type": "integer", "format": "int64", "description": "원금합계금액 / 길이 18 / 당일매도매입총원금" }, "phs_tal": { "type": "integer", "format": "int64", "description": "매입총액 / 길이 18 / 잔고매입총액" }, "aet_par_tal": { "type": "integer", "format": "int64", "description": "자산액면총액 / 길이 18 / 실자산금액" }, "sdr_xps2": { "type": "integer", "format": "int64", "description": "제비용2 / 길이 18 / 매도제비용합" }, "sby_wtm_aly_cd_nm": { "type": "string", "description": "매매증거금적용코드명 / 길이 50 / 계좌증거금율" }, "pft_rt10": { "type": "number", "format": "double", "description": "수익율10 / 길이 15.9 / 잔고평가수익률" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "itg_bnc_qty": { "type": "number", "format": "double", "description": "통합잔고수량 / 길이 18.3" }, "orr_pbl_qty": { "type": "integer", "format": "int64", "description": "주문가능수량 / 길이 18" }, "bf_dd_byn_qty": { "type": "integer", "format": "int64", "description": "전일매수수량 / 길이 18" }, "bf_dd_sll_qty": { "type": "integer", "format": "int64", "description": "전일매도수량 / 길이 18" }, "tdt_byn_qty": { "type": "integer", "format": "int64", "description": "당일매수수량 / 길이 18" }, "tdt_sll_qty": { "type": "integer", "format": "int64", "description": "당일매도수량 / 길이 18" }, "avg_phs_uit_pr": { "type": "integer", "format": "int64", "description": "평균매입단가 / 길이 18" }, "sll_uit_pr": { "type": "integer", "format": "int64", "description": "매도단가 / 길이 18" }, "phs_amt": { "type": "integer", "format": "int64", "description": "매입금액 / 길이 18" }, "rzt_pls_amt": { "type": "integer", "format": "int64", "description": "실현손익금액 / 길이 18" }, "sdr_xps": { "type": "integer", "format": "int64", "description": "제비용 / 길이 18 / 당일매매제비용" }, "rzt_pft_sby_pls_amt": { "type": "integer", "format": "int64", "description": "실현수익매매손익금액 / 길이 18" }, "ost_phs_amt_pna": { "type": "integer", "format": "int64", "description": "매입금액원금 / 길이 18" }, "eal_pls": { "type": "integer", "format": "int64", "description": "평가손익 / 길이 18" }, "now_pr": { "type": "integer", "format": "int64", "description": "현재가격 / 길이 15" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "sdr_xps1": { "type": "integer", "format": "int64", "description": "제비용1 / 길이 15 / 매도제비용" }, "pft_rt7": { "type": "number", "format": "double", "description": "수익율7 / 길이 15.9 / 당일실현수익률" }, "pft_rt6": { "type": "number", "format": "double", "description": "수익율6 / 길이 15.9 / 평가수익률" }, "pft_rt2": { "type": "number", "format": "double", "description": "수익율2 / 길이 15.9 / 당일실현수익률" }, "bnc_tp_dit_cd_nm": { "type": "string", "description": "잔고유형구분코드명 / 길이 50" }, "lon_dt": { "type": "string", "description": "대출일자 / 길이 8" }, "bf_dd_end_pr": { "type": "integer", "format": "int64", "description": "전일종가 / 길이 18" }, "bf_dd_bnc_amt": { "type": "integer", "format": "int64", "description": "전일잔고금액 / 길이 18" }, "bf_dd_cmp_ind_amt": { "type": "integer", "format": "int64", "description": "전일대비증감금액 / 길이 18" }, "bf_dd_cmp_ind_rt": { "type": "number", "format": "double", "description": "전일대비증감율 / 길이 8.3" }, "stl_bnc_qty": { "type": "integer", "format": "int64", "description": "결제잔고수량 / 길이 18" }, "avg_uit_pr1": { "type": "integer", "format": "int64", "description": "평균단가1 / 길이 15" }, "xrn_dt": { "type": "string", "description": "만기일자 / 길이 8" }, "dit_nm1": { "type": "string", "description": "구분명1 / 길이 10" }, "bf_dd_sll_amt": { "type": "integer", "format": "int64", "description": "전일매도금액 / 길이 18" }, "tdy_sll_amt": { "type": "integer", "format": "int64", "description": "금일매도금액 / 길이 18" }, "bf_dd_byn_amt": { "type": "integer", "format": "int64", "description": "전일매수금액 / 길이 18" }, "tdy_byn_amt": { "type": "integer", "format": "int64", "description": "금일매수금액 / 길이 18" }, "sll_pna": { "type": "integer", "format": "int64", "description": "매도원금 / 길이 18" }, "bnc_eal_amt": { "type": "integer", "format": "int64", "description": "잔고평가금액 / 길이 18" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/assetStatus": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryAssetStatus", "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 계좌만 유효)" }, "eal_aly_cd": { "type": "string", "description": "평가적용코드 / 길이 1 / 1.장부가평가 2.시가평가" }, "aet_bse": { "type": "string", "description": "자산기준 / 길이 1 / 1.순자산 2.총자산" }, "qut_dit_cd": { "type": "string", "description": "시세구분코드 / 길이 3 / UNT/KRX/NXT 중 하나를 반드시 입력 (UNT=통합시세, KRX=KRX시세, NXT=NXT시세)" } }, "required": [ "act_no", "eal_aly_cd", "aet_bse", "qut_dit_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "cus_fnm": { "type": "string", "description": "고객성명 / 길이 40" }, "rnm_cfm_no": { "type": "string", "description": "실명확인번호 / 길이 13" }, "ctc_tp_cd_nm": { "type": "string", "description": "약정유형코드명 / 길이 20" }, "act_amn_tab_cd": { "type": "string", "description": "계좌관리팀점코드 / 길이 4" }, "act_pdt_llf_cd": { "type": "string", "description": "계좌상품대분류코드 / 길이 2" }, "amn_emp_fnm": { "type": "string", "description": "관리사원성명 / 길이 40" }, "dca": { "type": "integer", "format": "int64", "description": "예수금 / 길이 18 / 예수금" }, "nxt_dd_dca": { "type": "integer", "format": "int64", "description": "익일예수금 / 길이 15 / D+1 예수금" }, "nxt2_dd_dca": { "type": "integer", "format": "int64", "description": "익익일예수금 / 길이 18 / D+2 예수금" }, "krw_tsl_fc_dca": { "type": "integer", "format": "int64", "description": "원화환산외화예수금 / 길이 18" }, "krw_tsl_fc_mgg_amt": { "type": "integer", "format": "int64", "description": "원화환산외화담보금액 / 길이 18" }, "krw_tsl_fc_orr_pbl_amt": { "type": "integer", "format": "int64", "description": "원화환산외화주문가능금액 / 길이 18" }, "drn_pbl_amt": { "type": "integer", "format": "int64", "description": "출금가능금액 / 길이 18" }, "fnn_amt": { "type": "integer", "format": "int64", "description": "융자금액 / 길이 18" }, "mgg_rt": { "type": "number", "format": "double", "description": "담보비율 / 길이 15.3" }, "stk_orr_pbl_amt": { "type": "integer", "format": "int64", "description": "주식주문가능금액 / 길이 18" }, "tot_aet_amt": { "type": "integer", "format": "int64", "description": "총자산금액 / 길이 18" }, "nas_amt": { "type": "integer", "format": "int64", "description": "순자산금액 / 길이 18" }, "tot_byn_amt": { "type": "integer", "format": "int64", "description": "총매수금액 / 길이 18" }, "tot_eal_amt": { "type": "integer", "format": "int64", "description": "총평가금액 / 길이 18" }, "tot_eal_pls_amt": { "type": "integer", "format": "int64", "description": "총평가손익금액 / 길이 18" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "rba": { "type": "integer", "format": "int64", "description": "미수금 / 길이 18" }, "int_ny_pmt_amt": { "type": "integer", "format": "int64", "description": "이자미납부금액 / 길이 18" }, "ect_lga": { "type": "integer", "format": "int64", "description": "기타대여금 / 길이 18" }, "lon_amt": { "type": "integer", "format": "int64", "description": "대출금액 / 길이 18" }, "sba_amt": { "type": "integer", "format": "int64", "description": "대용금액 / 길이 18" }, "fnc_pdt_orr_pbl_amt": { "type": "integer", "format": "int64", "description": "금융상품주문가능금액 / 길이 18" }, "ny_rdp_amt": { "type": "integer", "format": "int64", "description": "미상환금액 / 길이 18" }, "cfd_pdt_tp_nm": { "type": "string", "description": "신용상품유형명 / 길이 20" }, "act_atv_tp_cd_nm": { "type": "string", "description": "계좌활동유형코드명 / 길이 50" }, "slo_amt": { "type": "integer", "format": "int64", "description": "대주금액 / 길이 18" }, "csh_wtm": { "type": "integer", "format": "int64", "description": "현금증거금 / 길이 18" }, "fnd_sll_stl_xpn_amt": { "type": "number", "format": "double", "description": "펀드매도결제예정금액 / 길이 18.3" }, "sbi_dca": { "type": "integer", "format": "int64", "description": "청약예수금 / 길이 18" }, "ima_wtm": { "type": "integer", "format": "int64", "description": "IMA증거금 / 길이 18" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "iem_mlf_nm": { "type": "string", "description": "종목중분류명 / 길이 50" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "bnc_tp_dit_cd_nm": { "type": "string", "description": "잔고유형구분코드명 / 길이 50" }, "itg_bnc_qty": { "type": "number", "format": "double", "description": "통합잔고수량 / 길이 21.6" }, "phs_pr": { "type": "number", "format": "double", "description": "매입가격 / 길이 15.2" }, "now_pr": { "type": "number", "format": "double", "description": "현재가격 / 길이 15.2" }, "byn_amt": { "type": "integer", "format": "int64", "description": "매수금액 / 길이 18" }, "eal_amt": { "type": "integer", "format": "int64", "description": "평가금액 / 길이 18" }, "eal_pls_amt": { "type": "integer", "format": "int64", "description": "평가손익금액 / 길이 18" }, "sll_pls_amt": { "type": "number", "format": "double", "description": "매도손익금액 / 길이 15.3" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "int_rt": { "type": "number", "format": "double", "description": "이자율 / 길이 11.8" }, "byn_dt": { "type": "string", "description": "매수일자 / 길이 8" }, "xrn_dt": { "type": "string", "description": "만기일자 / 길이 8" }, "lon_xrn_dt": { "type": "string", "description": "대출만기일자 / 길이 8" }, "syn_ttn_dit_cd": { "type": "string", "description": "종합과세구분코드 / 길이 1" }, "syn_ttn_dit_cd_nm": { "type": "string", "description": "종합과세구분코드명 / 길이 50" }, "crm_aet_cfc_cd": { "type": "string", "description": "CRM자산분류코드 / 길이 2" }, "iem_mlf_cd": { "type": "string", "description": "종목중분류코드 / 길이 5" }, "byn_cim_qty": { "type": "integer", "format": "int64", "description": "매수청구수량 / 길이 18" }, "rth_qty": { "type": "integer", "format": "int64", "description": "실물수량 / 길이 18" }, "ctc_int_rt": { "type": "number", "format": "double", "description": "약정이자율 / 길이 11.8" }, "lon_bnc_amt": { "type": "integer", "format": "int64", "description": "대출잔고금액 / 길이 18" }, "cur_cd": { "type": "string", "description": "통화코드 / 길이 3" }, "fc_sec_trd_nat_cd": { "type": "string", "description": "외화증권거래국가코드 / 길이 3" }, "nat_cd_nm": { "type": "string", "description": "국가코드명 / 길이 40" }, "itg_bnc_tp_cd": { "type": "string", "description": "통합잔고유형코드 / 길이 3" }, "tck_iem_cd": { "type": "string", "description": "티커종목코드 / 길이 12" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/dailyPnl": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryDailyPnl", "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" }, "iqr_sta_dt": { "type": "string", "description": "조회시작일자 / 길이 8 / YYYYMMDD" }, "iqr_end_dt": { "type": "string", "description": "조회종료일자 / 길이 8 / YYYYMMDD" } }, "required": [ "act_no", "iqr_sta_dt", "iqr_end_dt" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "act_fnm": { "type": "string", "description": "계좌성명 / 길이 40" }, "byn_cst_sum": { "type": "string", "description": "매수대금합계1 / 길이 18" }, "sll_cst_sum": { "type": "string", "description": "매도대금합계1 / 길이 18" }, "pls_amt_sum": { "type": "integer", "format": "int64", "description": "손익금액합계 / 길이 15" }, "acl_sdr_xps": { "type": "integer", "format": "int64", "description": "누적제비용 / 길이 18" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "sby_dt": { "type": "string", "description": "매매일자 / 길이 8" }, "byn_qty": { "type": "number", "format": "double", "description": "매수수량 / 길이 18.6" }, "byn_amt": { "type": "integer", "format": "int64", "description": "매수금액 / 길이 18" }, "byn_fee": { "type": "integer", "format": "int64", "description": "매수수수료 / 길이 18" }, "byn_amt_sum": { "type": "integer", "format": "int64", "description": "매수금액합계 / 길이 18" }, "sll_qty": { "type": "number", "format": "double", "description": "매도수량 / 길이 18.6" }, "sll_amt": { "type": "integer", "format": "int64", "description": "매도금액 / 길이 18" }, "sll_tax_sum": { "type": "integer", "format": "int64", "description": "매도세금합계 / 길이 18" }, "sll_amt_sum": { "type": "integer", "format": "int64", "description": "매도금액합계 / 길이 18" }, "pls_amt": { "type": "integer", "format": "int64", "description": "손익금액 / 길이 18" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "iem_mlf_cd": { "type": "string", "description": "종목중분류코드 / 길이 5 / 01001.주식\n01002.DR\n01003.투자회사\n01004.신주인수권증권\n01005.상장REITS\n01006.신주인수권증서\n01007.ETF\n01008.상장수익증권" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/tradingPnl": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryTradingPnl", "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 계좌만 유효)" }, "iqr_sta_dt": { "type": "string", "description": "조회시작일자 / 길이 8 / YYYYMMDD" }, "iqr_end_dt": { "type": "string", "description": "조회종료일자 / 길이 8 / YYYYMMDD" } }, "required": [ "act_no", "iqr_sta_dt", "iqr_end_dt" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "byn_qty": { "type": "number", "format": "double", "description": "매수수량 / 길이 18.6" }, "byn_uit_pr": { "type": "number", "format": "double", "description": "매수단가 / 길이 15.3" }, "byn_fee": { "type": "integer", "format": "int64", "description": "매수수수료 / 길이 18" }, "byn_cnt": { "type": "integer", "format": "int64", "description": "매수건수 / 길이 18" }, "byn_amt": { "type": "integer", "format": "int64", "description": "매수금액 / 길이 18" }, "sll_qty": { "type": "number", "format": "double", "description": "매도수량 / 길이 18.6" }, "sll_uit_pr": { "type": "number", "format": "double", "description": "매도단가 / 길이 15.3" }, "sll_tax_sum": { "type": "integer", "format": "int64", "description": "매도세금합계 / 길이 18" }, "sll_cnt": { "type": "integer", "format": "int64", "description": "매도건수 / 길이 18" }, "sll_amt": { "type": "integer", "format": "int64", "description": "매도금액 / 길이 18" }, "sll_abk_amt": { "type": "integer", "format": "int64", "description": "매도장부금액 / 길이 18" }, "pls_amt": { "type": "integer", "format": "int64", "description": "손익금액 / 길이 18" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "fee_sum": { "type": "string", "description": "수수료합계 / 길이 18" }, "tax_sum": { "type": "string", "description": "세금합계 / 길이 18" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 60" }, "byn_qty": { "type": "number", "format": "double", "description": "매수수량 / 길이 18.6" }, "byn_uit_pr": { "type": "number", "format": "double", "description": "매수단가 / 길이 15.3" }, "byn_fee": { "type": "integer", "format": "int64", "description": "매수수수료 / 길이 18" }, "byn_cnt": { "type": "integer", "format": "int64", "description": "매수건수 / 길이 18" }, "byn_amt": { "type": "integer", "format": "int64", "description": "매수금액 / 길이 18" }, "sll_qty": { "type": "number", "format": "double", "description": "매도수량 / 길이 18.6" }, "sll_uit_pr": { "type": "number", "format": "double", "description": "매도단가 / 길이 15.3" }, "sll_tax_sum": { "type": "integer", "format": "int64", "description": "매도세금합계 / 길이 18" }, "sll_cnt": { "type": "integer", "format": "int64", "description": "매도건수 / 길이 18" }, "sll_amt": { "type": "integer", "format": "int64", "description": "매도금액 / 길이 18" }, "sll_abk_amt": { "type": "integer", "format": "int64", "description": "매도장부금액 / 길이 18" }, "pls_amt": { "type": "integer", "format": "int64", "description": "손익금액 / 길이 18" }, "pft_rt": { "type": "number", "format": "double", "description": "수익율 / 길이 15.9" }, "fee_sum": { "type": "string", "description": "수수료합계 / 길이 18" }, "tax_sum": { "type": "string", "description": "세금합계 / 길이 18" }, "iem_mlf_cd": { "type": "string", "description": "종목중분류코드 / 길이 5 / 01001.주식\n01002.DR\n01003.투자회사\n01004.신주인수권증권\n01005.상장REITS\n01006.신주인수권증서\n01007.ETF\n01008.상장수익증권" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/integratedMargin": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryIntegratedMargin", "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": { "fc_orr_pbl_amt3": { "type": "number", "format": "double", "description": "외화주문가능금액3 / 길이 15.3 / 주문가능금액" }, "cro_sby_stl_amt": { "type": "integer", "format": "int64", "description": "교차매매결제금액 / 길이 18 / 결제금(원)" }, "cro_sby_act_yn": { "type": "string", "description": "교차매매계좌여부 / 길이 1 / 약정여부" }, "lmt_amt": { "type": "integer", "format": "int64", "description": "한도금액 / 길이 18 / 한도금액(원)" }, "lmt_use_amt": { "type": "integer", "format": "int64", "description": "한도사용금액 / 길이 18 / 한도사용금액(원)" }, "rmn_lmt_amt": { "type": "integer", "format": "int64", "description": "잔여한도금액 / 길이 18 / 한도잔여금액(원)" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "cur_cd": { "type": "string", "description": "통화코드 / 길이 3" }, "fc_dca": { "type": "number", "format": "double", "description": "외화예수금 / 길이 15.3" }, "fc_mgg_amt": { "type": "number", "format": "double", "description": "외화담보금액 / 길이 15.3" }, "ose_trd_tax": { "type": "number", "format": "double", "description": "해외거래세 / 길이 15.3" }, "fc_ato_re_sby_obj_amt": { "type": "number", "format": "double", "description": "외화자동재매매대상금액 / 길이 15.3 / 매도금액" }, "fc_orr_pbl_amt": { "type": "number", "format": "double", "description": "외화주문가능금액 / 길이 15.3 / 자국통화 주문가능금액" }, "aly_xcg_rt": { "type": "number", "format": "double", "description": "적용환율 / 길이 12.6" }, "orr_pbl_amt_csh": { "type": "integer", "format": "int64", "description": "주문가능금액현금 / 길이 18" }, "cnv_rt": { "type": "number", "format": "double", "description": "전환비율 / 길이 11.8 / 통합증거금 통화간 전환비율" }, "krw_tsl_cro_pbl_amt": { "type": "integer", "format": "int64", "description": "원화환산교차가능금액 / 길이 18 / 타국통화 통합증거금 가능금액(원)" }, "trd_cur_cro_pbl_amt": { "type": "number", "format": "double", "description": "거래통화교차가능금액 / 길이 15.3 / 타국통화 주문가능금액" }, "fc_orr_pbl_amt1": { "type": "number", "format": "double", "description": "외화주문가능금액1 / 길이 15.3 / 주문가능금액" }, "fc_orr_pbl_amt2": { "type": "number", "format": "double", "description": "외화주문가능금액2 / 길이 15.3 / 가능금액" }, "trd_cur_cro_use_amt": { "type": "number", "format": "double", "description": "거래통화교차사용금액 / 길이 15.3 / 사용금액" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/rightsHeld": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryRightsHeld", "summary": "기간별계좌권리현황조회보유", "description": "국내주식 권리보유 현황조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "sta_dt": { "type": "string", "description": "시작일자 / 길이 8 / YYYYMMDD" }, "act_no": { "type": "string", "description": "권리계좌번호 / 길이 20 / /n2/acctinfo 의 acct_no 사용 (운영은 acct_type=01·02, 모의투자는 03 계좌만 유효)" }, "rit_tp_cd": { "type": "string", "description": "권리유형코드 / 길이 2 / .전체 01.배당 02.유상 03.무상 04.매수청구 05.신주인수권증서 06.뮤추얼 07.ETF분배금 08.선박펀드 09.투융자펀드 10.해외자원개발펀드 11.Ritz(부동산신탁) 12.ELS상환 13.DLS상환 14.ELW만기결제 15.기타청산 16.전환/상환 17.ETN분배금 21.흡수합병 22.회사분할 A2.회사분할2 A3.회사분할3 A4.회사분할4 A5.회사분할5 23.주식교환 24.자본감소 25.액면분할 27.종목변경 31.후흡수합병 32.후회사분할 33.후주식교환 34.후자본감소 35.후액면분할 36.후액면병합 37.후종목변경 48.수익증권 4B.말소" } }, "required": [ "act_no" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "sta_dt": { "type": "string", "description": "시작일자 / 길이 8 / YYYYMMDD" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 12" }, "bse_dt": { "type": "string", "description": "기준일자 / 길이 8 / YYYYMMDD" }, "rit_tp_cd": { "type": "string", "description": "권리유형코드 / 길이 2 / _.해당사항없음 01.배당 02.유상 03.무상 04.매수청구 05.신주인수권증서 06.뮤추얼 07.ETF분배금 08.선박펀드 09.투융자펀드 10.해외자원개발펀드 11.Ritz(부동산신탁) 12.ELS상환 13.DLS상환 14.ELW만기결제 15.기타청산 16.전환/상환 17.ETN분배금 21.흡수합병 22.회사분할 A2.회사분할2 A3.회사분할3 A4.회사분할4 A5.회사분할5 23.주식교환 24.자본감소 25.액면분할 26.액면병합 27.종목변경 31.후흡수합병 32.후회사분할 33.후주식교환 34.후자본감소 35.후액면분할 36.후액면병합 37.후종목변경 41.(기타)소규모합병 42.(기타)상장 43.(기타)주식매수청구 45.(기타)법원결정 46.(기타)공개매수 47.(기타)주주지분목록작성 48.수익증권 49.임시주총 4A.(기타)발행사 정관등 4B.(기타)말소 4C.(기타)정기보고 50.정기주총 51.전환청구 52.교환청구 53.신주인수권부채권권리행사 54.신주인수권증권권리행사 55.DR전환 56.증권소각 57.신주인수권분리 61.채권원리금상환 62.채권풋옵션 70.실권주_청약공매도 80.공모주_청약공매도 81.권리행사 91.배당옵션 92.자본이득 99.기타 E1.ETN중도상환 E2.ETN만기상환 E3.ETN조기상환 SS.주문임의공매도" }, "hld_qty": { "type": "integer", "format": "int64", "description": "보유수량 / 길이 18" }, "aloc_bse_pr": { "type": "integer", "format": "int64", "description": "배정기준가격 / 길이 18" }, "req_amt": { "type": "integer", "format": "int64", "description": "신청금액 / 길이 18" }, "aloc_amt_pym_dt": { "type": "string", "description": "배정금액지급일자 / 길이 8 / YYYYMMDD" }, "ltg_dt": { "type": "string", "description": "상장일자 / 길이 8 / YYYYMMDD" }, "req_yn": { "type": "string", "description": "신청여부 / 길이 1" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 50" }, "ldg_brw_dit_cd": { "type": "string", "description": "대여차입구분코드 / 길이 2 / 01.차입 02.대여(주식) 03.대여풀 04.대여(채권) 05.대여(해외주식) 06.대여(해외채권)" }, "cln_dit_cd": { "type": "string", "description": "유통구분코드 / 길이 2 / 01.일반 02.유통금융 03.유통대주" }, "aloc_qty": { "type": "integer", "format": "int64", "description": "배정수량 / 길이 18" }, "req_end_dt": { "type": "string", "description": "신청종료일자 / 길이 8 / YYYYMMDD" }, "req_qty": { "type": "integer", "format": "int64", "description": "신청수량 / 길이 18" }, "rit_aloc_amt": { "type": "integer", "format": "int64", "description": "권리배정금액 / 길이 18" }, "ltg_iem_cd": { "type": "string", "description": "상장종목코드 / 길이 12" }, "pcs_yn": { "type": "string", "description": "처리여부 / 길이 1" }, "hdd_yn": { "type": "string", "description": "고배당여부 / 길이 1" }, "bkg_sta_dt": { "type": "string", "description": "예약시작일자 / 길이 8 / YYYYMMDD" }, "bkg_end_dt": { "type": "string", "description": "예약종료일자 / 길이 8 / YYYYMMDD" }, "rrs_itn_rtn_end_dt": { "type": "string", "description": "반대의사접수종료일자 / 길이 8 / YYYYMMDD" }, "byn_cim_rtn_end_dt": { "type": "string", "description": "매수청구접수종료일자 / 길이 8 / YYYYMMDD" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/inquiry/v1/rightsScheduled": { "post": { "tags": [ "조회 (Inquiry)" ], "operationId": "krstockInquiryRightsScheduled", "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": "권리계좌번호 / 길이 20 / /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": "종목명 / 길이 50" }, "rit_tp_cd": { "type": "string", "description": "권리유형코드 / 길이 2 / .전체 01.배당 02.유상 03.무상 04.매수청구 05.신주인수권증서 06.뮤추얼 07.ETF분배금 08.선박펀드 09.투융자펀드 10.해외자원개발펀드 11.Ritz(부동산신탁) 12.ELS상환 13.DLS상환 14.ELW만기결제 15.기타청산 16.전환/상환 17.ETN분배금 21.흡수합병 22.회사분할 A2.회사분할2 A3.회사분할3 A4.회사분할4 A5.회사분할5 23.주식교환 24.자본감소 25.액면분할 27.종목변경 31.후흡수합병 32.후회사분할 33.후주식교환 34.후자본감소 35.후액면분할 36.후액면병합 37.후종목변경 48.수익증권 4B.말소" }, "rit_tp_nm": { "type": "string", "description": "권리유형명 / 길이 50" }, "aloc_qty": { "type": "integer", "format": "int64", "description": "배정수량 / 길이 18" }, "aloc_rt": { "type": "number", "format": "double", "description": "배정비율 / 길이 15.12" }, "xgt_dt": { "type": "string", "description": "권리락일자 / 길이 8" }, "bse_dt": { "type": "string", "description": "기준일자 / 길이 8" }, "rit_erc_end_dt": { "type": "string", "description": "권리행사종료일자 / 길이 8" }, "ltg_dt": { "type": "string", "description": "상장일자 / 길이 8" }, "rit_erc_pr": { "type": "integer", "format": "int64", "description": "권리행사가격 / 길이 18" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "parameters": [ { "$ref": "#/components/parameters/CtsHeader" } ] } }, "/krstock/quote/v1/currentPrice": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteCurrentPrice", "summary": "주식현재가 시세", "description": "국내주식 현재가 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: `Output_2` 는 명세상 **Array** 로 선언되어 있으나 예시 응답은 **Object** 입니다. 실제 응답 타입을 확인 후 사용하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "market_cd": { "type": "string", "description": "시장구분코드 / 길이 3 / KRX/NXT/UNT" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 6 / 예시> NH투자증권인 경우, 005940" } }, "required": [ "market_cd", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 41" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "현재가 / 길이 10" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int32", "description": "등락폭 / 길이 10" }, "prdy_ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "askp": { "type": "integer", "format": "int32", "description": "매도호가 / 길이 10" }, "bidp": { "type": "integer", "format": "int32", "description": "매수호가 / 길이 10" }, "acml_vol": { "type": "integer", "format": "int64", "description": "거래량 / 길이 12" }, "vol_rate": { "type": "number", "format": "float", "description": "거래비율 / 길이 6.2" }, "move_rate": { "type": "number", "format": "float", "description": "유동주회전율 / 길이 6.2" }, "acml_tr_pbmn": { "type": "integer", "format": "int64", "description": "거래대금 / 길이 18" }, "stck_mxpr": { "type": "integer", "format": "int32", "description": "상한가 / 길이 10" }, "stck_hgpr": { "type": "integer", "format": "int32", "description": "고가 / 길이 10" }, "stck_oprc": { "type": "integer", "format": "int32", "description": "시가 / 길이 10" }, "stck_oprc_sign": { "type": "string", "description": "시가대비부호 / 길이 1" }, "stck_oprc_vrss": { "type": "integer", "format": "int32", "description": "시가대비등락폭 / 길이 10" }, "stck_lwpr": { "type": "integer", "format": "int32", "description": "저가 / 길이 10" }, "stck_llam": { "type": "integer", "format": "int32", "description": "하한가 / 길이 10" }, "hoga_bsop_hour": { "type": "string", "description": "호가시간 / 길이 8" }, "askp1": { "type": "integer", "format": "int32", "description": "매도호가1 / 길이 10" }, "askp2": { "type": "integer", "format": "int32", "description": "매도호가2 / 길이 10" }, "askp3": { "type": "integer", "format": "int32", "description": "매도호가3 / 길이 10" }, "askp4": { "type": "integer", "format": "int32", "description": "매도호가4 / 길이 10" }, "askp5": { "type": "integer", "format": "int32", "description": "매도호가5 / 길이 10" }, "askp6": { "type": "integer", "format": "int32", "description": "매도호가6 / 길이 10" }, "askp7": { "type": "integer", "format": "int32", "description": "매도호가7 / 길이 10" }, "askp8": { "type": "integer", "format": "int32", "description": "매도호가8 / 길이 10" }, "askp9": { "type": "integer", "format": "int32", "description": "매도호가9 / 길이 10" }, "askp10": { "type": "integer", "format": "int32", "description": "매도호가10 / 길이 10" }, "bidp1": { "type": "integer", "format": "int32", "description": "매수호가1 / 길이 10" }, "bidp2": { "type": "integer", "format": "int32", "description": "매수호가2 / 길이 10" }, "bidp3": { "type": "integer", "format": "int32", "description": "매수호가3 / 길이 10" }, "bidp4": { "type": "integer", "format": "int32", "description": "매수호가4 / 길이 10" }, "bidp5": { "type": "integer", "format": "int32", "description": "매수호가5 / 길이 10" }, "bidp6": { "type": "integer", "format": "int32", "description": "매수호가6 / 길이 10" }, "bidp7": { "type": "integer", "format": "int32", "description": "매수호가7 / 길이 10" }, "bidp8": { "type": "integer", "format": "int32", "description": "매수호가8 / 길이 10" }, "bidp9": { "type": "integer", "format": "int32", "description": "매수호가9 / 길이 10" }, "bidp10": { "type": "integer", "format": "int32", "description": "매수호가10 / 길이 10" }, "askp_rsqn1": { "type": "integer", "format": "int64", "description": "매도호가잔량1 / 길이 12" }, "askp_rsqn2": { "type": "integer", "format": "int64", "description": "매도호가잔량2 / 길이 12" }, "askp_rsqn3": { "type": "integer", "format": "int64", "description": "매도호가잔량3 / 길이 12" }, "askp_rsqn4": { "type": "integer", "format": "int64", "description": "매도호가잔량4 / 길이 12" }, "askp_rsqn5": { "type": "integer", "format": "int64", "description": "매도호가잔량5 / 길이 12" }, "askp_rsqn6": { "type": "integer", "format": "int64", "description": "매도호가잔량6 / 길이 12" }, "askp_rsqn7": { "type": "integer", "format": "int64", "description": "매도호가잔량7 / 길이 12" }, "askp_rsqn8": { "type": "integer", "format": "int64", "description": "매도호가잔량8 / 길이 12" }, "askp_rsqn9": { "type": "integer", "format": "int64", "description": "매도호가잔량9 / 길이 12" }, "askp_rsqn10": { "type": "integer", "format": "int64", "description": "매도호가잔량10 / 길이 12" }, "bidp_rsqn1": { "type": "integer", "format": "int64", "description": "매수호가잔량1 / 길이 12" }, "bidp_rsqn2": { "type": "integer", "format": "int64", "description": "매수호가잔량2 / 길이 12" }, "bidp_rsqn3": { "type": "integer", "format": "int64", "description": "매수호가잔량3 / 길이 12" }, "bidp_rsqn4": { "type": "integer", "format": "int64", "description": "매수호가잔량4 / 길이 12" }, "bidp_rsqn5": { "type": "integer", "format": "int64", "description": "매수호가잔량5 / 길이 12" }, "bidp_rsqn6": { "type": "integer", "format": "int64", "description": "매수호가잔량6 / 길이 12" }, "bidp_rsqn7": { "type": "integer", "format": "int64", "description": "매수호가잔량7 / 길이 12" }, "bidp_rsqn8": { "type": "integer", "format": "int64", "description": "매수호가잔량8 / 길이 12" }, "bidp_rsqn9": { "type": "integer", "format": "int64", "description": "매수호가잔량9 / 길이 12" }, "bidp_rsqn10": { "type": "integer", "format": "int64", "description": "매수호가잔량10 / 길이 12" }, "total_askp_rsqn": { "type": "integer", "format": "int64", "description": "총매도잔량 / 길이 12" }, "total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "총매수잔량 / 길이 12" }, "ovtm_askp_rsqn": { "type": "integer", "format": "int64", "description": "시간외매도잔량 / 길이 12" }, "ovtm_bidp_rsqn": { "type": "integer", "format": "int64", "description": "시간외매수잔량 / 길이 12" }, "pvt_scnd_dmrs": { "type": "integer", "format": "int32", "description": "피봇2차저항 / 길이 10" }, "pvt_frst_dmrs": { "type": "integer", "format": "int32", "description": "피봇1차저항 / 길이 10" }, "pvt_pont_val": { "type": "integer", "format": "int32", "description": "피봇가 / 길이 10" }, "pvt_frst_dmsp": { "type": "integer", "format": "int32", "description": "피봇1차지지 / 길이 10" }, "pvt_scnd_dmsp": { "type": "integer", "format": "int32", "description": "피봇2차지지 / 길이 10" }, "mrkt_div_isnm": { "type": "string", "description": "코스피코스닥구분 / 길이 6" }, "bstp_kor_isnm": { "type": "string", "description": "업종명 / 길이 40" }, "bstp_cls_code": { "type": "string", "description": "업종코드 / 길이 6" }, "avls_scal_isnm": { "type": "string", "description": "자본금규모 / 길이 6" }, "stac_month": { "type": "string", "description": "결산월 / 길이 16" }, "market1": { "type": "string", "description": "시장조치1 / 길이 16" }, "market2": { "type": "string", "description": "시장조치2 / 길이 16" }, "market3": { "type": "string", "description": "시장조치3 / 길이 16" }, "market4": { "type": "string", "description": "시장조치4 / 길이 16" }, "market5": { "type": "string", "description": "시장조치5 / 길이 16" }, "market6": { "type": "string", "description": "시장조치6 / 길이 16" }, "cb_text": { "type": "string", "description": "CB구분 / 길이 6" }, "stck_fcam": { "type": "integer", "format": "int32", "description": "액면가 / 길이 10" }, "prdy_clpr_title": { "type": "string", "description": "전일종가타이틀 / 길이 12" }, "stck_prdy_clpr": { "type": "integer", "format": "int32", "description": "전일종가 / 길이 10" }, "stck_sspr": { "type": "integer", "format": "int32", "description": "대용가 / 길이 10" }, "gongprice": { "type": "integer", "format": "int64", "description": "공모가 / 길이 7" }, "d5_hgpr": { "type": "integer", "format": "int32", "description": "5일고가 / 길이 10" }, "d5_lwpr": { "type": "integer", "format": "int32", "description": "5일저가 / 길이 10" }, "d20_hgpr": { "type": "integer", "format": "int32", "description": "20일고가 / 길이 10" }, "d20_lwpr": { "type": "integer", "format": "int32", "description": "20일저가 / 길이 10" }, "w52_hgpr": { "type": "integer", "format": "int32", "description": "52주최고가 / 길이 10" }, "w52_hgpr_date": { "type": "string", "description": "52주최고가일 / 길이 4" }, "w52_lwpr": { "type": "integer", "format": "int32", "description": "52주최저가 / 길이 10" }, "w52_lwpr_date": { "type": "string", "description": "52주최저가일 / 길이 4" }, "move_stcn": { "type": "integer", "format": "int64", "description": "유동주식수 / 길이 12" }, "lstn_stcn_unit3": { "type": "integer", "format": "int64", "description": "상장주식수 / 길이 12" }, "hts_avls": { "type": "integer", "format": "int64", "description": "시가총액 / 길이 12" }, "memb_bsop_hour": { "type": "string", "description": "시간 / 길이 5" }, "seln_mbcr_name1": { "type": "string", "description": "매도거래원1 / 길이 6" }, "shnu_mbcr_name1": { "type": "string", "description": "매수거래원1 / 길이 6" }, "seln_qty1": { "type": "integer", "format": "int64", "description": "매도거래량1 / 길이 12" }, "shnu_qty1": { "type": "integer", "format": "int64", "description": "매수거래량1 / 길이 12" }, "seln_mbcr_name2": { "type": "string", "description": "매도거래원2 / 길이 6" }, "shnu_mbcr_name2": { "type": "string", "description": "매수거래원2 / 길이 6" }, "seln_qty2": { "type": "integer", "format": "int64", "description": "매도거래량2 / 길이 12" }, "shnu_qty2": { "type": "integer", "format": "int64", "description": "매수거래량2 / 길이 12" }, "seln_mbcr_name3": { "type": "string", "description": "매도거래원3 / 길이 6" }, "shnu_mbcr_name3": { "type": "string", "description": "매수거래원3 / 길이 6" }, "seln_qty3": { "type": "integer", "format": "int64", "description": "매도거래량3 / 길이 12" }, "shnu_qty3": { "type": "integer", "format": "int64", "description": "매수거래량3 / 길이 12" }, "seln_mbcr_name4": { "type": "string", "description": "매도거래원4 / 길이 6" }, "shnu_mbcr_name4": { "type": "string", "description": "매수거래원4 / 길이 6" }, "seln_qty4": { "type": "integer", "format": "int64", "description": "매도거래량4 / 길이 12" }, "shnu_qty4": { "type": "integer", "format": "int64", "description": "매수거래량4 / 길이 12" }, "seln_mbcr_name5": { "type": "string", "description": "매도거래원5 / 길이 6" }, "shnu_mbcr_name5": { "type": "string", "description": "매수거래원5 / 길이 6" }, "seln_qty5": { "type": "integer", "format": "int64", "description": "매도거래량5 / 길이 12" }, "shnu_qty5": { "type": "integer", "format": "int64", "description": "매수거래량5 / 길이 12" }, "glob_seln_qty": { "type": "integer", "format": "int64", "description": "매도외국인거래량 / 길이 12" }, "glob_shnu_qty": { "type": "integer", "format": "int64", "description": "매수외국인거래량 / 길이 12" }, "for_hour": { "type": "string", "description": "외국인시간 / 길이 6" }, "for_rate": { "type": "number", "format": "float", "description": "외국인지분율 / 길이 5.2" }, "crdt_stlm_date": { "type": "string", "description": "결제일 / 길이 4" }, "crdt_rmnd_rate": { "type": "number", "format": "float", "description": "잔고비율(%) / 길이 5.2" }, "yu_date": { "type": "string", "description": "유상기준일 / 길이 4" }, "mu_date": { "type": "string", "description": "무상기준일 / 길이 4" }, "yu_rate": { "type": "number", "format": "float", "description": "유상배정비율 / 길이 5.2" }, "mu_rate": { "type": "number", "format": "float", "description": "무상배정비율 / 길이 5.2" }, "frgn_ntby_vol": { "type": "number", "format": "double", "description": "외국인변동주수 / 길이 10.0" }, "jasa": { "type": "string", "description": "자사주 / 길이 1" }, "stck_lstn_date": { "type": "string", "description": "상장일 / 길이 8" }, "dae_rate": { "type": "number", "format": "float", "description": "대주주지분율 / 길이 5.2" }, "dae_date": { "type": "string", "description": "대주주지분일자 / 길이 6" }, "filler": { "type": "string", "description": "FILLER / 길이 1" }, "deposit_gb": { "type": "string", "description": "증거금율 / 길이 1" }, "cpfn": { "type": "integer", "format": "int64", "description": "자본금 / 길이 12" }, "total_seln_qty": { "type": "integer", "format": "int64", "description": "전체거래원매도합 / 길이 12" }, "total_shnu_qty": { "type": "integer", "format": "int64", "description": "전체거래원매수합 / 길이 12" }, "detour_gb": { "type": "string", "description": "우회상장여부 / 길이 1" }, "scrt_grp_isnm": { "type": "string", "description": "증권구분 / 길이 6" }, "crdt_deal_date": { "type": "string", "description": "공여율기준일 / 길이 4" }, "crdt_loan_gvrt": { "type": "number", "format": "float", "description": "공여율(%) / 길이 5.2" }, "per": { "type": "number", "format": "float", "description": "PER / 길이 5.2" }, "hando_gb": { "type": "string", "description": "종목별신용한도 / 길이 1" }, "wghn_avrg_prc": { "type": "integer", "format": "int32", "description": "가중가 / 길이 10" }, "lstn_stcn_unit0": { "type": "integer", "format": "int64", "description": "상장주식수_주 / 길이 12" }, "add_lstn_stcn": { "type": "integer", "format": "int64", "description": "추가상장주수 / 길이 12" }, "gicomment": { "type": "string", "description": "종목comment / 길이 100" }, "prdy_vol": { "type": "integer", "format": "int64", "description": "전일거래량 / 길이 12" }, "pre_prdy_sign": { "type": "string", "description": "전일대비등락부호 / 길이 1" }, "pre_prdy_vrss": { "type": "integer", "format": "int32", "description": "전일대비등락폭 / 길이 10" }, "stck_dryy_hgpr": { "type": "integer", "format": "int32", "description": "연종최고가 / 길이 10" }, "dryy_hgpr_date": { "type": "string", "description": "연중최고가일 / 길이 4" }, "stck_dryy_lwpr": { "type": "integer", "format": "int32", "description": "연중최저가 / 길이 10" }, "dryy_lwpr_date": { "type": "string", "description": "연중최저가일 / 길이 4" }, "frgn_hldn_qty": { "type": "number", "format": "double", "description": "외국인보유주식수 / 길이 15" }, "issu_limt_rate": { "type": "number", "format": "float", "description": "외국인한도율(%) / 길이 5.2" }, "frml_mrkt_unit": { "type": "number", "format": "double", "description": "매매수량단위 / 길이 5" }, "comp_cls_code": { "type": "string", "description": "경쟁대량방향구분 / 길이 1" }, "largem_gb": { "type": "string", "description": "대량매매구분 / 길이 1" }, "pbr": { "type": "number", "format": "float", "description": "PBR / 길이 5.2" }, "dmrs_val": { "type": "integer", "format": "int64", "description": "디저항값 / 길이 7" }, "dmsp_val": { "type": "integer", "format": "int64", "description": "디지지값 / 길이 7" }, "prdy_tr_pbmn": { "type": "integer", "format": "int64", "description": "전일거래대금 / 길이 12" }, "vi_antc_sdpr": { "type": "integer", "format": "int32", "description": "VI기준가 / 길이 10" }, "vi_antc_mxpr": { "type": "integer", "format": "int32", "description": "VI상승발동가 / 길이 10" }, "vi_antc_llam": { "type": "integer", "format": "int32", "description": "VI하락발동가 / 길이 10" }, "invt_epmd_yn": { "type": "string", "description": "투자유의종목여부 / 길이 1" }, "uplm_qty": { "type": "integer", "format": "int64", "description": "상한수량 / 길이 12" }, "short_over_code": { "type": "string", "description": "단기과열구분코드 / 길이 1 / 1.단기과열예고 2.단기과열지정 3.단기과열연장" }, "mrkt_alrm_code": { "type": "string", "description": "투자주의경고구분코드 / 길이 1 / 1.투자주의 2.투자경고 3.투자주의>투자위험예고 4.투자경고투자위험예고 5.투자위험" }, "sltr_yn": { "type": "string", "description": "정리매매여부 / 길이 1 / Y.정리매매종목" }, "crd_rt_grd_nm": { "type": "string", "description": "담보유지비율(%) / 길이 6" }, "mid_prc": { "type": "integer", "format": "int32", "description": "중간가 / 길이 10" }, "midp_total_askp_rsqn": { "type": "integer", "format": "int64", "description": "매도중간가잔량합계수량 / 길이 12" }, "midp_total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "매수중간가잔량합계수량 / 길이 12" }, "nxt_mid_prc": { "type": "integer", "format": "int32", "description": "nxt중간가 / 길이 10" }, "nxt_midp_total_askp_rsqn": { "type": "integer", "format": "int64", "description": "nxt매도중간가잔량합계수량 / 길이 12" }, "nxt_midp_total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "nxt매수중간가잔량합계수량 / 길이 12" }, "marg_grad_cls_code": { "type": "string", "description": "증거금등급구분코드 / 길이 1" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "bsop_hour": { "type": "string", "description": "시간 / 길이 8" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "현재가 / 길이 10" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int32", "description": "등락폭 / 길이 10" }, "askp": { "type": "integer", "format": "int32", "description": "매도호가 / 길이 10" }, "bidp": { "type": "integer", "format": "int32", "description": "매수호가 / 길이 10" }, "cntg_vol": { "type": "string", "description": "변동거래량 / 길이 12" }, "acml_vol": { "type": "integer", "format": "int64", "description": "거래량 / 길이 12" } } } }, "Output_2": { "type": "array", "items": { "type": "object", "properties": { "cncc_aspr_code": { "type": "string", "description": "동시호가구분 / 길이 1 / 1.동시호가\n이외 정규시장" }, "antc_cnpr": { "type": "string", "description": "예상체결가 / 길이 10" }, "antc_cntg_sign": { "type": "string", "description": "예상체결부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "antc_cntg_vrss": { "type": "string", "description": "예상체결등락폭 / 길이 10" }, "antc_prdy_ctrt": { "type": "string", "description": "예상체결등락률 / 길이 5.2" }, "antc_vol": { "type": "string", "description": "예상체결수량 / 길이 12" }, "chkdata": { "type": "string", "description": "ECN정보유무구분 / 길이 1" }, "ovtm_untp_prpr": { "type": "string", "description": "ECN전일종가 / 길이 10" }, "ovtm_untp_sign": { "type": "string", "description": "ECN부호 / 길이 1" }, "ovtm_untp_vrss": { "type": "string", "description": "ECN등락폭 / 길이 10" }, "ovtm_untp_ctrt": { "type": "string", "description": "ECN등락률 / 길이 5.2" }, "ovtm_untp_vol": { "type": "string", "description": "ECN체결수량 / 길이 12" }, "ovtm_antc_sign": { "type": "string", "description": "ECN대비예상체결부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보함+리버스(기세)" }, "ovtm_antc_vrss": { "type": "string", "description": "ECN대비예상체결등락폭 / 길이 10" }, "ovtm_antc_ctrt": { "type": "string", "description": "ECN대비예상체결등락률 / 길이 5.2" }, "scoring": { "type": "string", "description": "종합스코어링 / 길이 6.2" }, "vi_type_code": { "type": "string", "description": "VI거래중지여부 / 길이 1 / 1.VI발동\nN.그외" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "block": "Output_2", "declared": "Array", "sample": "Object" } ] } }, "/krstock/quote/v1/currentExecution": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteCurrentExecution", "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" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 6 / 예시> NH투자증권인 경우, 005940" }, "array_cnt": { "type": "string", "description": "읽을갯수 / 길이 4" } }, "required": [ "market_cd", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "bsop_hour": { "type": "string", "description": "시간 / 길이 8" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "현재가 / 길이 8" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int32", "description": "등락폭 / 길이 8" }, "prdy_ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "cntg_vol": { "type": "integer", "format": "int64", "description": "변동거래량 / 길이 12" }, "shnu_cntg_smtn": { "type": "integer", "format": "int64", "description": "누적매수체결량 / 길이 12" }, "bidrate": { "type": "number", "format": "float", "description": "당일매수비중 / 길이 5.2" }, "seln_cntg_smtn": { "type": "integer", "format": "int64", "description": "누적매도체결량 / 길이 12" }, "askrate": { "type": "number", "format": "float", "description": "당일매도비중 / 길이 5.2" }, "stnr_cntg_smtn": { "type": "integer", "format": "int64", "description": "누적보합체결량 / 길이 12" }, "uncrate": { "type": "number", "format": "float", "description": "당일보합비중 / 길이 5.2" }, "cttr": { "type": "number", "format": "float", "description": "체결강도 / 길이 6.2" }, "askp": { "type": "integer", "format": "int32", "description": "매도호가 / 길이 8" }, "bidp": { "type": "integer", "format": "int32", "description": "매수호가 / 길이 8" }, "acml_vol": { "type": "integer", "format": "int64", "description": "전체거래량 / 길이 12" }, "filler": { "type": "string", "description": "filler / 길이 30" } } } }, "Output_1": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" }, "iem_nm": { "type": "string", "description": "KOR_종목명 / 길이 40" }, "toffervol": { "type": "string", "description": "누적매도가체결량 / 길이 12" }, "tbidvol": { "type": "string", "description": "누적매수가체결량 / 길이 12" }, "tbovol": { "type": "string", "description": "누적보합가체결량 / 길이 12" }, "toffersu": { "type": "string", "description": "누적매도가체결건수 / 길이 10" }, "tbidsu": { "type": "string", "description": "누적매수가체결건수 / 길이 10" }, "tbosu": { "type": "string", "description": "누적보합가체결건수 / 길이 10" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "현재가 / 길이 8" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int32", "description": "등락폭 / 길이 8" }, "acml_vol": { "type": "integer", "format": "int64", "description": "전체거래량 / 길이 12" }, "stck_oprc": { "type": "string", "description": "시가 / 길이 8" }, "stck_hgpr": { "type": "string", "description": "고가 / 길이 8" }, "stck_lwpr": { "type": "string", "description": "저가 / 길이 8" }, "askp": { "type": "integer", "format": "int32", "description": "매도호가 / 길이 8" }, "bidp": { "type": "integer", "format": "int32", "description": "매수호가 / 길이 8" }, "cttr": { "type": "number", "format": "float", "description": "체결강도 / 길이 6.2" }, "new_volume": { "type": "string", "description": "신규거래량 / 길이 12" }, "stck_prdy_clpr": { "type": "string", "description": "전일종가 / 길이 8 / 기준가 혹은 전일종가\n기준가 우선 셋팅" }, "filler": { "type": "string", "description": "filler / 길이 30" }, "ctsz20": { "type": "string", "description": "CTSz20 / 길이 20" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/quote/v1/currentDaily": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteCurrentDaily", "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" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 6 / 예시> NH투자증권인 경우, 005940" }, "array_cnt": { "type": "string", "description": "읽을갯수 / 길이 3" } }, "required": [ "market_cd", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "일자 / 길이 8 / YY/MM/DD" }, "stck_oprc": { "type": "string", "description": "시가 / 길이 9" }, "stck_hgpr": { "type": "string", "description": "고가 / 길이 9" }, "stck_lwpr": { "type": "string", "description": "저가 / 길이 9" }, "stck_clpr": { "type": "string", "description": "종가 / 길이 9" }, "prdy_vrss_sign": { "type": "string", "description": "FILLER / 길이 1" }, "prdy_vrss": { "type": "string", "description": "등락폭 / 길이 9" }, "prdy_ctrt": { "type": "string", "description": "등락률 / 길이 5.2" }, "acml_vol": { "type": "string", "description": "거래량 / 길이 12" }, "acml_tr_pbmn": { "type": "string", "description": "거래대금 / 길이 18" }, "high_date": { "type": "string", "description": "고가일 / 길이 8" }, "low_date": { "type": "string", "description": "저가일 / 길이 8" }, "vol_prdy_rt": { "type": "string", "description": "거래량전일비 / 길이 6.2" }, "cttr": { "type": "string", "description": "체결강도 / 길이 6.2" }, "filler": { "type": "string", "description": "FILLER / 길이 43" }, "next_key": { "type": "string", "description": "NEXT_KEY / 길이 12" }, "nextbutton": { "type": "string", "description": "NEXTBUTTON / 길이 1" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/quote/v1/currentInvestor": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteCurrentInvestor", "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" }, "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" }, "array_cnt": { "type": "string", "description": "요청건수 / 길이 3" } }, "required": [ "market_cd", "iem_cd", "array_cnt" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "bsop_date1": { "type": "string", "description": "거래일자 / 길이 8 / YYYYMMDD" }, "bsop_date2": { "type": "string", "description": "거래일자 / 길이 8 / YYMMDD00" }, "stck_prpr": { "type": "integer", "format": "int64", "description": "종가 / 길이 7" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int64", "description": "등락폭 / 길이 6" }, "prdy_ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "acml_vol": { "type": "number", "format": "double", "description": "거래량 / 길이 10" }, "for_rate": { "type": "number", "format": "float", "description": "외국인지분율 / 길이 5.2" }, "frgn_ntby_qty": { "type": "number", "format": "double", "description": "외국인순매수량 / 길이 10" }, "person": { "type": "number", "format": "double", "description": "개인투자자순매수량 / 길이 10" }, "gigwan": { "type": "number", "format": "double", "description": "기관계투자자순매수량 / 길이 10" }, "invest": { "type": "number", "format": "double", "description": "외국인투자자순매수량 / 길이 10" }, "account": { "type": "number", "format": "double", "description": "거래원순매수량 / 길이 10" }, "program": { "type": "number", "format": "double", "description": "프로그램 / 길이 10" }, "jasaz10": { "type": "string", "description": "자사주 / 길이 10" }, "filler": { "type": "string", "description": "FILLER / 길이 30" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/quote/v1/period": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuotePeriod", "summary": "국내주식기간별시세(일/주/월/년)", "description": "국내주식 주기별 시세 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: `Output_0` 는 명세상 **Array** 로 선언되어 있으나 예시 응답은 **Object** 입니다. 실제 응답 타입을 확인 후 사용하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "market_cd": { "type": "string", "description": "시장구분코드 / 길이 3 / KRX/NXT/UNT" }, "iem_cd": { "type": "string", "description": "단축종목코드 / 길이 9" }, "mrkt_div_cls_code": { "type": "string", "description": "시장분류구분코드 / 길이 1 / 1.거래소 4.코스닥 A.ETN E.ELW T.K-OTC" }, "edate": { "type": "string", "description": "종료일 / 길이 8" }, "array_cnt": { "type": "string", "description": "읽을건수 / 길이 4" }, "maxavg": { "type": "string", "description": "최대이평 / 길이 3" }, "gubun": { "type": "string", "description": "주기구분 / 길이 1 / 1.일 2.주 3.월 4.년 5.분 6.초 7.틱" }, "xtick": { "type": "string", "description": "분구분 / 길이 3 / 분/초/틱시 입력" }, "today_cls_code": { "type": "string", "description": "당일조회구분 / 길이 1 / 1.당일만조회(분/초/틱에서 사용) 0.전체조회" }, "fake_tick": { "type": "string", "description": "거래량0봉제외여부 / 길이 1 / 0.허봉+실봉 1.실봉" }, "sur_flag": { "type": "string", "description": "복기구분플래그 / 길이 1 / 0.복기사용안함 1.복기처리사용함" }, "sur_gb_day_cnt": { "type": "string", "description": "복기시작n일전 / 길이 2 / sur_flag값이1일때만기능함 00.D당일데이터복기 01.D-1일전 02.D-2일전" }, "sur_bf_end_time": { "type": "string", "description": "복기시작전종료시각 / 길이 6 / HHmmSS sur_flag값이1일때 n일전기준으로복기시작전까지 표현할시각" }, "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": [ "market_cd", "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "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" }, "stck_prpr": { "type": "string", "description": "현재가 / 길이 10" }, "prdy_vrss_sign": { "type": "string", "description": "전일대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "prdy_vrss": { "type": "string", "description": "전일대비 / 길이 10" }, "prdy_ctrt": { "type": "string", "description": "전일대비율 / 길이 5 / float 5.2" }, "acml_vol": { "type": "string", "description": "누적거래량 / 길이 12" }, "acml_tr_pbmn": { "type": "string", "description": "누적거래대금 / 길이 18" }, "prdy_vol": { "type": "string", "description": "전일거래량 / 길이 12" }, "prdy_vol_rate": { "type": "string", "description": "거래량전일비 / 길이 15 / float 15.2" }, "vol_rate": { "type": "string", "description": "거래량회전율 / 길이 10 / float 10.5" }, "cttr": { "type": "string", "description": "체결강도 / 길이 6 / float 6.2" }, "prdy_cttr": { "type": "string", "description": "전일체결강도 / 길이 6 / float 6.2" }, "askp": { "type": "string", "description": "매도호가 / 길이 10" }, "bidp": { "type": "string", "description": "매수호가 / 길이 10" }, "askp_rsqn1": { "type": "string", "description": "매도1호가잔량 / 길이 12" }, "bidp_rsqn1": { "type": "string", "description": "매수1호가잔량 / 길이 12" }, "stck_mxpr": { "type": "string", "description": "상한가 / 길이 10" }, "stck_llam": { "type": "string", "description": "하한가 / 길이 10" }, "stck_oprc": { "type": "string", "description": "시가 / 길이 10" }, "stck_hgpr": { "type": "string", "description": "고가 / 길이 10" }, "stck_lwpr": { "type": "string", "description": "저가 / 길이 10" }, "lstn_stcn": { "type": "string", "description": "상장주수 / 길이 12" }, "hts_avls": { "type": "string", "description": "시가총액 / 길이 10 / 억단위" }, "dae_rate": { "type": "string", "description": "대주주지분율 / 길이 5 / float 5.2" }, "per": { "type": "string", "description": "PER / 길이 5 / float 5.2" }, "pbr": { "type": "string", "description": "PBR / 길이 5 / float 5.2" }, "eps": { "type": "string", "description": "EPS / 길이 9" }, "bps": { "type": "string", "description": "BPS / 길이 10" }, "prdy_oprc": { "type": "string", "description": "전일시가 / 길이 10" }, "prdy_high": { "type": "string", "description": "전일고가 / 길이 10" }, "prdy_low": { "type": "string", "description": "전일저가 / 길이 10" }, "prdy_clpr": { "type": "string", "description": "전일종가 / 길이 10" }, "tdw_oprc": { "type": "string", "description": "이번주시가 / 길이 10" }, "tdw_high": { "type": "string", "description": "이번주고가 / 길이 10" }, "tdw_low": { "type": "string", "description": "이번주저가 / 길이 10" }, "tdm_oprc": { "type": "string", "description": "이번달시가 / 길이 10" }, "tdm_high": { "type": "string", "description": "이번달고가 / 길이 10" }, "tdm_low": { "type": "string", "description": "이번달저가 / 길이 10" }, "vi_sttc_mxpr": { "type": "string", "description": "VI정적발동상승 / 길이 10" }, "vi_sttc_llam": { "type": "string", "description": "VI정적발동하락 / 길이 10" }, "start_time": { "type": "string", "description": "장시작시간 / 길이 6 / HHmmSS" }, "end_time": { "type": "string", "description": "장마감시간 / 길이 6 / HHmmSS" }, "bsop_date": { "type": "string", "description": "영업일 / 길이 8" }, "stck_sdpr": { "type": "string", "description": "주식기준가 / 길이 10" }, "stck_fcam": { "type": "string", "description": "주식액면가 / 길이 10" }, "bstp_kor_isnm": { "type": "string", "description": "업종한글명 / 길이 40" }, "bstp_cls_code": { "type": "string", "description": "업종코드 / 길이 6" }, "exchange_prpr": { "type": "string", "description": "달러환율 / 길이 8" }, "ctsz30": { "type": "string", "description": "연속조회키 / 길이 30" }, "lasttickcount": { "type": "string", "description": "마지막N틱봉의틱묶음갯수 / 길이 5 / 최근봉마지막틱갯수" }, "send_cnt": { "type": "string", "description": "전송레코드건수 / 길이 5" }, "pre_tr_sta_hour": { "type": "string", "description": "프리마켓시작시간 / 길이 6 / NXT/UNT프리마켓시작시간" }, "pre_tr_fin_hour": { "type": "string", "description": "프리마켓종료시간 / 길이 6 / NXT/UNT프리마켓종료시간" }, "main_tr_sta_hour": { "type": "string", "description": "메인마겟시작시간 / 길이 6 / NXT/UNT메인마켓시작시간" }, "main_tr_fin_hour": { "type": "string", "description": "메인마겟종료시간 / 길이 6 / NXT/UNT메인마켓종료시간" }, "aft_tr_sta_hour": { "type": "string", "description": "에프터마겟시작시간 / 길이 6 / NXT/UNT에프터마켓시작시간" }, "aft_tr_fin_hour": { "type": "string", "description": "에프터마겟종료시간 / 길이 6 / NXT/UNT에프터마켓종료시간" }, "cncc_aspr_sta_hour": { "type": "string", "description": "정규장마감전동시호가 / 길이 6 / KRX/UNT종료전동시호가시작시간" } } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "영업일 / 길이 8" }, "bsop_time": { "type": "string", "description": "시간 / 길이 6 / HHmmSS" }, "stck_sdpr": { "type": "string", "description": "주식기준가 / 길이 10" }, "stck_oprc": { "type": "string", "description": "시가 / 길이 10" }, "stck_hgpr": { "type": "string", "description": "고가 / 길이 10" }, "stck_lwpr": { "type": "string", "description": "저가 / 길이 10" }, "stck_prpr": { "type": "string", "description": "현재가 / 길이 10" }, "vol": { "type": "string", "description": "거래량 / 길이 15" }, "tr_pbmn": { "type": "string", "description": "거래대금 / 길이 18" }, "flng_cls_code": { "type": "string", "description": "락구분코드 / 길이 2 / 01.권리락\n02.배당락\n03.분배락\n04.권배락\n05.중간배당락\n06.권리중간배당락\n07.권리분기배당락\n99.기타" }, "prtt_rate": { "type": "string", "description": "락비율 / 길이 8 / float 8.2" }, "news_cnt": { "type": "string", "description": "뉴스건수 / 길이 3 / 일간일때만처리" }, "updownmark": { "type": "string", "description": "상하한가표시 / 길이 1 / 0.기본\n1.상한\n4.하한" }, "fcam_mod_cls_code": { "type": "string", "description": "액면가변경구분코드 / 길이 2 / 00.해당없음\n01.액면분할\n02.액면병합\n03.주식분할\n04.주식병합\n99.기타" }, "vol_prtt_rate": { "type": "string", "description": "거래량수정비율 / 길이 2" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "block": "Output_0", "declared": "Array", "sample": "Object" } ] } }, "/krstock/quote/v1/afterHoursCurrent": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteAfterHoursCurrent", "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": "종목코드 / 길이 6" } }, "required": [ "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 41" }, "mrkt_cls_code": { "type": "string", "description": "시장구분 / 길이 1" }, "trht_yn": { "type": "string", "description": "거래구분 / 길이 1" }, "mkop_cls_code": { "type": "string", "description": "장구분 / 길이 1" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "정규장종가 / 길이 10" }, "ovtm_untp_sdpr": { "type": "integer", "format": "int32", "description": "기준가 / 길이 10" }, "ovtm_untp_mxpr": { "type": "integer", "format": "int32", "description": "상한가 / 길이 10" }, "ovtm_untp_llam": { "type": "integer", "format": "int32", "description": "하한가 / 길이 10" }, "ovtm_cntg_hour": { "type": "string", "description": "체결시간 / 길이 8" }, "ovtm_untp_prpr": { "type": "integer", "format": "int32", "description": "체결가 / 길이 10" }, "prdy_vrss_sign": { "type": "string", "description": "체결등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "ovtm_prdy_vrss": { "type": "integer", "format": "int32", "description": "체결등락폭 / 길이 10" }, "ovtm_prdy_ctrt": { "type": "number", "format": "float", "description": "체결등락률 / 길이 5.2" }, "ovtm_untp_oprc": { "type": "integer", "format": "int32", "description": "시가 / 길이 10" }, "ovtm_untp_hgpr": { "type": "integer", "format": "int32", "description": "고가 / 길이 10" }, "ovtm_untp_lwpr": { "type": "integer", "format": "int32", "description": "저가 / 길이 10" }, "ovtm_untp_vol": { "type": "integer", "format": "int64", "description": "거래량 / 길이 12" }, "ovtm_tr_pbmn": { "type": "integer", "format": "int64", "description": "거래대금 / 길이 12" }, "ovtm_untp_askp": { "type": "integer", "format": "int32", "description": "매도호가 / 길이 10" }, "ovtm_untp_bidp": { "type": "integer", "format": "int32", "description": "매수호가 / 길이 10" }, "ovtm_bsop_hour": { "type": "string", "description": "호가시간 / 길이 8" }, "ovtm_untp_askp1": { "type": "integer", "format": "int32", "description": "매도1차선호가 / 길이 10" }, "ovtm_untp_askp2": { "type": "integer", "format": "int32", "description": "매도2차선호가 / 길이 10" }, "ovtm_untp_askp3": { "type": "integer", "format": "int32", "description": "매도3차선호가 / 길이 10" }, "ovtm_untp_askp4": { "type": "integer", "format": "int32", "description": "매도4차선호가 / 길이 10" }, "ovtm_untp_askp5": { "type": "integer", "format": "int32", "description": "매도5차선호가 / 길이 10" }, "ovtm_untp_askp6": { "type": "integer", "format": "int32", "description": "매도6차선호가 / 길이 10" }, "ovtm_untp_askp7": { "type": "integer", "format": "int32", "description": "매도7차선호가 / 길이 10" }, "ovtm_untp_askp8": { "type": "integer", "format": "int32", "description": "매도8차선호가 / 길이 10" }, "ovtm_untp_askp9": { "type": "integer", "format": "int32", "description": "매도9차선호가 / 길이 10" }, "ovtm_untp_askp10": { "type": "integer", "format": "int32", "description": "매도10차선호가 / 길이 10" }, "ovtm_untp_bidp1": { "type": "integer", "format": "int32", "description": "매수1차선호가 / 길이 10" }, "ovtm_untp_bidp2": { "type": "integer", "format": "int32", "description": "매수2차선호가 / 길이 10" }, "ovtm_untp_bidp3": { "type": "integer", "format": "int32", "description": "매수3차선호가 / 길이 10" }, "ovtm_untp_bidp4": { "type": "integer", "format": "int32", "description": "매수4차선호가 / 길이 10" }, "ovtm_untp_bidp5": { "type": "integer", "format": "int32", "description": "매수5차선호가 / 길이 10" }, "ovtm_untp_bidp6": { "type": "integer", "format": "int32", "description": "매수6차선호가 / 길이 10" }, "ovtm_untp_bidp7": { "type": "integer", "format": "int32", "description": "매수7차선호가 / 길이 10" }, "ovtm_untp_bidp8": { "type": "integer", "format": "int32", "description": "매수8차선호가 / 길이 10" }, "ovtm_untp_bidp9": { "type": "integer", "format": "int32", "description": "매수9차선호가 / 길이 10" }, "ovtm_untp_bidp10": { "type": "integer", "format": "int32", "description": "매수10차선호가 / 길이 10" }, "ovtm_askp_rsqn1": { "type": "integer", "format": "int64", "description": "매도1차선잔량 / 길이 12" }, "ovtm_askp_rsqn2": { "type": "integer", "format": "int64", "description": "매도2차선잔량 / 길이 12" }, "ovtm_askp_rsqn3": { "type": "integer", "format": "int64", "description": "매도3차선잔량 / 길이 12" }, "ovtm_askp_rsqn4": { "type": "integer", "format": "int64", "description": "매도4차선잔량 / 길이 12" }, "ovtm_askp_rsqn5": { "type": "integer", "format": "int64", "description": "매도5차선잔량 / 길이 12" }, "ovtm_askp_rsqn6": { "type": "integer", "format": "int64", "description": "매도6차선잔량 / 길이 12" }, "ovtm_askp_rsqn7": { "type": "integer", "format": "int64", "description": "매도7차선잔량 / 길이 12" }, "ovtm_askp_rsqn8": { "type": "integer", "format": "int64", "description": "매도8차선잔량 / 길이 12" }, "ovtm_askp_rsqn9": { "type": "integer", "format": "int64", "description": "매도9차선잔량 / 길이 12" }, "ovtm_askp_rsqn10": { "type": "integer", "format": "int64", "description": "매도10차선잔량 / 길이 12" }, "ovtm_bidp_rsqn1": { "type": "integer", "format": "int64", "description": "매수1차선잔량 / 길이 12" }, "ovtm_bidp_rsqn2": { "type": "integer", "format": "int64", "description": "매수2차선잔량 / 길이 12" }, "ovtm_bidp_rsqn3": { "type": "integer", "format": "int64", "description": "매수3차선잔량 / 길이 12" }, "ovtm_bidp_rsqn4": { "type": "integer", "format": "int64", "description": "매수4차선잔량 / 길이 12" }, "ovtm_bidp_rsqn5": { "type": "integer", "format": "int64", "description": "매수5차선잔량 / 길이 12" }, "ovtm_bidp_rsqn6": { "type": "integer", "format": "int64", "description": "매수6차선잔량 / 길이 12" }, "ovtm_bidp_rsqn7": { "type": "integer", "format": "int64", "description": "매수7차선잔량 / 길이 12" }, "ovtm_bidp_rsqn8": { "type": "integer", "format": "int64", "description": "매수8차선잔량 / 길이 12" }, "ovtm_bidp_rsqn9": { "type": "integer", "format": "int64", "description": "매수9차선잔량 / 길이 12" }, "ovtm_bidp_rsqn10": { "type": "integer", "format": "int64", "description": "매수10차선잔량 / 길이 12" }, "total_askp_rsqn": { "type": "integer", "format": "int64", "description": "매도잔량합 / 길이 12" }, "total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "매수잔량합 / 길이 12" }, "ecn_dongsi": { "type": "string", "description": "동시구분 / 길이 1 / 1.동시호가 이외 정규시장" }, "ovtm_antc_cnpr": { "type": "integer", "format": "int32", "description": "예상체결가 / 길이 10" }, "antc_vrss_sign": { "type": "string", "description": "예상체결부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "antc_cntg_vrss": { "type": "integer", "format": "int32", "description": "예상체결등락폭 / 길이 10" }, "antc_cntg_ctrt": { "type": "number", "format": "float", "description": "예상체결등락률 / 길이 5.2" }, "antc_vol": { "type": "integer", "format": "int64", "description": "예상체결수량 / 길이 12" }, "antc_tr_pbmn": { "type": "integer", "format": "int64", "description": "예상대금 / 길이 12" }, "item_info": { "type": "string", "description": "종목정보 / 길이 28" }, "ivs_hed_yn": { "type": "string", "description": "투자유의종목여부 / 길이 1 / Y.투자유의종목" }, "short_ovh_gb": { "type": "string", "description": "단기과열구분코드 / 길이 1 / 1.단기과열예고 2.단기과열지정 3.단기과열연장" }, "alert_gb": { "type": "string", "description": "투자주의경고구분코드 / 길이 1 / 1.투자주의 2.투자경고 3.투자주의>투자위험예고 4.투자경고투자위험예고 5.투자위험" }, "jungri_yn": { "type": "string", "description": "정리매매여부 / 길이 1 / Y.정리매매종목" } } }, "Output_1": { "type": "object", "properties": { "bsop_date": { "type": "string", "description": "일자 / 길이 8" }, "acml_vol": { "type": "string", "description": "거래량 / 길이 12" }, "vol_rate": { "type": "string", "description": "거래량전일비 / 길이 6.2" }, "acml_tr_pbmn": { "type": "string", "description": "거래대금 / 길이 12" }, "stck_oprc": { "type": "string", "description": "시가 / 길이 10" }, "stck_hgpr": { "type": "string", "description": "고가 / 길이 10" }, "stck_lwpr": { "type": "string", "description": "저가 / 길이 10" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "정규장종가 / 길이 10" }, "stck_mxpr": { "type": "string", "description": "상한가 / 길이 10" }, "stck_llam": { "type": "string", "description": "하한가 / 길이 10" }, "stck_fcam": { "type": "string", "description": "액면가 / 길이 10" }, "askp": { "type": "string", "description": "매도호가 / 길이 10" }, "bidp": { "type": "string", "description": "매수호가 / 길이 10" }, "askp_rsqn": { "type": "string", "description": "매도잔량 / 길이 12" }, "bidp_rsqn": { "type": "string", "description": "매수잔량 / 길이 12" }, "total_askp_rsqn": { "type": "integer", "format": "int64", "description": "매도잔량합 / 길이 12" }, "total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "매수잔량합 / 길이 12" }, "ovtm_askp_rsqn": { "type": "string", "description": "시간외매도잔량 / 길이 12" }, "ovtm_bidp_rsqn": { "type": "string", "description": "시간외매수잔량 / 길이 12" }, "frgn_hour": { "type": "string", "description": "외국인시간 / 길이 6" }, "for_rate": { "type": "string", "description": "외국인지분율 / 길이 5.2" }, "prdy_vrss_sign": { "type": "string", "description": "체결등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "string", "description": "등락폭 / 길이 10" }, "prdy_ctrt": { "type": "string", "description": "등락률 / 길이 5.2" }, "sosokz6": { "type": "string", "description": "코스피구분 / 길이 6" }, "bstp_kor_isnm": { "type": "string", "description": "업종명 / 길이 40" }, "bstp_cls_code": { "type": "string", "description": "업종코드 / 길이 6" }, "cap_size": { "type": "string", "description": "자본금규모 / 길이 6" }, "new_volume": { "type": "string", "description": "신규거래량 / 길이 12" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/quote/v1/currentAfterHoursDaily": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteCurrentAfterHoursDaily", "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": "종목코드 / 길이 6" }, "date": { "type": "string", "description": "일자 / 길이 8 / YYYYMMDD" }, "array_cnt": { "type": "string", "description": "읽을갯수 / 길이 4" }, "maxavg": { "type": "string", "description": "최대이평 / 길이 3" }, "gubun": { "type": "string", "description": "구분 / 길이 1 / 1.정규장 2.정규장+시간외단일가 이외.정규장+당일시간외단일가" } }, "required": [ "iem_cd", "date", "array_cnt", "maxavg", "gubun" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "qry_date": { "type": "string", "description": "일자 / 길이 8" }, "qry_time": { "type": "string", "description": "시가 / 길이 6" }, "shrn_iscd": { "type": "string", "description": "고가 / 길이 9" }, "hts_kor_isnm": { "type": "string", "description": "저가 / 길이 41" }, "stck_prpr": { "type": "string", "description": "락구분 / 길이 10" }, "prdy_vrss_sign": { "type": "string", "description": "Filler / 길이 1" } } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "prdy_ctrt": { "type": "string", "description": "현재가 / 길이 5" }, "acml_vol": { "type": "string", "description": "거래량 / 길이 12" }, "acml_tr_pbmn": { "type": "string", "description": "거래대금 / 길이 18" }, "prdy_vol": { "type": "string", "description": "Filler / 길이 12" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/quote/v1/currentAfterHoursExecution": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteCurrentAfterHoursExecution", "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": "종목코드 / 길이 6" } }, "required": [ "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" }, "bsop_hour": { "type": "string", "description": "시간 / 길이 8" }, "open": { "type": "integer", "format": "int64", "description": "시가 / 길이 9" }, "high": { "type": "integer", "format": "int64", "description": "고가 / 길이 9" }, "low": { "type": "integer", "format": "int64", "description": "저가 / 길이 9" }, "stck_prpr": { "type": "integer", "format": "int64", "description": "현재가 / 길이 9" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int64", "description": "등락폭 / 길이 9" }, "prdy_ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "acml_vol": { "type": "number", "format": "double", "description": "거래량 / 길이 10" }, "cntg_vol": { "type": "number", "format": "double", "description": "변동거래량 / 길이 10" }, "cntg_tr_pbmn": { "type": "number", "format": "double", "description": "거래대금 / 길이 14" }, "askp1": { "type": "integer", "format": "int64", "description": "매도호가 / 길이 9" }, "bidp1": { "type": "integer", "format": "int64", "description": "매수호가 / 길이 9" }, "filler": { "type": "string", "description": "Filler / 길이 30" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/quote/v1/afterHoursExpected": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteAfterHoursExpected", "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": "종목코드 / 길이 6" } }, "required": [ "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "array", "items": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" }, "bsop_hour": { "type": "string", "description": "시간 / 길이 8" }, "stck_prpr": { "type": "integer", "format": "int64", "description": "현재가 / 길이 9" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보함+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int64", "description": "등락폭 / 길이 9" }, "prdy_ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "cntg_vol": { "type": "number", "format": "double", "description": "거래량 / 길이 10" }, "askp1": { "type": "integer", "format": "int64", "description": "매도호가 / 길이 9" }, "bidp1": { "type": "integer", "format": "int64", "description": "매수호가 / 길이 9" }, "askp_rsqn1": { "type": "number", "format": "double", "description": "매도잔량 / 길이 10" }, "bidp_rsqn1": { "type": "number", "format": "double", "description": "매수잔량 / 길이 10" }, "filler": { "type": "string", "description": "Filler / 길이 30" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } }, "/krstock/quote/v1/etfCurrent": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteEtfCurrent", "summary": "ETF/ETN 현재가", "description": "국내주식 ETF 현재가 조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.\n\n⚠️ **명세 검증 필요**: 예시 응답에는 명세에 없는 블록(Output_3, Output_4)이 포함되어 있습니다.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" } }, "required": [ "iem_cd" ] } } } } } }, "responses": { "200": { "description": "성공", "content": { "application/json": { "schema": { "type": "object", "properties": { "Output_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "종목코드 / 길이 6" }, "iem_nm": { "type": "string", "description": "종목명 / 길이 41" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "현재가 / 길이 10" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int32", "description": "등락폭 / 길이 10" }, "prdy_ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 5.2" }, "askp": { "type": "integer", "format": "int32", "description": "매도호가 / 길이 10" }, "bidp": { "type": "integer", "format": "int32", "description": "매수호가 / 길이 10" }, "acml_vol": { "type": "integer", "format": "int64", "description": "거래량 / 길이 12" }, "acml_rate": { "type": "number", "format": "float", "description": "거래비율 / 길이 6.2" }, "yu_rate": { "type": "number", "format": "float", "description": "유동주회전율 / 길이 5.2" }, "acml_tr_pbmn": { "type": "integer", "format": "int64", "description": "거래대금 / 길이 12" }, "stck_mxpr": { "type": "integer", "format": "int32", "description": "상한가 / 길이 10" }, "stck_hgpr": { "type": "integer", "format": "int32", "description": "고가 / 길이 10" }, "stck_oprc": { "type": "integer", "format": "int32", "description": "시가 / 길이 10" }, "oprc_sign": { "type": "string", "description": "시가대비부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "oprc_vrss": { "type": "integer", "format": "int32", "description": "시가대비등락폭 / 길이 10" }, "stck_lwpr": { "type": "integer", "format": "int32", "description": "저가 / 길이 10" }, "stck_llam": { "type": "integer", "format": "int32", "description": "하한가 / 길이 10" }, "bsop_hour": { "type": "string", "description": "호가시간 / 길이 8" }, "askp1": { "type": "integer", "format": "int32", "description": "매도1호가 / 길이 10" }, "askp2": { "type": "integer", "format": "int32", "description": "매도2호가 / 길이 10" }, "askp3": { "type": "integer", "format": "int32", "description": "매도3호가 / 길이 10" }, "askp4": { "type": "integer", "format": "int32", "description": "매도4호가 / 길이 10" }, "askp5": { "type": "integer", "format": "int32", "description": "매도5호가 / 길이 10" }, "askp6": { "type": "integer", "format": "int32", "description": "매도6호가 / 길이 10" }, "askp7": { "type": "integer", "format": "int32", "description": "매도7호가 / 길이 10" }, "askp8": { "type": "integer", "format": "int32", "description": "매도8호가 / 길이 10" }, "askp9": { "type": "integer", "format": "int32", "description": "매도9호가 / 길이 10" }, "askp10": { "type": "integer", "format": "int32", "description": "매도10호가 / 길이 10" }, "bidp1": { "type": "integer", "format": "int32", "description": "매수1호가 / 길이 10" }, "bidp2": { "type": "integer", "format": "int32", "description": "매수2호가 / 길이 10" }, "bidp3": { "type": "integer", "format": "int32", "description": "매수3호가 / 길이 10" }, "bidp4": { "type": "integer", "format": "int32", "description": "매수4호가 / 길이 10" }, "bidp5": { "type": "integer", "format": "int32", "description": "매수5호가 / 길이 10" }, "bidp6": { "type": "integer", "format": "int32", "description": "매수6호가 / 길이 10" }, "bidp7": { "type": "integer", "format": "int32", "description": "매수7호가 / 길이 10" }, "bidp8": { "type": "integer", "format": "int32", "description": "매수8호가 / 길이 10" }, "bidp9": { "type": "integer", "format": "int32", "description": "매수9호가 / 길이 10" }, "bidp10": { "type": "integer", "format": "int32", "description": "매수10호가 / 길이 10" }, "askp_rsqn1": { "type": "integer", "format": "int64", "description": "매도1호가잔량 / 길이 12" }, "askp_rsqn2": { "type": "integer", "format": "int64", "description": "매도2호가잔량 / 길이 12" }, "askp_rsqn3": { "type": "integer", "format": "int64", "description": "매도3호가잔량 / 길이 12" }, "askp_rsqn4": { "type": "integer", "format": "int64", "description": "매도4호가잔량 / 길이 12" }, "askp_rsqn5": { "type": "integer", "format": "int64", "description": "매도5호가잔량 / 길이 12" }, "askp_rsqn6": { "type": "integer", "format": "int64", "description": "매도6호가잔량 / 길이 12" }, "askp_rsqn7": { "type": "integer", "format": "int64", "description": "매도7호가잔량 / 길이 12" }, "askp_rsqn8": { "type": "integer", "format": "int64", "description": "매도8호가잔량 / 길이 12" }, "askp_rsqn9": { "type": "integer", "format": "int64", "description": "매도9호가잔량 / 길이 12" }, "askp_rsqn10": { "type": "integer", "format": "int64", "description": "매도10호가잔량 / 길이 12" }, "bidp_rsqn1": { "type": "integer", "format": "int64", "description": "매수1호가잔량 / 길이 12" }, "bidp_rsqn2": { "type": "integer", "format": "int64", "description": "매수2호가잔량 / 길이 12" }, "bidp_rsqn3": { "type": "integer", "format": "int64", "description": "매수3호가잔량 / 길이 12" }, "bidp_rsqn4": { "type": "integer", "format": "int64", "description": "매수4호가잔량 / 길이 12" }, "bidp_rsqn5": { "type": "integer", "format": "int64", "description": "매수5호가잔량 / 길이 12" }, "bidp_rsqn6": { "type": "integer", "format": "int64", "description": "매수6호가잔량 / 길이 12" }, "bidp_rsqn7": { "type": "integer", "format": "int64", "description": "매수7호가잔량 / 길이 12" }, "bidp_rsqn8": { "type": "integer", "format": "int64", "description": "매수8호가잔량 / 길이 12" }, "bidp_rsqn9": { "type": "integer", "format": "int64", "description": "매수9호가잔량 / 길이 12" }, "bidp_rsqn10": { "type": "integer", "format": "int64", "description": "매수10호가잔량 / 길이 12" }, "total_askp_rsqn": { "type": "integer", "format": "int64", "description": "총매도호가잔량 / 길이 12" }, "total_bidp_rsqn": { "type": "integer", "format": "int64", "description": "총매수호가잔량 / 길이 12" }, "ovtm_askp_rsqn": { "type": "integer", "format": "int64", "description": "시간외매도잔량 / 길이 12" }, "ovtm_bidp_rsqn": { "type": "integer", "format": "int64", "description": "시간외매수잔량 / 길이 12" }, "pvt_scnd_dmrs": { "type": "integer", "format": "int32", "description": "피벗2차저항 / 길이 10" }, "pvt_frst_dmrs": { "type": "integer", "format": "int32", "description": "피벗1차저항 / 길이 10" }, "pvt_pont_val": { "type": "integer", "format": "int32", "description": "피벗가 / 길이 10" }, "pvt_frst_dmsp": { "type": "integer", "format": "int32", "description": "피벗1차지지 / 길이 10" }, "pvt_scnd_dmsp": { "type": "integer", "format": "int32", "description": "피벗2차지지 / 길이 10" }, "mrkt_div_code": { "type": "string", "description": "코스닥코스피구분 / 길이 6" }, "bstp_cls_code": { "type": "string", "description": "지수코드 / 길이 6" }, "bstp_kor_isnm": { "type": "string", "description": "업종명 / 길이 40" }, "cap_size": { "type": "string", "description": "자본금규모 / 길이 6" }, "stac_month": { "type": "string", "description": "결산월 / 길이 16" }, "market1": { "type": "string", "description": "시장조치1 / 길이 16" }, "market2": { "type": "string", "description": "시장조치2 / 길이 16" }, "market3": { "type": "string", "description": "시장조치3 / 길이 16" }, "market4": { "type": "string", "description": "시장조치4 / 길이 16" }, "market5": { "type": "string", "description": "시장조치5 / 길이 16" }, "market6": { "type": "string", "description": "시장조치6 / 길이 16" }, "cb_text": { "type": "string", "description": "CB구분 / 길이 6" }, "stck_fcam": { "type": "integer", "format": "int32", "description": "액면가 / 길이 10" }, "prdy_clpr_title": { "type": "string", "description": "전일종가타이틀 / 길이 12" }, "prdy_clpr": { "type": "integer", "format": "int32", "description": "전일종가 / 길이 10" }, "stck_sspr": { "type": "integer", "format": "int32", "description": "대용가 / 길이 10" }, "gongprice": { "type": "integer", "format": "int32", "description": "공모가 / 길이 10" }, "d5_hgpr": { "type": "integer", "format": "int32", "description": "5일고가 / 길이 10" }, "d5_lwpr": { "type": "integer", "format": "int32", "description": "5일저가 / 길이 10" }, "d20_hgpr": { "type": "integer", "format": "int32", "description": "20일고가 / 길이 10" }, "d20_lwpr": { "type": "integer", "format": "int32", "description": "20일저가 / 길이 10" }, "w52_hgpr": { "type": "integer", "format": "int32", "description": "52주최고가 / 길이 10" }, "w52_lwpr": { "type": "integer", "format": "int32", "description": "52주최저가 / 길이 10" }, "move_stcn": { "type": "integer", "format": "int64", "description": "유동주식수 / 길이 12" }, "lstn_stcn1": { "type": "integer", "format": "int64", "description": "상장주식수_천주 / 길이 12" }, "hts_avls": { "type": "integer", "format": "int64", "description": "시가총액 / 길이 12" }, "cntg_hour": { "type": "string", "description": "시간 / 길이 5" }, "seln_mbcr_no1": { "type": "string", "description": "매도거래원1 / 길이 6" }, "shnu_mbcr_no1": { "type": "string", "description": "매수거래원1 / 길이 6" }, "seln_acml_vol1": { "type": "integer", "format": "int64", "description": "매도거래량1 / 길이 12" }, "shnu_acml_vol1": { "type": "integer", "format": "int64", "description": "매수거래량1 / 길이 12" }, "seln_mbcr_no2": { "type": "string", "description": "매도거래원2 / 길이 6" }, "shnu_mbcr_no2": { "type": "string", "description": "매수거래원2 / 길이 6" }, "seln_acml_vol2": { "type": "integer", "format": "int64", "description": "매도거래량2 / 길이 12" }, "shnu_acml_vol2": { "type": "integer", "format": "int64", "description": "매수거래량2 / 길이 12" }, "seln_mbcr_no3": { "type": "string", "description": "매도거래원3 / 길이 6" }, "shnu_mbcr_no3": { "type": "string", "description": "매수거래원3 / 길이 6" }, "seln_acml_vol3": { "type": "integer", "format": "int64", "description": "매도거래량3 / 길이 12" }, "shnu_acml_vol3": { "type": "integer", "format": "int64", "description": "매수거래량3 / 길이 12" }, "seln_mbcr_no4": { "type": "string", "description": "매도거래원4 / 길이 6" }, "shnu_mbcr_no4": { "type": "string", "description": "매수거래원4 / 길이 6" }, "seln_acml_vol4": { "type": "integer", "format": "int64", "description": "매도거래량4 / 길이 12" }, "shnu_acml_vol4": { "type": "integer", "format": "int64", "description": "매수거래량4 / 길이 12" }, "seln_mbcr_no5": { "type": "string", "description": "매도거래원5 / 길이 6" }, "shnu_mbcr_no5": { "type": "string", "description": "매수거래원5 / 길이 6" }, "seln_acml_vol5": { "type": "integer", "format": "int64", "description": "매도거래량5 / 길이 12" }, "shnu_acml_vol5": { "type": "integer", "format": "int64", "description": "매수거래량5 / 길이 12" }, "seln_frgn_vol": { "type": "integer", "format": "int64", "description": "매도외국인거래량 / 길이 12" }, "shnu_frgn_vol": { "type": "integer", "format": "int64", "description": "매수외국인거래량 / 길이 12" }, "frgn_hour": { "type": "string", "description": "외국인시간 / 길이 6" }, "for_rate": { "type": "number", "format": "float", "description": "외국인지분율 / 길이 5.2" }, "settdate": { "type": "string", "description": "결제일 / 길이 4" }, "crate": { "type": "number", "format": "float", "description": "잔고비율(%) / 길이 5.2" }, "yudate": { "type": "string", "description": "유상기준일 / 길이 4" }, "mudate": { "type": "string", "description": "무상기준일 / 길이 4" }, "yurate": { "type": "number", "format": "float", "description": "유상배정비율 / 길이 5.2" }, "murate": { "type": "number", "format": "float", "description": "무상배정비율 / 길이 5.2" }, "lstn_date": { "type": "string", "description": "상장일 / 길이 8" }, "lstn_stcn": { "type": "integer", "format": "int64", "description": "상장주식수_주 / 길이 12" }, "total_seln_qty": { "type": "integer", "format": "int64", "description": "전체거래원매도합 / 길이 12" }, "total_shnu_qty": { "type": "integer", "format": "int64", "description": "전체거래원매수합 / 길이 12" }, "new_volume": { "type": "integer", "format": "int64", "description": "신규거래량 / 길이 12" } } }, "Output_1": { "type": "array", "items": { "type": "object", "properties": { "bsop_hour": { "type": "string", "description": "호가시간 / 길이 8" }, "stck_prpr": { "type": "integer", "format": "int32", "description": "현재가 / 길이 10" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int32", "description": "등락폭 / 길이 10" }, "askp": { "type": "integer", "format": "int32", "description": "매도호가 / 길이 10" }, "bidp": { "type": "integer", "format": "int32", "description": "매수호가 / 길이 10" }, "cntg_vol": { "type": "string", "description": "변동거래량 / 길이 12" }, "acml_vol": { "type": "integer", "format": "int64", "description": "거래량 / 길이 12" } } } }, "Output_2": { "type": "object", "properties": { "aspr_cls_code": { "type": "string", "description": "동시호가구분 / 길이 1 / 1.동시호가\n이외 정규시장" }, "antc_cnpr": { "type": "string", "description": "예상체결가 / 길이 10" }, "antc_sign": { "type": "string", "description": "예상체결부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보합+리버스(기세)" }, "antc_vrss": { "type": "string", "description": "예상체결등락폭 / 길이 10" }, "antc_ctrt": { "type": "string", "description": "예상체결등락률 / 길이 5.2" }, "antc_vol": { "type": "string", "description": "예상체결수량 / 길이 12" } } }, "Output_3": { "type": "object", "properties": { "bu12": { "type": "string", "description": "ETF구분 / 길이 1" }, "itmt_last_nav": { "type": "string", "description": "장중/최종NAV / 길이 10.2" }, "nav_sign": { "type": "string", "description": "NAV등락부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보합+리버스(기세)" }, "nav_vrss": { "type": "string", "description": "NAV등락폭 / 길이 10.2" }, "prdy_last_nav": { "type": "string", "description": "전일NAV / 길이 10.2" }, "dprt": { "type": "string", "description": "괴리율 / 길이 10.2" }, "dprt_sign": { "type": "string", "description": "괴리율부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보합+리버스(기세)" }, "cnfg_cnt": { "type": "string", "description": "구성종목수 / 길이 10" }, "totvalue": { "type": "string", "description": "순자산총액(억원) / 길이 12" }, "trc_errt": { "type": "string", "description": "추적오차율 / 길이 10.2" }, "lp_askp_rsqn1": { "type": "string", "description": "LP매도호가잔량1 / 길이 12" }, "lp_askp_rsqn2": { "type": "string", "description": "LP매도호가잔량2 / 길이 12" }, "lp_askp_rsqn3": { "type": "string", "description": "LP매도호가잔량3 / 길이 12" }, "lp_askp_rsqn4": { "type": "string", "description": "LP매도호가잔량4 / 길이 12" }, "lp_askp_rsqn5": { "type": "string", "description": "LP매도호가잔량5 / 길이 12" }, "lp_askp_rsqn6": { "type": "string", "description": "LP매도호가잔량6 / 길이 12" }, "lp_askp_rsqn7": { "type": "string", "description": "LP매도호가잔량7 / 길이 12" }, "lp_askp_rsqn8": { "type": "string", "description": "LP매도호가잔량8 / 길이 12" }, "lp_askp_rsqn9": { "type": "string", "description": "LP매도호가잔량9 / 길이 12" }, "lp_askp_rsqn10": { "type": "string", "description": "LP매도호가잔량10 / 길이 12" }, "lp_bidp_rsqn1": { "type": "string", "description": "LP매수호가잔량1 / 길이 12" }, "lp_bidp_rsqn2": { "type": "string", "description": "LP매수호가잔량2 / 길이 12" }, "lp_bidp_rsqn3": { "type": "string", "description": "LP매수호가잔량3 / 길이 12" }, "lp_bidp_rsqn4": { "type": "string", "description": "LP매수호가잔량4 / 길이 12" }, "lp_bidp_rsqn5": { "type": "string", "description": "LP매수호가잔량5 / 길이 12" }, "lp_bidp_rsqn6": { "type": "string", "description": "LP매수호가잔량6 / 길이 12" }, "lp_bidp_rsqn7": { "type": "string", "description": "LP매수호가잔량7 / 길이 12" }, "lp_bidp_rsqn8": { "type": "string", "description": "LP매수호가잔량8 / 길이 12" }, "lp_bidp_rsqn9": { "type": "string", "description": "LP매수호가잔량9 / 길이 12" }, "lp_bidp_rsqn10": { "type": "string", "description": "LP매수호가잔량10 / 길이 12" }, "clon_cls_code": { "type": "string", "description": "ETF복제방법구분코드 / 길이 12" }, "txtn_type_code": { "type": "string", "description": "ETF과세유형코드 / 길이 18" } } }, "Output_4": { "type": "object", "properties": { "bstp_cls_code": { "type": "string", "description": "지수코드 / 길이 6" }, "bstp_kor_isnm": { "type": "string", "description": "업종명 / 길이 40" }, "prpr_nmix": { "type": "string", "description": "지수 / 길이 10.2" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int32", "description": "등락폭 / 길이 10" }, "ubjiid": { "type": "string", "description": "채권지수코드 / 길이 6" }, "ubjiid2": { "type": "string", "description": "채권지수세부코드 / 길이 1" }, "ubjisu": { "type": "string", "description": "채권지수 / 길이 10.4" }, "ubsign": { "type": "string", "description": "채권등락부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보합+리버스(기세)" }, "ubchange": { "type": "string", "description": "채권등락폭 / 길이 10.4" }, "symbol": { "type": "string", "description": "해외지수심볼 / 길이 12" }, "ovrs_nmix": { "type": "string", "description": "해외지수 / 길이 10.2" }, "ovrs_sign": { "type": "string", "description": "해외지수등락부호 / 길이 1 / 1or6.상한가\n2or7.상승\n3or0.보합\n4or8.하한\n5or9.하락\n그외.보합+리버스(기세)" }, "ovrs_vrss": { "type": "string", "description": "해외지수등락폭 / 길이 10.2" }, "jisukpgubun": { "type": "string", "description": "지수거래소구분 / 길이 1 / 1.코스피\n2.코스닥" } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } }, "x-schema-warning": [ { "missing_blocks": [ "Output_3", "Output_4" ] } ] } }, "/krstock/quote/v1/etfComponents": { "post": { "tags": [ "시세 (Market Data)" ], "operationId": "krstockQuoteEtfComponents", "summary": "ETF 구성종목시세", "description": "국내주식 ETF 구성종목 시세조회 API 입니다.\n\n응답 블록은 **데이터가 있을 때만 내려옵니다.** 블록이 없을 수 있으니 존재 여부를 먼저 확인하세요.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "Input_0": { "type": "object", "properties": { "iem_cd": { "type": "string", "description": "ETF종목코드 / 길이 6" } }, "required": [ "iem_cd" ] } } } } } }, "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": "종목명 / 길이 40" }, "stck_prpr": { "type": "integer", "format": "int64", "description": "현재가 / 길이 7" }, "prdy_vrss_sign": { "type": "string", "description": "등락부호 / 길이 1 / 1or6.상한가 2or7.상승 3or0.보합 4or8.하한 5or9.하락 그외.보합+리버스(기세)" }, "prdy_vrss": { "type": "integer", "format": "int64", "description": "등락폭 / 길이 6" }, "prdy_ctrt": { "type": "number", "format": "float", "description": "등락률 / 길이 6.2" }, "cu_unit": { "type": "number", "format": "double", "description": "1CU단위증권수(주) / 길이 18.2" }, "totprice": { "type": "integer", "format": "int64", "description": "평가금액2 / 길이 12" }, "vol": { "type": "number", "format": "float", "description": "비중 / 길이 6.2" }, "vltn_amt": { "type": "number", "format": "double", "description": "평가금액 / 길이 18.0" }, "filler": { "type": "string", "description": "Filler / 길이 30" } } } }, "message": { "$ref": "#/components/schemas/Message" } } } } } } } } } }, "x-realtime-channels": { "endpoint": "wss://api.n2plug.com:7070", "endpoints": { "live": "wss://api.n2plug.com:7070", "mock": "wss://moapi.n2plug.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": "국내주식 실시간호가KRX", "sheet": "API_국내_주식_실시간_호가(KRX)", "tr_cd": "ob", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "hotime", "offer", "bid", "offerrem", "bidrem", "P_offer", "P_bid", "P_offerrem", "P_bidrem", "S_offer", "S_bid", "S_offerrem", "S_bidrem", "S4_offer", "S4_bid", "S4_offerrem", "S4_bidrem", "S5_offer", "S5_bid", "S5_offerrem", "S5_bidrem", "T_offerrem", "T_bidrem", "S6_offer", "S6_bid", "S6_offerrem", "S6_bidrem", "S7_offer", "S7_bid", "S7_offerrem", "S7_bidrem", "S8_offer", "S8_bid", "S8_offerrem", "S8_bidrem", "S9_offer", "S9_bid", "S9_offerrem", "S9_bidrem", "S10_offer", "S10_bid", "S10_offerrem", "S10_bidrem", "volume", "mid_prc", "mid_offerrem", "mid_bidrem", "kospigb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "ob", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "ob", "tr_key": "005940" }, "body": { "code": "005940", "hotime": "13:49:56", "offer": "31900", "bid": "31850", "offerrem": "298", "bidrem": "188", "P_offer": "31950", "P_bid": "31800", "P_offerrem": "273", "P_bidrem": "2263", "S_offer": "32000", "S_bid": "31750", "S_offerrem": "1679", "S_bidrem": "1910", "S4_offer": "32050", "S4_bid": "31700", "S4_offerrem": "1538", "S4_bidrem": "426", "S5_offer": "32100", "S5_bid": "31650", "S5_offerrem": "3657", "S5_bidrem": "979", "T_offerrem": "19915", "T_bidrem": "8490", "S6_offer": "32150", "S6_bid": "31600", "S6_offerrem": "601", "S6_bidrem": "646", "S7_offer": "32200", "S7_bid": "31550", "S7_offerrem": "4362", "S7_bidrem": "607", "S8_offer": "32250", "S8_bid": "31500", "S8_offerrem": "5112", "S8_bidrem": "774", "S9_offer": "32300", "S9_bid": "31450", "S9_offerrem": "1676", "S9_bidrem": "35", "S10_offer": "32350", "S10_bid": "31400", "S10_offerrem": "719", "S10_bidrem": "662", "volume": "0", "mid_prc": "31875", "mid_offerrem": "0", "mid_bidrem": "0", "kospigb": "1" } }, "description": "국내주식 실시간 호가(KRX기준) 서비스 입니다." }, { "name": "국내주식 실시간체결가KRX", "sheet": "API_국내_주식_실시간_체결가(KRX)", "tr_cd": "oc", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "time", "sign", "change", "price", "chrate", "high", "low", "offer", "bid", "volume", "volrate", "movolume", "value", "open", "avgprice", "janggubun", "bidrate", "volpower", "new_volume", "bidvolall", "offvolall", "kospigb", "value_won" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "oc", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "oc", "tr_key": "005940" }, "body": { "code": "005940", "time": "13:58:26", "sign": "2", "change": "2450", "price": "31700", "chrate": "8.38", "high": "32200", "low": "29600", "offer": "31750", "bid": "31700", "volume": "660224", "volrate": "85.65", "movolume": "1", "value": "20867", "open": "29800", "avgprice": "31607", "janggubun": "0", "bidrate": "52.09", "volpower": "109.75", "new_volume": "660224", "bidvolall": "343916", "offvolall": "313366", "kospigb": "1", "value_won": "20867545950" } }, "description": "국내주식 실시간 체결가(KRX기준) 서비스 입니다." }, { "name": "국내주식 실시간예상체결KRX", "sheet": "API_국내_주식_실시간_예상체결(KRX)", "tr_cd": "oa", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "hotime", "dongsi", "jeqprice", "jeqsign", "jeqchange", "jeqchrate", "jeqvol", "offer", "bid", "offerrem", "bidrem", "mid_prc", "mid_offerrem", "mid_bidrem", "kospigb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "oa", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "oa", "tr_key": "005940" }, "body": { "code": "005940", "hotime": "14:04:41", "dongsi": "0", "jeqprice": "0", "jeqsign": "0", "jeqchange": "0", "jeqchrate": "0.00", "jeqvol": "0", "offer": "31950", "bid": "31900", "offerrem": "26", "bidrem": "579", "mid_prc": "31925", "mid_offerrem": "0", "kospigb": "1" } }, "description": "국내주식 실시간 예상체결가(KRX기준) 서비스 입니다." }, { "name": "국내주식 실시간회원사KRX", "sheet": "API_국내_주식_실시간_회원사(KRX)", "tr_cd": "t1", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "time", "off_trano1", "off_tra1", "N_off_tra1", "N_otraflag1", "N_offvolume1", "N_offvolcha1", "bid_trano1", "bid_tra1", "N_bid_tra1", "N_btraflag1", "N_bidvolume1", "N_bidvolcha1", "off_trano2", "off_tra2", "N_off_tra2", "N_otraflag2", "N_offvolume2", "N_offvolcha2", "bid_trano2", "bid_tra2", "N_bid_tra2", "N_btraflag2", "N_bidvolume2", "N_bidvolcha2", "off_trano3", "off_tra3", "N_off_tra3", "N_otraflag3", "N_offvolume3", "N_offvolcha3", "bid_trano3", "bid_tra3", "N_bid_tra3", "N_btraflag3", "N_bidvolume3", "N_bidvolcha3", "off_trano4", "off_tra4", "N_off_tra4", "N_otraflag4", "N_offvolume4", "N_offvolcha4", "bid_trano4", "bid_tra4", "N_bid_tra4", "N_btraflag4", "N_bidvolume4", "N_bidvolcha4", "off_trano5", "off_tra5", "N_off_tra5", "N_otraflag5", "N_offvolume5", "N_offvolcha5", "bid_trano5", "bid_tra5", "N_bid_tra5", "N_btraflag5", "N_bidvolume5", "N_bidvolcha5", "N_offvolall", "N_offvolcha", "N_bidvolall", "N_bidvolcha", "N_soonmaesu", "N_soonmaecha", "N_alloffvol", "N_allbidvol", "hname", "kpgubun" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "t1", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "t1", "tr_key": "005940" }, "body": { "code": "005940", "time": "14:10", "off_trano1": "0012", "off_tra1": "NH투자", "N_off_tra1": "NH투자증권", "N_otraflag1": "0", "N_offvolume1": "173814", "N_offvolcha1": "141", "bid_trano1": "0033", "bid_tra1": "JP모간", "N_bid_tra1": "J P 모간증권", "N_btraflag1": "1", "N_bidvolume1": "147802", "N_bidvolcha1": "163", "off_trano2": "0002", "off_tra2": "신한투", "N_off_tra2": "신한투자증권", "N_otraflag2": "0", "N_offvolume2": "90881", "N_offvolcha2": "54", "bid_trano2": "0045", "bid_tra2": "골드만", "N_bid_tra2": "골드만삭스증권", "N_btraflag2": "1", "N_bidvolume2": "78200", "N_bidvolcha2": "108", "off_trano3": "0030", "off_tra3": "삼 성", "N_off_tra3": "삼 성 증 권", "N_otraflag3": "0", "N_offvolume3": "57191", "N_offvolcha3": "9", "bid_trano3": "0002", "bid_tra3": "신한투", "N_bid_tra3": "신한투자증권", "N_btraflag3": "0", "N_bidvolume3": "75806", "N_bidvolcha3": "0", "off_trano4": "0008", "off_tra4": "유진투", "N_off_tra4": "유진투자증권", "N_otraflag4": "0", "N_offvolume4": "49908", "N_offvolcha4": "904", "bid_trano4": "0043", "bid_tra4": "U B S", "N_bid_tra4": "U B S 증 권", "N_btraflag4": "1", "N_bidvolume4": "62136", "N_bidvolcha4": "307", "off_trano5": "0033", "off_tra5": "JP모간", "N_off_tra5": "J P 모간증권", "N_otraflag5": "1", "N_offvolume5": "45447", "N_offvolcha5": "0", "bid_trano5": "0003", "bid_tra5": "한국투", "N_bid_tra5": "한국투자증권", "N_btraflag5": "0", "N_bidvolume5": "44367", "N_bidvolcha5": "5", "N_offvolall": "45447", "N_offvolcha": "0", "N_bidvolall": "288138", "N_bidvolcha": "578", "N_soonmaesu": "242691", "N_soonmaecha": "578", "N_alloffvol": "417241", "N_allbidvol": "408311", "hname": "NH투자증권", "kpgubun": "1" } }, "description": "국내주식 실시간 회원사 거래(KRX기준) 서비스 입니다." }, { "name": "국내주식 실시간프로그램매매KRX", "sheet": "API_국내_주식_실시간_프로그램매매(KRX)", "tr_cd": "t8", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "timez8", "offval", "mov_offval", "bidval", "mov_bidval", "sbidval", "mov_sbidval", "offvol", "mov_offvol", "bidvol", "mov_bidvol", "sbidvol", "mov_sbidvol", "c_offval", "mov_c_offval", "b_offval", "mov_b_offval", "c_bidval", "mov_c_bidval", "b_bidval", "mov_b_bidval", "c_offvol", "mov_c_offvol", "b_offvol", "mov_b_offvol", "c_bidvol", "mov_c_bidvol", "b_bidvol", "mov_b_bidvol" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "t8", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "t8", "tr_key": "005940" }, "body": { "code": "005940", "timez8": "14:16:30", "offval": "6310", "mov_offval": "1", "bidval": "17311", "mov_bidval": "0", "sbidval": "11001", "mov_sbidval": "-1", "offvol": "199503", "mov_offvol": "34", "bidvol": "547568", "mov_bidvol": "0", "sbidvol": "348065", "mov_sbidvol": "-34", "c_offval": "252", "mov_c_offval": "0", "b_offval": "6059", "mov_b_offval": "1", "c_bidval": "528", "mov_c_bidval": "0", "b_bidval": "16783", "mov_b_bidval": "0", "c_offvol": "7930", "mov_c_offvol": "0", "b_offvol": "191573", "mov_b_offvol": "34", "c_bidvol": "16782", "mov_c_bidvol": "0", "b_bidvol": "530786", "mov_b_bidvol": "0" } }, "description": "국내주식 실시간 프로그램매매(KRX기준) 서비스 입니다." }, { "name": "국내주식 시간외 실시간호가KRX", "sheet": "API_국내_주식_실시간_시간외호가(KRX)", "tr_cd": "e5", "tr_key": { "name": "ecn_code", "kor": "종목코드", "length": "6" }, "fields": [ "ecn_code", "ecn_chetime", "ecn_offerho1", "ecn_bidho1", "ecn_offerrem1", "ecn_bidrem1", "ecn_offerho2", "ecn_bidho2", "ecn_offerrem2", "ecn_bidrem2", "ecn_offerho3", "ecn_bidho3", "ecn_offerrem3", "ecn_bidrem3", "ecn_offerho4", "ecn_bidho4", "ecn_offerrem4", "ecn_bidrem4", "ecn_offerho5", "ecn_bidho5", "ecn_offerrem5", "ecn_bidrem5", "ecn_offertot", "ecn_bidtot", "ecn_offerho6", "ecn_bidho6", "ecn_offerrem6", "ecn_bidrem6", "ecn_offerho7", "ecn_bidho7", "ecn_offerrem7", "ecn_bidrem7", "ecn_offerho8", "ecn_bidho8", "ecn_offerrem8", "ecn_bidrem8", "ecn_offerho9", "ecn_bidho9", "ecn_offerrem9", "ecn_bidrem10", "ecn_offerho10", "ecn_bidho10", "ecn_offerrem10", "ecn_ygubun", "ecn_yprice", "ecn_ysign", "ecn_ychange", "ecn_ychrate", "ecn_yvolume" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "e5", "tr_key": "005950" } }, "push_example": { "header": { "tr_cd": "e5", "tr_key": "005950" }, "body": { "ecn_code": "005950", "ecn_chetime": "17:21:27", "ecn_offerho1": "13510", "ecn_bidho1": "13500", "ecn_offerrem1": "112", "ecn_bidrem1": "222", "ecn_offerho2": "13550", "ecn_bidho2": "13460", "ecn_offerrem2": "1040", "ecn_bidrem2": "92", "ecn_offerho3": "13780", "ecn_bidho3": "13450", "ecn_offerrem3": "299", "ecn_bidrem3": "15", "ecn_offerho4": "0", "ecn_bidho4": "0", "ecn_offerrem4": "0", "ecn_bidrem4": "0", "ecn_offerho5": "0", "ecn_bidho5": "0", "ecn_offerrem5": "0", "ecn_bidrem5": "0", "ecn_offertot": "1451", "ecn_bidtot": "329", "ecn_offerho6": "0", "ecn_bidho6": "0", "ecn_offerrem6": "0", "ecn_bidrem6": "0", "ecn_offerho7": "0", "ecn_bidho7": "0", "ecn_offerrem7": "0", "ecn_bidrem7": "0", "ecn_offerho8": "0", "ecn_bidho8": "0", "ecn_offerrem8": "0", "ecn_bidrem8": "0", "ecn_offerho9": "0", "ecn_bidho9": "0", "ecn_offerrem9": "0", "ecn_bidrem9": "0", "ecn_offerho10": "0", "ecn_bidho10": "0", "ecn_offerrem10": "0", "ecn_bidrem10": "0", "ecn_ygubun": "1", "ecn_yprice": "13510", "ecn_ysign": "5", "ecn_ychange": "40", "ecn_ychrate": "0.30", "ecn_yvolume": "20" } }, "description": "국내주식 실시간 시간외 호가(KRX기준) 서비스 입니다." }, { "name": "국내주식 시간외 실시간체결가KRX", "sheet": "API_국내_주식_실시간_시간외체결가(KRX)", "tr_cd": "e2", "tr_key": { "name": "ecn_code", "kor": "종목코드", "length": "6" }, "fields": [ "ecn_code", "ecn_time", "ecn_price", "ecn_sign", "ecn_change", "ecn_chrate", "ecn_open", "ecn_high", "ecn_low", "ecn_offerho1", "ecn_bidho1", "ecn_volume", "ecn_movolume", "ecn_value", "ecn_janggubun", "ecn_stop", "ecn_quotes" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "e2", "tr_key": "005950" } }, "push_example": { "header": { "tr_cd": "e2", "tr_key": "005950" }, "body": { "ecn_code": "005950", "ecn_time": "17:30:30", "ecn_price": "13500", "ecn_sign": "5", "ecn_change": "50", "ecn_chrate": "0.37", "ecn_open": "13500", "ecn_high": "13550", "ecn_low": "13500", "ecn_offer": "13510", "ecn_bid": "13500", "ecn_volume": "1268", "ecn_movolume": "125", "ecn_value": "17158190", "ecn_janggubun": "0", "ecn_stop": "0", "ecn_quotes": "2" } }, "description": "국내주식 실시간 시간외 체결가(KRX기준) 서비스 입니다." }, { "name": "국내주식 시간외 실시간예상체결KRX", "sheet": "API_국내_주식_실시간_시간외예상체결(KRX)", "tr_cd": "e4", "tr_key": { "name": "ecn_code", "kor": "종목코드", "length": "6" }, "fields": [ "ecn_code", "ecn_ytime", "ecn_ygubun", "ecn_yprice", "ecn_ysign", "ecn_ychange", "ecn_ychrate", "ecn_yvolume", "ecn_yofferho", "ecn_ybidho", "ecn_yofferrem", "ecn_ybidrem" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "e4", "tr_key": "005950" } }, "push_example": { "header": { "tr_cd": "e4", "tr_key": "005950" }, "body": { "ecn_code": "005950", "ecn_ytime": "17:23:38", "ecn_ygubun": "1", "ecn_yprice": "13500", "ecn_ysign": "5", "ecn_ychange": "50", "ecn_ychrate": "0.37", "ecn_yvolume": "125", "ecn_yofferho": "13510", "ecn_ybidho": "13500", "ecn_yofferrem": "7", "ecn_ybidrem": "215" } }, "description": "국내주식 실시간 시간외 예상체결가(KRX기준) 서비스 입니다." }, { "name": "국내주식 실시간호가통합", "sheet": "API_국내_주식_실시간_호가(통합)", "tr_cd": "mb", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "hotime", "offer", "bid", "offerrem", "bidrem", "P_offer", "P_bid", "P_offerrem", "P_bidrem", "S_offer", "S_bid", "S_offerrem", "S_bidrem", "S4_offer", "S4_bid", "S4_offerrem", "S4_bidrem", "S5_offer", "S5_bid", "S5_offerrem", "S5_bidrem", "T_offerrem", "T_bidrem", "S6_offer", "S6_bid", "S6_offerrem", "S6_bidrem", "S7_offer", "S7_bid", "S7_offerrem", "S7_bidrem", "S8_offer", "S8_bid", "S8_offerrem", "S8_bidrem", "S9_offer", "S9_bid", "S9_offerrem", "S9_bidrem", "S10_offer", "S10_bid", "S10_offerrem", "S10_bidrem", "volume", "krx_mid_prc", "krx_mid_offerrem", "krx_mid_bidrem", "nxt_mid_prc", "nxt_mid_offerrem", "nxt_mid_bidrem", "kospigb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "mb", "tr_key": "005930" } }, "push_example": { "header": { "tr_cd": "mb", "tr_key": "005940" }, "body": { "code": "005940", "hotime": "13:55:11", "offer": "31800", "bid": "31750", "offerrem": "668", "bidrem": "2899", "P_offer": "31850", "P_bid": "31700", "P_offerrem": "289", "P_bidrem": "1582", "S_offer": "31900", "S_bid": "31650", "S_offerrem": "40", "S_bidrem": "1508", "S4_offer": "31950", "S4_bid": "31600", "S4_offerrem": "317", "S4_bidrem": "2224", "S5_offer": "32000", "S5_bid": "31550", "S5_offerrem": "2923", "S5_bidrem": "659", "T_offerrem": "33938", "T_bidrem": "13132", "S6_offer": "32050", "S6_bid": "31500", "S6_offerrem": "3329", "S6_bidrem": "788", "S7_offer": "32100", "S7_bid": "31450", "S7_offerrem": "5659", "S7_bidrem": "918", "S8_offer": "32150", "S8_bid": "31400", "S8_offerrem": "4708", "S8_bidrem": "776", "S9_offer": "32200", "S9_bid": "31350", "S9_offerrem": "10399", "S9_bidrem": "607", "S10_offer": "32250", "S10_bid": "31300", "S10_offerrem": "5606", "S10_bidrem": "1171", "volume": "0", "krx_mid_prc": "31775", "krx_mid_offerrem": "0", "krx_mid_bidrem": "0", "nxt_mid_prc": "31775", "nxt_mid_offerrem": "0", "nxt_mid_bidrem": "0", "kospigb": "1" } }, "description": "국내주식 실시간 호가(통합시세 기준) 서비스 입니다." }, { "name": "국내주식 실시간체결가통합", "sheet": "API_국내_주식_실시간_체결가(통합)", "tr_cd": "mc", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "time", "sign", "change", "price", "chrate", "high", "low", "offer", "bid", "volume", "volrate", "movolume", "value", "open", "avgprice", "janggubun", "bidrate", "volpower", "new_volume", "bidvolall", "offvolall", "kospigb", "value_won" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "mc", "tr_key": "005930" } }, "push_example": { "header": { "tr_cd": "mc", "tr_key": "005940" }, "body": { "code": "005940", "time": "14:00:31", "sign": "2", "change": "2500", "price": "31750", "chrate": "8.55", "high": "32200", "low": "29450", "offer": "31750", "bid": "31700", "volume": "837624", "volrate": "81.75", "movolume": "13", "value": "26387", "open": "29600", "avgprice": "31503", "janggubun": "0", "bidrate": "57.65", "volpower": "137.24", "new_volume": "837624", "bidvolall": "482854", "offvolall": "351828", "kospigb": "1", "value_won": "26387679000" } }, "description": "국내주식 실시간 체결가(통합시세 기준) 서비스 입니다." }, { "name": "국내주식 실시간예상체결통합", "sheet": "API_국내_주식_실시간_예상체결(통합)", "tr_cd": "ma", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "hotime", "dongsi", "jeqprice", "jeqsign", "jeqchange", "jeqchrate", "jeqvol", "offer", "bid", "offerrem", "bidrem", "krx_mid_prc", "krx_mid_offerrem", "krx_mid_bidrem", "nxt_mid_prc", "nxt_mid_offerrem", "nxt_mid_bidrem", "kospigb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "ma", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "ma", "tr_key": "005940" }, "body": { "code": "005940", "hotime": "14:04:50", "dongsi": "0", "jeqprice": "0", "jeqsign": "0", "jeqchange": "0", "jeqchrate": "0.00", "jeqvol": "0", "offer": "31950", "bid": "31900", "offerrem": "144", "bidrem": "855", "krx_mid_prc": "31925", "krx_mid_offerrem": "0", "nxt_mid_prc": "31925", "nxt_mid_offerrem": "0", "kospigb": "1" } }, "description": "국내주식 실시간 예상체결가(통합시세 기준) 서비스 입니다." }, { "name": "국내주식 실시간회원사통합", "sheet": "API_국내_주식_실시간_회원사(통합)", "tr_cd": "mg", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "time", "off_trano1", "off_tra1", "N_off_tra1", "N_otraflag1", "N_offvolume1", "N_offvolcha1", "bid_trano1", "bid_tra1", "N_bid_tra1", "N_btraflag1", "N_bidvolume1", "N_bidvolcha1", "off_trano2", "off_tra2", "N_off_tra2", "N_otraflag2", "N_offvolume2", "N_offvolcha2", "bid_trano2", "bid_tra2", "N_bid_tra2", "N_btraflag2", "N_bidvolume2", "N_bidvolcha2", "off_trano3", "off_tra3", "N_off_tra3", "N_otraflag3", "N_offvolume3", "N_offvolcha3", "bid_trano3", "bid_tra3", "N_bid_tra3", "N_btraflag3", "N_bidvolume3", "N_bidvolcha3", "off_trano4", "off_tra4", "N_off_tra4", "N_otraflag4", "N_offvolume4", "N_offvolcha4", "bid_trano4", "bid_tra4", "N_bid_tra4", "N_btraflag4", "N_bidvolume4", "N_bidvolcha4", "off_trano5", "off_tra5", "N_off_tra5", "N_otraflag5", "N_offvolume5", "N_offvolcha5", "bid_trano5", "bid_tra5", "N_bid_tra5", "N_btraflag5", "N_bidvolume5", "N_bidvolcha5", "N_offvolall", "N_offvolcha", "N_bidvolall", "N_bidvolcha", "N_soonmaesu", "N_soonmaecha", "N_alloffvol", "N_allbidvol", "hname", "kpgubun" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "mg", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "mg", "tr_key": "005940" }, "body": { "code": "005940", "time": "14:12", "off_trano1": "0012", "off_tra1": "NH투자", "N_off_tra1": "NH투자증권", "N_otraflag1": "0", "N_offvolume1": "219592", "N_offvolcha1": "0", "bid_trano1": "0033", "bid_tra1": "JP모간", "N_bid_tra1": "J P 모간증권", "N_btraflag1": "1", "N_bidvolume1": "148396", "N_bidvolcha1": "0", "off_trano2": "0002", "off_tra2": "신한투", "N_off_tra2": "신한투자증권", "N_otraflag2": "0", "N_offvolume2": "90927", "N_offvolcha2": "0", "bid_trano2": "0002", "bid_tra2": "신한투", "N_bid_tra2": "신한투자증권", "N_btraflag2": "0", "N_bidvolume2": "111464", "N_bidvolcha2": "0", "off_trano3": "0030", "off_tra3": "삼 성", "N_off_tra3": "삼 성 증 권", "N_otraflag3": "0", "N_offvolume3": "82288", "N_offvolcha3": "0", "bid_trano3": "0003", "bid_tra3": "한국투", "N_bid_tra3": "한국투자증권", "N_btraflag3": "0", "N_bidvolume3": "97292", "N_bidvolcha3": "0", "off_trano4": "0008", "off_tra4": "유진투", "N_off_tra4": "유진투자증권", "N_otraflag4": "0", "N_offvolume4": "51248", "N_offvolcha4": "0", "bid_trano4": "0045", "bid_tra4": "골드만", "N_bid_tra4": "골드만삭스증권", "N_btraflag4": "1", "N_bidvolume4": "78833", "N_bidvolcha4": "0", "off_trano5": "0033", "off_tra5": "JP모간", "N_off_tra5": "J P 모간증권", "N_otraflag5": "1", "N_offvolume5": "45622", "N_offvolcha5": "0", "bid_trano5": "0043", "bid_tra5": "U B S", "N_bid_tra5": "U B S 증 권", "N_btraflag5": "1", "N_bidvolume5": "62307", "N_bidvolcha5": "0", "N_offvolall": "45622", "N_offvolcha": "0", "N_bidvolall": "289536", "N_bidvolcha": "0", "N_soonmaesu": "243914", "N_soonmaecha": "0", "N_alloffvol": "489677", "N_allbidvol": "498292", "hname": "NH투자증권", "kpgubun": "1" } }, "description": "국내주식 실시간 회원사 거래(통합시세 기준) 서비스 입니다." }, { "name": "국내주식 실시간프로그램매매통합", "sheet": "API_국내_주식_실시간_프로그램매매(통합)", "tr_cd": "mn", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "timez8", "offval", "mov_offval", "bidval", "mov_bidval", "sbidval", "mov_sbidval", "offvol", "mov_offvol", "bidvol", "mov_bidvol", "sbidvol", "mov_sbidvol", "c_offval", "mov_c_offval", "b_offval", "mov_b_offval", "c_bidval", "mov_c_bidval", "b_bidval", "mov_b_bidval", "c_offvol", "mov_c_offvol", "b_offvol", "mov_b_offvol", "c_bidvol", "mov_c_bidvol", "b_bidvol", "mov_b_bidvol" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "mn", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "mn", "tr_key": "005940" }, "body": { "code": "005940", "timez8": "14:20:14", "offval": "6928", "mov_offval": "75", "bidval": "20708", "mov_bidval": "87", "sbidval": "13780", "mov_sbidval": "12", "offvol": "219362", "mov_offvol": "2354", "bidvol": "656725", "mov_bidvol": "2726", "sbidvol": "437363", "mov_sbidvol": "372", "c_offval": "252", "mov_c_offval": "0", "b_offval": "6677", "mov_b_offval": "75", "c_bidval": "647", "mov_c_bidval": "0", "b_bidval": "20062", "mov_b_bidval": "87", "c_offvol": "7930", "mov_c_offvol": "0", "b_offvol": "211432", "mov_b_offvol": "2354", "c_bidvol": "20760", "mov_c_bidvol": "0", "b_bidvol": "635965", "mov_b_bidvol": "2726" } }, "description": "국내주식 실시간 프로그램매매(통합시세 기준) 서비스 입니다." }, { "name": "국내주식 실시간호가NXT", "sheet": "API_국내_주식_실시간_호가(NXT)", "tr_cd": "nb", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "hotime", "offer", "bid", "offerrem", "bidrem", "P_offer", "P_bid", "P_offerrem", "P_bidrem", "S_offer", "S_bid", "S_offerrem", "S_bidrem", "S4_offer", "S4_bid", "S4_offerrem", "S4_bidrem", "S5_offer", "S5_bid", "S5_offerrem", "S5_bidrem", "T_offerrem", "T_bidrem", "S6_offer", "S6_bid", "S6_offerrem", "S6_bidrem", "S7_offer", "S7_bid", "S7_offerrem", "S7_bidrem", "S8_offer", "S8_bid", "S8_offerrem", "S8_bidrem", "S9_offer", "S9_bid", "S9_offerrem", "S9_bidrem", "S10_offer", "S10_bid", "S10_offerrem", "S10_bidrem", "volume", "mid_prc", "mid_offerrem", "mid_bidrem", "kospigb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "nb", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "nb", "tr_key": "005940" }, "body": { "code": "005940", "hotime": "13:52:26", "offer": "31850", "bid": "31800", "offerrem": "130", "bidrem": "84", "P_offer": "31900", "P_bid": "31750", "P_offerrem": "67", "P_bidrem": "935", "S_offer": "31950", "S_bid": "31700", "S_offerrem": "141", "S_bidrem": "517", "S4_offer": "32000", "S4_bid": "31650", "S4_offerrem": "705", "S4_bidrem": "66", "S5_offer": "32050", "S5_bid": "31600", "S5_offerrem": "1819", "S5_bidrem": "1578", "T_offerrem": "16919", "T_bidrem": "3657", "S6_offer": "32100", "S6_bid": "31550", "S6_offerrem": "2002", "S6_bidrem": "53", "S7_offer": "32150", "S7_bid": "31500", "S7_offerrem": "4117", "S7_bidrem": "113", "S8_offer": "32200", "S8_bid": "31450", "S8_offerrem": "6034", "S8_bidrem": "115", "S9_offer": "32250", "S9_bid": "31400", "S9_offerrem": "494", "S9_bidrem": "94", "S10_offer": "32300", "S10_bid": "31350", "S10_offerrem": "1410", "S10_bidrem": "102", "volume": "0", "mid_prc": "31825", "mid_offerrem": "0", "mid_bidrem": "0", "kospigb": "1" } }, "description": "국내주식 실시간 호가(NXT 기준) 서비스 입니다." }, { "name": "국내주식 실시간체결가NXT", "sheet": "API_국내_주식_실시간_체결가(NXT)", "tr_cd": "nc", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "time", "sign", "change", "price", "chrate", "high", "low", "offer", "bid", "volume", "volrate", "movolume", "value", "open", "avgprice", "janggubun", "bidrate", "volpower", "new_volume", "bidvolall", "offvolall", "kospigb", "value_won" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "nc", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "nc", "tr_key": "005940" }, "body": { "code": "005940", "time": "14:00:09", "sign": "2", "change": "2450", "price": "31700", "chrate": "8.38", "high": "32150", "low": "29450", "offer": "31750", "bid": "31700", "volume": "174270", "volrate": "68.68", "movolume": "6", "value": "5420", "open": "29600", "avgprice": "31106", "janggubun": "0", "bidrate": "79.25", "volpower": "381.87", "new_volume": "174270", "bidvolall": "138105", "offvolall": "36165", "kospigb": "1", "value_won": "5420856450" } }, "description": "국내주식 실시간 체결가(NXT 기준) 서비스 입니다." }, { "name": "국내주식 실시간예상체결NXT", "sheet": "API_국내_주식_실시간_예상체결(NXT)", "tr_cd": "na", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "hotime", "dongsi", "jeqprice", "jeqsign", "jeqchange", "jeqchrate", "jeqvol", "offer", "bid", "offerrem", "bidrem", "mid_prc", "mid_offerrem", "mid_bidrem", "kospigb" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "na", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "na", "tr_key": "005940" }, "body": { "code": "005940", "hotime": "14:04:40", "dongsi": "0", "jeqprice": "0", "jeqsign": "0", "jeqchange": "0", "jeqchrate": "0.00", "jeqvol": "0", "offer": "31950", "bid": "31750", "offerrem": "80", "bidrem": "100", "mid_prc": "31850", "mid_offerrem": "0", "kospigb": "1" } }, "description": "국내주식 실시간 예상체결가(NXT 기준) 서비스 입니다." }, { "name": "국내주식 실시간회원사NXT", "sheet": "API_국내_주식_실시간_회원사(NXT)", "tr_cd": "ng", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "time", "off_trano1", "off_tra1", "N_off_tra1", "N_otraflag1", "N_offvolume1", "N_offvolcha1", "bid_trano1", "bid_tra1", "N_bid_tra1", "N_btraflag1", "N_bidvolume1", "N_bidvolcha1", "off_trano2", "off_tra2", "N_off_tra2", "N_otraflag2", "N_offvolume2", "N_offvolcha2", "bid_trano2", "bid_tra2", "N_bid_tra2", "N_btraflag2", "N_bidvolume2", "N_bidvolcha2", "off_trano3", "off_tra3", "N_off_tra3", "N_otraflag3", "N_offvolume3", "N_offvolcha3", "bid_trano3", "bid_tra3", "N_bid_tra3", "N_btraflag3", "N_bidvolume3", "N_bidvolcha3", "off_trano4", "off_tra4", "N_off_tra4", "N_otraflag4", "N_offvolume4", "N_offvolcha4", "bid_trano4", "bid_tra4", "N_bid_tra4", "N_btraflag4", "N_bidvolume4", "N_bidvolcha4", "off_trano5", "off_tra5", "N_off_tra5", "N_otraflag5", "N_offvolume5", "N_offvolcha5", "bid_trano5", "bid_tra5", "N_bid_tra5", "N_btraflag5", "N_bidvolume5", "N_bidvolcha5", "N_offvolall", "N_offvolcha", "N_bidvolall", "N_bidvolcha", "N_soonmaesu", "N_soonmaecha", "N_alloffvol", "N_allbidvol", "hname", "kpgubun" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "ng", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "ng", "tr_key": "005940" }, "body": { "code": "005940", "time": "14:10", "off_trano1": "0012", "off_tra1": "NH투자", "N_off_tra1": "NH투자증권", "N_otraflag1": "0", "N_offvolume1": "45390", "N_offvolcha1": "10", "bid_trano1": "0003", "bid_tra1": "한국투", "N_bid_tra1": "한국투자증권", "N_btraflag1": "0", "N_bidvolume1": "52923", "N_bidvolcha1": "0", "off_trano2": "0030", "off_tra2": "삼 성", "N_off_tra2": "삼 성 증 권", "N_otraflag2": "0", "N_offvolume2": "25088", "N_offvolcha2": "0", "bid_trano2": "0002", "bid_tra2": "신한투", "N_bid_tra2": "신한투자증권", "N_btraflag2": "0", "N_bidvolume2": "35658", "N_bidvolcha2": "0", "off_trano3": "0050", "off_tra3": "키 움", "N_off_tra3": "키 움 증 권", "N_otraflag3": "0", "N_offvolume3": "22941", "N_offvolcha3": "15", "bid_trano3": "0012", "bid_tra3": "NH투자", "N_bid_tra3": "NH투자증권", "N_btraflag3": "0", "N_bidvolume3": "23838", "N_bidvolcha3": "0", "off_trano4": "0005", "off_tra4": "미래에", "N_off_tra4": "미래에셋증권", "N_otraflag4": "0", "N_offvolume4": "18860", "N_offvolcha4": "10", "bid_trano4": "0005", "bid_tra4": "미래에", "N_bid_tra4": "미래에셋증권", "N_btraflag4": "0", "N_bidvolume4": "15089", "N_bidvolcha4": "51", "off_trano5": "0003", "off_tra5": "한국투", "N_off_tra5": "한국투자증권", "N_otraflag5": "0", "N_offvolume5": "13125", "N_offvolcha5": "11", "bid_trano5": "0050", "bid_tra5": "키 움", "N_bid_tra5": "키 움 증 권", "N_btraflag5": "0", "N_bidvolume5": "14835", "N_bidvolcha5": "0", "N_offvolall": "0", "N_offvolcha": "0", "N_bidvolall": "0", "N_bidvolcha": "0", "N_soonmaesu": "0", "N_soonmaecha": "0", "N_alloffvol": "125404", "N_allbidvol": "142343", "hname": "NH투자증권", "kpgubun": "1" } }, "description": "국내주식 실시간 회원사 거래(NXT 기준) 서비스 입니다." }, { "name": "국내주식 실시간프로그램매매NXT", "sheet": "API_국내_주식_실시간_프로그램매매(NXT)", "tr_cd": "nn", "tr_key": { "name": "code", "kor": "종목코드", "length": "6" }, "fields": [ "code", "timez8", "offval", "mov_offval", "bidval", "mov_bidval", "sbidval", "mov_sbidval", "offvol", "mov_offvol", "bidvol", "mov_bidvol", "sbidvol", "mov_sbidvol", "c_offval", "mov_c_offval", "b_offval", "mov_b_offval", "c_bidval", "mov_c_bidval", "b_bidval", "mov_b_bidval", "c_offvol", "mov_c_offvol", "b_offvol", "mov_b_offvol", "c_bidvol", "mov_c_bidvol", "b_bidvol", "mov_b_bidvol" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "nn", "tr_key": "005940" } }, "push_example": { "header": { "tr_cd": "nn", "tr_key": "005940" }, "body": { "code": "005940", "timez8": "14:16:35", "offval": "461", "mov_offval": "0", "bidval": "3231", "mov_bidval": "1", "sbidval": "2770", "mov_sbidval": "1", "offvol": "14933", "mov_offvol": "0", "bidvol": "103951", "mov_bidvol": "41", "sbidvol": "89018", "mov_sbidvol": "41", "c_offval": "0", "mov_c_offval": "0", "b_offval": "461", "mov_b_offval": "0", "c_bidval": "119", "mov_c_bidval": "0", "b_bidval": "3113", "mov_b_bidval": "1", "c_offvol": "0", "mov_c_offvol": "0", "b_offvol": "14933", "mov_b_offvol": "0", "c_bidvol": "3978", "mov_c_bidvol": "0", "b_bidvol": "99973", "mov_b_bidvol": "41" } }, "description": "국내주식 실시간 프로그램매매(NXT 기준) 서비스 입니다." }, { "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": "1", "accountno": "ACCOUNT NUMBER", "orderno": "0000000030", "issuecd": "005940", "slbygb": "2", "concgty": "0000000005", "concprc": "00000035550", "conctime": "115606", "ucgb": "0", "rejgb": "0", "fundcode": "000", "sin_gb": "10", "loan_date": "", "ato_ord_tpe_chg": "0", "issue_nm": "NH투자증권", "rmt_mkt_cd": "S", "snd_mkt_cd": "K", "ord_cond_prc": "", "sor_orrgb": "B", "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": "1", "accountno": "ACCOUNT NUMBER", "orderno": "0000000030", "orgordno": "", "ordercd": "10", "issuecd": "005940", "issuename": "NH투자증권", "slbygb": "2", "order_type": "01", "ordergty": "0000000010", "orderprc": "00000035550", "procnm": "00", "commcd": "F5", "order_cond": "0", "fundcode": "000", "sin_gb": "10", "order_time": "115606", "loan_date": "", "rmt_mkt_cd": "S", "snd_mkt_cd": "K", "ord_cond_prc": "00000000000", "sor_orrgb": "B", "mkt_order_qty": "0000000010" } }, "description": "국내주식 주문 접수 시 실시간으로 수신됩니다." }, { "name": "채권지수 실시간 체결가", "sheet": "API_국내_주식_실시간_채권지수체결가", "tr_cd": "uB", "tr_key": { "name": "jisuid", "kor": "지수ID", "length": "6" }, "fields": [ "jisuid", "time", "grossprofit", "gross_sign", "gross_change", "gross_open", "gross_high", "gross_hightime", "gross_low", "gross_lowtime", "gross_chrate", "cleanprice", "clean_sign", "clean_change", "clean_open", "clean_high", "clean_hightime", "clean_low", "clean_lowtime", "clean_chrate", "marketprice", "market_sign", "market_change", "market_open", "market_high", "market_hightime", "market_low", "market_lowtime", "market_chrate", "callreinvest", "zeroreinvest", "theoryprice", "avgduration", "avgconvexity", "avgytm", "avgguidanceytm" ], "subscribe_example": { "header": { "token": "TOKEN", "tr_type": "1" }, "body": { "tr_cd": "uB", "tr_key": "MKFR01" } }, "push_example": { "header": { "tr_cd": "uB", "tr_key": "MKFR01" }, "body": { "jisuid": "MKFR01", "time": "15:41:00", "grossprofit": "203.8161", "gross_sign": "5", "gross_change": "0.0485", "gross_open": "203.8854", "gross_high": "203.8993", "gross_hightime": "15:30:00", "gross_low": "203.4349", "gross_lowtime": "09:19:30", "gross_chrate": "0.02", "cleanprice": "103.5987", "clean_sign": "5", "clean_change": "0.0328", "clean_open": "103.6341", "clean_high": "103.6376", "clean_hightime": "15:30:00", "clean_low": "103.4003", "clean_lowtime": "09:19:30", "clean_chrate": "0.03", "marketprice": "102.4890", "market_sign": "5", "market_change": "0.0244", "market_open": "102.5239", "market_high": "102.5309", "market_hightime": "15:30:00", "market_low": "102.2973", "market_lowtime": "09:19:30", "market_chrate": "0.02", "callreinvest": "0.0000", "zeroreinvest": "0.0000", "theoryprice": "0.00", "avgduration": "2.785", "avgconvexity": "10.527", "avgytm": "3.811", "avgguidanceytm": "0.000" } }, "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_new_stock.mst (국내주식)" ], "download_url_pattern": "https://www.n2plug.com/instruments/<파일명>.mst", "auth_required": false, "format_key_points": [ "CP949", "고정길이 레코드 + LF(0x0A) 종단", "바이너리 모드(\"rb\") 필수", "파일크기 % 레코드크기 == 0 검증" ], "struct_definition_url_pattern": "https://www.n2plug.com/instruments/<파일명>.h", "struct_definition_note": "마스터 파일(.mst)과 1:1 대응하는 .h 파일에 오프셋·길이·코드값·레코드크기가 정의되어 있습니다. 인증 불필요.", "struct_definition_files": [ "m_new_stock.h" ] } }