키움 REST API 목차 No. API ID 1 au10001 2 API 명 대분류 중분류 페이지번호 접근토큰 발급 OAuth 인증 접근토큰발급 7 au10002 접근토큰폐기 OAuth 인증 접근토큰폐기 9 3 ka00001 계좌번호조회 국내주식 계좌 10 4 ka00198 실시간종목조회순위 국내주식 종목정보 11 5 ka01690 일별잔고수익률 국내주식 계좌 13 6 ka10001 주식기본정보요청 국내주식 종목정보 15 7 ka10002 주식거래원요청 국내주식 종목정보 18 8 ka10003 체결정보요청 국내주식 종목정보 21 9 ka10004 주식호가요청 국내주식 시세 24 10 ka10005 주식일주월시분요청 국내주식 시세 28 11 ka10006 주식시분요청 국내주식 시세 31 12 ka10007 시세표성정보요청 국내주식 시세 33 13 ka10008 주식외국인종목별매매동향 국내주식 기관/외국인 39 14 ka10009 주식기관요청 국내주식 기관/외국인 42 15 ka10010 업종프로그램요청 국내주식 업종 44 16 ka10011 신주인수권전체시세요청 국내주식 시세 46 17 ka10013 신용매매동향요청 국내주식 종목정보 48 18 ka10014 공매도추이요청 국내주식 공매도 51 19 ka10015 일별거래상세요청 국내주식 종목정보 54 20 ka10016 신고저가요청 국내주식 종목정보 58 21 ka10017 상하한가요청 국내주식 종목정보 61 22 ka10018 고저가근접요청 국내주식 종목정보 64 23 ka10019 가격급등락요청 국내주식 종목정보 67 24 ka10020 호가잔량상위요청 국내주식 순위정보 70 25 ka10021 호가잔량급증요청 국내주식 순위정보 73 26 ka10022 잔량율급증요청 국내주식 순위정보 75 27 ka10023 거래량급증요청 국내주식 순위정보 77 28 ka10024 거래량갱신요청 국내주식 종목정보 80 29 ka10025 매물대집중요청 국내주식 종목정보 82 30 ka10026 고저PER요청 국내주식 종목정보 85 31 ka10027 전일대비등락률상위요청 국내주식 순위정보 87 32 ka10028 시가대비등락률요청 국내주식 종목정보 90 33 ka10029 예상체결등락률상위요청 국내주식 순위정보 93 34 ka10030 당일거래량상위요청 국내주식 순위정보 96 35 ka10031 전일거래량상위요청 국내주식 순위정보 99 36 ka10032 거래대금상위요청 국내주식 순위정보 102 37 ka10033 신용비율상위요청 국내주식 순위정보 104 38 ka10034 외인기간별매매상위요청 국내주식 순위정보 107 1 / 528 키움 REST API 목차 No. API ID 39 ka10035 40 API 명 대분류 중분류 페이지번호 외인연속순매매상위요청 국내주식 순위정보 109 ka10036 외인한도소진율증가상위 국내주식 순위정보 112 41 ka10037 외국계창구매매상위요청 국내주식 순위정보 114 42 ka10038 종목별증권사순위요청 국내주식 순위정보 117 43 ka10039 증권사별매매상위요청 국내주식 순위정보 119 44 ka10040 당일주요거래원요청 국내주식 순위정보 121 45 ka10042 순매수거래원순위요청 국내주식 순위정보 124 46 ka10043 거래원매물대분석요청 국내주식 종목정보 126 47 ka10044 일별기관매매종목요청 국내주식 시세 129 48 ka10045 종목별기관매매추이요청 국내주식 시세 131 49 ka10046 체결강도추이시간별요청 국내주식 시세 133 50 ka10047 체결강도추이일별요청 국내주식 시세 135 51 ka10048 ELW일별민감도지표요청 국내주식 ELW 137 52 ka10050 ELW민감도지표요청 국내주식 ELW 140 53 ka10051 업종별투자자순매수요청 국내주식 업종 142 54 ka10052 거래원순간거래량요청 국내주식 종목정보 145 55 ka10053 당일상위이탈원요청 국내주식 순위정보 147 56 ka10054 변동성완화장치발동종목요청 국내주식 종목정보 149 57 ka10055 당일전일체결량요청 국내주식 종목정보 152 58 ka10058 투자자별일별매매종목요청 국내주식 종목정보 154 59 ka10059 종목별투자자기관별요청 국내주식 종목정보 156 60 ka10060 종목별투자자기관별차트요청 국내주식 차트 159 61 ka10061 종목별투자자기관별합계요청 국내주식 종목정보 162 62 ka10062 동일순매매순위요청 국내주식 순위정보 164 63 ka10063 장중투자자별매매요청 국내주식 시세 166 64 ka10064 장중투자자별매매차트요청 국내주식 차트 169 65 ka10065 장중투자자별매매상위요청 국내주식 순위정보 171 66 ka10066 장마감후투자자별매매요청 국내주식 시세 173 67 ka10068 대차거래추이요청 국내주식 대차거래 176 68 ka10069 대차거래상위10종목요청 국내주식 대차거래 178 69 ka10072 일자별종목별실현손익요청_일자 국내주식 계좌 180 70 ka10073 일자별종목별실현손익요청_기간 국내주식 계좌 182 71 ka10074 일자별실현손익요청 국내주식 계좌 185 72 ka10075 미체결요청 국내주식 계좌 187 73 ka10076 체결요청 국내주식 계좌 190 74 ka10077 당일실현손익상세요청 국내주식 계좌 193 75 ka10078 증권사별종목매매동향요청 국내주식 시세 195 2 / 528 키움 REST API 목차 No. API ID 76 ka10079 77 API 명 대분류 중분류 페이지번호 주식틱차트조회요청 국내주식 차트 197 ka10080 주식분봉차트조회요청 국내주식 차트 199 78 ka10081 주식일봉차트조회요청 국내주식 차트 201 79 ka10082 주식주봉차트조회요청 국내주식 차트 203 80 ka10083 주식월봉차트조회요청 국내주식 차트 205 81 ka10084 당일전일체결요청 국내주식 종목정보 207 82 ka10085 계좌수익률요청 국내주식 계좌 209 83 ka10086 일별주가요청 국내주식 시세 212 84 ka10087 시간외단일가요청 국내주식 시세 215 85 ka10088 미체결 분할주문 상세 국내주식 계좌 219 86 ka10094 주식년봉차트조회요청 국내주식 차트 221 87 ka10095 관심종목정보요청 국내주식 종목정보 223 88 ka10098 시간외단일가등락율순위요청 국내주식 순위정보 227 89 ka10099 종목정보 리스트 국내주식 종목정보 229 90 ka10100 종목정보 조회 국내주식 종목정보 232 91 ka10101 업종코드 리스트 국내주식 종목정보 234 92 ka10102 회원사 리스트 국내주식 종목정보 236 93 ka10131 기관외국인연속매매현황요청 국내주식 기관/외국인 238 94 ka10170 당일매매일지요청 국내주식 계좌 241 95 ka10171 조건검색 목록조회 국내주식 조건검색 243 96 ka10172 조건검색 요청 일반 국내주식 조건검색 245 97 ka10173 조건검색 요청 실시간 국내주식 조건검색 248 98 ka10174 조건검색 실시간 해제 국내주식 조건검색 251 99 ka20001 업종현재가요청 국내주식 업종 253 100 ka20002 업종별주가요청 국내주식 업종 256 101 ka20003 전업종지수요청 국내주식 업종 259 102 ka20004 업종틱차트조회요청 국내주식 차트 261 103 ka20005 업종분봉조회요청 국내주식 차트 263 104 ka20006 업종일봉조회요청 국내주식 차트 265 105 ka20007 업종주봉조회요청 국내주식 차트 267 106 ka20008 업종월봉조회요청 국내주식 차트 269 107 ka20009 업종현재가일별요청 국내주식 업종 271 108 ka20019 업종년봉조회요청 국내주식 차트 274 109 ka20068 대차거래추이요청(종목별) 국내주식 대차거래 276 110 ka30001 ELW가격급등락요청 국내주식 ELW 278 111 ka30002 거래원별ELW순매매상위요청 국내주식 ELW 280 112 ka30003 ELWLP보유일별추이요청 국내주식 ELW 282 3 / 528 키움 REST API 목차 No. API ID 113 ka30004 114 API 명 대분류 중분류 페이지번호 ELW괴리율요청 국내주식 ELW 284 ka30005 ELW조건검색요청 국내주식 ELW 287 115 ka30009 ELW등락율순위요청 국내주식 ELW 290 116 ka30010 ELW잔량순위요청 국내주식 ELW 292 117 ka30011 ELW근접율요청 국내주식 ELW 294 118 ka30012 ELW종목상세정보요청 국내주식 ELW 296 119 ka40001 ETF수익율요청 국내주식 ETF 300 120 ka40002 ETF종목정보요청 국내주식 ETF 302 121 ka40003 ETF일별추이요청 국내주식 ETF 304 122 ka40004 ETF전체시세요청 국내주식 ETF 306 123 ka40006 ETF시간대별추이요청 국내주식 ETF 309 124 ka40007 ETF시간대별체결요청 국내주식 ETF 311 125 ka40008 ETF일자별체결요청 국내주식 ETF 313 126 ka40009 ETF시간대별체결요청 국내주식 ETF 315 127 ka40010 ETF시간대별추이요청 국내주식 ETF 317 128 ka50010 금현물체결추이 국내주식 시세 319 129 ka50012 금현물일별추이 국내주식 시세 321 130 ka50079 금현물틱차트조회요청 국내주식 차트 323 131 ka50080 금현물분봉차트조회요청 국내주식 차트 325 132 ka50081 금현물일봉차트조회요청 국내주식 차트 327 133 ka50082 금현물주봉차트조회요청 국내주식 차트 329 134 ka50083 금현물월봉차트조회요청 국내주식 차트 331 135 ka50087 금현물예상체결 국내주식 시세 333 136 ka50091 금현물당일틱차트조회요청 국내주식 차트 335 137 ka50092 금현물당일분봉차트조회요청 국내주식 차트 337 138 ka50100 금현물 시세정보 국내주식 시세 339 139 ka50101 금현물 호가 국내주식 시세 341 140 ka52301 금현물투자자현황 국내주식 기관/외국인 343 141 ka90001 테마그룹별요청 국내주식 테마 346 142 ka90002 테마구성종목요청 국내주식 테마 348 143 ka90003 프로그램순매수상위50요청 국내주식 종목정보 351 144 ka90004 종목별프로그램매매현황요청 국내주식 종목정보 353 145 ka90005 프로그램매매추이요청 시간대별 국내주식 시세 356 146 ka90006 프로그램매매차익잔고추이요청 국내주식 시세 359 147 ka90007 프로그램매매누적추이요청 국내주식 시세 361 148 ka90008 종목시간별프로그램매매추이요청 국내주식 시세 363 149 ka90009 외국인기관매매상위요청 국내주식 순위정보 366 4 / 528 키움 REST API 목차 No. API ID API 명 대분류 중분류 페이지번호 150 ka90010 프로그램매매추이요청 일자별 국내주식 시세 369 151 ka90012 대차거래내역요청 국내주식 대차거래 372 152 ka90013 종목일별프로그램매매추이요청 국내주식 시세 374 153 kt00001 예수금상세현황요청 국내주식 계좌 377 154 kt00002 일별추정예탁자산현황요청 국내주식 계좌 382 155 kt00003 추정자산조회요청 국내주식 계좌 384 156 kt00004 계좌평가현황요청 국내주식 계좌 385 157 kt00005 체결잔고요청 국내주식 계좌 388 158 kt00007 계좌별주문체결내역상세요청 국내주식 계좌 391 159 kt00008 계좌별익일결제예정내역요청 국내주식 계좌 394 160 kt00009 계좌별주문체결현황요청 국내주식 계좌 396 161 kt00010 주문인출가능금액요청 국내주식 계좌 399 162 kt00011 증거금율별주문가능수량조회요청 국내주식 계좌 402 163 kt00012 신용보증금율별주문가능수량조회요청 국내주식 계좌 405 164 kt00013 증거금세부내역조회요청 국내주식 계좌 408 165 kt00015 위탁종합거래내역요청 국내주식 계좌 411 166 kt00016 일별계좌수익률상세현황요청 국내주식 계좌 415 167 kt00017 계좌별당일현황요청 국내주식 계좌 418 168 kt00018 계좌평가잔고내역요청 국내주식 계좌 420 169 kt10000 주식 매수주문 국내주식 주문 423 170 kt10001 주식 매도주문 국내주식 주문 425 171 kt10002 주식 정정주문 국내주식 주문 427 172 kt10003 주식 취소주문 국내주식 주문 429 173 kt10006 신용 매수주문 국내주식 신용주문 431 174 kt10007 신용 매도주문 국내주식 신용주문 433 175 kt10008 신용 정정주문 국내주식 신용주문 435 176 kt10009 신용 취소주문 국내주식 신용주문 437 177 kt20016 신용융자 가능종목요청 국내주식 종목정보 439 178 kt20017 신용융자 가능문의 국내주식 종목정보 441 179 kt50000 금현물 매수주문 국내주식 주문 442 180 kt50001 금현물 매도주문 국내주식 주문 444 181 kt50002 금현물 정정주문 국내주식 주문 446 182 kt50003 금현물 취소주문 국내주식 주문 448 183 kt50020 금현물 잔고확인 국내주식 계좌 450 184 kt50021 금현물 예수금 국내주식 계좌 453 185 kt50030 금현물 주문체결전체조회 국내주식 계좌 455 186 kt50031 금현물 주문체결조회 국내주식 계좌 458 5 / 528 키움 REST API 목차 No. API ID 187 kt50032 188 kt50075 189 API 명 대분류 중분류 페이지번호 금현물 거래내역조회 국내주식 계좌 461 금현물 미체결조회 국내주식 계좌 464 00 주문체결 국내주식 실시간시세 467 190 04 잔고 국내주식 실시간시세 471 191 0A 주식기세 국내주식 실시간시세 474 192 0B 주식체결 국내주식 실시간시세 477 193 0C 주식우선호가 국내주식 실시간시세 481 194 0D 주식호가잔량 국내주식 실시간시세 483 195 0E 주식시간외호가 국내주식 실시간시세 492 196 0F 주식당일거래원 국내주식 실시간시세 494 197 0G ETF NAV 국내주식 실시간시세 498 198 0H 주식예상체결 국내주식 실시간시세 501 199 0I 국제금환산가격 국내주식 실시간시세 503 200 0J 업종지수 국내주식 실시간시세 505 201 0U 업종등락 국내주식 실시간시세 508 202 0g 주식종목정보 국내주식 실시간시세 511 203 0m ELW 이론가 국내주식 실시간시세 514 204 0s 장시작시간 국내주식 실시간시세 517 205 0u ELW 지표 국내주식 실시간시세 520 206 0w 종목프로그램매매 국내주식 실시간시세 522 207 1h VI발동/해제 국내주식 실시간시세 525 208 공통 오류코드 528 6 / 528 키움 REST API API 정보 메뉴 위치 OAuth 인증 > 접근토큰발급 > 접근토큰 발급(au10001) API 명 접근토큰 발급 API ID au10001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /oauth2/token Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body grant_type grant_type String Y Body appkey 앱키 String Y Body secretkey 시크릿키 String Y 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... client_credentials 입력 Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body expires_dt 만료일 String Y Body token_type 토큰타입 String Y Body token 접근토큰 String Y Request Example { } "grant_type": "client_credentials", "appkey": "AxserEsdcredca.....", "secretkey": "SEefdcwcforehDre2fdvc...." Response Example { Description "expires_dt":"20241107083713", 7 / 528 Response Example } "token_type":"bearer", "token":"WQJCwyqInphKnR3bSRtB9NE1lv..." "return_code":0, "return_msg":"정상적으로 처리되었습니다" 8 / 528 키움 REST API API 정보 메뉴 위치 OAuth 인증 > 접근토큰폐기 > 접근토큰폐기(au10002) API 명 접근토큰폐기 API ID au10002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /oauth2/revoke Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body appkey 앱키 String Y Body secretkey 시크릿키 String Y Body token 접근토큰 String Y 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Request Example { } "appkey": "AxserEsdcredca.....", "secretkey": "SEefdcwcforehDre2fdvc....", "token": "WQJCwyqInphKnR3bSRtB9NE1lv..." Response Example { } Description "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 9 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌번호조회(ka00001) API 명 계좌번호조회 API ID ka00001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 현재 토큰의 계좌번호를 조회합니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acctNo 계좌번호 String N 20 Request Example {} Response Example { } Description "acctNo": "0123456789" "return_code":0, "return_msg":"정상적으로 처리되었습니다" 10 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 실시간종목조회순위(ka00198) API 명 실시간종목조회순위 API ID ka00198 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body qry_tp 구분 String Y 1 1:1분, 2:10분, 3:1시간, 4:당일 누적, 5:30초 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body item_inq_rank 실시간종목조회순위 LIST N Body - stk_nm 종목명 String N 40 Body - bigd_rank 빅데이터 순위 String N 20 Body - rank_chg 순위 등락 String N 20 Body - rank_chg_sign 순위 등락 부호 String N 20 Body - past_curr_prc 과거 현재가 String N 20 Body - base_comp_sign 기준가 대비 부호 String N 20 Body - base_comp_chgr 기준가 대비 등락율 String N 20 Body - prev_base_sign 직전 기준 대비 부호 String N 20 Body - prev_base_chgr 직전 기준 대비 등락율 String N 20 Body - dt 일자 String N 20 11 / 528 Response 구분 Element 한글명 Type Require d Length Body - tm 시간 String N 20 Body - stk_cd 종목코드 String N 20 Request Example { } "qry_tp": "1" Response Example { } "item_inq_rank": [ { "stk_nm": "키움증권", "bigd_rank": "1", "rank_chg": "0", "rank_chg_sign": "N", "past_curr_prc": "+70700", "base_comp_sign": "2", "base_comp_chgr": "+0.57", "prev_base_sign": "3", "prev_base_chgr": "0.00", "dt": "20250827", "tm": "085900", "stk_cd": "005930" }, { "stk_nm": "키움증권", "bigd_rank": "2", "rank_chg": "-1", "rank_chg_sign": "-", "past_curr_prc": "+206000", "base_comp_sign": "2", "base_comp_chgr": "+0.49", "prev_base_sign": "3", "prev_base_chgr": "0.00", "dt": "20250827", "tm": "085900", "stk_cd": "039490" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 12 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 일별잔고수익률(ka01690) API 명 일별잔고수익률 API ID ka01690 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 해당 API는 모의투자를 지원하지 않습니다 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body qry_dt 조회일자 String Y 8 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dt 일자 String N 20 Body tot_buy_amt 총 매입가 String N 20 Body tot_evlt_amt 총 평가금액 String N 20 Body tot_evltv_prft 총 평가손익 String N 20 Body tot_prft_rt 수익률 String N 20 Body dbst_bal 예수금 String N 20 Body day_stk_asst 추정자산 String N 20 Body buy_wght 현금비중 String N 20 Body day_bal_rt 일별잔고수익률 LIST N Body - cur_prc 현재가 String N 20 Body - stk_cd 종목코드 String N 20 13 / 528 Response 구분 Element 한글명 Type Require d Length Body - stk_nm 종목명 String N 20 Body - rmnd_qty 보유 수량 String N 20 Body - buy_uv 매입 단가 String N 20 Body - buy_wght 매수비중 String N 20 Body - evltv_prft 평가손익 String N 20 Body - prft_rt 수익률 String N 20 Body - evlt_amt 평가금액 String N 20 Body - evlt_wght 평가비중 String N 20 Request Example { } "qry_dt": "20250825" Response Example { } "dt": "20250306", "tot_buy_amt": "192328073", "tot_evlt_amt": "0", "tot_evltv_prft": "-192359839", "tot_prft_rt": "-100.02", "dbst_bal": "0", "day_stk_asst": "0", "buy_wght": "0.00", "day_bal_rt": [ { "cur_prc": "0", "stk_cd": "205100", "stk_nm": "엑셈", "rmnd_qty": "117478", "buy_uv": "1362", "buy_wght": "83.2", "evltv_prft": "-160071534", "prft_rt": "-100.01", "evlt_amt": "0", "evlt_wght": "0.0" }, { "cur_prc": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "rmnd_qty": "187", "buy_uv": "78526", "buy_wght": "7.6", "evltv_prft": "-14689466", "prft_rt": "-100.04", "evlt_amt": "0", "evlt_wght": "0.0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 14 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 주식기본정보요청(ka10001) API 명 주식기본정보요청 API ID ka10001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 20 Body stk_nm 종목명 String N 40 Body setl_mm 결산월 String N 20 Body fav 액면가 String N 20 Body cap 자본금 String N 20 Body flo_stk 상장주식 String N 20 Body crd_rt 신용비율 String N 20 Body oyr_hgst 연중최고 String N 20 Body oyr_lwst 연중최저 String N 20 Body mac 시가총액 String N 20 Body mac_wght 시가총액비중 String N 20 15 / 528 Response 구분 Element 한글명 Type Require d Length Body for_exh_rt 외인소진률 String N 20 Body repl_pric 대용가 String N 20 Body per PER String N 20 Body eps EPS String N 20 Body roe ROE String N 20 Body pbr PBR String N 20 Body ev EV String N 20 Body bps BPS String N 20 Body sale_amt 매출액 String N 20 Body bus_pro 영업이익 String N 20 Body cup_nga 당기순이익 String N 20 Body 250hgst 250최고 String N 20 Body 250lwst 250최저 String N 20 Body open_pric 시가 String N 20 Body high_pric 고가 String N 20 Body low_pric 저가 String N 20 Body upl_pric 상한가 String N 20 Body lst_pric 하한가 String N 20 Body base_pric 기준가 String N 20 Body exp_cntr_pric 예상체결가 String N 20 Body exp_cntr_qty 예상체결수량 String N 20 Body 250hgst_pric_dt 250최고가일 String N 20 Body 250hgst_pric_pre_rt 250최고가대비율 String N 20 Body 250lwst_pric_dt 250최저가일 String N 20 Body 250lwst_pric_pre_rt 250최저가대비율 String N 20 Body cur_prc 현재가 String N 20 Body pre_sig 대비기호 String N 20 Body pred_pre 전일대비 String N 20 Body flu_rt 등락율 String N 20 Body trde_qty 거래량 String N 20 Body trde_pre 거래대비 String N 20 Body fav_unit 액면가단위 String N 20 Body dstr_stk 유통주식 String N 20 Body dstr_rt 유통비율 String N 20 Request Example 16 / 528 Description [ 주의 ] PER, ROE 값들은 외부벤더사에서 제공되는 데이터이며 일주일에 한번 또는 실적발표 시즌에 업데이트 됨 [ 주의 ] PER, ROE 값들은 외부벤더사에서 제공되는 데이터이며 일주일에 한번 또는 실적발표 시즌에 업데이트 됨 Request Example { } "stk_cd": "005930" Response Example { } "stk_cd": "005930", "stk_nm": "삼성전자", "setl_mm": "12", "fav": "5000", "cap": "1311", "flo_stk": "25527", "crd_rt": "+0.08", "oyr_hgst": "+181400", "oyr_lwst": "-91200", "mac": "24352", "mac_wght": "", "for_exh_rt": "0.00", "repl_pric": "66780", "per": "", "eps": "", "roe": "", "pbr": "", "ev": "", "bps": "-75300", "sale_amt": "0", "bus_pro": "0", "cup_nga": "0", "250hgst": "+124000", "250lwst": "-66800", "high_pric": "95400", "open_pric": "-0", "low_pric": "0", "upl_pric": "20241016", "lst_pric": "-47.41", "base_pric": "20231024", "exp_cntr_pric": "+26.69", "exp_cntr_qty": "95400", "250hgst_pric_dt": "3", "250hgst_pric_pre_rt": "0", "250lwst_pric_dt": "0.00", "250lwst_pric_pre_rt": "0", "cur_prc": "0.00", "pre_sig": "", "pred_pre": "", "flu_rt": "0", "trde_qty": "0", "trde_pre": "0", "fav_unit": "0", "dstr_stk": "0", "dstr_rt": "0", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 17 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 주식거래원요청(ka10002) API 명 주식거래원요청 API ID ka10002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 20 Body stk_nm 종목명 String N 40 Body cur_prc 현재가 String N 20 Body flu_smbol 등락부호 String N 20 Body base_pric 기준가 String N 20 Body pred_pre 전일대비 String N 20 Body flu_rt 등락율 String N 20 Body sel_trde_ori_nm_1 매도거래원명1 String N 20 Body sel_trde_ori_1 매도거래원1 String N 20 Body sel_trde_qty_1 매도거래량1 String N 20 Body buy_trde_ori_nm_1 매수거래원명1 String N 20 18 / 528 Response 구분 Element 한글명 Type Require d Length Body buy_trde_ori_1 매수거래원1 String N 20 Body buy_trde_qty_1 매수거래량1 String N 20 Body sel_trde_ori_nm_2 매도거래원명2 String N 20 Body sel_trde_ori_2 매도거래원2 String N 20 Body sel_trde_qty_2 매도거래량2 String N 20 Body buy_trde_ori_nm_2 매수거래원명2 String N 20 Body buy_trde_ori_2 매수거래원2 String N 20 Body buy_trde_qty_2 매수거래량2 String N 20 Body sel_trde_ori_nm_3 매도거래원명3 String N 20 Body sel_trde_ori_3 매도거래원3 String N 20 Body sel_trde_qty_3 매도거래량3 String N 20 Body buy_trde_ori_nm_3 매수거래원명3 String N 20 Body buy_trde_ori_3 매수거래원3 String N 20 Body buy_trde_qty_3 매수거래량3 String N 20 Body sel_trde_ori_nm_4 매도거래원명4 String N 20 Body sel_trde_ori_4 매도거래원4 String N 20 Body sel_trde_qty_4 매도거래량4 String N 20 Body buy_trde_ori_nm_4 매수거래원명4 String N 20 Body buy_trde_ori_4 매수거래원4 String N 20 Body buy_trde_qty_4 매수거래량4 String N 20 Body sel_trde_ori_nm_5 매도거래원명5 String N 20 Body sel_trde_ori_5 매도거래원5 String N 20 Body sel_trde_qty_5 매도거래량5 String N 20 Body buy_trde_ori_nm_5 매수거래원명5 String N 20 Body buy_trde_ori_5 매수거래원5 String N 20 Body buy_trde_qty_5 매수거래량5 String N 20 Request Example { } "stk_cd": "005930" Response Example { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "95400", "flu_smbol": "3", "base_pric": "95400", "pred_pre": "0", "flu_rt": "0.00", "sel_trde_ori_nm_1": "", "sel_trde_ori_1": "000", "sel_trde_qty_1": "0", "buy_trde_ori_nm_1": "", "buy_trde_ori_1": "000", "buy_trde_qty_1": "0", 19 / 528 Description Response Example } "sel_trde_ori_nm_2": "", "sel_trde_ori_2": "000", "sel_trde_qty_2": "0", "buy_trde_ori_nm_2": "", "buy_trde_ori_2": "000", "buy_trde_qty_2": "0", "sel_trde_ori_nm_3": "", "sel_trde_ori_3": "000", "sel_trde_qty_3": "0", "buy_trde_ori_nm_3": "", "buy_trde_ori_3": "000", "buy_trde_qty_3": "0", "sel_trde_ori_nm_4": "", "sel_trde_ori_4": "000", "sel_trde_qty_4": "0", "buy_trde_ori_nm_4": "", "buy_trde_ori_4": "000", "buy_trde_qty_4": "0", "sel_trde_ori_nm_5": "", "sel_trde_ori_5": "000", "sel_trde_qty_5": "0", "buy_trde_ori_nm_5": "", "buy_trde_ori_5": "000", "buy_trde_qty_5": "0", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 20 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 체결정보요청(ka10003) API 명 체결정보요청 API ID ka10003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body cntr_infr 체결정보 LIST N Body - tm 시간 String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre 전일대비 String N 20 Body - pre_rt 대비율 String N 20 Body - pri_sel_bid_unit 우선매도호가단위 String N 20 Body - pri_buy_bid_unit 우선매수호가단위 String N 20 Body - cntr_trde_qty 체결거래량 String N 20 Body - sign sign String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - acc_trde_prica 누적거래대금 String N 20 21 / 528 Response 구분 Element 한글명 Type Require d Length Body - cntr_str 체결강도 String N 20 Body - stex_tp 거래소구분 String N 20 Request Example { } "stk_cd": "005930" Response Example { "cntr_infr": [ { "tm": "130429", "cur_prc": "+53500", "pred_pre": "+500", "pre_rt": "+0.94", "pri_sel_bid_unit": "+68900", "pri_buy_bid_unit": "+53500", "cntr_trde_qty": "1010", "sign": "2", "acc_trde_qty": "8735", "acc_trde_prica": "524269500", "cntr_str": "12.99", "stex_tp": "KRX" }, { "tm": "130153", "cur_prc": "+68900", "pred_pre": "+15900", "pre_rt": "+30.00", "pri_sel_bid_unit": "+68900", "pri_buy_bid_unit": "+55000", "cntr_trde_qty": "456", "sign": "1", "acc_trde_qty": "7725", "acc_trde_prica": "470234500", "cntr_str": "12.99", "stex_tp": "KRX" }, { "tm": "125947", "cur_prc": "+55000", "pred_pre": "+2000", "pre_rt": "+3.77", "pri_sel_bid_unit": "+68900", "pri_buy_bid_unit": "+55000", "cntr_trde_qty": "1000", "sign": "2", "acc_trde_qty": "7269", "acc_trde_prica": "438816100", "cntr_str": "12.99", "stex_tp": "KRX" }, { "tm": "125153", "cur_prc": "+68900", "pred_pre": "+15900", "pre_rt": "+30.00", "pri_sel_bid_unit": "+68900", "pri_buy_bid_unit": "+60100", "cntr_trde_qty": "2", "sign": "1", "acc_trde_qty": "6269", "acc_trde_prica": "383816100", "cntr_str": "12.99", "stex_tp": "KRX" }, { "tm": "124721", "cur_prc": "+68900", "pred_pre": "+15900", "pre_rt": "+30.00", "pri_sel_bid_unit": "+68900", 22 / 528 Description KRX , NXT , 통합 Response Example }, { } "pri_buy_bid_unit": "+60100", "cntr_trde_qty": "2", "sign": "1", "acc_trde_qty": "6267", "acc_trde_prica": "383678300", "cntr_str": "12.99", "stex_tp": "KRX" "tm": "124507", "cur_prc": "+67100", "pred_pre": "+14100", "pre_rt": "+26.60", "pri_sel_bid_unit": "+68900", "pri_buy_bid_unit": "+67500", "cntr_trde_qty": "-5", "sign": "2", "acc_trde_qty": "6265", "acc_trde_prica": "383540500", "cntr_str": "12.99", "stex_tp": "KRX" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 23 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 주식호가요청(ka10004) API 명 주식호가요청 API ID ka10004 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body bid_req_base_tm 호가잔량기준시간 String N 20 호가시간 Body sel_10th_pre_req_pre 매도10차선잔량대비 String N 20 매도호가직전대비10 Body sel_10th_pre_req 매도10차선잔량 String N 20 매도호가수량10 Body sel_10th_pre_bid 매도10차선호가 String N 20 매도호가10 Body sel_9th_pre_req_pre 매도9차선잔량대비 String N 20 매도호가직전대비9 Body sel_9th_pre_req 매도9차선잔량 String N 20 매도호가수량9 Body sel_9th_pre_bid 매도9차선호가 String N 20 매도호가9 Body sel_8th_pre_req_pre 매도8차선잔량대비 String N 20 매도호가직전대비8 Body sel_8th_pre_req 매도8차선잔량 String N 20 매도호가수량8 Body sel_8th_pre_bid 매도8차선호가 String N 20 매도호가8 Body sel_7th_pre_req_pre 매도7차선잔량대비 String N 20 매도호가직전대비7 24 / 528 Response 구분 Element 한글명 Type Require d Length Body sel_7th_pre_req 매도7차선잔량 String N 20 매도호가수량7 Body sel_7th_pre_bid 매도7차선호가 String N 20 매도호가7 Body sel_6th_pre_req_pre 매도6차선잔량대비 String N 20 매도호가직전대비6 Body sel_6th_pre_req 매도6차선잔량 String N 20 매도호가수량6 Body sel_6th_pre_bid 매도6차선호가 String N 20 매도호가6 Body sel_5th_pre_req_pre 매도5차선잔량대비 String N 20 매도호가직전대비5 Body sel_5th_pre_req 매도5차선잔량 String N 20 매도호가수량5 Body sel_5th_pre_bid 매도5차선호가 String N 20 매도호가5 Body sel_4th_pre_req_pre 매도4차선잔량대비 String N 20 매도호가직전대비4 Body sel_4th_pre_req 매도4차선잔량 String N 20 매도호가수량4 Body sel_4th_pre_bid 매도4차선호가 String N 20 매도호가4 Body sel_3th_pre_req_pre 매도3차선잔량대비 String N 20 매도호가직전대비3 Body sel_3th_pre_req 매도3차선잔량 String N 20 매도호가수량3 Body sel_3th_pre_bid 매도3차선호가 String N 20 매도호가3 Body sel_2th_pre_req_pre 매도2차선잔량대비 String N 20 매도호가직전대비2 Body sel_2th_pre_req 매도2차선잔량 String N 20 매도호가수량2 Body sel_2th_pre_bid 매도2차선호가 String N 20 매도호가2 Body sel_1th_pre_req_pre 매도1차선잔량대비 String N 20 매도호가직전대비1 Body sel_fpr_req 매도최우선잔량 String N 20 매도호가수량1 Body sel_fpr_bid 매도최우선호가 String N 20 매도호가1 Body buy_fpr_bid 매수최우선호가 String N 20 매수호가1 Body buy_fpr_req 매수최우선잔량 String N 20 매수호가수량1 Body buy_1th_pre_req_pre 매수1차선잔량대비 String N 20 매수호가직전대비1 Body buy_2th_pre_bid 매수2차선호가 String N 20 매수호가2 Body buy_2th_pre_req 매수2차선잔량 String N 20 매수호가수량2 Body buy_2th_pre_req_pre 매수2차선잔량대비 String N 20 매수호가직전대비2 Body buy_3th_pre_bid 매수3차선호가 String N 20 매수호가3 Body buy_3th_pre_req 매수3차선잔량 String N 20 매수호가수량3 Body buy_3th_pre_req_pre 매수3차선잔량대비 String N 20 매수호가직전대비3 Body buy_4th_pre_bid 매수4차선호가 String N 20 매수호가4 Body buy_4th_pre_req 매수4차선잔량 String N 20 매수호가수량4 Body buy_4th_pre_req_pre 매수4차선잔량대비 String N 20 매수호가직전대비4 Body buy_5th_pre_bid 매수5차선호가 String N 20 매수호가5 Body buy_5th_pre_req 매수5차선잔량 String N 20 매수호가수량5 Body buy_5th_pre_req_pre 매수5차선잔량대비 String N 20 매수호가직전대비5 Body buy_6th_pre_bid 매수6차선호가 String N 20 매수호가6 Body buy_6th_pre_req 매수6차선잔량 String N 20 매수호가수량6 25 / 528 Description Response 구분 Element 한글명 Type Require d Length Body buy_6th_pre_req_pre 매수6차선잔량대비 String N 20 매수호가직전대비6 Body buy_7th_pre_bid 매수7차선호가 String N 20 매수호가7 Body buy_7th_pre_req 매수7차선잔량 String N 20 매수호가수량7 Body buy_7th_pre_req_pre 매수7차선잔량대비 String N 20 매수호가직전대비7 Body buy_8th_pre_bid 매수8차선호가 String N 20 매수호가8 Body buy_8th_pre_req 매수8차선잔량 String N 20 매수호가수량8 Body buy_8th_pre_req_pre 매수8차선잔량대비 String N 20 매수호가직전대비8 Body buy_9th_pre_bid 매수9차선호가 String N 20 매수호가9 Body buy_9th_pre_req 매수9차선잔량 String N 20 매수호가수량9 Body buy_9th_pre_req_pre 매수9차선잔량대비 String N 20 매수호가직전대비9 Body buy_10th_pre_bid 매수10차선호가 String N 20 매수호가10 Body buy_10th_pre_req 매수10차선잔량 String N 20 매수호가수량10 Body buy_10th_pre_req_pr e 매수10차선잔량대비 String N 20 매수호가직전대비10 Body tot_sel_req_jub_pre 총매도잔량직전대비 String N 20 매도호가총잔량직전대비 Body tot_sel_req 총매도잔량 String N 20 매도호가총잔량 Body tot_buy_req 총매수잔량 String N 20 매수호가총잔량 Body tot_buy_req_jub_pre 총매수잔량직전대비 String N 20 매수호가총잔량직전대비 Body ovt_sel_req_pre 시간외매도잔량대비 String N 20 시간외 매도호가 총잔량 직전대비 Body ovt_sel_req 시간외매도잔량 String N 20 시간외 매도호가 총잔량 Body ovt_buy_req 시간외매수잔량 String N 20 시간외 매수호가 총잔량 Body ovt_buy_req_pre 시간외매수잔량대비 String N 20 시간외 매수호가 총잔량 직전대비 Request Example { } "stk_cd": "005930" Response Example { "bid_req_base_tm": "162000", "sel_10th_pre_req_pre": "0", "sel_10th_pre_req": "0", "sel_10th_pre_bid": "0", "sel_9th_pre_req_pre": "0", "sel_9th_pre_req": "0", "sel_9th_pre_bid": "0", "sel_8th_pre_req_pre": "0", "sel_8th_pre_req": "0", "sel_8th_pre_bid": "0", "sel_7th_pre_req_pre": "0", "sel_7th_pre_req": "0", "sel_7th_pre_bid": "0", "sel_6th_pre_req_pre": "0", "sel_6th_pre_req": "0", "sel_6th_pre_bid": "0", "sel_5th_pre_req_pre": "0", "sel_5th_pre_req": "0", "sel_5th_pre_bid": "0", "sel_4th_pre_req_pre": "0", "sel_4th_pre_req": "0", "sel_4th_pre_bid": "0", 26 / 528 Description Response Example } "sel_3th_pre_req_pre": "0", "sel_3th_pre_req": "0", "sel_3th_pre_bid": "0", "sel_2th_pre_req_pre": "0", "sel_2th_pre_req": "0", "sel_2th_pre_bid": "0", "sel_1th_pre_req_pre": "0", "sel_fpr_req": "0", "sel_fpr_bid": "0", "buy_fpr_bid": "0", "buy_fpr_req": "0", "buy_1th_pre_req_pre": "0", "buy_2th_pre_bid": "0", "buy_2th_pre_req": "0", "buy_2th_pre_req_pre": "0", "buy_3th_pre_bid": "0", "buy_3th_pre_req": "0", "buy_3th_pre_req_pre": "0", "buy_4th_pre_bid": "0", "buy_4th_pre_req": "0", "buy_4th_pre_req_pre": "0", "buy_5th_pre_bid": "0", "buy_5th_pre_req": "0", "buy_5th_pre_req_pre": "0", "buy_6th_pre_bid": "0", "buy_6th_pre_req": "0", "buy_6th_pre_req_pre": "0", "buy_7th_pre_bid": "0", "buy_7th_pre_req": "0", "buy_7th_pre_req_pre": "0", "buy_8th_pre_bid": "0", "buy_8th_pre_req": "0", "buy_8th_pre_req_pre": "0", "buy_9th_pre_bid": "0", "buy_9th_pre_req": "0", "buy_9th_pre_req_pre": "0", "buy_10th_pre_bid": "0", "buy_10th_pre_req": "0", "buy_10th_pre_req_pre": "0", "tot_sel_req_jub_pre": "0", "tot_sel_req": "0", "tot_buy_req": "0", "tot_buy_req_jub_pre": "0", "ovt_sel_req_pre": "0", "ovt_sel_req": "0", "ovt_buy_req": "0", "ovt_buy_req_pre": "0", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 27 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 주식일주월시분요청(ka10005) API 명 주식일주월시분요청 API ID ka10005 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_ddwkmm 주식일주월시분 LIST N Body - date 날짜 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - close_pric 종가 String N 20 Body - pre 대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Body - for_poss 외인보유 String N 20 28 / 528 Response 구분 Element 한글명 Type Require d Length Body - for_wght 외인비중 String N 20 Body - for_netprps 외인순매수 String N 20 Body - orgn_netprps 기관순매수 String N 20 Body - ind_netprps 개인순매수 String N 20 Body - crd_remn_rt 신용잔고율 String N 20 Body - frgn 외국계 String N 20 Body - prm 프로그램 String N 20 Request Example { } "stk_cd": "005930" Response Example { "stk_ddwkmm": [ { "date": "20241028", "open_pric": "95400", "high_pric": "95400", "low_pric": "95400", "close_pric": "95400", "pre": "0", "flu_rt": "0.00", "trde_qty": "0", "trde_prica": "0", "cntr_str": "0.00", "for_poss": "+26.07", "for_wght": "+26.07", "for_netprps": "0", "orgn_netprps": "", "ind_netprps": "", "frgn": "", "crd_remn_rt": "", "prm": "" }, { "date": "20241025", "open_pric": "95400", "high_pric": "95400", "low_pric": "95400", "close_pric": "95400", "pre": "", "flu_rt": "", "trde_qty": "0", "trde_prica": "", "cntr_str": "", "for_poss": "", "for_wght": "", "for_netprps": "", "orgn_netprps": "", "ind_netprps": "", "frgn": "", "crd_remn_rt": "", "prm": "" }, { "date": "20241024", "open_pric": "94300", "high_pric": "95400", "low_pric": "94300", "close_pric": "+95400", "pre": "", "flu_rt": "", "trde_qty": "70", "trde_prica": "", "cntr_str": "", 29 / 528 Description Response Example "for_poss": "", "for_wght": "", "for_netprps": "", "orgn_netprps": "", "ind_netprps": "", "frgn": "", "crd_remn_rt": "", "prm": "" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 30 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 주식시분요청(ka10006) API 명 주식시분요청 API ID ka10006 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body date 날짜 String N 20 Body open_pric 시가 String N 20 Body high_pric 고가 String N 20 Body low_pric 저가 String N 20 Body close_pric 종가 String N 20 Body pre 대비 String N 20 Body flu_rt 등락률 String N 20 Body trde_qty 거래량 String N 20 Body trde_prica 거래대금 String N 20 Body cntr_str 체결강도 String N 20 Request Example 31 / 528 Request Example { } "stk_cd": "005930" Response Example { } "date": "20241105", "open_pric": "0", "high_pric": "0", "low_pric": "0", "close_pric": "135300", "pre": "0", "flu_rt": "0.00", "trde_qty": "0", "trde_prica": "0", "cntr_str": "0.00", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 32 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 시세표성정보요청(ka10007) API 명 시세표성정보요청 API ID ka10007 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_nm 종목명 String N 40 Body stk_cd 종목코드 String N 6 Body date 날짜 String N 20 Body tm 시간 String N 20 Body pred_close_pric 전일종가 String N 20 Body pred_trde_qty 전일거래량 String N 20 Body upl_pric 상한가 String N 20 Body lst_pric 하한가 String N 20 Body pred_trde_prica 전일거래대금 String N 20 Body flo_stkcnt 상장주식수 String N 20 Body cur_prc 현재가 String N 20 33 / 528 Response 구분 Element 한글명 Type Require d Length Body smbol 부호 String N 20 Body flu_rt 등락률 String N 20 Body pred_rt 전일비 String N 20 Body open_pric 시가 String N 20 Body high_pric 고가 String N 20 Body low_pric 저가 String N 20 Body cntr_qty 체결량 String N 20 Body trde_qty 거래량 String N 20 Body trde_prica 거래대금 String N 20 Body exp_cntr_pric 예상체결가 String N 20 Body exp_cntr_qty 예상체결량 String N 20 Body exp_sel_pri_bid 예상매도우선호가 String N 20 Body exp_buy_pri_bid 예상매수우선호가 String N 20 Body trde_strt_dt 거래시작일 String N 20 Body exec_pric 행사가격 String N 20 Body hgst_pric 최고가 String N 20 Body lwst_pric 최저가 String N 20 Body hgst_pric_dt 최고가일 String N 20 Body lwst_pric_dt 최저가일 String N 20 Body sel_1bid 매도1호가 String N 20 Body sel_2bid 매도2호가 String N 20 Body sel_3bid 매도3호가 String N 20 Body sel_4bid 매도4호가 String N 20 Body sel_5bid 매도5호가 String N 20 Body sel_6bid 매도6호가 String N 20 Body sel_7bid 매도7호가 String N 20 Body sel_8bid 매도8호가 String N 20 Body sel_9bid 매도9호가 String N 20 Body sel_10bid 매도10호가 String N 20 Body buy_1bid 매수1호가 String N 20 Body buy_2bid 매수2호가 String N 20 Body buy_3bid 매수3호가 String N 20 Body buy_4bid 매수4호가 String N 20 Body buy_5bid 매수5호가 String N 20 Body buy_6bid 매수6호가 String N 20 Body buy_7bid 매수7호가 String N 20 Body buy_8bid 매수8호가 String N 20 34 / 528 Description Response 구분 Element 한글명 Type Require d Length Body buy_9bid 매수9호가 String N 20 Body buy_10bid 매수10호가 String N 20 Body sel_1bid_req 매도1호가잔량 String N 20 Body sel_2bid_req 매도2호가잔량 String N 20 Body sel_3bid_req 매도3호가잔량 String N 20 Body sel_4bid_req 매도4호가잔량 String N 20 Body sel_5bid_req 매도5호가잔량 String N 20 Body sel_6bid_req 매도6호가잔량 String N 20 Body sel_7bid_req 매도7호가잔량 String N 20 Body sel_8bid_req 매도8호가잔량 String N 20 Body sel_9bid_req 매도9호가잔량 String N 20 Body sel_10bid_req 매도10호가잔량 String N 20 Body buy_1bid_req 매수1호가잔량 String N 20 Body buy_2bid_req 매수2호가잔량 String N 20 Body buy_3bid_req 매수3호가잔량 String N 20 Body buy_4bid_req 매수4호가잔량 String N 20 Body buy_5bid_req 매수5호가잔량 String N 20 Body buy_6bid_req 매수6호가잔량 String N 20 Body buy_7bid_req 매수7호가잔량 String N 20 Body buy_8bid_req 매수8호가잔량 String N 20 Body buy_9bid_req 매수9호가잔량 String N 20 Body buy_10bid_req 매수10호가잔량 String N 20 Body sel_1bid_jub_pre 매도1호가직전대비 String N 20 Body sel_2bid_jub_pre 매도2호가직전대비 String N 20 Body sel_3bid_jub_pre 매도3호가직전대비 String N 20 Body sel_4bid_jub_pre 매도4호가직전대비 String N 20 Body sel_5bid_jub_pre 매도5호가직전대비 String N 20 Body sel_6bid_jub_pre 매도6호가직전대비 String N 20 Body sel_7bid_jub_pre 매도7호가직전대비 String N 20 Body sel_8bid_jub_pre 매도8호가직전대비 String N 20 Body sel_9bid_jub_pre 매도9호가직전대비 String N 20 Body sel_10bid_jub_pre 매도10호가직전대비 String N 20 Body buy_1bid_jub_pre 매수1호가직전대비 String N 20 Body buy_2bid_jub_pre 매수2호가직전대비 String N 20 Body buy_3bid_jub_pre 매수3호가직전대비 String N 20 Body buy_4bid_jub_pre 매수4호가직전대비 String N 20 Body buy_5bid_jub_pre 매수5호가직전대비 String N 20 35 / 528 Description Response 구분 Element 한글명 Type Require d Length Body buy_6bid_jub_pre 매수6호가직전대비 String N 20 Body buy_7bid_jub_pre 매수7호가직전대비 String N 20 Body buy_8bid_jub_pre 매수8호가직전대비 String N 20 Body buy_9bid_jub_pre 매수9호가직전대비 String N 20 Body buy_10bid_jub_pre 매수10호가직전대비 String N 20 Body sel_1bid_cnt 매도1호가건수 String N 20 Body sel_2bid_cnt 매도2호가건수 String N 20 Body sel_3bid_cnt 매도3호가건수 String N 20 Body sel_4bid_cnt 매도4호가건수 String N 20 Body sel_5bid_cnt 매도5호가건수 String N 20 Body buy_1bid_cnt 매수1호가건수 String N 20 Body buy_2bid_cnt 매수2호가건수 String N 20 Body buy_3bid_cnt 매수3호가건수 String N 20 Body buy_4bid_cnt 매수4호가건수 String N 20 Body buy_5bid_cnt 매수5호가건수 String N 20 Body lpsel_1bid_req LP매도1호가잔량 String N 20 Body lpsel_2bid_req LP매도2호가잔량 String N 20 Body lpsel_3bid_req LP매도3호가잔량 String N 20 Body lpsel_4bid_req LP매도4호가잔량 String N 20 Body lpsel_5bid_req LP매도5호가잔량 String N 20 Body lpsel_6bid_req LP매도6호가잔량 String N 20 Body lpsel_7bid_req LP매도7호가잔량 String N 20 Body lpsel_8bid_req LP매도8호가잔량 String N 20 Body lpsel_9bid_req LP매도9호가잔량 String N 20 Body lpsel_10bid_req LP매도10호가잔량 String N 20 Body lpbuy_1bid_req LP매수1호가잔량 String N 20 Body lpbuy_2bid_req LP매수2호가잔량 String N 20 Body lpbuy_3bid_req LP매수3호가잔량 String N 20 Body lpbuy_4bid_req LP매수4호가잔량 String N 20 Body lpbuy_5bid_req LP매수5호가잔량 String N 20 Body lpbuy_6bid_req LP매수6호가잔량 String N 20 Body lpbuy_7bid_req LP매수7호가잔량 String N 20 Body lpbuy_8bid_req LP매수8호가잔량 String N 20 Body lpbuy_9bid_req LP매수9호가잔량 String N 20 Body lpbuy_10bid_req LP매수10호가잔량 String N 20 Body tot_buy_req 총매수잔량 String N 20 Body tot_sel_req 총매도잔량 String N 20 36 / 528 Description Response 구분 Element 한글명 Type Require d Length Body tot_buy_cnt 총매수건수 String N 20 Body tot_sel_cnt 총매도건수 String N 20 Request Example { } "stk_cd": "005930" Response Example { "stk_nm": "삼성전자", "stk_cd": "005930", "date": "20241105", "tm": "104000", "pred_close_pric": "135300", "pred_trde_qty": "88862", "upl_pric": "+175800", "lst_pric": "-94800", "pred_trde_prica": "11963", "flo_stkcnt": "25527", "cur_prc": "135300", "smbol": "3", "flu_rt": "0.00", "pred_rt": "0.00", "open_pric": "0", "high_pric": "0", "low_pric": "0", "cntr_qty": "", "trde_qty": "0", "trde_prica": "0", "exp_cntr_pric": "-0", "exp_cntr_qty": "0", "exp_sel_pri_bid": "0", "exp_buy_pri_bid": "0", "trde_strt_dt": "00000000", "exec_pric": "0", "hgst_pric": "", "lwst_pric": "", "hgst_pric_dt": "", "lwst_pric_dt": "", "sel_1bid": "0", "sel_2bid": "0", "sel_3bid": "0", "sel_4bid": "0", "sel_5bid": "0", "sel_6bid": "0", "sel_7bid": "0", "sel_8bid": "0", "sel_9bid": "0", "sel_10bid": "0", "buy_1bid": "0", "buy_2bid": "0", "buy_3bid": "0", "buy_4bid": "0", "buy_5bid": "0", "buy_6bid": "0", "buy_7bid": "0", "buy_8bid": "0", "buy_9bid": "0", "buy_10bid": "0", "sel_1bid_req": "0", "sel_2bid_req": "0", "sel_3bid_req": "0", "sel_4bid_req": "0", "sel_5bid_req": "0", "sel_6bid_req": "0", "sel_7bid_req": "0", "sel_8bid_req": "0", "sel_9bid_req": "0", "sel_10bid_req": "0", "buy_1bid_req": "0", "buy_2bid_req": "0", "buy_3bid_req": "0", 37 / 528 Description Response Example } "buy_4bid_req": "0", "buy_5bid_req": "0", "buy_6bid_req": "0", "buy_7bid_req": "0", "buy_8bid_req": "0", "buy_9bid_req": "0", "buy_10bid_req": "0", "sel_1bid_jub_pre": "0", "sel_2bid_jub_pre": "0", "sel_3bid_jub_pre": "0", "sel_4bid_jub_pre": "0", "sel_5bid_jub_pre": "0", "sel_6bid_jub_pre": "0", "sel_7bid_jub_pre": "0", "sel_8bid_jub_pre": "0", "sel_9bid_jub_pre": "0", "sel_10bid_jub_pre": "0", "buy_1bid_jub_pre": "0", "buy_2bid_jub_pre": "0", "buy_3bid_jub_pre": "0", "buy_4bid_jub_pre": "0", "buy_5bid_jub_pre": "0", "buy_6bid_jub_pre": "0", "buy_7bid_jub_pre": "0", "buy_8bid_jub_pre": "0", "buy_9bid_jub_pre": "0", "buy_10bid_jub_pre": "0", "sel_1bid_cnt": "", "sel_2bid_cnt": "", "sel_3bid_cnt": "", "sel_4bid_cnt": "", "sel_5bid_cnt": "", "buy_1bid_cnt": "", "buy_2bid_cnt": "", "buy_3bid_cnt": "", "buy_4bid_cnt": "", "buy_5bid_cnt": "", "lpsel_1bid_req": "0", "lpsel_2bid_req": "0", "lpsel_3bid_req": "0", "lpsel_4bid_req": "0", "lpsel_5bid_req": "0", "lpsel_6bid_req": "0", "lpsel_7bid_req": "0", "lpsel_8bid_req": "0", "lpsel_9bid_req": "0", "lpsel_10bid_req": "0", "lpbuy_1bid_req": "0", "lpbuy_2bid_req": "0", "lpbuy_3bid_req": "0", "lpbuy_4bid_req": "0", "lpbuy_5bid_req": "0", "lpbuy_6bid_req": "0", "lpbuy_7bid_req": "0", "lpbuy_8bid_req": "0", "lpbuy_9bid_req": "0", "lpbuy_10bid_req": "0", "tot_buy_req": "0", "tot_sel_req": "0", "tot_buy_cnt": "", "tot_sel_cnt": "0", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 38 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 기관/외국인 > 주식외국인종목별매매동향(ka10008) API 명 주식외국인종목별매매동향 API ID ka10008 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/frgnistt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_frgnr 주식외국인 LIST N Body - dt 일자 String N 20 Body - close_pric 종가 String N 20 Body - pred_pre 전일대비 String N 20 Body - trde_qty 거래량 String N 20 Body - chg_qty 변동수량 String N 20 Body - poss_stkcnt 보유주식수 String N 20 Body - wght 비중 String N 20 Body - gain_pos_stkcnt 취득가능주식수 String N 20 Body - frgnr_limit 외국인한도 String N 20 Body - frgnr_limit_irds 외국인한도증감 String N 20 39 / 528 Response 구분 Element Body - limit_exh_rt 한글명 한도소진률 Type Require d Length String N 20 Request Example { } "stk_cd": "005930" Response Example { "stk_frgnr": [ { "dt": "20241105", "close_pric": "135300", "pred_pre": "0", "trde_qty": "0", "chg_qty": "0", "poss_stkcnt": "6663509", "wght": "+26.10", "gain_pos_stkcnt": "18863197", "frgnr_limit": "25526706", "frgnr_limit_irds": "0", "limit_exh_rt": "+26.10" }, { "dt": "20241101", "close_pric": "65100", "pred_pre": "0", "trde_qty": "0", "chg_qty": "-3441", "poss_stkcnt": "6642402", "wght": "+26.02", "gain_pos_stkcnt": "18884304", "frgnr_limit": "25526706", "frgnr_limit_irds": "0", "limit_exh_rt": "+26.02" }, { "dt": "20241031", "close_pric": "65100", "pred_pre": "0", "trde_qty": "0", "chg_qty": "4627", "poss_stkcnt": "6645843", "wght": "+26.03", "gain_pos_stkcnt": "18880863", "frgnr_limit": "25526706", "frgnr_limit_irds": "0", "limit_exh_rt": "+26.03" }, { "dt": "20241030", "close_pric": "+65100", "pred_pre": "+100", "trde_qty": "1", "chg_qty": "-10245", "poss_stkcnt": "6641216", "wght": "+26.02", "gain_pos_stkcnt": "18885490", "frgnr_limit": "25526706", "frgnr_limit_irds": "0", "limit_exh_rt": "+26.02" }, { "dt": "20241029", "close_pric": "-65000", "pred_pre": "-27300", "trde_qty": "4", "chg_qty": "249", "poss_stkcnt": "6651461", "wght": "+26.06", "gain_pos_stkcnt": "18875245", "frgnr_limit": "25526706", "frgnr_limit_irds": "0", "limit_exh_rt": "+26.06" 40 / 528 Description Response Example } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 41 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 기관/외국인 > 주식기관요청(ka10009) API 명 주식기관요청 API ID ka10009 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/frgnistt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body date 날짜 String N 20 Body close_pric 종가 String N 20 Body pre 대비 String N 20 Body orgn_dt_acc 기관기간누적 String N 20 Body orgn_daly_nettrde 기관일별순매매 String N 20 Body frgnr_daly_nettrde 외국인일별순매매 String N 20 Body frgnr_qota_rt 외국인지분율 String N 20 Request Example { } Description "stk_cd": "005930" Response Example 42 / 528 Response Example { } "date": "20241105", "close_pric": "135300", "pre": "0", "orgn_dt_acc": "", "orgn_daly_nettrde": "", "frgnr_daly_nettrde": "", "frgnr_qota_rt": "", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 43 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 업종 > 업종프로그램요청(ka10010) API 명 업종프로그램요청 API ID ka10010 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/sect Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dfrt_trst_sell_qty 차익위탁매도수량 String N 20 Body dfrt_trst_sell_amt 차익위탁매도금액 String N 20 Body dfrt_trst_buy_qty 차익위탁매수수량 String N 20 Body dfrt_trst_buy_amt 차익위탁매수금액 String N 20 Body dfrt_trst_netprps_qty 차익위탁순매수수량 String N 20 Body dfrt_trst_netprps_am t 차익위탁순매수금액 String N 20 Body ndiffpro_trst_sell_qty 비차익위탁매도수량 String N 20 Body ndiffpro_trst_sell_am t 비차익위탁매도금액 String N 20 Body ndiffpro_trst_buy_qty 비차익위탁매수수량 String N 20 Body ndiffpro_trst_buy_am 비차익위탁매수금액 String N 20 44 / 528 Response Element 한글명 Type Require d Length Body ndiffpro_trst_netprps _qty 비차익위탁순매수수 량 String N 20 Body ndiffpro_trst_netprps _amt 비차익위탁순매수금 액 String N 20 Body all_dfrt_trst_sell_qty 전체차익위탁매도수 량 String N 20 Body all_dfrt_trst_sell_amt 전체차익위탁매도금 액 String N 20 Body all_dfrt_trst_buy_qty 전체차익위탁매수수 량 String N 20 Body all_dfrt_trst_buy_amt 전체차익위탁매수금 액 String N 20 Body all_dfrt_trst_netprps_ qty 전체차익위탁순매수 수량 String N 20 Body all_dfrt_trst_netprps_ amt 전체차익위탁순매수 금액 String N 20 구분 t Request Example { } "stk_cd": "005930" Response Example { } "dfrt_trst_sell_qty": "", "dfrt_trst_sell_amt": "", "dfrt_trst_buy_qty": "", "dfrt_trst_buy_amt": "", "dfrt_trst_netprps_qty": "", "dfrt_trst_netprps_amt": "", "ndiffpro_trst_sell_qty": "", "ndiffpro_trst_sell_amt": "", "ndiffpro_trst_buy_qty": "", "ndiffpro_trst_buy_amt": "", "ndiffpro_trst_netprps_qty": "", "ndiffpro_trst_netprps_amt": "", "all_dfrt_trst_sell_qty": "40242", "all_dfrt_trst_sell_amt": "", "all_dfrt_trst_buy_qty": "69219", "all_dfrt_trst_buy_amt": "", "all_dfrt_trst_netprps_qty": "346871946", "all_dfrt_trst_netprps_amt": "", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 45 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 신주인수권전체시세요청(ka10011) API 명 신주인수권전체시세요청 API ID ka10011 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body newstk_recvrht_tp 신주인수권구분 String Y 2 00:전체, 05:신주인수권증권, 07:신주인수권증서 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body newstk_recvrht_mrpr 신주인수권시세 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - fpr_sel_bid 최우선매도호가 String N 20 Body - fpr_buy_bid 최우선매수호가 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - open_pric 시가 String N 20 46 / 528 Response 구분 Element 한글명 Type Require d Length Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Request Example { } "newstk_recvrht_tp": "00" Response Example { } "newstk_recvrht_mrpr": [ { "stk_cd": "J0036221D", "stk_nm": "KG모빌리티 122WR", "cur_prc": "988", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "fpr_sel_bid": "-0", "fpr_buy_bid": "-0", "acc_trde_qty": "0", "open_pric": "-0", "high_pric": "-0", "low_pric": "-0" }, { "stk_cd": "J00532219", "stk_nm": "온타이드 9WR", "cur_prc": "12", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "fpr_sel_bid": "-0", "fpr_buy_bid": "-0", "acc_trde_qty": "0", "open_pric": "-0", "high_pric": "-0", "low_pric": "-0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 47 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 신용매매동향요청(ka10013) API 명 신용매매동향요청 API ID ka10013 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body dt 일자 String Y 8 YYYYMMDD Body qry_tp 조회구분 String Y 1 1:융자, 2:대주 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body crd_trde_trend 신용매매동향 LIST N Body - dt 일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - trde_qty 거래량 String N 20 Body - new 신규 String N 20 Body - rpya 상환 String N 20 Body - remn 잔고 String N 20 48 / 528 Response 구분 Element 한글명 Type Require d Length Body - amt 금액 String N 20 Body - pre 대비 String N 20 Body - shr_rt 공여율 String N 20 Body - remn_rt 잔고율 String N 20 Request Example { } "stk_cd": "005930", "dt": "20241104", "qry_tp": "1" Response Example { "crd_trde_trend": [ { "dt": "20241101", "cur_prc": "65100", "pred_pre_sig": "0", "pred_pre": "0", "trde_qty": "0", "new": "", "rpya": "", "remn": "", "amt": "", "pre": "", "shr_rt": "", "remn_rt": "" }, { "dt": "20241031", "cur_prc": "65100", "pred_pre_sig": "0", "pred_pre": "0", "trde_qty": "0", "new": "", "rpya": "", "remn": "", "amt": "", "pre": "", "shr_rt": "", "remn_rt": "" }, { "dt": "20241030", "cur_prc": "+65100", "pred_pre_sig": "2", "pred_pre": "+100", "trde_qty": "1", "new": "", "rpya": "", "remn": "", "amt": "", "pre": "", "shr_rt": "", "remn_rt": "" }, { "dt": "20241029", "cur_prc": "-65000", "pred_pre_sig": "5", "pred_pre": "-27300", "trde_qty": "4", "new": "", "rpya": "", "remn": "", "amt": "", "pre": "", "shr_rt": "", "remn_rt": "" 49 / 528 Description Response Example } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 50 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 공매도 > 공매도추이요청(ka10014) API 명 공매도추이요청 API ID ka10014 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/shsa Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body tm_tp 시간구분 String N 1 0:시작일, 1:기간 Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body shrts_trnsn 공매도추이 LIST N Body - dt 일자 String N 20 Body - close_pric 종가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - shrts_qty 공매도량 String N 20 51 / 528 Response 구분 Element 한글명 Type Require d Length Body - ovr_shrts_qty 누적공매도량 String N 20 Body - trde_wght 매매비중 String N 20 Body - shrts_trde_prica 공매도거래대금 String N 20 Body - shrts_avg_pric 공매도평균가 String N 20 Request Example { } "stk_cd": "005930", "tm_tp": "1", "strt_dt": "20250501", "end_dt": "20250519" Response Example { "shrts_trnsn": [ { "dt": "20250519", "close_pric": "-55800", "pred_pre_sig": "5", "pred_pre": "-1000", "flu_rt": "-1.76", "trde_qty": "9802105", "shrts_qty": "841407", "ovr_shrts_qty": "6424755", "trde_wght": "+8.58", "shrts_trde_prica": "46985302", "shrts_avg_pric": "55841" }, { "dt": "20250516", "close_pric": "-56800", "pred_pre_sig": "5", "pred_pre": "-500", "flu_rt": "-0.87", "trde_qty": "10385352", "shrts_qty": "487354", "ovr_shrts_qty": "5583348", "trde_wght": "+4.69", "shrts_trde_prica": "27725268", "shrts_avg_pric": "56889" }, { "dt": "20250515", "close_pric": "-57300", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.17", "trde_qty": "13139736", "shrts_qty": "404120", "ovr_shrts_qty": "5095994", "trde_wght": "+3.08", "shrts_trde_prica": "23278677", "shrts_avg_pric": "57603" }, { "dt": "20250514", "close_pric": "+57400", "pred_pre_sig": "2", "pred_pre": "+500", "flu_rt": "+0.88", "trde_qty": "12468089", "shrts_qty": "607315", "ovr_shrts_qty": "4691874", "trde_wght": "+4.87", "shrts_trde_prica": "34862170", "shrts_avg_pric": "57404" }, ], "return_code": 0, 52 / 528 Description 설정 기간의 공매도량 합산데이터 Response Example } "return_msg": "정상적으로 처리되었습니다" 53 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 일별거래상세요청(ka10015) API 명 일별거래상세요청 API ID ka10015 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body strt_dt 시작일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body daly_trde_dtl 일별거래상세 LIST N Body - dt 일자 String N 20 Body - close_pric 종가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Body - bf_mkrt_trde_qty 장전거래량 String N 20 Body - bf_mkrt_trde_wght 장전거래비중 String N 20 54 / 528 Response 구분 Element 한글명 Type Require d Length Body - opmr_trde_qty 장중거래량 String N 20 Body - opmr_trde_wght 장중거래비중 String N 20 Body - af_mkrt_trde_qty 장후거래량 String N 20 Body - af_mkrt_trde_wght 장후거래비중 String N 20 Body - tot_3 합계3 String N 20 Body - prid_trde_qty 기간중거래량 String N 20 Body - cntr_str 체결강도 String N 20 Body - for_poss 외인보유 String N 20 Body - for_wght 외인비중 String N 20 Body - for_netprps 외인순매수 String N 20 Body - orgn_netprps 기관순매수 String N 20 Body - ind_netprps 개인순매수 String N 20 Body - frgn 외국계 String N 20 Body - crd_remn_rt 신용잔고율 String N 20 Body - prm 프로그램 String N 20 Body - bf_mkrt_trde_prica 장전거래대금 String N 20 Body - bf_mkrt_trde_prica_ wght 장전거래대금비중 String N 20 Body - opmr_trde_prica 장중거래대금 String N 20 Body - opmr_trde_prica_w ght 장중거래대금비중 String N 20 Body - af_mkrt_trde_prica 장후거래대금 String N 20 Body - af_mkrt_trde_prica_ wght 장후거래대금비중 String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241105" Response Example { "daly_trde_dtl": [ { "dt": "20241105", "close_pric": "135300", "pred_pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "trde_prica": "0", "bf_mkrt_trde_qty": "", "bf_mkrt_trde_wght": "", "opmr_trde_qty": "", "opmr_trde_wght": "", "af_mkrt_trde_qty": "", "af_mkrt_trde_wght": "", "tot_3": "0", "prid_trde_qty": "0", "cntr_str": "", "for_poss": "", 55 / 528 Description Response Example }, { }, { ], } "for_wght": "", "for_netprps": "", "orgn_netprps": "", "ind_netprps": "", "frgn": "", "crd_remn_rt": "", "prm": "", "bf_mkrt_trde_prica": "", "bf_mkrt_trde_prica_wght": "", "opmr_trde_prica": "", "opmr_trde_prica_wght": "", "af_mkrt_trde_prica": "", "af_mkrt_trde_prica_wght": "" "dt": "20241101", "close_pric": "65100", "pred_pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "trde_prica": "0", "bf_mkrt_trde_qty": "", "bf_mkrt_trde_wght": "", "opmr_trde_qty": "", "opmr_trde_wght": "", "af_mkrt_trde_qty": "", "af_mkrt_trde_wght": "", "tot_3": "0", "prid_trde_qty": "0", "cntr_str": "", "for_poss": "", "for_wght": "", "for_netprps": "", "orgn_netprps": "", "ind_netprps": "", "frgn": "", "crd_remn_rt": "", "prm": "", "bf_mkrt_trde_prica": "", "bf_mkrt_trde_prica_wght": "", "opmr_trde_prica": "", "opmr_trde_prica_wght": "", "af_mkrt_trde_prica": "", "af_mkrt_trde_prica_wght": "" "dt": "20241031", "close_pric": "65100", "pred_pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "trde_prica": "0", "bf_mkrt_trde_qty": "", "bf_mkrt_trde_wght": "", "opmr_trde_qty": "", "opmr_trde_wght": "", "af_mkrt_trde_qty": "", "af_mkrt_trde_wght": "", "tot_3": "0", "prid_trde_qty": "0", "cntr_str": "", "for_poss": "", "for_wght": "", "for_netprps": "", "orgn_netprps": "", "ind_netprps": "", "frgn": "", "crd_remn_rt": "", "prm": "", "bf_mkrt_trde_prica": "", "bf_mkrt_trde_prica_wght": "", "opmr_trde_prica": "", "opmr_trde_prica_wght": "", "af_mkrt_trde_prica": "", "af_mkrt_trde_prica_wght": "" 56 / 528 Response Example } "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 57 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 신고저가요청(ka10016) API 명 신고저가요청 API ID ka10016 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body ntl_tp 신고저구분 String Y 1 1:신고가,2:신저가 Body high_low_close_tp 고저종구분 String Y 1 1:고저기준, 2:종가기준 Body stk_cnd 종목조건 String Y 1 0:전체조회,1:관리종목제외, 3:우선주제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기 Body trde_qty_tp 거래량구분 String Y 5 00000:전체조회, 00010:만주이상, 00050:5만주이상, 00100:10만주이상, 00150:15만주이상, 00200:20만주이상, 00300:30만주이상, 00500:50만주이상, 01000:백만주이상 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body updown_incls 상하한포함 String Y 1 0:미포함, 1:포함 Body dt 기간 String Y 3 5:5일, 10:10일, 20:20일, 60:60일, 250:250일, 250일까지 입력가능 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ntl_pric 신고저가 LIST N 58 / 528 Response 구분 Element 한글명 Type Require d Length Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 Body pred_trde_qty_pre_rt 전일거래량대비율 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Request Example { } "mrkt_tp": "000", "ntl_tp": "1", "high_low_close_tp": "1", "stk_cnd": "0", "trde_qty_tp": "00000", "crd_cnd": "0", "updown_incls": "0", "dt": "5", "stex_tp": "1" Response Example { "ntl_pric": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "334", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "3", "pred_trde_qty_pre_rt": "-0.00", "sel_bid": "0", "buy_bid": "0", "high_pric": "334", "low_pric": "320" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-6230", "pred_pre_sig": "5", "pred_pre": "-60", "flu_rt": "-0.95", "trde_qty": "77", "pred_trde_qty_pre_rt": "-6.16", "sel_bid": "+6300", "buy_bid": "-6270", "high_pric": "6340", "low_pric": "6150" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-140000", 59 / 528 Description Response Example }, { }, { }, { }, { } "pred_pre_sig": "5", "pred_pre": "-800", "flu_rt": "-0.57", "trde_qty": "7", "pred_trde_qty_pre_rt": "-0.00", "sel_bid": "-140000", "buy_bid": "0", "high_pric": "140800", "low_pric": "70000" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+214000", "pred_pre_sig": "2", "pred_pre": "+20900", "flu_rt": "+10.82", "trde_qty": "45", "pred_trde_qty_pre_rt": "-0.05", "sel_bid": "0", "buy_bid": "+214000", "high_pric": "214000", "low_pric": "89800" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-89000", "pred_pre_sig": "5", "pred_pre": "-8400", "flu_rt": "-8.62", "trde_qty": "130", "pred_trde_qty_pre_rt": "-0.01", "sel_bid": "0", "buy_bid": "-89000", "high_pric": "97500", "low_pric": "58800" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+40300", "pred_pre_sig": "2", "pred_pre": "+1150", "flu_rt": "+2.94", "trde_qty": "86", "pred_trde_qty_pre_rt": "-0.13", "sel_bid": "+40550", "buy_bid": "+40300", "high_pric": "40300", "low_pric": "14000" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-190000", "pred_pre_sig": "5", "pred_pre": "-4000", "flu_rt": "-2.06", "trde_qty": "137", "pred_trde_qty_pre_rt": "-0.00", "sel_bid": "0", "buy_bid": "-182000", "high_pric": "195000", "low_pric": "67300" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 60 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 상하한가요청(ka10017) API 명 상하한가요청 API ID ka10017 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body updown_tp 상하한구분 String Y 1 1:상한, 2:상승, 3:보합, 4: 하한, 5:하락, 6:전일상한, 7:전일하한 Body sort_tp 정렬구분 String Y 1 1:종목코드순, 2:연속횟수순(상위100개), 3:등락률순 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body stk_cnd 종목조건 String Y 1 0:전체조회,1:관리종목제외, 3:우선주제외, 4:우선주+관리종목제외, 5:증100제외, 6:증100만 보기, 7:증40만 보기, 8:증30만 보기, 9:증20만 보기, 10:우선주+관리종목+환기종목제외 Body trde_qty_tp 거래량구분 String Y 5 00000:전체조회, 00010:만주이상, 00050:5만주이상, 00100:10만주이상, 00150:15만주이상, 00200:20만주이상, 00300:30만주이상, 00500:50만주이상, 01000:백만주이상 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body trde_gold_tp 매매금구분 String Y 1 0:전체조회, 1:1천원미만, 2:1천원~2천원, 3:2천원~3천원, 4:5천원~1만원, 5:1만원이상, 8:1천원이상 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body updown_pric 상하한가 LIST N 61 / 528 Response 구분 Element 한글명 Type Require d Length Body - stk_cd 종목코드 String N 20 Body - stk_infr 종목정보 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 Body - pred_trde_qty 전일거래량 String N 20 Body - sel_req 매도잔량 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - buy_req 매수잔량 String N 20 Body - cnt 횟수 String N 20 Request Example { } "mrkt_tp": "000", "updown_tp": "1", "sort_tp": "1", "stk_cnd": "0", "trde_qty_tp": "0000", "crd_cnd": "0", "trde_gold_tp": "0", "stex_tp": "1" Response Example { "updown_pric": [ { "stk_cd": "005930", "stk_infr": "", "stk_nm": "삼성전자", "cur_prc": "+235500", "pred_pre_sig": "1", "pred_pre": "+54200", "flu_rt": "+29.90", "trde_qty": "0", "pred_trde_qty": "96197", "sel_req": "0", "sel_bid": "0", "buy_bid": "+235500", "buy_req": "4", "cnt": "1" }, { "stk_cd": "005930", "stk_infr": "", "stk_nm": "삼성전자", "cur_prc": "+13715", "pred_pre_sig": "1", "pred_pre": "+3165", "flu_rt": "+30.00", "trde_qty": "0", "pred_trde_qty": "929670", "sel_req": "0", "sel_bid": "0", "buy_bid": "+13715", "buy_req": "4", 62 / 528 Description Response Example } } "cnt": "1" ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 63 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 고저가근접요청(ka10018) API 명 고저가근접요청 API ID ka10018 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body high_low_tp 고저구분 String Y 1 1:고가, 2:저가 Body alacc_rt 근접율 String Y 2 05:0.5 10:1.0, 15:1.5, 20:2.0. 25:2.5, 30:3.0 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body trde_qty_tp 거래량구분 String Y 5 00000:전체조회, 00010:만주이상, 00050:5만주이상, 00100:10만주이상, 00150:15만주이상, 00200:20만주이상, 00300:30만주이상, 00500:50만주이상, 01000:백만주이상 Body stk_cnd 종목조건 String Y 1 0:전체조회,1:관리종목제외, 3:우선주제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body high_low_pric_alacc 고저가근접 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 64 / 528 Response 구분 Element 한글명 Type Require d Length Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - tdy_high_pric 당일고가 String N 20 Body - tdy_low_pric 당일저가 String N 20 Request Example { } "high_low_tp": "1", "alacc_rt": "05", "mrkt_tp": "000", "trde_qty_tp": "0000", "stk_cnd": "0", "crd_cnd": "0", "stex_tp": "1" Response Example { "high_low_pric_alacc": [ { "stk_cd": "004930", "stk_nm": "삼성전자", "cur_prc": "334", "pred_pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "3", "sel_bid": "0", "buy_bid": "0", "tdy_high_pric": "334", "tdy_low_pric": "334" }, { "stk_cd": "004930", "stk_nm": "삼성전자", "cur_prc": "+7470", "pred_pre_sig": "2", "pred_pre": "+90", "flu_rt": "+1.22", "trde_qty": "2", "sel_bid": "0", "buy_bid": "-7320", "tdy_high_pric": "+7470", "tdy_low_pric": "+7470" }, { "stk_cd": "004930", "stk_nm": "삼성전자", "cur_prc": "+214000", "pred_pre_sig": "60", "pred_pre": "+20900", "flu_rt": "+10.82", "trde_qty": "45", "sel_bid": "0", "buy_bid": "+214000", "tdy_high_pric": "+214000", "tdy_low_pric": "193100" }, { "stk_cd": "004930", 65 / 528 Description Response Example }, { }, { } "stk_nm": "삼성전자", "cur_prc": "+40300", "pred_pre_sig": "114", "pred_pre": "+1150", "flu_rt": "+2.94", "trde_qty": "86", "sel_bid": "+40550", "buy_bid": "+40300", "tdy_high_pric": "+40300", "tdy_low_pric": "39150" "stk_cd": "004930", "stk_nm": "삼성전자", "cur_prc": "-10060", "pred_pre_sig": "0", "pred_pre": "-1790", "flu_rt": "-15.11", "trde_qty": "1", "sel_bid": "-10060", "buy_bid": "0", "tdy_high_pric": "-10060", "tdy_low_pric": "-10060" "stk_cd": "008370", "stk_nm": "원풍", "cur_prc": "+4970", "pred_pre_sig": "0", "pred_pre": "+15", "flu_rt": "+0.30", "trde_qty": "500", "sel_bid": "0", "buy_bid": "0", "tdy_high_pric": "+4970", "tdy_low_pric": "+4970" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 66 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 가격급등락요청(ka10019) API 명 가격급등락요청 API ID ka10019 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥, 201:코스피200 Body flu_tp 등락구분 String Y 1 1:급등, 2:급락 Body tm_tp 시간구분 String Y 1 1:분전, 2:일전 Body tm 시간 String Y 2 분 혹은 일입력 Body trde_qty_tp 거래량구분 String Y 4 00000:전체조회, 00010:만주이상, 00050:5만주이상, 00100:10만주이상, 00150:15만주이상, 00200:20만주이상, 00300:30만주이상, 00500:50만주이상, 01000:백만주이상 Body stk_cnd 종목조건 String Y 1 0:전체조회,1:관리종목제외, 3:우선주제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body pric_cnd 가격조건 String Y 1 0:전체조회, 1:1천원미만, 2:1천원~2천원, 3:2천원~3천원, 4:5천원~1만원, 5:1만원이상, 8:1천원이상 Body updown_incls 상하한포함 String Y 1 0:미포함, 1:포함 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 67 / 528 Response 구분 Element 한글명 Type Require d Length Body pric_jmpflu 가격급등락 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_cls 종목분류 String N 20 Body - stk_nm 종목명 String N 40 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - base_pric 기준가 String N 20 Body - cur_prc 현재가 String N 20 Body - base_pre 기준대비 String N 20 Body - trde_qty 거래량 String N 20 Body - jmp_rt 급등률 String N 20 Request Example { } "mrkt_tp": "000", "flu_tp": "1", "tm_tp": "1", "tm": "60", "trde_qty_tp": "0000", "stk_cnd": "0", "crd_cnd": "0", "pric_cnd": "0", "updown_incls": "1", "stex_tp": "1" Response Example { "pric_jmpflu": [ { "stk_cd": "005930", "stk_cls": "", "stk_nm": "삼성전자", "pred_pre_sig": "2", "pred_pre": "+300", "flu_rt": "+0.57", "base_pric": "51600", "cur_prc": "+52700", "base_pre": "1100", "trde_qty": "2400", "jmp_rt": "+2.13" }, { "stk_cd": "005930", "stk_cls": "", "stk_nm": "삼성전자", "pred_pre_sig": "5", "pred_pre": "-24200", "flu_rt": "-26.68", "base_pric": "66000", "cur_prc": "-66500", "base_pre": "500", "trde_qty": "577", "jmp_rt": "+0.76" }, { "stk_cd": "005930", "stk_cls": "", "stk_nm": "삼성전자", "pred_pre_sig": "2", "pred_pre": "+10", 68 / 528 Description Response Example }, { }, { } "flu_rt": "+0.06", "base_pric": "16370", "cur_prc": "+16380", "base_pre": "10", "trde_qty": "102", "jmp_rt": "+0.06" "stk_cd": "005930", "stk_cls": "", "stk_nm": "삼성전자", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "base_pric": "334", "cur_prc": "334", "base_pre": "0", "trde_qty": "3", "jmp_rt": "0.00" "stk_cd": "005930", "stk_cls": "", "stk_nm": "삼성전자", "pred_pre_sig": "2", "pred_pre": "+90", "flu_rt": "+1.22", "base_pric": "7470", "cur_prc": "+7470", "base_pre": "0", "trde_qty": "2", "jmp_rt": "0.00" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 69 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 호가잔량상위요청(ka10020) API 명 호가잔량상위요청 API ID ka10020 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 001:코스피, 101:코스닥 Body sort_tp 정렬구분 String Y 1 1:순매수잔량순, 2:순매도잔량순, 3:매수비율순, 4:매도비율순 Body trde_qty_tp 거래량구분 String Y 4 0000:장시작전(0주이상), 0010:만주이상, 0050:5만주이상, 00100:10만주이상 Body stk_cnd 종목조건 String Y 1 0:전체조회, 1:관리종목제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body bid_req_upper 호가잔량상위 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 70 / 528 Response 구분 Element 한글명 Type Require d Length Body - pred_pre 전일대비 String N 20 Body - trde_qty 거래량 String N 20 Body - tot_sel_req 총매도잔량 String N 20 Body - tot_buy_req 총매수잔량 String N 20 Body - netprps_req 순매수잔량 String N 20 Body - buy_rt 매수비율 String N 20 Request Example { } "mrkt_tp": "001", "sort_tp": "1", "trde_qty_tp": "0000", "stk_cnd": "0", "crd_cnd": "0", "stex_tp": "1" Response Example { "bid_req_upper": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+65000", "pred_pre_sig": "2", "pred_pre": "+6300", "trde_qty": "214670", "tot_sel_req": "1", "tot_buy_req": "22287", "netprps_req": "22286", "buy_rt": "2228700.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+13335", "pred_pre_sig": "2", "pred_pre": "+385", "trde_qty": "0", "tot_sel_req": "0", "tot_buy_req": "9946", "netprps_req": "9946", "buy_rt": "0.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+10435", "pred_pre_sig": "2", "pred_pre": "+360", "trde_qty": "0", "tot_sel_req": "0", "tot_buy_req": "8013", "netprps_req": "8013", "buy_rt": "0.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+9530", "pred_pre_sig": "2", "pred_pre": "+275", "trde_qty": "0", "tot_sel_req": "0", "tot_buy_req": "5432", "netprps_req": "5432", "buy_rt": "0.00" }, 71 / 528 Description Response Example { } "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+13120", "pred_pre_sig": "2", "pred_pre": "+55", "trde_qty": "0", "tot_sel_req": "0", "tot_buy_req": "5335", "netprps_req": "5335", "buy_rt": "0.00" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 72 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 호가잔량급증요청(ka10021) API 명 호가잔량급증요청 API ID ka10021 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 001:코스피, 101:코스닥 Body trde_tp 매매구분 String Y 1 1:매수잔량, 2:매도잔량 Body sort_tp 정렬구분 String Y 1 1:급증량, 2:급증률 Body tm_tp 시간구분 String Y 2 분 입력 Body trde_qty_tp 거래량구분 String Y 4 1:천주이상, 5:5천주이상, 10:만주이상, 50:5만주이상, 100:10만주이상 Body stk_cnd 종목조건 String Y 1 0:전체조회, 1:관리종목제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body bid_req_sdnin 호가잔량급증 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 73 / 528 Response 구분 Element 한글명 Type Require d Length Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - int 기준률 String N 20 Body - now 현재 String N 20 Body - sdnin_qty 급증수량 String N 20 Body - sdnin_rt 급증률 String N 20 Body - tot_buy_qty 총매수량 String N 20 Request Example { } "mrkt_tp": "001", "trde_tp": "1", "sort_tp": "1", "tm_tp": "30", "trde_qty_tp": "1", "stk_cnd": "0", "stex_tp": "3" Response Example { } "bid_req_sdnin": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "8680", "pred_pre_sig": "3", "pred_pre": "0", "int": "5000", "now": "10000", "sdnin_qty": "5000", "sdnin_rt": "+100.00", "tot_buy_qty": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 74 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 잔량율급증요청(ka10022) API 명 잔량율급증요청 API ID ka10022 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 001:코스피, 101:코스닥 Body rt_tp 비율구분 String Y 1 1:매수/매도비율, 2:매도/매수비율 Body tm_tp 시간구분 String Y 2 분 입력 Body trde_qty_tp 거래량구분 String Y 1 5:5천주이상, 10:만주이상, 50:5만주이상, 100:10만주이상 Body stk_cnd 종목조건 String Y 1 0:전체조회, 1:관리종목제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body req_rt_sdnin 잔량율급증 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 75 / 528 Response 구분 Element 한글명 Type Require d Length Body - int 기준률 String N 20 Body - now_rt 현재비율 String N 20 Body - sdnin_rt 급증률 String N 20 Body - tot_sel_req 총매도잔량 String N 20 Body - tot_buy_req 총매수잔량 String N 20 Request Example { } "mrkt_tp": "001", "rt_tp": "1", "tm_tp": "1", "trde_qty_tp": "5", "stk_cnd": "0", "stex_tp": "3" Response Example { } "req_rt_sdnin": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+74300", "pred_pre_sig": "2", "pred_pre": "+17000", "int": "+12600.00", "now_rt": "-21474836.00", "sdnin_rt": "-21474836.00", "tot_sel_req": "74", "tot_buy_req": "74337920" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 76 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 거래량급증요청(ka10023) API 명 거래량급증요청 API ID ka10023 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body sort_tp 정렬구분 String Y 1 1:급증량, 2:급증률, 3:급감량, 4:급감률 Body tm_tp 시간구분 String Y 1 1:분, 2:전일 Body trde_qty_tp 거래량구분 String Y 1 5:5천주이상, 10:만주이상, 50:5만주이상, 100:10만주이상, 200:20만주이상, 300:30만주이상, 500:50만주이상, 1000:백만주이상 Body tm 시간 String N 2 분 입력 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body stk_cnd 종목조건 String Y 1 0:전체조회, 1:관리종목제외, 3:우선주제외, 11:정리매매종목제외, 4:관리종목,우선주제외, 5:증100제외, 6:증100만보기, 13:증60만보기, 12:증50만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기, 17:ETN제외, 14:ETF제외, 18:ETF+ETN제외, 15:스팩제외, 20:ETF+ETN+스팩제외 Body pric_tp 가격구분 String Y 1 0:전체조회, 2:5만원이상, 5:1만원이상, 6:5천원이상, 8:1천원이상, 9:10만원이상 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trde_qty_sdnin 거래량급증 LIST N 77 / 528 Response 구분 Element 한글명 Type Require d Length Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - prev_trde_qty 이전거래량 String N 20 Body - now_trde_qty 현재거래량 String N 20 Body - sdnin_qty 급증량 String N 20 Body - sdnin_rt 급증률 String N 20 Request Example { } "mrkt_tp": "000", "sort_tp": "1", "tm_tp": "2", "trde_qty_tp": "5", "tm": "", "stk_cnd": "0", "pric_tp": "0", "stex_tp": "3" Response Example { "trde_qty_sdnin": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-152000", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.07", "prev_trde_qty": "22532511", "now_trde_qty": "31103523", "sdnin_qty": "+8571012", "sdnin_rt": "+38.04" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-94400", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.11", "prev_trde_qty": "25027263", "now_trde_qty": "30535372", "sdnin_qty": "+5508109", "sdnin_rt": "+22.01" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-42900", "pred_pre_sig": "5", "pred_pre": "-150", "flu_rt": "-0.35", "prev_trde_qty": "25717492", "now_trde_qty": "31033221", "sdnin_qty": "+5315729", "sdnin_rt": "+20.67" }, { "stk_cd": "005930", 78 / 528 Description Response Example }, { } "stk_nm": "삼성전자", "cur_prc": "-22350", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.45", "prev_trde_qty": "25548474", "now_trde_qty": "30673438", "sdnin_qty": "+5124964", "sdnin_rt": "+20.06" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-56400", "pred_pre_sig": "5", "pred_pre": "-300", "flu_rt": "-0.53", "prev_trde_qty": "26185726", "now_trde_qty": "30990416", "sdnin_qty": "+4804690", "sdnin_rt": "+18.35" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 79 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 거래량갱신요청(ka10024) API 명 거래량갱신요청 API ID ka10024 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body cycle_tp 주기구분 String Y 1 5:5일, 10:10일, 20:20일, 60:60일, 250:250일 Body trde_qty_tp 거래량구분 String Y 1 5:5천주이상, 10:만주이상, 50:5만주이상, 100:10만주이상, 200:20만주이상, 300:30만주이상, 500:50만주이상, 1000:백만주이상 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trde_qty_updt 거래량갱신 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 80 / 528 Response Type Require d Length 이전거래량 String N 20 - now_trde_qty 현재거래량 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 구분 Element Body - prev_trde_qty Body 한글명 Request Example { } "mrkt_tp": "000", "cycle_tp": "5", "trde_qty_tp": "5", "stex_tp": "3" Response Example { } "trde_qty_updt": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+29.86", "prev_trde_qty": "243520", "now_trde_qty": "435771", "sel_bid": "0", "buy_bid": "+74800" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-42900", "pred_pre_sig": "5", "pred_pre": "-150", "flu_rt": "-0.35", "prev_trde_qty": "25377975", "now_trde_qty": "31399114", "sel_bid": "-42900", "buy_bid": "+45250" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-152000", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.07", "prev_trde_qty": "22435675", "now_trde_qty": "31491771", "sel_bid": "-152000", "buy_bid": "-151900" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-65300", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.15", "prev_trde_qty": "25114462", "now_trde_qty": "26395169", "sel_bid": "-65300", "buy_bid": "+74900" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 81 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 매물대집중요청(ka10025) API 명 매물대집중요청 API ID ka10025 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body prps_cnctr_rt 매물집중비율 String Y 3 0~100 입력 Body cur_prc_entry 현재가진입 String Y 1 0:현재가 매물대 진입 포함안함, 1:현재가 매물대 진입포함 Body prpscnt 매물대수 String Y 2 숫자입력 Body cycle_tp 주기구분 String Y 2 50:50일, 100:100일, 150:150일, 200:200일, 250:250일, 300:300일 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body prps_cnctr 매물대집중 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 82 / 528 Response 구분 Element 한글명 Type Require d Length Body - flu_rt 등락률 String N 20 Body - now_trde_qty 현재거래량 String N 20 Body - pric_strt 가격대시작 String N 20 Body - pric_end 가격대끝 String N 20 Body - prps_qty 매물량 String N 20 Body - prps_rt 매물비 String N 20 Request Example { } "mrkt_tp": "000", "prps_cnctr_rt": "50", "cur_prc_entry": "0", "prpscnt": "10", "cycle_tp": "50", "stex_tp": "3" Response Example { "prps_cnctr": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "30000", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "pric_strt": "31350", "pric_end": "31799", "prps_qty": "4", "prps_rt": "+50.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "30000", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "pric_strt": "32700", "pric_end": "33149", "prps_qty": "4", "prps_rt": "+50.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "109", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "1", "pric_strt": "109", "pric_end": "326", "prps_qty": "8", "prps_rt": "+50.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "2555", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "pric_strt": "2669", 83 / 528 Description Response Example "pric_end": "2685", "prps_qty": "4", "prps_rt": "+50.00" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 84 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 고저PER요청(ka10026) API 명 고저PER요청 API ID ka10026 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body pertp PER구분 String Y 1 1:저PBR, 2:고PBR, 3:저PER, 4:고PER, 5:저ROE, 6:고ROE Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body high_low_per 고저PER LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - per PER String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - now_trde_qty 현재거래량 String N 20 Body - sel_bid 매도호가 String N 20 85 / 528 Request Example { } "pertp": "1", "stex_tp": "3" Response Example { } "high_low_per": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "per": "0.44", "cur_prc": "4930", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "per": "0.54", "cur_prc": "5980", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "per": "0.71", "cur_prc": "3445", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "per": "0.71", "cur_prc": "83", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "per": "0.82", "cur_prc": "7820", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "7820" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 86 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 전일대비등락률상위요청(ka10027) API 명 전일대비등락률상위요청 API ID ka10027 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body sort_tp 정렬구분 String Y 1 1:상승률, 2:상승폭, 3:하락률, 4:하락폭, 5:보합 Body trde_qty_cnd 거래량조건 String Y 5 0000:전체조회, 0010:만주이상, 0050:5만주이상, 0100:10만주이상, 0150:15만주이상, 0200:20만주이상, 0300:30만주이상, 0500:50만주이상, 1000:백만주이상 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body stk_cnd 종목조건 String Y 2 0:전체조회, 1:관리종목제외, 4:우선주+관리주제외, 3:우선주제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기, 11:정리매매종목제외, 12:증50만보기, 13:증60만보기, 14:ETF제외, 15:스펙제외, 16:ETF+ETN제외 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body updown_incls 상하한포함 String Y 2 0:불 포함, 1:포함 Body pric_cnd 가격조건 String Y 2 0:전체조회, 1:1천원미만, 2:1천원~2천원, 3:2천원~5천원, 4:5천원~1만원, 5:1만원이상, 8:1천원이상, 10: 1만원미만 Body trde_prica_cnd 거래대금조건 String Y 4 0:전체조회, 3:3천만원이상, 5:5천만원이상, 10:1억원이상, 30:3억원이상, 50:5억원이상, 100:10억원이상, 300:30억원이상, 500:50억원이상, 1000:100억원이상, 3000:300억원이상, 5000:500억원이상 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 Response 구분 Header Element api-id 한글명 TR명 Type Require d Length String Y 10 87 / 528 Description Response 구분 Element 한글명 Type Require d Length Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body pred_pre_flu_rt_uppe r 전일대비등락률상위 LIST N Body - stk_cls 종목분류 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - sel_req 매도잔량 String N 20 Body - buy_req 매수잔량 String N 20 Body - now_trde_qty 현재거래량 String N 20 Body - cntr_str 체결강도 String N 20 Body - cnt 횟수 String N 20 Request Example { } "mrkt_tp": "000", "sort_tp": "1", "trde_qty_cnd": "0000", "stk_cnd": "0", "crd_cnd": "0", "updown_incls": "1", "pric_cnd": "0", "trde_prica_cnd": "0", "stex_tp": "3" Response Example { Description "pred_pre_flu_rt_upper": [ { "stk_cls": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+29.86", "sel_req": "207", "buy_req": "3820638", "now_trde_qty": "446203", "cntr_str": "346.54", "cnt": "4" }, { "stk_cls": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+12000", "pred_pre_sig": "2", "pred_pre": "+2380", "flu_rt": "+24.74", "sel_req": "54", "buy_req": "0", "now_trde_qty": "6", 88 / 528 Response Example }, { }, { } "cntr_str": "500.00", "cnt": "1" "stk_cls": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+22550", "pred_pre_sig": "2", "pred_pre": "+2300", "flu_rt": "+11.36", "sel_req": "3042", "buy_req": "11", "now_trde_qty": "9", "cntr_str": "500.00", "cnt": "2" "stk_cls": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+45000", "pred_pre_sig": "2", "pred_pre": "+3950", "flu_rt": "+9.62", "sel_req": "0", "buy_req": "0", "now_trde_qty": "106", "cntr_str": "0.00", "cnt": "1" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 89 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 시가대비등락률요청(ka10028) API 명 시가대비등락률요청 API ID ka10028 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body sort_tp 정렬구분 String Y 1 1:시가, 2:고가, 3:저가, 4:기준가 Body trde_qty_cnd 거래량조건 String Y 4 0000:전체조회, 0010:만주이상, 0050:5만주이상, 0100:10만주이상, 0500:50만주이상, 1000:백만주이상 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body updown_incls 상하한포함 String Y 1 0:불 포함, 1:포함 Body stk_cnd 종목조건 String Y 2 0:전체조회, 1:관리종목제외, 4:우선주+관리주제외, 3:우선주제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body trde_prica_cnd 거래대금조건 String Y 4 0:전체조회, 3:3천만원이상, 5:5천만원이상, 10:1억원이상, 30:3억원이상, 50:5억원이상, 100:10억원이상, 300:30억원이상, 500:50억원이상, 1000:100억원이상, 3000:300억원이상, 5000:500억원이상 Body flu_cnd 등락조건 String Y 1 1:상위, 2:하위 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 90 / 528 Response Type Require d 시가대비등락률 LIST N - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - open_pric_pre 시가대비 String N 20 Body - now_trde_qty 현재거래량 String N 20 Body - cntr_str 체결강도 String N 20 구분 Element Body open_pric_pre_flu_rt Body 한글명 Length Request Example { } "sort_tp": "1", "trde_qty_cnd": "0000", "mrkt_tp": "000", "updown_incls": "1", "stk_cnd": "0", "crd_cnd": "0", "trde_prica_cnd": "0", "flu_cnd": "1", "stex_tp": "3" Response Example { "open_pric_pre_flu_rt": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+29.86", "open_pric": "+65000", "high_pric": "+74800", "low_pric": "-57000", "open_pric_pre": "+15.08", "now_trde_qty": "448203", "cntr_str": "346.54" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-200000", "pred_pre_sig": "5", "pred_pre": "-15000", "flu_rt": "-6.98", "open_pric": "-180000", "high_pric": "215000", "low_pric": "-180000", "open_pric_pre": "+11.11", "now_trde_qty": "619", "cntr_str": "385.07" }, { "stk_cd": "005930", "stk_nm": "삼성전자", 91 / 528 Description Response Example }, { } "cur_prc": "+200000", "pred_pre_sig": "2", "pred_pre": "+15600", "flu_rt": "+8.46", "open_pric": "184400", "high_pric": "+200000", "low_pric": "-183500", "open_pric_pre": "+8.46", "now_trde_qty": "143", "cntr_str": "500.00" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+140100", "pred_pre_sig": "2", "pred_pre": "+4100", "flu_rt": "+3.01", "open_pric": "+136100", "high_pric": "+150000", "low_pric": "-129000", "open_pric_pre": "+2.94", "now_trde_qty": "135", "cntr_str": "136.36" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 92 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 예상체결등락률상위요청(ka10029) API 명 예상체결등락률상위요청 API ID ka10029 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body sort_tp 정렬구분 String Y 1 1:상승률, 2:상승폭, 3:보합, 4:하락률, 5:하락폭, 6:체결량, 7:상한, 8:하한 Body trde_qty_cnd 거래량조건 String Y 5 0:전체조회, 1;천주이상, 3:3천주, 5:5천주, 10:만주이상, 50:5만주이상, 100:10만주이상 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body stk_cnd 종목조건 String Y 2 0:전체조회, 1:관리종목제외, 3:우선주제외, 4:관리종목,우선주제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기, 11:정리매매종목제외, 12:증50만보기, 13:증60만보기, 14:ETF제외, 15:스팩제외, 16:ETF+ETN제외 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 5:신용한도초과제외, 7:신용융자E군, 8:신용대주, 9:신용융자전체 Body pric_cnd 가격조건 String Y 2 0:전체조회, 1:1천원미만, 2:1천원~2천원, 3:2천원~5천원, 4:5천원~1만원, 5:1만원이상, 8:1천원이상, 10:1만원미만 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body exp_cntr_flu_rt_uppe 예상체결등락률상위 LIST N 93 / 528 Response 구분 Element 한글명 Type Require d Length r Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - exp_cntr_pric 예상체결가 String N 20 Body - base_pric 기준가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - exp_cntr_qty 예상체결량 String N 20 Body - sel_req 매도잔량 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - buy_req 매수잔량 String N 20 Request Example { } "mrkt_tp": "000", "sort_tp": "1", "trde_qty_cnd": "0", "stk_cnd": "0", "crd_cnd": "0", "pric_cnd": "0", "stex_tp": "3" Response Example { "exp_cntr_flu_rt_upper": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "exp_cntr_pric": "+48100", "base_pric": "37000", "pred_pre_sig": "1", "pred_pre": "+11100", "flu_rt": "+30.00", "exp_cntr_qty": "1", "sel_req": "0", "sel_bid": "0", "buy_bid": "0", "buy_req": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "exp_cntr_pric": "+40000", "base_pric": "34135", "pred_pre_sig": "2", "pred_pre": "+5865", "flu_rt": "+17.18", "exp_cntr_qty": "1", "sel_req": "1", "sel_bid": "+40000", "buy_bid": "+35370", "buy_req": "1" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "exp_cntr_pric": "+37750", "base_pric": "36550", 94 / 528 Description Response Example "pred_pre_sig": "2", "pred_pre": "+1200", "flu_rt": "+3.28", "exp_cntr_qty": "2", "sel_req": "0", "sel_bid": "0", "buy_bid": "+37850", "buy_req": "3" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 95 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 당일거래량상위요청(ka10030) API 명 당일거래량상위요청 API ID ka10030 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body sort_tp 정렬구분 String Y 1 1:거래량, 2:거래회전율, 3:거래대금 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body mang_stk_incls 관리종목포함 String Y 1 0:관리종목 포함, 1:관리종목 미포함, 3:우선주제외, 11:정리매매종목제외, 4:관리종목, 우선주제외, 5:증100제외, 6:증100마나보기, 13:증60만보기, 12:증50만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기, 14:ETF제외, 15:스팩제외, 16:ETF+ETN제외 Body crd_tp 신용구분 String Y 1 0:전체조회, 9:신용융자전체, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 8:신용대주 Body trde_qty_tp 거래량구분 String Y 1 0:전체조회, 5:5천주이상, 10:1만주이상, 50:5만주이상, 100:10만주이상, 200:20만주이상, 300:30만주이상, 500:500만주이상, 1000:백만주이상 Body pric_tp 가격구분 String Y 1 0:전체조회, 1:1천원미만, 2:1천원이상, 3:1천원~2천원, 4:2천원~5천원, 5:5천원이상, 6:5천원~1만원, 10:1만원미만, 7:1만원이상, 8:5만원이상, 9:10만원이상 Body trde_prica_tp 거래대금구분 String Y 1 0:전체조회, 1:1천만원이상, 3:3천만원이상, 4:5천만원이상, 10:1억원이상, 30:3억원이상, 50:5억원이상, 100:10억원이상, 300:30억원이상, 500:50억원이상, 1000:100억원이상, 3000:300억원이상, 5000:500억원이상 Body mrkt_open_tp 장운영구분 String Y 1 0:전체조회, 1:장중, 2:장전시간외, 3:장후시간외 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 Response 구분 Element 한글명 Type Require d 96 / 528 Length Description Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tdy_trde_qty_upper 당일거래량상위 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 Body - pred_rt 전일비 String N 20 Body - trde_tern_rt 거래회전율 String N 20 Body - trde_amt 거래금액 String N 20 Body - opmr_trde_qty 장중거래량 String N 20 Body - opmr_pred_rt 장중전일비 String N 20 Body - opmr_trde_rt 장중거래회전율 String N 20 Body - opmr_trde_amt 장중거래금액 String N 20 Body - af_mkrt_trde_qty 장후거래량 String N 20 Body - af_mkrt_pred_rt 장후전일비 String N 20 Body - af_mkrt_trde_rt 장후거래회전율 String N 20 Body - af_mkrt_trde_amt 장후거래금액 String N 20 Body - bf_mkrt_trde_qty 장전거래량 String N 20 Body - bf_mkrt_pred_rt 장전전일비 String N 20 Body - bf_mkrt_trde_rt 장전거래회전율 String N 20 Body - bf_mkrt_trde_amt 장전거래금액 String N 20 Request Example { } "mrkt_tp": "000", "sort_tp": "1", "mang_stk_incls": "0", "crd_tp": "0", "trde_qty_tp": "0", "pric_tp": "0", "trde_prica_tp": "0", "mrkt_open_tp": "0", "stex_tp": "3" Response Example { Description "tdy_trde_qty_upper": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-152000", 97 / 528 Response Example }, { } "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.07", "trde_qty": "34954641", "pred_rt": "+155.13", "trde_tern_rt": "+48.21", "trde_amt": "5308092", "opmr_trde_qty": "0", "opmr_pred_rt": "0.00", "opmr_trde_rt": "+0.00", "opmr_trde_amt": "0", "af_mkrt_trde_qty": "0", "af_mkrt_pred_rt": "0.00", "af_mkrt_trde_rt": "+0.00", "af_mkrt_trde_amt": "0", "bf_mkrt_trde_qty": "0", "bf_mkrt_pred_rt": "0.00", "bf_mkrt_trde_rt": "+0.00", "bf_mkrt_trde_amt": "0" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-42950", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.23", "trde_qty": "34854261", "pred_rt": "+135.53", "trde_tern_rt": "+13.83", "trde_amt": "1501908", "opmr_trde_qty": "0", "opmr_pred_rt": "0.00", "opmr_trde_rt": "+0.00", "opmr_trde_amt": "0", "af_mkrt_trde_qty": "0", "af_mkrt_pred_rt": "0.00", "af_mkrt_trde_rt": "+0.00", "af_mkrt_trde_amt": "0", "bf_mkrt_trde_qty": "0", "bf_mkrt_pred_rt": "0.00", "bf_mkrt_trde_rt": "+0.00", "bf_mkrt_trde_amt": "0" } ], "returnCode": 0, "returnMsg": "정상적으로 처리되었습니다" 98 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 전일거래량상위요청(ka10031) API 명 전일거래량상위요청 API ID ka10031 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body qry_tp 조회구분 String Y 1 1:전일거래량 상위100종목, 2:전일거래대금 상위100종목 Body rank_strt 순위시작 String Y 3 0 ~ 100 값 중에 조회를 원하는 순위 시작값 Body rank_end 순위끝 String Y 3 0 ~ 100 값 중에 조회를 원하는 순위 끝값 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body pred_trde_qty_upper 전일거래량상위 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - trde_qty 거래량 String N 20 99 / 528 Request Example { } "mrkt_tp": "101", "qry_tp": "1", "rank_strt": "0", "rank_end": "10", "stex_tp": "3" Response Example { "pred_trde_qty_upper": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "81", "pred_pre_sig": "3", "pred_pre": "0", "trde_qty": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "2050", "pred_pre_sig": "3", "pred_pre": "0", "trde_qty": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "2375", "pred_pre_sig": "3", "pred_pre": "0", "trde_qty": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-43750", "pred_pre_sig": "5", "pred_pre": "-50", "trde_qty": "34605668" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "70", "pred_pre_sig": "3", "pred_pre": "0", "trde_qty": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-56600", "pred_pre_sig": "5", "pred_pre": "-100", "trde_qty": "33014975" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "11260", "pred_pre_sig": "3", "pred_pre": "0", "trde_qty": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-65300", "pred_pre_sig": "5", "pred_pre": "-100", "trde_qty": "28117804" }, { "stk_cd": "005930", "stk_nm": "삼성전자", 100 / 528 Response Example }, { } "cur_prc": "-94400", "pred_pre_sig": "5", "pred_pre": "-100", "trde_qty": "34289700" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-18610", "pred_pre_sig": "5", "pred_pre": "-20", "trde_qty": "33030086" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 101 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 거래대금상위요청(ka10032) API 명 거래대금상위요청 API ID ka10032 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body mang_stk_incls 관리종목포함 String Y 1 0:관리종목 미포함, 1:관리종목 포함 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trde_prica_upper 거래대금상위 LIST N Body - stk_cd 종목코드 String N 20 Body - now_rank 현재순위 String N 20 Body - pred_rank 전일순위 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 102 / 528 Response 구분 Element 한글명 Type Require d Length Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - now_trde_qty 현재거래량 String N 20 Body - pred_trde_qty 전일거래량 String N 20 Body - trde_prica 거래대금 String N 20 Request Example { } "mrkt_tp": "001", "mang_stk_incls": "1", "stex_tp": "3" Response Example { } "trde_prica_upper": [ { "stk_cd": "005930", "now_rank": "1", "pred_rank": "1", "stk_nm": "삼성전자", "cur_prc": "-152000", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.07", "sel_bid": "-152000", "buy_bid": "-150000", "now_trde_qty": "34954641", "pred_trde_qty": "22532511", "trde_prica": "5308092" }, { "stk_cd": "005930", "now_rank": "2", "pred_rank": "2", "stk_nm": "삼성전자", "cur_prc": "-53700", "pred_pre_sig": "4", "pred_pre": "-23000", "flu_rt": "-29.99", "sel_bid": "-76500", "buy_bid": "+85100", "now_trde_qty": "31821639", "pred_trde_qty": "30279412", "trde_prica": "2436091" }, { "stk_cd": "005930", "now_rank": "3", "pred_rank": "3", "stk_nm": "삼성전자", "cur_prc": "-42950", "pred_pre_sig": "5", "pred_pre": "-100", "flu_rt": "-0.23", "sel_bid": "-42950", "buy_bid": "+45250", "now_trde_qty": "34854261", "pred_trde_qty": "25717492", "trde_prica": "1501908" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 103 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 신용비율상위요청(ka10033) API 명 신용비율상위요청 API ID ka10033 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body trde_qty_tp 거래량구분 String Y 3 0:전체조회, 10:만주이상, 50:5만주이상, 100:10만주이상, 200:20만주이상, 300:30만주이상, 500:50만주이상, 1000:백만주이상 Body stk_cnd 종목조건 String Y 1 0:전체조회, 1:관리종목제외, 5:증100제외, 6:증100만보기, 7:증40만보기, 8:증30만보기, 9:증20만보기 Body updown_incls 상하한포함 String Y 1 0:상하한 미포함, 1:상하한포함 Body crd_cnd 신용조건 String Y 1 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 9:신용융자전체 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body crd_rt_upper 신용비율상위 LIST N Body - stk_infr 종목정보 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 104 / 528 Response 구분 Element 한글명 Type Require d Length Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - crd_rt 신용비율 String N 20 Body - sel_req 매도잔량 String N 20 Body - buy_req 매수잔량 String N 20 Body - now_trde_qty 현재거래량 String N 20 Request Example { } "mrkt_tp": "000", "trde_qty_tp": "0", "stk_cnd": "0", "updown_incls": "1", "crd_cnd": "0", "stex_tp": "3" Response Example { "crd_rt_upper": [ { "stk_infr": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "16420", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "crd_rt": "+9.49", "sel_req": "0", "buy_req": "0", "now_trde_qty": "0" }, { "stk_infr": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "3415", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "crd_rt": "+9.48", "sel_req": "1828", "buy_req": "0", "now_trde_qty": "0" }, { "stk_infr": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "3660", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "crd_rt": "+8.92", "sel_req": "0", "buy_req": "0", "now_trde_qty": "0" }, { "stk_infr": "0", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "11050", 105 / 528 Description Response Example "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "crd_rt": "+8.73", "sel_req": "0", "buy_req": "0", "now_trde_qty": "0" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 106 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 외인기간별매매상위요청(ka10034) API 명 외인기간별매매상위요청 API ID ka10034 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body trde_tp 매매구분 String Y 1 1:순매도, 2:순매수, 3:순매매 Body dt 기간 String Y 2 0:당일, 1:전일, 5:5일, 10;10일, 20:20일, 60:60일 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body for_dt_trde_upper 외인기간별매매상위 LIST N Body - rank 순위 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - sel_bid 매도호가 String N 20 107 / 528 Response 구분 Element 한글명 Type Require d Length Body - buy_bid 매수호가 String N 20 Body - trde_qty 거래량 String N 20 Body - netprps_qty 순매수량 String N 20 Body - gain_pos_stkcnt 취득가능주식수 String N 20 Request Example { } "mrkt_tp": "001", "trde_tp": "2", "dt": "0", "stex_tp": "1" Response Example { } "for_dt_trde_upper": [ { "rank": "1", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "sel_bid": "0", "buy_bid": "+74800", "trde_qty": "435771", "netprps_qty": "+290232191", "gain_pos_stkcnt": "2548278006" }, { "rank": "2", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-183500", "pred_pre_sig": "5", "pred_pre": "-900", "sel_bid": "+184900", "buy_bid": "0", "trde_qty": "135", "netprps_qty": "+167189864", "gain_pos_stkcnt": "0" }, { "rank": "3", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "4115", "pred_pre_sig": "3", "pred_pre": "0", "sel_bid": "0", "buy_bid": "0", "trde_qty": "0", "netprps_qty": "+59255646", "gain_pos_stkcnt": "430439234" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 108 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 외인연속순매매상위요청(ka10035) API 명 외인연속순매매상위요청 API ID ka10035 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body trde_tp 매매구분 String Y 1 1:연속순매도, 2:연속순매수 Body base_dt_tp 기준일구분 String Y 1 0:당일기준, 1:전일기준 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body for_cont_nettrde_up per 외인연속순매매상위 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - dm1 D-1 String N 20 Body - dm2 D-2 String N 20 109 / 528 Response 구분 Element 한글명 Type Require d Length Body - dm3 D-3 String N 20 Body - tot 합계 String N 20 Body - limit_exh_rt 한도소진율 String N 20 Body - pred_pre_1 전일대비1 String N 20 Body - pred_pre_2 전일대비2 String N 20 Body - pred_pre_3 전일대비3 String N 20 Request Example { } "mrkt_tp": "000", "trde_tp": "2", "base_dt_tp": "1", "stex_tp": "1" Response Example { "for_cont_nettrde_upper": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "10200", "pred_pre_sig": "3", "pred_pre": "0", "dm1": "+33928250", "dm2": "+234840", "dm3": "+233891", "tot": "+34396981", "limit_exh_rt": "+71.53", "pred_pre_1": "", "pred_pre_2": "", "pred_pre_3": "" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-8540", "pred_pre_sig": "5", "pred_pre": "-140", "dm1": "+4033818", "dm2": "+12474308", "dm3": "+13173262", "tot": "+29681388", "limit_exh_rt": "+0.10", "pred_pre_1": "", "pred_pre_2": "", "pred_pre_3": "" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "23000", "pred_pre_sig": "3", "pred_pre": "0", "dm1": "+24595310", "dm2": "+247863", "dm3": "+247188", "tot": "+25090361", "limit_exh_rt": "+38.85", "pred_pre_1": "", "pred_pre_2": "", "pred_pre_3": "" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "195800", "pred_pre_sig": "3", 110 / 528 Description Response Example "pred_pre": "0", "dm1": "+21220444", "dm2": "+213984", "dm3": "+104034", "tot": "+21538462", "limit_exh_rt": "+54.76", "pred_pre_1": "", "pred_pre_2": "", "pred_pre_3": "" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 111 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 외인한도소진율증가상위(ka10036) API 명 외인한도소진율증가상위 API ID ka10036 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body dt 기간 String Y 2 0:당일, 1:전일, 5:5일, 10;10일, 20:20일, 60:60일 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body for_limit_exh_rt_incrs _upper 외인한도소진율증가 상위 LIST N Body - rank 순위 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - trde_qty 거래량 String N 20 Body - poss_stkcnt 보유주식수 String N 20 112 / 528 Response 구분 Element 한글명 Type Require d Length Body - gain_pos_stkcnt 취득가능주식수 String N 20 Body - base_limit_exh_rt 기준한도소진율 String N 20 Body - limit_exh_rt 한도소진율 String N 20 Body - exh_rt_incrs 소진율증가 String N 20 Request Example { } "mrkt_tp": "000", "dt": "1", "stex_tp": "1" Response Example { } "for_limit_exh_rt_incrs_upper": [ { "rank": "1", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "14255", "pred_pre_sig": "3", "pred_pre": "0", "trde_qty": "0", "poss_stkcnt": "0", "gain_pos_stkcnt": "600000", "base_limit_exh_rt": "-283.33", "limit_exh_rt": "0.00", "exh_rt_incrs": "+283.33" }, { "rank": "2", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "1590", "pred_pre_sig": "3", "pred_pre": "0", "trde_qty": "0", "poss_stkcnt": "519785", "gain_pos_stkcnt": "31404714", "base_limit_exh_rt": "-101.25", "limit_exh_rt": "+1.63", "exh_rt_incrs": "+102.87" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 113 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 외국계창구매매상위요청(ka10037) API 명 외국계창구매매상위요청 API ID ka10037 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body dt 기간 String Y 2 0:당일, 1:전일, 5:5일, 10;10일, 20:20일, 60:60일 Body trde_tp 매매구분 String Y 1 1:순매수, 2:순매도, 3:매수, 4:매도 Body sort_tp 정렬구분 String Y 1 1:금액, 2:수량 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body frgn_wicket_trde_up per 외국계창구매매상위 LIST N Body - rank 순위 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 114 / 528 Response 구분 Element 한글명 Type Require d Length Body - flu_rt 등락율 String N 20 Body - sel_trde_qty 매도거래량 String N 20 Body - buy_trde_qty 매수거래량 String N 20 Body - netprps_trde_qty 순매수거래량 String N 20 Body - netprps_prica 순매수대금 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Request Example { } "mrkt_tp": "000", "dt": "0", "trde_tp": "1", "sort_tp": "2", "stex_tp": "1" Response Example { "frgn_wicket_trde_upper": [ { "rank": "1", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "69", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "sel_trde_qty": "-0", "buy_trde_qty": "+0", "netprps_trde_qty": "0", "netprps_prica": "0", "trde_qty": "0", "trde_prica": "0" }, { "rank": "2", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "316", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "sel_trde_qty": "-0", "buy_trde_qty": "+0", "netprps_trde_qty": "0", "netprps_prica": "0", "trde_qty": "0", "trde_prica": "0" }, { "rank": "3", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "675", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "sel_trde_qty": "-0", "buy_trde_qty": "+0", "netprps_trde_qty": "0", "netprps_prica": "0", "trde_qty": "0", "trde_prica": "0" } ], "return_code": 0, 115 / 528 Description Response Example } "return_msg": "정상적으로 처리되었습니다" 116 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 종목별증권사순위요청(ka10038) API 명 종목별증권사순위요청 API ID ka10038 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body strt_dt 시작일자 String N 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body end_dt 종료일자 String N 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body qry_tp 조회구분 String Y 1 1:순매도순위정렬, 2:순매수순위정렬 Body dt 기간 String N 2 1:전일, 4:5일, 9:10일, 19:20일, 39:40일, 59:60일, 119:120일 Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body rank_1 순위1 String N 20 Body rank_2 순위2 String N 20 Body rank_3 순위3 String N 20 Body prid_trde_qty 기간중거래량 String N 20 Body stk_sec_rank 종목별증권사순위 LIST N Body - rank 순위 String N 117 / 528 20 Response 구분 Element 한글명 Type Require d Length Body - mmcm_nm 회원사명 String N 20 Body - buy_qty 매수수량 String N 20 Body - sell_qty 매도수량 String N 20 Body - acc_netprps_qty 누적순매수수량 String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241106", "end_dt": "20241107", "qry_tp": "2", "dt": "1" Response Example { } "rank_1": "+34881", "rank_2": "-13253", "rank_3": "+21628", "prid_trde_qty": "43", "stk_sec_rank": [ { "rank": "1", "mmcm_nm": "키움증권", "buy_qty": "+9800", "sell_qty": "-2813", "acc_netprps_qty": "+6987" }, { "rank": "2", "mmcm_nm": "키움증권", "buy_qty": "+3459", "sell_qty": "-117", "acc_netprps_qty": "+3342" }, { "rank": "3", "mmcm_nm": "키움증권", "buy_qty": "+3321", "sell_qty": "-125", "acc_netprps_qty": "+3196" }, { "rank": "4", "mmcm_nm": "키움증권", "buy_qty": "+3941", "sell_qty": "-985", "acc_netprps_qty": "+2956" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 118 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 증권사별매매상위요청(ka10039) API 명 증권사별매매상위요청 API ID ka10039 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mmcm_cd 회원사코드 String Y 3 회원사 코드는 ka10102 조회 Body trde_qty_tp 거래량구분 String Y 4 0:전체, 5:5000주, 10:1만주, 50:5만주, 100:10만주, 500:50만주, 1000: 100만주 Body trde_tp 매매구분 String Y 2 1:순매수, 2:순매도 Body dt 기간 String Y 2 1:전일, 5:5일, 10:10일, 60:60일 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body sec_trde_upper 증권사별매매상위 LIST N Body - rank 순위 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - prid_stkpc_flu 기간중주가등락 String N 20 Body - flu_rt 등락율 String N 20 Body - prid_trde_qty 기간중거래량 String N 20 119 / 528 Response 구분 Element 한글명 Type Require d Length Body - netprps 순매수 String N 20 Body - buy_trde_qty 매수거래량 String N 20 Body - sel_trde_qty 매도거래량 String N 20 Body - netprps_amt 순매수금액 String N 20 Body - buy_amt 매수금액 String N 20 Body - sell_amt 매도금액 String N 20 Request Example { } "mmcm_cd": "001", "trde_qty_tp": "0", "trde_tp": "1", "dt": "1", "stex_tp": "3" Response Example { } "sec_trde_upper": [ { "rank": "1", "stk_cd": "219550_AL", "stk_nm": "디와이디", "prid_stkpc_flu": "+9", "flu_rt": "+3.52", "prid_trde_qty": "17608995", "netprps": "+406895", "buy_trde_qty": "+427268", "sel_trde_qty": "-20373", "netprps_amt": "+119706", "buy_amt": "+125569", "sell_amt": "-5863" }, { "rank": "2", "stk_cd": "317120_AL", "stk_nm": "라닉스", "prid_stkpc_flu": "+467", "flu_rt": "+29.78", "prid_trde_qty": "2130125", "netprps": "+202658", "buy_trde_qty": "+212678", "sel_trde_qty": "-10020", "netprps_amt": "+409949", "buy_amt": "+430339", "sell_amt": "-20391" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 120 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 당일주요거래원요청(ka10040) API 명 당일주요거래원요청 API ID ka10040 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body sel_trde_ori_irds_1 매도거래원별증감1 String N Body sel_trde_ori_qty_1 매도거래원수량1 String N Body sel_trde_ori_1 매도거래원1 String N Body sel_trde_ori_cd_1 매도거래원코드1 String N Body buy_trde_ori_1 매수거래원1 String N Body buy_trde_ori_cd_1 매수거래원코드1 String N Body buy_trde_ori_qty_1 매수거래원수량1 String N Body buy_trde_ori_irds_1 매수거래원별증감1 String N Body sel_trde_ori_irds_2 매도거래원별증감2 String N Body sel_trde_ori_qty_2 매도거래원수량2 String N Body sel_trde_ori_2 매도거래원2 String N 121 / 528 Response 구분 Element 한글명 Type Require d Length Body sel_trde_ori_cd_2 매도거래원코드2 String N Body buy_trde_ori_2 매수거래원2 String N Body buy_trde_ori_cd_2 매수거래원코드2 String N Body buy_trde_ori_qty_2 매수거래원수량2 String N Body buy_trde_ori_irds_2 매수거래원별증감2 String N Body sel_trde_ori_irds_3 매도거래원별증감3 String N Body sel_trde_ori_qty_3 매도거래원수량3 String N Body sel_trde_ori_3 매도거래원3 String N Body sel_trde_ori_cd_3 매도거래원코드3 String N Body buy_trde_ori_3 매수거래원3 String N Body buy_trde_ori_cd_3 매수거래원코드3 String N Body buy_trde_ori_qty_3 매수거래원수량3 String N Body buy_trde_ori_irds_3 매수거래원별증감3 String N Body sel_trde_ori_irds_4 매도거래원별증감4 String N Body sel_trde_ori_qty_4 매도거래원수량4 String N Body sel_trde_ori_4 매도거래원4 String N Body sel_trde_ori_cd_4 매도거래원코드4 String N Body buy_trde_ori_4 매수거래원4 String N Body buy_trde_ori_cd_4 매수거래원코드4 String N Body buy_trde_ori_qty_4 매수거래원수량4 String N Body buy_trde_ori_irds_4 매수거래원별증감4 String N Body sel_trde_ori_irds_5 매도거래원별증감5 String N Body sel_trde_ori_qty_5 매도거래원수량5 String N Body sel_trde_ori_5 매도거래원5 String N Body sel_trde_ori_cd_5 매도거래원코드5 String N Body buy_trde_ori_5 매수거래원5 String N Body buy_trde_ori_cd_5 매수거래원코드5 String N Body buy_trde_ori_qty_5 매수거래원수량5 String N Body buy_trde_ori_irds_5 매수거래원별증감5 String N Body frgn_sel_prsm_sum_c hang 외국계매도추정합변 동 String N Body frgn_sel_prsm_sum 외국계매도추정합 String N Body frgn_buy_prsm_sum 외국계매수추정합 String N Body frgn_buy_prsm_sum_ chang 외국계매수추정합변 동 String N Body tdy_main_trde_ori 당일주요거래원 LIST N Body - sel_scesn_tm 매도이탈시간 String N 20 Body - sell_qty 매도수량 String N 20 122 / 528 Description Response Type Require d Length 매도상위이탈원 String N 20 - buy_scesn_tm 매수이탈시간 String N 20 Body - buy_qty 매수수량 String N 20 Body buy_upper_scesn_ori 매수상위이탈원 String N 20 Body - qry_dt 조회일자 String N 20 Body - qry_tm 조회시간 String N 20 구분 Element Body sel_upper_scesn_ori Body 한글명 Request Example { } "stk_cd": "005930" Response Example { } "sel_trde_ori_irds_1": "0", "sel_trde_ori_qty_1": "-5689", "sel_trde_ori_1": "모건스탠리", "sel_trde_ori_cd_1": "036", "buy_trde_ori_1": "모건스탠리", "buy_trde_ori_cd_1": "036", "buy_trde_ori_qty_1": "+6305", "buy_trde_ori_irds_1": "+615", "sel_trde_ori_irds_2": "+615", "sel_trde_ori_qty_2": "-615", "sel_trde_ori_2": "신 영", "sel_trde_ori_cd_2": "006", "buy_trde_ori_2": "키움증권", "buy_trde_ori_cd_2": "050", "buy_trde_ori_qty_2": "+7", "buy_trde_ori_irds_2": "0", "sel_trde_ori_irds_3": "0", "sel_trde_ori_qty_3": "-8", "sel_trde_ori_3": "키움증권", "sel_trde_ori_cd_3": "050", "buy_trde_ori_3": "", "buy_trde_ori_cd_3": "000", "buy_trde_ori_qty_3": "0", "buy_trde_ori_irds_3": "0", "sel_trde_ori_irds_4": "0", "sel_trde_ori_qty_4": "0", "sel_trde_ori_4": "", "sel_trde_ori_cd_4": "000", "buy_trde_ori_4": "", "buy_trde_ori_cd_4": "000", "buy_trde_ori_qty_4": "0", "buy_trde_ori_irds_4": "0", "sel_trde_ori_irds_5": "0", "sel_trde_ori_qty_5": "0", "sel_trde_ori_5": "", "sel_trde_ori_cd_5": "000", "buy_trde_ori_5": "", "buy_trde_ori_cd_5": "000", "buy_trde_ori_qty_5": "0", "buy_trde_ori_irds_5": "0", "frgn_sel_prsm_sum_chang": "0", "frgn_sel_prsm_sum": "-5689", "frgn_buy_prsm_sum": "+6305", "frgn_buy_prsm_sum_chang": "+615", "tdy_main_trde_ori": [], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 123 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 순매수거래원순위요청(ka10042) API 명 순매수거래원순위요청 API ID ka10042 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body strt_dt 시작일자 String N 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body end_dt 종료일자 String N 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body qry_dt_tp 조회기간구분 String Y 1 0:기간으로 조회, 1:시작일자, 종료일자로 조회 Body pot_tp 시점구분 String Y 1 0:당일, 1:전일 Body dt 기간 String N 4 5:5일, 10:10일, 20:20일, 40:40일, 60:60일, 120:120일 Body sort_base 정렬기준 String Y 1 1:종가순, 2:날짜순 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body netprps_trde_ori_ran k 순매수거래원순위 LIST N Body - rank 순위 String N 20 Body - mmcm_cd 회원사코드 String N 20 124 / 528 Response 구분 Body Element - mmcm_nm 한글명 회원사명 Type Require d Length String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241031", "end_dt": "20241107", "qry_dt_tp": "0", "pot_tp": "0", "dt": "5", "sort_base": "1" Response Example { } "netprps_trde_ori_rank": [ { "rank": "1", "mmcm_cd": "36", "mmcm_nm": "키움증권" }, { "rank": "2", "mmcm_cd": "50", "mmcm_nm": "키움증권" }, { "rank": "3", "mmcm_cd": "45", "mmcm_nm": "키움증권" }, { "rank": "4", "mmcm_cd": "6", "mmcm_nm": "키움증권" }, { "rank": "5", "mmcm_cd": "64", "mmcm_nm": "키움증권" }, { "rank": "6", "mmcm_cd": "31", "mmcm_nm": "키움증권" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 125 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 거래원매물대분석요청(ka10043) API 명 거래원매물대분석요청 API ID ka10043 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD Body qry_dt_tp 조회기간구분 String Y 1 0:기간으로 조회, 1:시작일자, 종료일자로 조회 Body pot_tp 시점구분 String Y 1 0:당일, 1:전일 Body dt 기간 String Y 4 5:5일, 10:10일, 20:20일, 40:40일, 60:60일, 120:120일 Body sort_base 정렬기준 String Y 1 1:종가순, 2:날짜순 Body mmcm_cd 회원사코드 String Y 3 회원사 코드는 ka10102 조회 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trde_ori_prps_anly 거래원매물대분석 LIST N Body - dt 일자 String N 20 Body - close_pric 종가 String N 20 126 / 528 Response 구분 Element 한글명 Type Require d Length Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - sel_qty 매도량 String N 20 Body - buy_qty 매수량 String N 20 Body - netprps_qty 순매수수량 String N 20 Body - trde_qty_sum 거래량합 String N 20 Body - trde_wght 거래비중 String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241031", "end_dt": "20241107", "qry_dt_tp": "0", "pot_tp": "0", "dt": "5", "sort_base": "1", "mmcm_cd": "36", "stex_tp": "3" Response Example { "trde_ori_prps_anly": [ { "dt": "20241105", "close_pric": "135300", "pre_sig": "2", "pred_pre": "+1700", "sel_qty": "43", "buy_qty": "1090", "netprps_qty": "1047", "trde_qty_sum": "1133", "trde_wght": "+1317.44" }, { "dt": "20241107", "close_pric": "133600", "pre_sig": "3", "pred_pre": "0", "sel_qty": "0", "buy_qty": "0", "netprps_qty": "0", "trde_qty_sum": "0", "trde_wght": "0.00" }, { "dt": "20241106", "close_pric": "132500", "pre_sig": "5", "pred_pre": "--1100", "sel_qty": "117", "buy_qty": "3459", "netprps_qty": "3342", "trde_qty_sum": "3576", "trde_wght": "+4158.14" }, { "dt": "20241101", "close_pric": "65100", "pre_sig": "5", "pred_pre": "--68500", "sel_qty": "3728", "buy_qty": "12680", "netprps_qty": "8952", "trde_qty_sum": "16408", "trde_wght": "+19079.07" 127 / 528 Description Response Example } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 128 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 일별기관매매종목요청(ka10044) API 명 일별기관매매종목요청 API ID ka10044 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD Body trde_tp 매매구분 String Y 1 1:순매도, 2:순매수 Body mrkt_tp 시장구분 String Y 3 001:코스피, 101:코스닥 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body daly_orgn_trde_stk 일별기관매매종목 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - netprps_qty 순매수수량 String N 20 Body - netprps_amt 순매수금액 String N 20 Request Example { Description "strt_dt": "20241106", 129 / 528 Request Example } "end_dt": "20241107", "trde_tp": "1", "mrkt_tp": "001", "stex_tp": "3" Response Example { } "daly_orgn_trde_stk": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "netprps_qty": "-0", "netprps_amt": "-1", "prsm_avg_pric": "140000", "cur_prc": "-95100", "avg_pric_pre": "--44900", "pre_rt": "-32.07" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "netprps_qty": "-0", "netprps_amt": "-0", "prsm_avg_pric": "12000", "cur_prc": "9920", "avg_pric_pre": "--2080", "pre_rt": "-17.33" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 130 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 종목별기관매매추이요청(ka10045) API 명 종목별기관매매추이요청 API ID ka10045 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD Body orgn_prsm_unp_tp 기관추정단가구분 String Y 1 1:매수단가, 2:매도단가 Body for_prsm_unp_tp 외인추정단가구분 String Y 1 1:매수단가, 2:매도단가 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body orgn_prsm_avg_pric 기관추정평균가 String N Body for_prsm_avg_pric 외인추정평균가 String N Body stk_orgn_trde_trnsn 종목별기관매매추이 LIST N Body - dt 일자 String N 20 Body - close_pric 종가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 131 / 528 Response 구분 Element 한글명 Type Require d Length Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - orgn_dt_acc 기관기간누적 String N 20 Body - orgn_daly_nettrde_ qty 기관일별순매매수량 String N 20 Body - for_dt_acc 외인기간누적 String N 20 Body for_daly_nettrde_qty 외인일별순매매수량 String N 20 Body - limit_exh_rt 한도소진율 String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241007", "end_dt": "20241107", "orgn_prsm_unp_tp": "1", "for_prsm_unp_tp": "1" Response Example { } "orgn_prsm_avg_pric": "117052", "for_prsm_avg_pric": "0", "stk_orgn_trde_trnsn": [ { "dt": "20241107", "close_pric": "133600", "pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "orgn_dt_acc": "158", "orgn_daly_nettrde_qty": "0", "for_dt_acc": "28315", "for_daly_nettrde_qty": "0", "limit_exh_rt": "+26.14" }, { "dt": "20241106", "close_pric": "-132500", "pre_sig": "5", "pred_pre": "-600", "flu_rt": "-0.45", "trde_qty": "43", "orgn_dt_acc": "158", "orgn_daly_nettrde_qty": "0", "for_dt_acc": "28315", "for_daly_nettrde_qty": "11243", "limit_exh_rt": "+26.14" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 132 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 체결강도추이시간별요청(ka10046) API 명 체결강도추이시간별요청 API ID ka10046 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body cntr_str_tm 체결강도시간별 LIST N Body - cntr_tm 체결시간 String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre 전일대비 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - acc_trde_prica 누적거래대금 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - cntr_str 체결강도 String N 20 Body - cntr_str_5min 체결강도5분 String N 20 133 / 528 Response 구분 Element 한글명 Type Require d Length Body - cntr_str_20min 체결강도20분 String N 20 Body - cntr_str_60min 체결강도60분 String N 20 Body - stex_tp 거래소구분 String N 20 Request Example { } "stk_cd": "005930" Response Example { } "cntr_str_tm": [ { "cntr_tm": "163713", "cur_prc": "+156600", "pred_pre": "+34900", "pred_pre_sig": "2", "flu_rt": "+28.68", "trde_qty": "-1", "acc_trde_prica": "14449", "acc_trde_qty": "113636", "cntr_str": "172.01", "cntr_str_5min": "172.01", "cntr_str_20min": "172.01", "cntr_str_60min": "170.67", "stex_tp": "KRX" }, { "cntr_tm": "163500", "cur_prc": "+156600", "pred_pre": "+34900", "pred_pre_sig": "2", "flu_rt": "+28.68", "trde_qty": "2", "acc_trde_prica": "14449", "acc_trde_qty": "113635", "cntr_str": "172.01", "cntr_str_5min": "172.01", "cntr_str_20min": "172.01", "cntr_str_60min": "170.62", "stex_tp": "KRX" }, { "cntr_tm": "163016", "cur_prc": "+156600", "pred_pre": "+34900", "pred_pre_sig": "2", "flu_rt": "+28.68", "trde_qty": "823", "acc_trde_prica": "14449", "acc_trde_qty": "113633", "cntr_str": "172.01", "cntr_str_5min": "172.01", "cntr_str_20min": "171.02", "cntr_str_60min": "170.70", "stex_tp": "KRX" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 134 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 체결강도추이일별요청(ka10047) API 명 체결강도추이일별요청 API ID ka10047 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body cntr_str_daly 체결강도일별 LIST N Body - dt 일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre 전일대비 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - acc_trde_prica 누적거래대금 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - cntr_str 체결강도 String N 20 Body - cntr_str_5min 체결강도5일 String N 20 135 / 528 Response 구분 Element 한글명 Type Require d Length Body - cntr_str_20min 체결강도20일 String N 20 Body - cntr_str_60min 체결강도60일 String N 20 Request Example { } "stk_cd": "005930" Response Example { } "cntr_str_daly": [ { "dt": "20241128", "cur_prc": "+219000", "pred_pre": "+14000", "pred_pre_sig": "2", "flu_rt": "+6.83", "trde_qty": "", "acc_trde_prica": "2", "acc_trde_qty": "8", "cntr_str": "0.00", "cntr_str_5min": "201.54", "cntr_str_20min": "139.37", "cntr_str_60min": "172.06" }, { "dt": "20241127", "cur_prc": "+205000", "pred_pre": "+40300", "pred_pre_sig": "2", "flu_rt": "+24.47", "trde_qty": "", "acc_trde_prica": "9", "acc_trde_qty": "58", "cntr_str": "0.00", "cntr_str_5min": "209.54", "cntr_str_20min": "139.37", "cntr_str_60min": "180.40" }, { "dt": "20241126", "cur_prc": "+164700", "pred_pre": "+38000", "pred_pre_sig": "1", "flu_rt": "+29.99", "trde_qty": "", "acc_trde_prica": "2", "acc_trde_qty": "15", "cntr_str": "7.69", "cntr_str_5min": "309.54", "cntr_str_20min": "164.37", "cntr_str_60min": "188.73" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 136 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW일별민감도지표요청(ka10048) API 명 ELW일별민감도지표요청 API ID ka10048 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwdaly_snst_ix ELW일별민감도지표 LIST N Body - dt 일자 String N 20 Body - iv IV String N 20 Body - delta 델타 String N 20 Body - gam 감마 String N 20 Body - theta 쎄타 String N 20 Body - vega 베가 String N 20 Body - law 로 String N 20 Body - lp LP String N 20 Request Example { Description "stk_cd": "57JBHH" 137 / 528 Request Example } Response Example { "elwdaly_snst_ix": [ { "dt": "000000", "iv": "1901", "delta": "126664", "gam": "5436", "theta": "-5271886", "vega": "41752995", "law": "13982453", "lp": "0" }, { "dt": "000000", "iv": "1901", "delta": "126664", "gam": "5436", "theta": "-5271886", "vega": "41752995", "law": "13982453", "lp": "0" }, { "dt": "000000", "iv": "1901", "delta": "126664", "gam": "5436", "theta": "-5271886", "vega": "41752995", "law": "13982453", "lp": "0" }, { "dt": "000000", "iv": "1901", "delta": "126664", "gam": "5436", "theta": "-5271886", "vega": "41752995", "law": "13982453", "lp": "0" }, { "dt": "000000", "iv": "1901", "delta": "126664", "gam": "5436", "theta": "-5271886", "vega": "41752995", "law": "13982453", "lp": "0" }, { "dt": "000000", "iv": "1901", "delta": "126664", "gam": "5436", "theta": "-5271886", "vega": "41752995", "law": "13982453", "lp": "0" }, { "dt": "000000", "iv": "1901", "delta": "126664", "gam": "5436", "theta": "-5271886", "vega": "41752995", "law": "13982453", "lp": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 138 / 528 Response Example } 139 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW민감도지표요청(ka10050) API 명 ELW민감도지표요청 API ID ka10050 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwsnst_ix_array ELW민감도지표배열 LIST N Body - cntr_tm 체결시간 String N 20 Body - cur_prc 현재가 String N 20 Body - elwtheory_pric ELW이론가 String N 20 Body - iv IV String N 20 Body - delta 델타 String N 20 Body - gam 감마 String N 20 Body - theta 쎄타 String N 20 Body - vega 베가 String N 20 Body - law 로 String N 20 Body - lp LP String N 20 140 / 528 Request Example { } "stk_cd": "57JBHH" Response Example { } "elwsnst_ix_array": [ { "cntr_tm": "095820", "cur_prc": "5", "elwtheory_pric": "4", "iv": "3336", "delta": "7128", "gam": "904", "theta": "-2026231", "vega": "1299294", "law": "95218", "lp": "0" }, { "cntr_tm": "095730", "cur_prc": "5", "elwtheory_pric": "4", "iv": "3342", "delta": "7119", "gam": "902", "theta": "-2026391", "vega": "1297498", "law": "95078", "lp": "0" }, { "cntr_tm": "095640", "cur_prc": "5", "elwtheory_pric": "4", "iv": "3345", "delta": "7114", "gam": "900", "theta": "-2026285", "vega": "1296585", "law": "95012", "lp": "0" }, { "cntr_tm": "095550", "cur_prc": "5", "elwtheory_pric": "4", "iv": "3346", "delta": "7111", "gam": "900", "theta": "-2026075", "vega": "1296025", "law": "94974", "lp": "0" }, { "cntr_tm": "095500", "cur_prc": "5", "elwtheory_pric": "4", "iv": "3339", "delta": "7121", "gam": "902", "theta": "-2025002", "vega": "1298269", "law": "95168", "lp": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 141 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 업종 > 업종별투자자순매수요청(ka10051) API 명 업종별투자자순매수요청 API ID ka10051 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/sect Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 1 코스피:0, 코스닥:1 Body amt_qty_tp 금액수량구분 String Y 1 금액:0, 수량:1 Body base_dt 기준일자 String N 8 YYYYMMDD Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_netprps 업종별순매수 LIST N Body - inds_cd 업종코드 String N 20 Body - inds_nm 업종명 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_smbol 대비부호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 142 / 528 Response 구분 Element 한글명 Type Require d Length Body - sc_netprps 증권순매수 String N 20 Body - insrnc_netprps 보험순매수 String N 20 Body - invtrt_netprps 투신순매수 String N 20 Body - bank_netprps 은행순매수 String N 20 Body - jnsinkm_netprps 종신금순매수 String N 20 Body - endw_netprps 기금순매수 String N 20 Body - etc_corp_netprps 기타법인순매수 String N 20 Body - ind_netprps 개인순매수 String N 20 Body - frgnr_netprps 외국인순매수 String N 20 Body - native_trmt_frgnr_n etprps 내국인대우외국인순 매수 String N 20 Body - natn_netprps 국가순매수 String N 20 Body samo_fund_netprps 사모펀드순매수 String N 20 Body - orgn_netprps 기관계순매수 String N 20 Request Example { } "mrkt_tp": "0", "amt_qty_tp": "0", "base_dt": "20241107", "stex_tp": "3" Response Example { "inds_netprps": [ { "inds_cd": "001_AL", "inds_nm": "종합(KOSPI)", "cur_prc": "+265381", "pre_smbol": "2", "pred_pre": "+9030", "flu_rt": "352", "trde_qty": "1164", "sc_netprps": "+255", "insrnc_netprps": "+0", "invtrt_netprps": "+0", "bank_netprps": "+0", "jnsinkm_netprps": "+0", "endw_netprps": "+0", "etc_corp_netprps": "+0", "ind_netprps": "-0", "frgnr_netprps": "-622", "native_trmt_frgnr_netprps": "+4", "natn_netprps": "+0", "samo_fund_netprps": "+1", "orgn_netprps": "+601" }, { "inds_cd": "002_AL", "inds_nm": "대형주", "cur_prc": "+265964", "pre_smbol": "2", "pred_pre": "+10690", "flu_rt": "419", "trde_qty": "1145", "sc_netprps": "+255", "insrnc_netprps": "+0", "invtrt_netprps": "+0", "bank_netprps": "+0", 143 / 528 Description Response Example "jnsinkm_netprps": "+0", "endw_netprps": "+0", "etc_corp_netprps": "+0", "ind_netprps": "+16", "frgnr_netprps": "-622", "native_trmt_frgnr_netprps": "+4", "natn_netprps": "+0", "samo_fund_netprps": "+1", "orgn_netprps": "+602" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 144 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 거래원순간거래량요청(ka10052) API 명 거래원순간거래량요청 API ID ka10052 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mmcm_cd 회원사코드 String Y 3 회원사 코드는 ka10102 조회 Body stk_cd 종목코드 String N 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body mrkt_tp 시장구분 String Y 1 0:전체, 1:코스피, 2:코스닥, 3:종목 Body qty_tp 수량구분 String Y 3 0:전체, 1:1000주, 2:2000주, 3:, 5:, 10:10000주, 30: 30000주, 50: 50000주, 100: 100000주 Body pric_tp 가격구분 String Y 1 0:전체, 1:1천원 미만, 8:1천원 이상, 2:1천원 ~ 2천원, 3:2천원 ~ 5천원, 4:5천원 ~ 1만원, 5:1만원 이상 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trde_ori_mont_trde_ qty 거래원순간거래량 LIST N Body - tm 시간 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 20 145 / 528 Response Type Require d Length 거래원명 String N 20 - tp 구분 String N 20 Body - mont_trde_qty 순간거래량 String N 20 Body - acc_netprps 누적순매수 String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 구분 Element Body - trde_ori_nm Body 한글명 Request Example { } "mmcm_cd": "888", "stk_cd": "", "mrkt_tp": "0", "qty_tp": "0", "pric_tp": "0", "stex_tp": "3" Response Example { } "trde_ori_mont_trde_qty": [ { "tm": "161437", "stk_cd": "005930", "stk_nm": "삼성전자", "trde_ori_nm": "다이와", "tp": "-매도", "mont_trde_qty": "-399928", "acc_netprps": "-1073004", "cur_prc": "+57700", "pred_pre_sig": "2", "pred_pre": "400", "flu_rt": "+0.70" }, { "tm": "161423", "stk_cd": "005930", "stk_nm": "삼성전자", "trde_ori_nm": "다이와", "tp": "-매도", "mont_trde_qty": "-100000", "acc_netprps": "-673076", "cur_prc": "+57700", "pred_pre_sig": "2", "pred_pre": "400", "flu_rt": "+0.70" }, { "tm": "161417", "stk_cd": "005930", "stk_nm": "삼성전자", "trde_ori_nm": "다이와", "tp": "-매도", "mont_trde_qty": "-100000", "acc_netprps": "-573076", "cur_prc": "+57700", "pred_pre_sig": "2", "pred_pre": "400", "flu_rt": "+0.70" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 146 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 당일상위이탈원요청(ka10053) API 명 당일상위이탈원요청 API ID ka10053 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tdy_upper_scesn_ori 당일상위이탈원 LIST N Body - sel_scesn_tm 매도이탈시간 String N 20 Body - sell_qty 매도수량 String N 20 Body sel_upper_scesn_ori 매도상위이탈원 String N 20 Body - buy_scesn_tm 매수이탈시간 String N 20 Body - buy_qty 매수수량 String N 20 Body buy_upper_scesn_ori 매수상위이탈원 String N 20 Body - qry_dt 조회일자 String N 20 Body - qry_tm 조회시간 String N 20 Request Example 147 / 528 Request Example { } "stk_cd": "005930" Response Example { } "tdy_upper_scesn_ori": [ { "sel_scesn_tm": "154706", "sell_qty": "32", "sel_upper_scesn_ori": "키움증권", "buy_scesn_tm": "151615", "buy_qty": "48", "buy_upper_scesn_ori": "키움증권", "qry_dt": "012", "qry_tm": "012" }, { "sel_scesn_tm": "145127", "sell_qty": "14", "sel_upper_scesn_ori": "키움증권", "buy_scesn_tm": "144055", "buy_qty": "21", "buy_upper_scesn_ori": "키움증권", "qry_dt": "017", "qry_tm": "046" }, { "sel_scesn_tm": "145117", "sell_qty": "10", "sel_upper_scesn_ori": "키움증권", "buy_scesn_tm": "140901", "buy_qty": "3", "buy_upper_scesn_ori": "키움증권", "qry_dt": "050", "qry_tm": "056" }, { "sel_scesn_tm": "", "sell_qty": "", "sel_upper_scesn_ori": "", "buy_scesn_tm": "135548", "buy_qty": "2", "buy_upper_scesn_ori": "키움증권", "qry_dt": "", "qry_tm": "001" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 148 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 변동성완화장치발동종목요청(ka10054) API 명 변동성완화장치발동종목요청 API ID ka10054 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001: 코스피, 101:코스닥 Body bf_mkrt_tp 장전구분 String Y 1 0:전체, 1:정규시장,2:시간외단일가 Body stk_cd 종목코드 String N 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 공백입력시 시장구분으로 설정한 전체종목조회 Body motn_tp 발동구분 String Y 1 0:전체, 1:정적VI, 2:동적VI, 3:동적VI + 정적VI 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body skip_stk 제외종목 String Y 9 전종목포함 조회시 9개 0으로 설정(000000000),전종목제외 조회시 9개 1으로 설정(111111111),9개 종목조회여부를 조회포함(0), 조회제외(1)로 설정하며 종목순서는 우선주,관리 종목,투자경고/위험,투자주의,환기종목,단기과열종목,증거금1 00%,ETF,ETN가 됨.우선주만 조회시"011111111"", 관리종목만 조회시 ""101111111"" 설정" Body trde_qty_tp 거래량구분 String Y 1 0:사용안함, 1:사용 Body min_trde_qty 최소거래량 String Y 12 0 주 이상, 거래량구분이 1일때만 입력(공백허용) Body max_trde_qty 최대거래량 String Y 12 100000000 주 이하, 거래량구분이 1일때만 입력(공백허용) Body trde_prica_tp 거래대금구분 String Y 1 0:사용안함, 1:사용 Body min_trde_prica 최소거래대금 String Y 10 0 백만원 이상, 거래대금구분 1일때만 입력(공백허용) Body max_trde_prica 최대거래대금 String Y 10 100000000 백만원 이하, 거래대금구분 1일때만 입력(공백허용) Body motn_drc 발동방향 String Y 1 0:전체, 1:상승, 2:하락 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 149 / 528 Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body motn_stk 발동종목 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - acc_trde_qty 누적거래량 String N 20 Body - motn_pric 발동가격 String N 20 Body - dynm_dispty_rt 동적괴리율 String N 20 Body trde_cntr_proc_time 매매체결처리시각 String N 20 Body - virelis_time VI해제시각 String N 20 Body - viaplc_tp VI적용구분 String N 20 Body - dynm_stdpc 동적기준가격 String N 20 Body - static_stdpc 정적기준가격 String N 20 Body - static_dispty_rt 정적괴리율 String N 20 Body open_pric_pre_flu_rt 시가대비등락률 String N 20 Body - vimotn_cnt VI발동횟수 String N 20 Body - stex_tp 거래소구분 String N 20 Request Example { } "mrkt_tp": "000", "bf_mkrt_tp": "0", "stk_cd": "", "motn_tp": "0", "skip_stk": "000000000", "trde_qty_tp": "0", "min_trde_qty": "0", "max_trde_qty": "0", "trde_prica_tp": "0", "min_trde_prica": "0", "max_trde_prica": "0", "motn_drc": "0", "stex_tp": "3" Response Example { Description "motn_stk": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "acc_trde_qty": "1105968", "motn_pric": "67000", "dynm_dispty_rt": "+9.30", "trde_cntr_proc_time": "172311", "virelis_time": "172511", "viaplc_tp": "동적", "dynm_stdpc": "61300", "static_stdpc": "0", "static_dispty_rt": "0.00", "open_pric_pre_flu_rt": "+16.93", "vimotn_cnt": "23", 150 / 528 Response Example }, { }, { }, { } "stex_tp": "NXT" "stk_cd": "005930", "stk_nm": "삼성전자", "acc_trde_qty": "1105968", "motn_pric": "65000", "dynm_dispty_rt": "-3.13", "trde_cntr_proc_time": "170120", "virelis_time": "170320", "viaplc_tp": "동적", "dynm_stdpc": "67100", "static_stdpc": "0", "static_dispty_rt": "0.00", "open_pric_pre_flu_rt": "+13.44", "vimotn_cnt": "22", "stex_tp": "NXT" "stk_cd": "005930", "stk_nm": "삼성전자", "acc_trde_qty": "14", "motn_pric": "95100", "dynm_dispty_rt": "-1.96", "trde_cntr_proc_time": "163030", "virelis_time": "163224", "viaplc_tp": "동적", "dynm_stdpc": "97000", "static_stdpc": "0", "static_dispty_rt": "0.00", "open_pric_pre_flu_rt": "+0.11", "vimotn_cnt": "2", "stex_tp": "KRX" "stk_cd": "005930", "stk_nm": "삼성전자", "acc_trde_qty": "153", "motn_pric": "250000", "dynm_dispty_rt": "+22.55", "trde_cntr_proc_time": "163030", "virelis_time": "163224", "viaplc_tp": "동적+정적", "dynm_stdpc": "204000", "static_stdpc": "203500", "static_dispty_rt": "+22.85", "open_pric_pre_flu_rt": "+27.62", "vimotn_cnt": "3", "stex_tp": "KRX" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 151 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 당일전일체결량요청(ka10055) API 명 당일전일체결량요청 API ID ka10055 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body tdy_pred 당일전일 String Y 1 1:당일, 2:전일 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tdy_pred_cntr_qty 당일전일체결량 LIST N Body - cntr_tm 체결시간 String N 20 Body - cntr_pric 체결가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - cntr_qty 체결량 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - acc_trde_prica 누적거래대금 String N 20 Request Example 152 / 528 Request Example { } "stk_cd": "005930", "tdy_pred": "2" Response Example { } "tdy_pred_cntr_qty": [ { "cntr_tm": "171945", "cntr_pric": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+29.86", "cntr_qty": "-1793", "acc_trde_qty": "446203", "acc_trde_prica": "33225" }, { "cntr_tm": "154626", "cntr_pric": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+29.86", "cntr_qty": "-1", "acc_trde_qty": "444401", "acc_trde_prica": "33090" }, { "cntr_tm": "154626", "cntr_pric": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+29.86", "cntr_qty": "-1", "acc_trde_qty": "444400", "acc_trde_prica": "33090" }, { "cntr_tm": "154357", "cntr_pric": "+74800", "pred_pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+29.86", "cntr_qty": "-100", "acc_trde_qty": "444399", "acc_trde_prica": "33090" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 153 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 투자자별일별매매종목요청(ka10058) API 명 투자자별일별매매종목요청 API ID ka10058 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD Body trde_tp 매매구분 String Y 1 순매도:1, 순매수:2 Body mrkt_tp 시장구분 String Y 3 001:코스피, 101:코스닥 Body invsr_tp 투자자구분 String Y 4 8000:개인, 9000:외국인, 1000:금융투자, 3000:투신, 3100:사모펀드, 5000:기타금융, 4000:은행, 2000:보험, 6000:연기금, 7000:국가, 7100:기타법인, 9999:기관계 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body invsr_daly_trde_stk 투자자별일별매매종 목 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - netslmt_qty 순매도수량 String N 20 Body - netslmt_amt 순매도금액 String N 20 154 / 528 Response Type Require d Length 추정평균가 String N 20 - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - avg_pric_pre 평균가대비 String N 20 Body - pre_rt 대비율 String N 20 Body - dt_trde_qty 기간거래량 String N 20 구분 Element Body - prsm_avg_pric Body 한글명 Request Example { } "strt_dt": "20241106", "end_dt": "20241107", "trde_tp": "2", "mrkt_tp": "101", "invsr_tp": "8000", "stex_tp": "3" Response Example { } "invsr_daly_trde_stk": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "netslmt_qty": "+4464", "netslmt_amt": "+25467", "prsm_avg_pric": "57056", "cur_prc": "+61300", "pre_sig": "2", "pred_pre": "+4000", "avg_pric_pre": "+4244", "pre_rt": "+7.43", "dt_trde_qty": "1554171" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "netslmt_qty": "+12", "netslmt_amt": "+106", "prsm_avg_pric": "86658", "cur_prc": "+100200", "pre_sig": "2", "pred_pre": "+5200", "avg_pric_pre": "+13542", "pre_rt": "+15.62", "dt_trde_qty": "12868" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "netslmt_qty": "+46", "netslmt_amt": "+75", "prsm_avg_pric": "16320", "cur_prc": "15985", "pre_sig": "3", "pred_pre": "0", "avg_pric_pre": "--335", "pre_rt": "-2.05", "dt_trde_qty": "4770" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 155 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 종목별투자자기관별요청(ka10059) API 명 종목별투자자기관별요청 API ID ka10059 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dt 일자 String Y 8 YYYYMMDD Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body amt_qty_tp 금액수량구분 String Y 1 1:금액, 2:수량 Body trde_tp 매매구분 String Y 1 0:순매수, 1:매수, 2:매도 Body unit_tp 단위구분 String Y 4 1000:천주, 1:단주 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_invsr_orgn 종목별투자자기관별 LIST N Body - dt 일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - acc_trde_qty 누적거래량 String N 20 156 / 528 우측 2자리 소수점자리수 Response 구분 Element 한글명 Type Require d Length Body - acc_trde_prica 누적거래대금 String N 20 Body - ind_invsr 개인투자자 String N 20 Body - frgnr_invsr 외국인투자자 String N 20 Body - orgn 기관계 String N 20 Body - fnnc_invt 금융투자 String N 20 Body - insrnc 보험 String N 20 Body - invtrt 투신 String N 20 Body - etc_fnnc 기타금융 String N 20 Body - bank 은행 String N 20 Body - penfnd_etc 연기금등 String N 20 Body - samo_fund 사모펀드 String N 20 Body - natn 국가 String N 20 Body - etc_corp 기타법인 String N 20 Body - natfor 내외국인 String N 20 Request Example { } "dt": "20241107", "stk_cd": "005930", "amt_qty_tp": "1", "trde_tp": "0", "unit_tp": "1000" Response Example { "stk_invsr_orgn": [ { "dt": "20241107", "cur_prc": "+61300", "pre_sig": "2", "pred_pre": "+4000", "flu_rt": "+698", "acc_trde_qty": "1105968", "acc_trde_prica": "64215", "ind_invsr": "1584", "frgnr_invsr": "-61779", "orgn": "60195", "fnnc_invt": "25514", "insrnc": "0", "invtrt": "0", "etc_fnnc": "34619", "bank": "4", "penfnd_etc": "-1", "samo_fund": "58", "natn": "0", "etc_corp": "0", "natfor": "1" }, { "dt": "20241106", "cur_prc": "+74800", "pre_sig": "1", "pred_pre": "+17200", "flu_rt": "+2986", "acc_trde_qty": "448203", "acc_trde_prica": "33340", "ind_invsr": "-639", "frgnr_invsr": "-7", "orgn": "646", 157 / 528 Description Response Example "fnnc_invt": "-47", "insrnc": "15", "invtrt": "-2", "etc_fnnc": "730", "bank": "-51", "penfnd_etc": "1", "samo_fund": "0", "natn": "0", "etc_corp": "0", "natfor": "0" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 158 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 종목별투자자기관별차트요청(ka10060) API 명 종목별투자자기관별차트요청 API ID ka10060 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dt 일자 String Y 8 YYYYMMDD Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body amt_qty_tp 금액수량구분 String Y 1 1:금액, 2:수량 Body trde_tp 매매구분 String Y 1 0:순매수, 1:매수, 2:매도 Body unit_tp 단위구분 String Y 4 1000:천주, 1:단주 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_invsr_orgn_chart 종목별투자자기관별 차트 LIST N Body - dt 일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre 전일대비 String N 20 Body - acc_trde_prica 누적거래대금 String N 20 Body - ind_invsr 개인투자자 String N 20 159 / 528 Response 구분 Element 한글명 Type Require d Length Body - frgnr_invsr 외국인투자자 String N 20 Body - orgn 기관계 String N 20 Body - fnnc_invt 금융투자 String N 20 Body - insrnc 보험 String N 20 Body - invtrt 투신 String N 20 Body - etc_fnnc 기타금융 String N 20 Body - bank 은행 String N 20 Body - penfnd_etc 연기금등 String N 20 Body - samo_fund 사모펀드 String N 20 Body - natn 국가 String N 20 Body - etc_corp 기타법인 String N 20 Body - natfor 내외국인 String N 20 Request Example { } "dt": "20241107", "stk_cd": "005930", "amt_qty_tp": "1", "trde_tp": "0", "unit_tp": "1000" Response Example { "stk_invsr_orgn_chart": [ { "dt": "20241107", "cur_prc": "+61300", "pred_pre": "+4000", "acc_trde_prica": "1105968", "ind_invsr": "1584", "frgnr_invsr": "-61779", "orgn": "60195", "fnnc_invt": "25514", "insrnc": "0", "invtrt": "0", "etc_fnnc": "34619", "bank": "4", "penfnd_etc": "-1", "samo_fund": "58", "natn": "0", "etc_corp": "0", "natfor": "1" }, { "dt": "20241106", "cur_prc": "+74800", "pred_pre": "+17200", "acc_trde_prica": "448203", "ind_invsr": "-639", "frgnr_invsr": "-7", "orgn": "646", "fnnc_invt": "-47", "insrnc": "15", "invtrt": "-2", "etc_fnnc": "730", "bank": "-51", "penfnd_etc": "1", "samo_fund": "0", "natn": "0", "etc_corp": "0", "natfor": "0" 160 / 528 Description Response Example } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 161 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 종목별투자자기관별합계요청(ka10061) API 명 종목별투자자기관별합계요청 API ID ka10061 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD Body amt_qty_tp 금액수량구분 String Y 1 1:금액, 2:수량 Body trde_tp 매매구분 String Y 1 0:순매수 Body unit_tp 단위구분 String Y 4 1000:천주, 1:단주 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_invsr_orgn_tot 종목별투자자기관별 합계 LIST N Body - ind_invsr 개인투자자 String N 20 Body - frgnr_invsr 외국인투자자 String N 20 Body - orgn 기관계 String N 20 Body - fnnc_invt 금융투자 String N 20 162 / 528 Response 구분 Element 한글명 Type Require d Length Body - insrnc 보험 String N 20 Body - invtrt 투신 String N 20 Body - etc_fnnc 기타금융 String N 20 Body - bank 은행 String N 20 Body - penfnd_etc 연기금등 String N 20 Body - samo_fund 사모펀드 String N 20 Body - natn 국가 String N 20 Body - etc_corp 기타법인 String N 20 Body - natfor 내외국인 String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241007", "end_dt": "20241107", "amt_qty_tp": "1", "trde_tp": "0", "unit_tp": "1000" Response Example { } "stk_invsr_orgn_tot": [ { "ind_invsr": "--28837", "frgnr_invsr": "--40142", "orgn": "+64891", "fnnc_invt": "+72584", "insrnc": "--9071", "invtrt": "--7790", "etc_fnnc": "+35307", "bank": "+526", "penfnd_etc": "--22783", "samo_fund": "--3881", "natn": "0", "etc_corp": "+1974", "natfor": "+2114" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 163 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 동일순매매순위요청(ka10062) API 명 동일순매매순위요청 API ID ka10062 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String Y 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body end_dt 종료일자 String N 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body mrkt_tp 시장구분 String Y 3 000:전체, 001: 코스피, 101:코스닥 Body trde_tp 매매구분 String Y 1 1:순매수, 2:순매도 Body sort_cnd 정렬조건 String Y 1 1:수량, 2:금액 Body unit_tp 단위구분 String Y 1 1:단주, 1000:천주 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body eql_nettrde_rank 동일순매매순위 LIST N Body - stk_cd 종목코드 String N 20 Body - rank 순위 String N 20 Body - stk_nm 종목명 String N 40 164 / 528 Response 구분 Element 한글명 Type Require d Length Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - orgn_nettrde_qty 기관순매매수량 String N 20 Body - orgn_nettrde_amt 기관순매매금액 String N 20 Body - orgn_nettrde_avg_ pric 기관순매매평균가 String N 20 Body - for_nettrde_qty 외인순매매수량 String N 20 Body - for_nettrde_amt 외인순매매금액 String N 20 Body for_nettrde_avg_pric 외인순매매평균가 String N 20 Body - nettrde_qty 순매매수량 String N 20 Body - nettrde_amt 순매매금액 String N 20 Request Example { } "strt_dt": "20241106", "end_dt": "20241107", "mrkt_tp": "000", "trde_tp": "1", "sort_cnd": "1", "unit_tp": "1", "stex_tp": "3" Response Example { } "eql_nettrde_rank": [ { "stk_cd": "005930", "rank": "1", "stk_nm": "삼성전자", "cur_prc": "-206000", "pre_sig": "5", "pred_pre": "-500", "flu_rt": "-0.24", "acc_trde_qty": "85", "orgn_nettrde_qty": "+2", "orgn_nettrde_amt": "0", "orgn_nettrde_avg_pric": "206000", "for_nettrde_qty": "+275", "for_nettrde_amt": "+59", "for_nettrde_avg_pric": "213342", "nettrde_qty": "+277", "nettrde_amt": "+59" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 165 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 장중투자자별매매요청(ka10063) API 명 장중투자자별매매요청 API ID ka10063 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body amt_qty_tp 금액수량구분 String Y 1 1: 금액&수량 Body invsr 투자자별 String Y 1 6:외국인, 7:기관계, 1:투신, 0:보험, 2:은행, 3:연기금, 4:국가, 5:기타법인 Body frgn_all 외국계전체 String Y 1 1:체크, 0:미체크 Body smtm_netprps_tp 동시순매수구분 String Y 1 1:체크, 0:미체크 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body opmr_invsr_trde 장중투자자별매매 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 166 / 528 Response 구분 Element 한글명 Type Require d Length Body - flu_rt 등락율 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - netprps_amt 순매수금액 String N 20 Body - prev_netprps_amt 이전순매수금액 String N 20 Body - buy_amt 매수금액 String N 20 Body - netprps_amt_irds 순매수금액증감 String N 20 Body - buy_amt_irds 매수금액증감 String N 20 Body - sell_amt 매도금액 String N 20 Body - sell_amt_irds 매도금액증감 String N 20 Body - netprps_qty 순매수수량 String N 20 Body - prev_pot_netprps_ qty 이전시점순매수수량 String N 20 Body - netprps_irds 순매수증감 String N 20 Body - buy_qty 매수수량 String N 20 Body - buy_qty_irds 매수수량증감 String N 20 Body - sell_qty 매도수량 String N 20 Body - sell_qty_irds 매도수량증감 String N 20 Request Example { } "mrkt_tp": "000", "amt_qty_tp": "1", "invsr": "6", "frgn_all": "0", "smtm_netprps_tp": "0", "stex_tp": "3" Response Example { 'opmr_invsr_trde': [ { 'stk_cd': '005930', 'stk_nm': '삼성전자', 'cur_prc': '64', 'pre_sig': '3', 'pred_pre': '0', 'flu_rt': '0.00', 'acc_trde_qty': '1', 'netprps_qty': '+1083000', 'prev_pot_netprps_qty': '+1083000', 'netprps_irds': '0', 'buy_qty': '+1113000', 'buy_qty_irds': '0', 'sell_qty': '--30000', 'sell_qty_irds': '0' }, { 'stk_cd': '005930', 'stk_nm': '삼성전자', 'cur_prc': '284', 'pre_sig': '3', 'pred_pre': '0', 'flu_rt': '0.00', 'acc_trde_qty': '0', 'netprps_qty': '--261000', 167 / 528 Description Response Example 'prev_pot_netprps_qty': '--347000', 'netprps_irds': '+86000', 'buy_qty': '+2728000', 'buy_qty_irds': '+108000', 'sell_qty': '--2989000', 'sell_qty_irds': '+22000' } } ], 'return_code': 0, 'return_msg': '정상적으로 처리되었습니다' 168 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 장중투자자별매매차트요청(ka10064) API 명 장중투자자별매매차트요청 API ID ka10064 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body amt_qty_tp 금액수량구분 String Y 1 1:금액, 2:수량 Body trde_tp 매매구분 String Y 1 0:순매수, 1:매수, 2:매도 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body opmr_invsr_trde_cha rt 장중투자자별매매차 트 LIST N Body - tm 시간 String N 20 Body - frgnr_invsr 외국인투자자 String N 20 Body - orgn 기관계 String N 20 Body - invtrt 투신 String N 20 Body - insrnc 보험 String N 20 Body - bank 은행 String N 20 169 / 528 Response 구분 Element 한글명 Type Require d Length Body - penfnd_etc 연기금등 String N 20 Body - etc_corp 기타법인 String N 20 Body - natn 국가 String N 20 Request Example { } "mrkt_tp": "000", "amt_qty_tp": "1", "trde_tp": "0", "stk_cd": "005930" Response Example { } "opmr_invsr_trde_chart": [ { "tm": "090000", "frgnr_invsr": "0", "orgn": "0", "invtrt": "0", "insrnc": "0", "bank": "0", "penfnd_etc": "0", "etc_corp": "0", "natn": "0" }, { "tm": "092200", "frgnr_invsr": "3", "orgn": "0", "invtrt": "0", "insrnc": "0", "bank": "0", "penfnd_etc": "0", "etc_corp": "0", "natn": "0" }, { "tm": "095200", "frgnr_invsr": "-68", "orgn": "0", "invtrt": "0", "insrnc": "0", "bank": "0", "penfnd_etc": "0", "etc_corp": "0", "natn": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 170 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 장중투자자별매매상위요청(ka10065) API 명 장중투자자별매매상위요청 API ID ka10065 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trde_tp 매매구분 String Y 1 1:순매수, 2:순매도 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body orgn_tp 기관구분 String Y 4 9000:외국인, 9100:외국계, 1000:금융투자, 3000:투신, 5000:기타금융, 4000:은행, 2000:보험, 6000:연기금, 7000:국가, 7100:기타법인, 9999:기관계 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body opmr_invsr_trde_upp er 장중투자자별매매상 위 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - sel_qty 매도량 String N 20 Body - buy_qty 매수량 String N 20 Body - netslmt 순매도 String N 20 Request Example { 171 / 528 Request Example } "trde_tp": "1", "mrkt_tp": "000", "orgn_tp": "9000" Response Example { } "opmr_invsr_trde_upper": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "sel_qty": "-39420", "buy_qty": "+73452", "netslmt": "+34033" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "sel_qty": "-13970", "buy_qty": "+25646", "netslmt": "+11676" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "sel_qty": "-10063", "buy_qty": "+21167", "netslmt": "+11104" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "sel_qty": "-37542", "buy_qty": "+47604", "netslmt": "+10061" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "sel_qty": "-2310", "buy_qty": "+10874", "netslmt": "+8564" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "sel_qty": "-24912", "buy_qty": "+33114", "netslmt": "+8203" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "sel_qty": "-27306", "buy_qty": "+34853", "netslmt": "+7547" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 172 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 장마감후투자자별매매요청(ka10066) API 명 장마감후투자자별매매요청 API ID ka10066 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body amt_qty_tp 금액수량구분 String Y 1 1:금액, 2:수량 Body trde_tp 매매구분 String Y 1 0:순매수, 1:매수, 2:매도 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body opaf_invsr_trde 장중투자자별매매차 트 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 173 / 528 Response 구분 Element 한글명 Type Require d Length Body - ind_invsr 개인투자자 String N 20 Body - frgnr_invsr 외국인투자자 String N 20 Body - orgn 기관계 String N 20 Body - fnnc_invt 금융투자 String N 20 Body - insrnc 보험 String N 20 Body - invtrt 투신 String N 20 Body - etc_fnnc 기타금융 String N 20 Body - bank 은행 String N 20 Body - penfnd_etc 연기금등 String N 20 Body - samo_fund 사모펀드 String N 20 Body - natn 국가 String N 20 Body - etc_corp 기타법인 String N 20 Request Example { } "mrkt_tp": "000", "amt_qty_tp": "1", "trde_tp": "0", "stex_tp": "3" Response Example { "opaf_invsr_trde": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-7410", "pre_sig": "5", "pred_pre": "-50", "flu_rt": "-0.67", "trde_qty": "8", "ind_invsr": "0", "frgnr_invsr": "0", "orgn": "0", "fnnc_invt": "0", "insrnc": "0", "invtrt": "0", "etc_fnnc": "0", "bank": "0", "penfnd_etc": "0", "samo_fund": "0", "natn": "0", "etc_corp": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "542", "pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "ind_invsr": "0", "frgnr_invsr": "0", "orgn": "0", "fnnc_invt": "0", "insrnc": "0", "invtrt": "0", "etc_fnnc": "0", "bank": "0", "penfnd_etc": "0", 174 / 528 Description Response Example "samo_fund": "0", "natn": "0", "etc_corp": "0" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 175 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 대차거래 > 대차거래추이요청(ka10068) API 명 대차거래추이요청 API ID ka10068 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/slb Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String N 8 YYYYMMDD Body end_dt 종료일자 String N 8 YYYYMMDD Body all_tp 전체구분 String Y 6 1: 전체표시 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dbrt_trde_trnsn 대차거래추이 LIST N Body - dt 일자 String N 8 Body - dbrt_trde_cntrcnt 대차거래체결주수 String N 12 Body - dbrt_trde_rpy 대차거래상환주수 String N 18 Body - rmnd 잔고주수 String N 18 Body - dbrt_trde_irds 대차거래증감 String N 60 Body - remn_amt 잔고금액 String N 18 Request Example { Description "strt_dt": "20250401", 176 / 528 Request Example } "end_dt": "20250430", "all_tp": "1" Response Example { } "dbrt_trde_trnsn": [ { "dt": "20250430", "dbrt_trde_cntrcnt": "35330036", "dbrt_trde_rpy": "25217364", "dbrt_trde_irds": "10112672", "rmnd": "2460259444", "remn_amt": "73956254" }, { "dt": "20250429", "dbrt_trde_cntrcnt": "23721553", "dbrt_trde_rpy": "13986586", "dbrt_trde_irds": "9734967", "rmnd": "2125919149", "remn_amt": "66422682" }, { "dt": "20250428", "dbrt_trde_cntrcnt": "17165250", "dbrt_trde_rpy": "30883228", "dbrt_trde_irds": "-13717978", "rmnd": "2276180199", "remn_amt": "68480718" }, { "dt": "20250425", "dbrt_trde_cntrcnt": "62932490", "dbrt_trde_rpy": "85148199", "dbrt_trde_irds": "-22215709", "rmnd": "2355269107", "remn_amt": "69882489" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 177 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 대차거래 > 대차거래상위10종목요청(ka10069) API 명 대차거래상위10종목요청 API ID ka10069 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/slb Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String Y 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body end_dt 종료일자 String N 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body mrkt_tp 시장구분 String Y 3 001:코스피, 101:코스닥 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dbrt_trde_cntrcnt_su m 대차거래체결주수합 String N Body dbrt_trde_rpy_sum 대차거래상환주수합 String N Body rmnd_sum 잔고주수합 String N Body remn_amt_sum 잔고금액합 String N Body dbrt_trde_cntrcnt_rt 대차거래체결주수비 율 String N Body dbrt_trde_rpy_rt 대차거래상환주수비 율 String N Body rmnd_rt 잔고주수비율 String N 178 / 528 Response 구분 Element 한글명 Type Require d Length Body remn_amt_rt 잔고금액비율 String N Body dbrt_trde_upper_10s tk 대차거래상위10종목 LIST N Body - stk_nm 종목명 String N 40 Body - stk_cd 종목코드 String N 20 Body - dbrt_trde_cntrcnt 대차거래체결주수 String N 20 Body - dbrt_trde_rpy 대차거래상환주수 String N 20 Body - rmnd 잔고주수 String N 20 Body - remn_amt 잔고금액 String N 20 Request Example { } "strt_dt": "20241110", "end_dt": "20241125", "mrkt_tp": "001" Response Example { } "dbrt_trde_cntrcnt_sum": "3383301", "dbrt_trde_rpy_sum": "764254", "rmnd_sum": "173782689", "remn_amt_sum": "14218184", "dbrt_trde_cntrcnt_rt": "7061", "dbrt_trde_rpy_rt": "3196", "rmnd_rt": "2225", "remn_amt_rt": "3728", "dbrt_trde_upper_10stk": [ { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "1209600", "dbrt_trde_rpy": "0", "rmnd": "1505173", "remn_amt": "1203" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "681807", "dbrt_trde_rpy": "304467", "rmnd": "122704705", "remn_amt": "9546426" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "297431", "dbrt_trde_rpy": "208222", "rmnd": "13731939", "remn_amt": "1691775" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "230866", "dbrt_trde_rpy": "301", "rmnd": "3012573", "remn_amt": "104838" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 179 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 일자별종목별실현손익요청_일자(ka10072) API 명 일자별종목별실현손익요청_일자 API ID ka10072 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String N 6 Body strt_dt 시작일자 String Y 8 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... YYYYMMDD Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dt_stk_div_rlzt_pl 일자별종목별실현손 익 LIST N Body - stk_nm 종목명 String N 40 Body - cntr_qty 체결량 String N 20 Body - buy_uv 매입단가 String N 20 Body - cntr_pric 체결가 String N 20 Body - tdy_sel_pl 당일매도손익 String N 20 Body - pl_rt 손익율 String N 20 Body - stk_cd 종목코드 String N 20 Body - tdy_trde_cmsn 당일매매수수료 String N 20 Body - tdy_trde_tax 당일매매세금 String N 20 180 / 528 Response 구분 Element 한글명 Type Require d Length Body - wthd_alowa 인출가능금액 String N 20 Body - loan_dt 대출일 String N 20 Body - crd_tp 신용구분 String N 20 Body - stk_cd_1 종목코드1 String N 20 Body - tdy_sel_pl_1 당일매도손익1 String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241128" Response Example { } "dt_stk_div_rlzt_pl": [ { "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.96", "cntr_pric": "158200", "tdy_sel_pl": "59813.04", "pl_rt": "+61.28", "stk_cd": "A005930", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "wthd_alowa": "0", "loan_dt": "", "crd_tp": "현금잔고", "stk_cd_1": "A005930", "tdy_sel_pl_1": "59813.04" }, { "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.96", "cntr_pric": "158200", "tdy_sel_pl": "59813.04", "pl_rt": "+61.28", "stk_cd": "A005930", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "wthd_alowa": "0", "loan_dt": "", "crd_tp": "현금잔고", "stk_cd_1": "A005930", "tdy_sel_pl_1": "59813.04" } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 181 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 일자별종목별실현손익요청_기간(ka10073) API 명 일자별종목별실현손익요청_기간 API ID ka10073 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String N 6 Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dt_stk_rlzt_pl 일자별종목별실현손 익 LIST N Body - dt 일자 String N 20 Body - tdy_htssel_cmsn 당일hts매도수수료 String N 20 Body - stk_nm 종목명 String N 40 Body - cntr_qty 체결량 String N 20 Body - buy_uv 매입단가 String N 20 Body - cntr_pric 체결가 String N 20 Body - tdy_sel_pl 당일매도손익 String N 20 Body - pl_rt 손익율 String N 20 182 / 528 Response 구분 Element 한글명 Type Require d Length Body - stk_cd 종목코드 String N 20 Body - tdy_trde_cmsn 당일매매수수료 String N 20 Body - tdy_trde_tax 당일매매세금 String N 20 Body - wthd_alowa 인출가능금액 String N 20 Body - loan_dt 대출일 String N 20 Body - crd_tp 신용구분 String N 20 Request Example { } "stk_cd": "005930", "strt_dt": "20241128", "end_dt": "20241128" Response Example { "dt_stk_rlzt_pl": [ { "dt": "20241128", "tdy_htssel_cmsn": "현금", "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.96", "cntr_pric": "158200", "tdy_sel_pl": "59813.04", "pl_rt": "+61.28", "stk_cd": "A005930", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "wthd_alowa": "0", "loan_dt": "", "crd_tp": "현금잔고" }, { "dt": "20241128", "tdy_htssel_cmsn": "현금", "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.96", "cntr_pric": "158200", "tdy_sel_pl": "59813.04", "pl_rt": "+61.28", "stk_cd": "A005930", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "wthd_alowa": "0", "loan_dt": "", "crd_tp": "현금잔고" }, { "dt": "20241128", "tdy_htssel_cmsn": "현금", "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.96", "cntr_pric": "158200", "tdy_sel_pl": "59813.04", "pl_rt": "+61.28", "stk_cd": "A005930", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "wthd_alowa": "0", "loan_dt": "", "crd_tp": "현금잔고" } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 183 / 528 Description Response Example } 184 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 일자별실현손익요청(ka10074) API 명 일자별실현손익요청 API ID ka10074 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 [ 주의 ] 실현손익이 발생한 일자에대해서만 데이터가 채워짐. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String Y 8 Body end_dt 종료일자 String Y 8 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tot_buy_amt 총매수금액 String N Body tot_sell_amt 총매도금액 String N Body rlzt_pl 실현손익 String N Body trde_cmsn 매매수수료 String N Body trde_tax 매매세금 String N Body dt_rlzt_pl 일자별실현손익 LIST N Body - dt 일자 String N 20 Body - buy_amt 매수금액 String N 20 Body - sell_amt 매도금액 String N 20 Body - tdy_sel_pl 당일매도손익 String N 20 185 / 528 Response 구분 Element 한글명 Type Require d Length Body - tdy_trde_cmsn 당일매매수수료 String N 20 Body - tdy_trde_tax 당일매매세금 String N 20 Request Example { } "strt_dt": "20241128", "end_dt": "20241128" Response Example { } "tot_buy_amt": "0", "tot_sell_amt": "474600", "rlzt_pl": "179419", "trde_cmsn": "940", "trde_tax": "852", "dt_rlzt_pl": [ { "dt": "20241128", "buy_amt": "0", "sell_amt": "474600", "tdy_sel_pl": "179419", "tdy_trde_cmsn": "940", "tdy_trde_tax": "852" } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 186 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 미체결요청(ka10075) API 명 미체결요청 API ID ka10075 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body all_stk_tp 전체종목구분 String Y 1 0:전체, 1:종목 Body trde_tp 매매구분 String Y 1 0:전체, 1:매도, 2:매수 Body stk_cd 종목코드 String N 6 Body stex_tp 거래소구분 String Y 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0 : 통합, 1 : KRX, 2 : NXT Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body oso 미체결 LIST N Body - acnt_no 계좌번호 String N 20 Body - ord_no 주문번호 String N 20 Body - mang_empno 관리사번 String N 20 Body - stk_cd 종목코드 String N 20 Body - tsk_tp 업무구분 String N 20 Body - ord_stt 주문상태 String N 20 Body - stk_nm 종목명 String N 40 187 / 528 Response 구분 Element 한글명 Type Require d Length Body - ord_qty 주문수량 String N 20 Body - ord_pric 주문가격 String N 20 Body - oso_qty 미체결수량 String N 20 Body - cntr_tot_amt 체결누계금액 String N 20 Body - orig_ord_no 원주문번호 String N 20 Body - io_tp_nm 주문구분 String N 20 Body - trde_tp 매매구분 String N 20 Body - tm 시간 String N 20 Body - cntr_no 체결번호 String N 20 Body - cntr_pric 체결가 String N 20 Body - cntr_qty 체결량 String N 20 Body - cur_prc 현재가 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - unit_cntr_pric 단위체결가 String N 20 Body - unit_cntr_qty 단위체결량 String N 20 Body - tdy_trde_cmsn 당일매매수수료 String N 20 Body - tdy_trde_tax 당일매매세금 String N 20 Body - ind_invsr 개인투자자 String N 20 Body - stex_tp 거래소구분 String N 20 0 : 통합, 1 : KRX, 2 : NXT Body - stex_tp_txt 거래소구분텍스트 String N 20 통합,KRX,NXT Body - sor_yn SOR 여부값 String N 20 Y,N Body - stop_pric 스톱가 String N 20 스톱지정가주문 스톱가 Request Example { } "all_stk_tp": "1", "trde_tp": "0", "stk_cd": "005930", "stex_tp": "0" Response Example { Description "oso": [ { "acnt_no": "1234567890", "ord_no": "0000069", "mang_empno": "", "stk_cd": "005930", "tsk_tp": "", "ord_stt": "접수", "stk_nm": "삼성전자", "ord_qty": "1", "ord_pric": "0", "oso_qty": "1", "cntr_tot_amt": "0", "orig_ord_no": "0000000", "io_tp_nm": "+매수", "trde_tp": "시장가", 188 / 528 Response Example "tm": "154113", "cntr_no": "", "cntr_pric": "0", "cntr_qty": "0", "cur_prc": "+74100", "sel_bid": "0", "buy_bid": "+74100", "unit_cntr_pric": "", "unit_cntr_qty": "", "tdy_trde_cmsn": "0", "tdy_trde_tax": "0", "ind_invsr": "", "stex_tp": "1", "stex_tp_txt": "KRX", "sor_yn": "N" } } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 189 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 체결요청(ka10076) API 명 체결요청 API ID ka10076 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String N 6 Body qry_tp 조회구분 String Y 1 0:전체, 1:종목 Body sell_tp 매도수구분 String Y 1 0:전체, 1:매도, 2:매수 Body ord_no 주문번호 String N 10 검색 기준 값으로 입력한 주문번호 보다 과거에 체결된 내역이 조회됩니다. Body stex_tp 거래소구분 String Y 1 0 : 통합, 1 : KRX, 2 : NXT 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body cntr 체결 LIST N Body - ord_no 주문번호 String N 20 Body - stk_nm 종목명 String N 40 Body - io_tp_nm 주문구분 String N 20 Body - ord_pric 주문가격 String N 20 Body - ord_qty 주문수량 String N 20 Body - cntr_pric 체결가 String N 20 190 / 528 Response 구분 Element 한글명 Type Require d Length Body - cntr_qty 체결량 String N 20 Body - oso_qty 미체결수량 String N 20 Body - tdy_trde_cmsn 당일매매수수료 String N 20 Body - tdy_trde_tax 당일매매세금 String N 20 Body - ord_stt 주문상태 String N 20 Body - trde_tp 매매구분 String N 20 Body - orig_ord_no 원주문번호 String N 20 Body - ord_tm 주문시간 String N 20 Body - stk_cd 종목코드 String N 20 Body - stex_tp 거래소구분 String N 20 0 : 통합, 1 : KRX, 2 : NXT Body - stex_tp_txt 거래소구분텍스트 String N 20 통합,KRX,NXT Body - sor_yn SOR 여부값 String N 20 Y,N Body - stop_pric 스톱가 String N 20 스톱지정가주문 스톱가 Request Example { } "stk_cd": "005930", "qry_tp": "1", "sell_tp": "0", "ord_no": "", "stex_tp": "0" Response Example { Description "cntr": [ { "ord_no": "0000037", "stk_nm": "삼성전자", "io_tp_nm": "-매도", "ord_pric": "158200", "ord_qty": "1", "cntr_pric": "158200", "cntr_qty": "1", "oso_qty": "0", "tdy_trde_cmsn": "310", "tdy_trde_tax": "284", "ord_stt": "체결", "trde_tp": "보통", "orig_ord_no": "0000000", "ord_tm": "153815", "stk_cd": "005930", "stex_tp": "0", "stex_tp_txt": "SOR", "sor_yn": "Y" }, { "ord_no": "0000036", "stk_nm": "삼성전자", "io_tp_nm": "-매도", "ord_pric": "158200", "ord_qty": "1", "cntr_pric": "158200", "cntr_qty": "1", "oso_qty": "0", "tdy_trde_cmsn": "310", "tdy_trde_tax": "284", "ord_stt": "체결", "trde_tp": "보통", "orig_ord_no": "0000000", "ord_tm": "153806", 191 / 528 Response Example "stk_cd": "005930", "stex_tp": "0", "stex_tp_txt": "SOR", "sor_yn": "Y" } } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 192 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 당일실현손익상세요청(ka10077) API 명 당일실현손익상세요청 API ID ka10077 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tdy_rlzt_pl 당일실현손익 String N Body tdy_rlzt_pl_dtl 당일실현손익상세 LIST N Body - stk_nm 종목명 String N 40 Body - cntr_qty 체결량 String N 20 Body - buy_uv 매입단가 String N 20 Body - cntr_pric 체결가 String N 20 Body - tdy_sel_pl 당일매도손익 String N 20 Body - pl_rt 손익율 String N 20 Body - tdy_trde_cmsn 당일매매수수료 String N 20 Body - tdy_trde_tax 당일매매세금 String N 20 Body - stk_cd 종목코드 String N 20 193 / 528 Request Example { } "stk_cd": "005930" Response Example { } "tdy_rlzt_pl": "179439", "tdy_rlzt_pl_dtl": [ { "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.9573459", "cntr_pric": "158200", "tdy_sel_pl": "59813.0426541", "pl_rt": "+61.28", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "stk_cd": "A005930" }, { "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.9573459", "cntr_pric": "158200", "tdy_sel_pl": "59813.0426541", "pl_rt": "+61.28", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "stk_cd": "A005930" }, { "stk_nm": "삼성전자", "cntr_qty": "1", "buy_uv": "97602.9573459", "cntr_pric": "158200", "tdy_sel_pl": "59813.0426541", "pl_rt": "+61.28", "tdy_trde_cmsn": "500", "tdy_trde_tax": "284", "stk_cd": "A005930" } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 194 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 증권사별종목매매동향요청(ka10078) API 명 증권사별종목매매동향요청 API ID ka10078 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mmcm_cd 회원사코드 String Y 3 회원사 코드는 ka10102 조회 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body strt_dt 시작일자 String Y 8 YYYYMMDD Body end_dt 종료일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body sec_stk_trde_trend 증권사별종목매매동 향 LIST N Body - dt 일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - acc_trde_qty 누적거래량 String N 20 195 / 528 Response Type Require d Length 순매수수량 String N 20 - buy_qty 매수수량 String N 20 - sell_qty 매도수량 String N 20 구분 Element Body - netprps_qty Body Body 한글명 Request Example { } "mmcm_cd": "001", "stk_cd": "005930", "strt_dt": "20241106", "end_dt": "20241107" Response Example { } "sec_stk_trde_trend": [ { "dt": "20241107", "cur_prc": "10050", "pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "acc_trde_qty": "0", "netprps_qty": "0", "buy_qty": "0", "sell_qty": "0" }, { "dt": "20241106", "cur_prc": "10240", "pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "acc_trde_qty": "0", "netprps_qty": "-1016", "buy_qty": "951", "sell_qty": "1967" }, { "dt": "20241105", "cur_prc": "10040", "pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "acc_trde_qty": "0", "netprps_qty": "2016", "buy_qty": "5002", "sell_qty": "2986" }, { "dt": "20241101", "cur_prc": "-5880", "pre_sig": "4", "pred_pre": "-2520", "flu_rt": "-30.00", "acc_trde_qty": "16139969", "netprps_qty": "-532", "buy_qty": "2454", "sell_qty": "2986" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 196 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 주식틱차트조회요청(ka10079) API 명 주식틱차트조회요청 API ID ka10079 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body tic_scope 틱범위 String Y 2 1:1틱, 3:3틱, 5:5틱, 10:10틱, 30:30틱 Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 6 Body last_tic_cnt 마지막틱갯수 String N Body stk_tic_chart_qry 주식틱차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - cntr_tm 체결시간 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 197 / 528 Response 구분 Element 한글명 Type Require d Length Body - pred_pre 전일대비 String N 20 현재가 - 전일종가 Body - pred_pre_sig 전일대비 기호 String N 20 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 Request Example { } "stk_cd": "005930", "tic_scope": "1", "upd_stkpc_tp": "1" Response Example { } Description "stk_cd": "005930", "last_tic_cnt": "", "stk_tic_chart_qry": [ { "cur_prc": "78900", "trde_qty": "143", "cntr_tm": "20250917131939", "open_pric": "78900", "high_pric": "78900", "low_pric": "78900", "pred_pre": "500", "pred_pre_sig": "5" }, { "cur_prc": "78900", "trde_qty": "200", "cntr_tm": "20250917131939", "open_pric": "78900", "high_pric": "78900", "low_pric": "78900", "pred_pre": "500", "pred_pre_sig": "5" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 198 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 주식분봉차트조회요청(ka10080) API 명 주식분봉차트조회요청 API ID ka10080 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body tic_scope 틱범위 String Y 2 1:1분, 3:3분, 5:5분, 10:10분, 15:15분, 30:30분, 45:45분, 60:60분 Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 Body base_dt 기준일자 String N 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 6 Body stk_min_pole_chart_ qry 주식분봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - cntr_tm 체결시간 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 199 / 528 종가 Response 구분 Element 한글명 Type Require d Length Body - low_pric 저가 String N 20 Body - pred_pre 전일대비 String N 20 현재가 - 전일종가 Body - pred_pre_sig 전일대비 기호 String N 20 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 Request Example { } "stk_cd": "005930", "tic_scope": "1", "upd_stkpc_tp": "1", "base_dt": "20260202" Response Example { } Description "stk_cd": "005930", "stk_min_pole_chart_qry": [ { "cur_prc": "-78800", "trde_qty": "7913", "cntr_tm": "20250917132000", "open_pric": "-78850", "high_pric": "-78900", "low_pric": "-78800", "acc_trde_qty": "14947571", "pred_pre": "-600", "pred_pre_sig": "5" }, { "cur_prc": "-78900", "trde_qty": "16084", "cntr_tm": "20250917131900", "open_pric": "-78900", "high_pric": "-78900", "low_pric": "-78800", "acc_trde_qty": "14939658", "pred_pre": "-500", "pred_pre_sig": "5" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 200 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 주식일봉차트조회요청(ka10081) API 명 주식일봉차트조회요청 API ID ka10081 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body base_dt 기준일자 String Y 8 YYYYMMDD Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 6 Body stk_dt_pole_chart_qr y 주식일봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 201 / 528 Response 구분 Element 한글명 Type Require d Length Body - low_pric 저가 String N 20 Body - pred_pre 전일대비 String N 20 현재가 - 전일종가 Body - pred_pre_sig 전일대비기호 String N 20 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 Body - trde_tern_rt 거래회전율 String N 20 Request Example { } "stk_cd": "005930", "base_dt": "20250908", "upd_stkpc_tp": "1" Response Example { } Description "stk_cd": "005930", "stk_dt_pole_chart_qry": [ { "cur_prc": "70100", "trde_qty": "9263135", "trde_prica": "648525", "dt": "20250908", "open_pric": "69800", "high_pric": "70500", "low_pric": "69600", "pred_pre": "+600", "pred_pre_sig": "2", "trde_tern_rt": "+0.16" }, { "cur_prc": "69500", "trde_qty": "11526724", "trde_prica": "804642", "dt": "20250905", "open_pric": "70300", "high_pric": "70400", "low_pric": "69500", "pred_pre": "-600", "pred_pre_sig": "5", "trde_tern_rt": "+0.19" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 202 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 주식주봉차트조회요청(ka10082) API 명 주식주봉차트조회요청 API ID ka10082 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body base_dt 기준일자 String Y 8 YYYYMMDD Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 6 Body stk_stk_pole_chart_qr y 주식주봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 203 / 528 Response 구분 Element 한글명 Type Require d Length Body - low_pric 저가 String N 20 Body - pred_pre 전일대비 String N 20 현재가 - 전일종가 Body - pred_pre_sig 전일대비기호 String N 20 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 Body - trde_tern_rt 거래회전율 String N 20 Request Example { } "stk_cd": "005930", "base_dt": "20250905", "upd_stkpc_tp": "1" Response Example { } Description "stk_cd": "005930", "stk_stk_pole_chart_qry": [ { "cur_prc": "69500", "trde_qty": "56700518", "trde_prica": "3922030535087", "dt": "20250901", "open_pric": "68400", "high_pric": "70400", "low_pric": "67500", "pred_pre": "-200", "pred_pre_sig": "5", "trde_tern_rt": "+0.96" }, { "cur_prc": "69700", "trde_qty": "58841393", "trde_prica": "4144644408600", "dt": "20250825", "open_pric": "71700", "high_pric": "71800", "low_pric": "69600", "pred_pre": "-1700", "pred_pre_sig": "5", "trde_tern_rt": "+0.99" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 204 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 주식월봉차트조회요청(ka10083) API 명 주식월봉차트조회요청 API ID ka10083 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body base_dt 기준일자 String Y 8 YYYYMMDD Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 6 Body stk_mth_pole_chart_ qry 주식월봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 205 / 528 Response 구분 Element 한글명 Type Require d Length Body - low_pric 저가 String N 20 Body - pred_pre 전일대비 String N 20 현재가 - 전일종가 Body - pred_pre_sig 전일대비기호 String N 20 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 Body - trde_tern_rt 거래회전율 String N 20 Request Example { } "stk_cd": "005930", "base_dt": "20250905", "upd_stkpc_tp": "1" Response Example { } Description "stk_cd": "005930", "stk_mth_pole_chart_qry": [ { "cur_prc": "78900", "trde_qty": "215040968", "trde_prica": "15774571011618", "dt": "20250901", "open_pric": "68400", "high_pric": "79500", "low_pric": "67500", "pred_pre": "+9200", "pred_pre_sig": "2", "trde_tern_rt": "+3.38" }, { "cur_prc": "69700", "trde_qty": "258905351", "trde_prica": "18306059690160", "dt": "20250804", "open_pric": "69500", "high_pric": "72400", "low_pric": "68300", "pred_pre": "+13600", "pred_pre_sig": "2", "trde_tern_rt": "+4.37" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 206 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 당일전일체결요청(ka10084) API 명 당일전일체결요청 API ID ka10084 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body tdy_pred 당일전일 String Y 1 당일 : 1, 전일 : 2 Body tic_min 틱분 String Y 1 0:틱, 1:분 Body tm 시간 String N 4 조회시간 4자리, 오전 9시일 경우 0900, 오후 2시 30분일 경우 1430 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tdy_pred_cntr 당일전일체결 LIST N Body - tm 시간 String N 20 Body - cur_prc 현재가 String N 20 Body - pred_pre 전일대비 String N 20 Body - pre_rt 대비율 String N 20 Body - pri_sel_bid_unit 우선매도호가단위 String N 20 Body - pri_buy_bid_unit 우선매수호가단위 String N 20 207 / 528 Response Type Require d Length 체결거래량 String N 20 - sign 전일대비기호 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - acc_trde_prica 누적거래대금 String N 20 Body - cntr_str 체결강도 String N 20 Body - stex_tp 거래소구분 String N 20 구분 Element Body - cntr_trde_qty Body 한글명 Request Example { } "stk_cd": "005930", "tdy_pred": "1", "tic_min": "0", "tm": "" Response Example { } "tdy_pred_cntr": [ { "tm": "112711", "cur_prc": "+128300", "pred_pre": "+700", "pre_rt": "+0.55", "pri_sel_bid_unit": "-0", "pri_buy_bid_unit": "+128300", "cntr_trde_qty": "-1", "sign": "2", "acc_trde_qty": "2", "acc_trde_prica": "0", "cntr_str": "0.00" }, { "tm": "111554", "cur_prc": "+128300", "pred_pre": "+700", "pre_rt": "+0.55", "pri_sel_bid_unit": "-0", "pri_buy_bid_unit": "+128300", "cntr_trde_qty": "-1", "sign": "2", "acc_trde_qty": "1", "acc_trde_prica": "0", "cntr_str": "0.00" } ], "returnCode": 0, "returnMsg": "정상적으로 처리되었습니다" 208 / 528 Description KRX , NXT , 통합 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌수익률요청(ka10085) API 명 계좌수익률요청 API ID ka10085 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stex_tp 거래소구분 String Y 1 0 : 통합, 1 : KRX, 2 : NXT 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acnt_prft_rt 계좌수익률 LIST N Body - dt 일자 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pur_pric 매입가 String N 20 Body - pur_amt 매입금액 String N 20 Body - rmnd_qty 보유수량 String N 20 Body - tdy_sel_pl 당일매도손익 String N 20 Body - tdy_trde_cmsn 당일매매수수료 String N 20 Body - tdy_trde_tax 당일매매세금 String N 20 209 / 528 Response 구분 Element 한글명 Type Require d Length Body - crd_tp 신용구분 String N 20 Body - loan_dt 대출일 String N 20 Body - setl_remn 결제잔고 String N 20 Body - clrn_alow_qty 청산가능수량 String N 20 Body - crd_amt 신용금액 String N 20 Body - crd_int 신용이자 String N 20 Body - expr_dt 만기일 String N 20 Request Example { } "stex_tp": "0" Response Example { "acnt_prft_rt": [ { "dt": "", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-63000", "pur_pric": "124500", "pur_amt": "373500", "rmnd_qty": "3", "tdy_sel_pl": "0", "tdy_trde_cmsn": "0", "tdy_trde_tax": "0", "crd_tp": "00", "loan_dt": "00000000", "setl_remn": "3", "clrn_alow_qty": "3", "crd_amt": "0", "crd_int": "0", "expr_dt": "00000000" }, { "dt": "", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+256500", "pur_pric": "209179", "pur_amt": "1673429", "rmnd_qty": "8", "tdy_sel_pl": "0", "tdy_trde_cmsn": "0", "tdy_trde_tax": "0", "crd_tp": "00", "loan_dt": "00000000", "setl_remn": "8", "clrn_alow_qty": "8", "crd_amt": "0", "crd_int": "0", "expr_dt": "00000000" }, { "dt": "", "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+156600", "pur_pric": "97603", "pur_amt": "3513706", "rmnd_qty": "36", "tdy_sel_pl": "0", "tdy_trde_cmsn": "0", "tdy_trde_tax": "0", "crd_tp": "00", "loan_dt": "00000000", 210 / 528 Description Response Example "setl_remn": "39", "clrn_alow_qty": "36", "crd_amt": "0", "crd_int": "0", "expr_dt": "00000000" } } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 211 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 일별주가요청(ka10086) API 명 일별주가요청 API ID ka10086 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 [ 주의 ] 외국인순매수 데이터는 거래소로부터 금액데이터가 제공되지 않고 수량으로만 조회됩니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body qry_dt 조회일자 String Y 8 YYYYMMDD Body indc_tp 표시구분 String Y 1 0:수량, 1:금액(백만원) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body daly_stkpc 일별주가 LIST N Body - date 날짜 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - close_pric 종가 String N 20 Body - pred_rt 전일비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 212 / 528 Response 구분 Element 한글명 Type Require d Length Body - amt_mn 금액(백만) String N 20 Body - crd_rt 신용비 String N 20 Body - ind 개인 String N 20 Body - orgn 기관 String N 20 Body - for_qty 외인수량 String N 20 Body - frgn 외국계 String N 20 Body - prm 프로그램 String N 20 Body - for_rt 외인비 String N 20 Body - for_poss 외인보유 String N 20 Body - for_wght 외인비중 String N 20 Body - for_netprps 외인순매수 String N 20 Body - orgn_netprps 기관순매수 String N 20 Body - ind_netprps 개인순매수 String N 20 Body - crd_remn_rt 신용잔고율 String N 20 Request Example { } "stk_cd": "005930", "qry_dt": "20241125", "indc_tp": "0" Response Example { "daly_stkpc": [ { "date": "20241125", "open_pric": "+78800", "high_pric": "+101100", "low_pric": "-54500", "close_pric": "-55000", "pred_rt": "-22800", "flu_rt": "-29.31", "trde_qty": "20278", "amt_mn": "1179", "crd_rt": "0.00", "ind": "--714", "orgn": "+693", "for_qty": "--266783", "frgn": "0", "prm": "0", "for_rt": "+51.56", "for_poss": "+51.56", "for_wght": "+51.56", "for_netprps": "--266783", "orgn_netprps": "+693", "ind_netprps": "--714", "crd_remn_rt": "0.00" }, { "date": "20241122", "open_pric": "-54500", "high_pric": "77800", "low_pric": "-54500", "close_pric": "77800", "pred_rt": "0", "flu_rt": "0.00", "trde_qty": "209653", "amt_mn": "11447", "crd_rt": "0.00", 213 / 528 Description Response Example "ind": "--196415", "orgn": "+196104", "for_qty": "--2965929", "frgn": "0", "prm": "--6", "for_rt": "+51.56", "for_poss": "+51.56", "for_wght": "+51.56", "for_netprps": "--2965929", "orgn_netprps": "+196104", "ind_netprps": "--196415", "crd_remn_rt": "0.00" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 214 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 시간외단일가요청(ka10087) API 명 시간외단일가요청 API ID ka10087 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 [ 주의 ] 호가잔량기준시간은 시간외거래에대한 시간이 아닌 정규장시간 값임 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body bid_req_base_tm 호가잔량기준시간 String N Body ovt_sigpric_sel_bid_j ub_pre_5 시간외단일가_매도호 가직전대비5 String N Body ovt_sigpric_sel_bid_j ub_pre_4 시간외단일가_매도호 가직전대비4 String N Body ovt_sigpric_sel_bid_j ub_pre_3 시간외단일가_매도호 가직전대비3 String N Body ovt_sigpric_sel_bid_j ub_pre_2 시간외단일가_매도호 가직전대비2 String N Body ovt_sigpric_sel_bid_j ub_pre_1 시간외단일가_매도호 가직전대비1 String N Body ovt_sigpric_sel_bid_q ty_5 시간외단일가_매도호 가수량5 String N Body ovt_sigpric_sel_bid_q ty_4 시간외단일가_매도호 가수량4 String N 215 / 528 Response 구분 Element 한글명 Type Require d Body ovt_sigpric_sel_bid_q ty_3 시간외단일가_매도호 가수량3 String N Body ovt_sigpric_sel_bid_q ty_2 시간외단일가_매도호 가수량2 String N Body ovt_sigpric_sel_bid_q ty_1 시간외단일가_매도호 가수량1 String N Body ovt_sigpric_sel_bid_5 시간외단일가_매도호 가5 String N Body ovt_sigpric_sel_bid_4 시간외단일가_매도호 가4 String N Body ovt_sigpric_sel_bid_3 시간외단일가_매도호 가3 String N Body ovt_sigpric_sel_bid_2 시간외단일가_매도호 가2 String N Body ovt_sigpric_sel_bid_1 시간외단일가_매도호 가1 String N Body ovt_sigpric_buy_bid_ 1 시간외단일가_매수호 가1 String N Body ovt_sigpric_buy_bid_ 2 시간외단일가_매수호 가2 String N Body ovt_sigpric_buy_bid_ 3 시간외단일가_매수호 가3 String N Body ovt_sigpric_buy_bid_ 4 시간외단일가_매수호 가4 String N Body ovt_sigpric_buy_bid_ 5 시간외단일가_매수호 가5 String N Body ovt_sigpric_buy_bid_ qty_1 시간외단일가_매수호 가수량1 String N Body ovt_sigpric_buy_bid_ qty_2 시간외단일가_매수호 가수량2 String N Body ovt_sigpric_buy_bid_ qty_3 시간외단일가_매수호 가수량3 String N Body ovt_sigpric_buy_bid_ qty_4 시간외단일가_매수호 가수량4 String N Body ovt_sigpric_buy_bid_ qty_5 시간외단일가_매수호 가수량5 String N Body ovt_sigpric_buy_bid_j ub_pre_1 시간외단일가_매수호 가직전대비1 String N Body ovt_sigpric_buy_bid_j ub_pre_2 시간외단일가_매수호 가직전대비2 String N Body ovt_sigpric_buy_bid_j ub_pre_3 시간외단일가_매수호 가직전대비3 String N Body ovt_sigpric_buy_bid_j ub_pre_4 시간외단일가_매수호 가직전대비4 String N Body ovt_sigpric_buy_bid_j ub_pre_5 시간외단일가_매수호 가직전대비5 String N Body ovt_sigpric_sel_bid_t ot_req 시간외단일가_매도호 가총잔량 String N Body ovt_sigpric_buy_bid_ tot_req 시간외단일가_매수호 가총잔량 String N 216 / 528 Length Description Response 구분 Element 한글명 Type Require d Body sel_bid_tot_req_jub_ pre 매도호가총잔량직전 대비 String N Body sel_bid_tot_req 매도호가총잔량 String N Body buy_bid_tot_req 매수호가총잔량 String N Body buy_bid_tot_req_jub_ pre 매수호가총잔량직전 대비 String N Body ovt_sel_bid_tot_req_j ub_pre 시간외매도호가총잔 량직전대비 String N Body ovt_sel_bid_tot_req 시간외매도호가총잔 량 String N Body ovt_buy_bid_tot_req 시간외매수호가총잔 량 String N Body ovt_buy_bid_tot_req_ jub_pre 시간외매수호가총잔 량직전대비 String N Body ovt_sigpric_cur_prc 시간외단일가_현재가 String N Body ovt_sigpric_pred_pre _sig 시간외단일가_전일대 비기호 String N Body ovt_sigpric_pred_pre 시간외단일가_전일대 비 String N Body ovt_sigpric_flu_rt 시간외단일가_등락률 String N Body ovt_sigpric_acc_trde_ qty 시간외단일가_누적거 래량 String N Length Request Example { } "stk_cd": "005930" Response Example { "bid_req_base_tm": "164000", "ovt_sigpric_sel_bid_jub_pre_5": "0", "ovt_sigpric_sel_bid_jub_pre_4": "0", "ovt_sigpric_sel_bid_jub_pre_3": "0", "ovt_sigpric_sel_bid_jub_pre_2": "0", "ovt_sigpric_sel_bid_jub_pre_1": "0", "ovt_sigpric_sel_bid_qty_5": "0", "ovt_sigpric_sel_bid_qty_4": "0", "ovt_sigpric_sel_bid_qty_3": "0", "ovt_sigpric_sel_bid_qty_2": "0", "ovt_sigpric_sel_bid_qty_1": "0", "ovt_sigpric_sel_bid_5": "-0", "ovt_sigpric_sel_bid_4": "-0", "ovt_sigpric_sel_bid_3": "-0", "ovt_sigpric_sel_bid_2": "-0", "ovt_sigpric_sel_bid_1": "-0", "ovt_sigpric_buy_bid_1": "-0", "ovt_sigpric_buy_bid_2": "-0", "ovt_sigpric_buy_bid_3": "-0", "ovt_sigpric_buy_bid_4": "-0", "ovt_sigpric_buy_bid_5": "-0", "ovt_sigpric_buy_bid_qty_1": "0", "ovt_sigpric_buy_bid_qty_2": "0", "ovt_sigpric_buy_bid_qty_3": "0", "ovt_sigpric_buy_bid_qty_4": "0", "ovt_sigpric_buy_bid_qty_5": "0", "ovt_sigpric_buy_bid_jub_pre_1": "0", "ovt_sigpric_buy_bid_jub_pre_2": "0", "ovt_sigpric_buy_bid_jub_pre_3": "0", "ovt_sigpric_buy_bid_jub_pre_4": "0", "ovt_sigpric_buy_bid_jub_pre_5": "0", 217 / 528 Description Response Example } "ovt_sigpric_sel_bid_tot_req": "0", "ovt_sigpric_buy_bid_tot_req": "0", "sel_bid_tot_req_jub_pre": "0", "sel_bid_tot_req": "24028", "buy_bid_tot_req": "26579", "buy_bid_tot_req_jub_pre": "0", "ovt_sel_bid_tot_req_jub_pre": "0", "ovt_sel_bid_tot_req": "0", "ovt_buy_bid_tot_req": "11", "ovt_buy_bid_tot_req_jub_pre": "0", "ovt_sigpric_cur_prc": "156600", "ovt_sigpric_pred_pre_sig": "0", "ovt_sigpric_pred_pre": "0", "ovt_sigpric_flu_rt": "0.00", "ovt_sigpric_acc_trde_qty": "0", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 218 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 미체결 분할주문 상세(ka10088) API 명 미체결 분할주문 상세 API ID ka10088 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body ord_no 주문번호 String Y 20 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body osop 미체결분할주문리스 트 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - ord_no 주문번호 String N 20 Body - ord_qty 주문수량 String N 20 Body - ord_pric 주문가격 String N 20 Body - osop_qty 미체결수량 String N 20 Body - io_tp_nm 주문구분 String N 20 Body - trde_tp 매매구분 String N 20 Body - sell_tp 매도/수 구분 String N 20 Body - cntr_qty 체결량 String N 20 219 / 528 Response 구분 Element 한글명 Type Require d Length Body - ord_stt 주문상태 String N 20 Body - cur_prc 현재가 String N 20 Body - stex_tp 거래소구분 String N 20 0 : 통합, 1 : KRX, 2 : NXT Body - stex_tp_txt 거래소구분텍스트 String N 20 통합,KRX,NXT Request Example { } "ord_no": "8" Response Example { } Description "osop": [ { "stk_cd": "005930", "acnt_no": "1234567890", "stk_nm": "삼성전자", "ord_no": "0000008", "ord_qty": "1", "ord_pric": "5150", "osop_qty": "1", "io_tp_nm": "+매수정정", "trde_tp": "보통", "sell_tp": "2", "cntr_qty": "0", "ord_stt": "접수", "cur_prc": "5250", "stex_tp": "1", "stex_tp_txt": "S-KRX" } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 220 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 주식년봉차트조회요청(ka10094) API 명 주식년봉차트조회요청 API ID ka10094 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body base_dt 기준일자 String Y 8 YYYYMMDD Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cd 종목코드 String N 6 Body stk_yr_pole_chart_qr y 주식년봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 221 / 528 Response 구분 Body Element - low_pric 한글명 저가 Type Require d Length String N 20 Request Example { } "stk_cd": "005930", "base_dt": "20250905", "upd_stkpc_tp": "1" Response Example { } "stk_cd": "005930", "stk_yr_pole_chart_qry": [ { "cur_prc": "78200", "trde_qty": "10541142553", "trde_prica": "698972287992549", "dt": "20250102", "open_pric": "65100", "high_pric": "118800", "low_pric": "34900" }, { "cur_prc": "65100", "trde_qty": "6932860023", "trde_prica": "487975647547136", "dt": "20240102", "open_pric": "78200", "high_pric": "861000", "low_pric": "39300" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 222 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 관심종목정보요청(ka10095) API 명 관심종목정보요청 API ID ka10095 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 여러개의 종목코드 입력시 | 로 구분 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body atn_stk_infr 관심종목정보 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - base_pric 기준가 String N 20 Body - pred_pre 전일대비 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 223 / 528 Response 구분 Element 한글명 Type Require d Length Body - cntr_qty 체결량 String N 20 Body - cntr_str 체결강도 String N 20 Body - pred_trde_qty_pre 전일거래량대비 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - sel_1th_bid 매도1차호가 String N 20 Body - sel_2th_bid 매도2차호가 String N 20 Body - sel_3th_bid 매도3차호가 String N 20 Body - sel_4th_bid 매도4차호가 String N 20 Body - sel_5th_bid 매도5차호가 String N 20 Body - buy_1th_bid 매수1차호가 String N 20 Body - buy_2th_bid 매수2차호가 String N 20 Body - buy_3th_bid 매수3차호가 String N 20 Body - buy_4th_bid 매수4차호가 String N 20 Body - buy_5th_bid 매수5차호가 String N 20 Body - upl_pric 상한가 String N 20 Body - lst_pric 하한가 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - close_pric 종가 String N 20 Body - cntr_tm 체결시간 String N 20 Body - exp_cntr_pric 예상체결가 String N 20 Body - exp_cntr_qty 예상체결량 String N 20 Body - cap 자본금 String N 20 Body - fav 액면가 String N 20 Body - mac 시가총액 String N 20 Body - stkcnt 주식수 String N 20 Body - bid_tm 호가시간 String N 20 Body - dt 일자 String N 20 Body - pri_sel_req 우선매도잔량 String N 20 Body - pri_buy_req 우선매수잔량 String N 20 Body - pri_sel_cnt 우선매도건수 String N 20 Body - pri_buy_cnt 우선매수건수 String N 20 Body - tot_sel_req 총매도잔량 String N 20 Body - tot_buy_req 총매수잔량 String N 20 Body - tot_sel_cnt 총매도건수 String N 20 224 / 528 Description Response Type Require d Length 총매수건수 String N 20 - prty 패리티 String N 20 Body - gear 기어링 String N 20 Body - pl_qutr 손익분기 String N 20 Body - cap_support 자본지지 String N 20 Body - elwexec_pric ELW행사가 String N 20 Body - cnvt_rt 전환비율 String N 20 Body - elwexpr_dt ELW만기일 String N 20 Body - cntr_engg 미결제약정 String N 20 Body - cntr_pred_pre 미결제전일대비 String N 20 Body - theory_pric 이론가 String N 20 Body - innr_vltl 내재변동성 String N 20 Body - delta 델타 String N 20 Body - gam 감마 String N 20 Body - theta 쎄타 String N 20 Body - vega 베가 String N 20 Body - law 로 String N 20 구분 Element Body - tot_buy_cnt Body 한글명 Request Example { } "stk_cd": "005930" Response Example { "atn_stk_infr": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+156600", "base_pric": "121700", "pred_pre": "+34900", "pred_pre_sig": "2", "flu_rt": "+28.68", "trde_qty": "118636", "trde_prica": "14889", "cntr_qty": "-1", "cntr_str": "172.01", "pred_trde_qty_pre": "+1995.22", "sel_bid": "+156700", "buy_bid": "+156600", "sel_1th_bid": "+156700", "sel_2th_bid": "+156800", "sel_3th_bid": "+156900", "sel_4th_bid": "+158000", "sel_5th_bid": "+158100", "buy_1th_bid": "+156600", "buy_2th_bid": "+156500", "buy_3th_bid": "+156400", "buy_4th_bid": "+130000", "buy_5th_bid": "121700", "upl_pric": "+158200", "lst_pric": "-85200", "open_pric": "121700", "high_pric": "+158200", "low_pric": "-85200", 225 / 528 Description Response Example "close_pric": "+156600", "cntr_tm": "163713", "exp_cntr_pric": "+156600", "exp_cntr_qty": "823", "cap": "7780", "fav": "100", "mac": "9348679", "stkcnt": "5969783", "bid_tm": "164000", "dt": "20241128", "pri_sel_req": "8003", "pri_buy_req": "7705", "pri_sel_cnt": "", "pri_buy_cnt": "", "tot_sel_req": "24028", "tot_buy_req": "26579", "tot_sel_cnt": "-11", "tot_buy_cnt": "", "prty": "0.00", "gear": "0.00", "pl_qutr": "0.00", "cap_support": "0.00", "elwexec_pric": "0", "cnvt_rt": "0.0000", "elwexpr_dt": "00000000", "cntr_engg": "", "cntr_pred_pre": "", "theory_pric": "", "innr_vltl": "", "delta": "", "gam": "", "theta": "", "vega": "", "law": "" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 226 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 시간외단일가등락율순위요청(ka10098) API 명 시간외단일가등락율순위요청 API ID ka10098 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체,001:코스피,101:코스닥 Body sort_base 정렬기준 String Y 1 1:상승률, 2:상승폭, 3:하락률, 4:하락폭, 5:보합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body stk_cnd 종목조건 String Y 2 0:전체조회,1:관리종목제외,2:정리매매종목제외,3:우선주제외, 4:관리종목우선주제외,5:증100제외,6:증100만보기,7:증40만보 기,8:증30만보기,9:증20만보기,12:증50만보기,13:증60만보기, 14:ETF제외,15:스팩제외,16:ETF+ETN제외,17:ETN제외 Body trde_qty_cnd 거래량조건 String Y 5 0:전체조회, 10:백주이상,50:5백주이상,100;천주이상, 500:5천주이상, 1000:만주이상, 5000:5만주이상, 10000:10만주이상 Body crd_cnd 신용조건 String Y 1 0:전체조회, 9:신용융자전체, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 7:신용융자E군, 8:신용대주, 5:신용한도초과제외 Body trde_prica 거래대금 String Y 5 0:전체조회, 5:5백만원이상,10:1천만원이상, 30:3천만원이상, 50:5천만원이상, 100:1억원이상, 300:3억원이상, 500:5억원이상, 1000:10억원이상, 3000:30억원이상, 5000:50억원이상, 10000:100억원이상 Description Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ovt_sigpric_flu_rt_ran k 시간외단일가등락율 순위 LIST N 227 / 528 Response 구분 Element 한글명 Type Require d Length Body - rank 순위 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - sel_tot_req 매도총잔량 String N 20 Body - buy_tot_req 매수총잔량 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - acc_trde_prica 누적거래대금 String N 20 Body - tdy_close_pric 당일종가 String N 20 Body tdy_close_pric_flu_rt 당일종가등락률 String N 20 Request Example { } "mrkt_tp": "000", "sort_base": "5", "stk_cnd": "0", "trde_qty_cnd": "0", "crd_cnd": "0", "trde_prica": "0" Response Example { } "ovt_sigpric_flu_rt_rank": [ { "rank": "1", "stk_cd": "069500", "stk_nm": "KODEX 200", "cur_prc": "17140", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "sel_tot_req": "0", "buy_tot_req": "24", "acc_trde_qty": "42", "acc_trde_prica": "1", "tdy_close_pric": "17140", "tdy_close_pric_flu_rt": "-0.26" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 228 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 종목정보 리스트(ka10099) API 명 종목정보 리스트 API ID ka10099 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 2 0 : 코스피, 10 : 코스닥, 30 : K-OTC, 50 : 코넥스, 60 : ETN, 70 : 손실제한 ETN, 80 : 금현물, 90 : 변동성 ETN, 2 : 인프라투융자, 3 : ELW, 4 : 뮤추얼펀드, 5 : 신주인수권, 6 : 리츠종목, 7 : 신주인수권증서, 8 : ETF, 9 : 하이일드펀드 Body mrkt_tp 시장구분 String Y 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body list 종목리스트 LIST N Body - code 종목코드 String N 20 단축코드 Body - name 종목명 String N 40 Body - listCount 상장주식수 String N 20 229 / 528 Response 구분 Element 한글명 Type Require d Length Body - auditInfo 감리구분 String N 20 Body - regDay 상장일 String N 20 Body - lastPrice 전일종가 String N 20 Body - state 종목상태 String N 20 Body - marketCode 시장구분코드 String N 20 Body - marketName 시장명 String N 20 Body - upName 업종명 String N 20 Body - upSizeName 회사크기분류 String N 20 Body companyClassName 회사분류 String N 20 코스닥만 존재함 Body - orderWarning 투자유의종목여부 String N 20 0: 해당없음, 2: 정리매매, 3: 단기과열, 4: 투자위험, 5: 투자경과, 1: ETF투자주의요망(ETF인 경우만 전달 Body - nxtEnable NXT가능여부 String N 20 Y: 가능 Request Example { } "mrkt_tp": "0" Response Example { Description "return_msg": "정상적으로 처리되었습니다", "return_code": 0, "list": [ { "code": "005930", "name": "삼성전자", "listCount": "0000000123759593", "auditInfo": "투자주의환기종목", "regDay": "20091204", "lastPrice": "00000197", "state": "관리종목", "marketCode": "10", "marketName": "코스닥", "upName": "", "upSizeName": "", "companyClassName": "", "orderWarning": "0", "nxtEnable": "Y" }, { "code": "005930", "name": "삼성전자", "listCount": "0000000136637536", "auditInfo": "정상", "regDay": "20100423", "lastPrice": "00000213", "state": "증거금100%", "marketCode": "10", "marketName": "코스닥", "upName": "", "upSizeName": "", "companyClassName": "외국기업", "orderWarning": "0", "nxtEnable": "Y" }, { "code": "005930", "name": "삼성전자", "listCount": "0000000080000000", "auditInfo": "정상", "regDay": "20160818", "lastPrice": "00000614", 230 / 528 Response Example }, { }, { } ] } "state": "증거금100%", "marketCode": "10", "marketName": "코스닥", "upName": "", "upSizeName": "", "companyClassName": "외국기업", "orderWarning": "0", "nxtEnable": "Y" "code": "005930", "name": "삼성전자", "listCount": "0000000141781250", "auditInfo": "정상", "regDay": "20160630", "lastPrice": "00000336", "state": "증거금100%", "marketCode": "10", "marketName": "코스닥", "upName": "", "upSizeName": "", "companyClassName": "외국기업", "orderWarning": "0", "nxtEnable": "Y" "code": "005930", "name": "삼성전자", "listCount": "0000000067375000", "auditInfo": "투자주의환기종목", "regDay": "20161025", "lastPrice": "00000951", "state": "관리종목", "marketCode": "10", "marketName": "코스닥", "upName": "", "upSizeName": "", "companyClassName": "", "orderWarning": "0", "nxtEnable": "Y" 231 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 종목정보 조회(ka10100) API 명 종목정보 조회 API ID ka10100 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body code 종목코드 String N Body name 종목명 String N Body listCount 상장주식수 String N Body auditInfo 감리구분 String N Body regDay 상장일 String N Body lastPrice 전일종가 String N Body state 종목상태 String N Body marketCode 시장구분코드 String N Body marketName 시장명 String N Body upName 업종명 String N Body upSizeName 회사크기분류 String N 232 / 528 단축코드 40 Response Type Require d 회사분류 String N 코스닥만 존재함 orderWarning 투자유의종목여부 String N 0: 해당없음, 2: 정리매매, 3: 단기과열, 4: 투자위험, 5: 투자경과, 1: ETF투자주의요망(ETF인 경우만 전달 nxtEnable NXT가능여부 String N Y: 가능 구분 Element Body companyClassName Body Body 한글명 Length Request Example { } "stk_cd": "005930" Response Example { } "code": "005930", "name": "삼성전자", "listCount": "0000000026034239", "auditInfo": "정상", "regDay": "20090803", "lastPrice": "00136000", "state": "증거금20%|담보대출|신용가능", "marketCode": "0", "marketName": "거래소", "upName": "금융업", "upSizeName": "대형주", "companyClassName": "", "orderWarning": "0", "nxtEnable": "Y", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 233 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 업종코드 리스트(ka10101) API 명 업종코드 리스트 API ID ka10101 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 1 0:코스피(거래소),1:코스닥,2:KOSPI200,4:KOSPI100,7:KRX100( 통합지수) Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body list 업종코드리스트 LIST N Body - marketCode 시장구분코드 LIST N Body - code 코드 String N Body - name 업종명 String N Body - group 그룹 String N Request Example { } "mrkt_tp": "0" Response Example { "return_msg": "정상적으로 처리되었습니다", "list": [ 234 / 528 Response Example { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { } "marketCode": "0", "code": "001", "name": "종합(KOSPI)", "group": "1" "marketCode": "0", "code": "002", "name": "대형주", "group": "2" "marketCode": "0", "code": "003", "name": "중형주", "group": "3" "marketCode": "0", "code": "004", "name": "소형주", "group": "4" "marketCode": "0", "code": "005", "name": "음식료업", "group": "5" "marketCode": "0", "code": "006", "name": "섬유의복", "group": "6" "marketCode": "0", "code": "007", "name": "종이목재", "group": "7" "marketCode": "0", "code": "008", "name": "화학", "group": "8" "marketCode": "0", "code": "009", "name": "의약품", "group": "9" "marketCode": "0", "code": "010", "name": "비금속광물", "group": "10" "marketCode": "0", "code": "011", "name": "철강금속", "group": "11" } ], "return_code": 0 235 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 회원사 리스트(ka10102) API 명 회원사 리스트 API ID ka10102 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body list 회원사코드리스트 LIST N Body - code 코드 String N Body - name 업종명 String N Body - gb 구분 String N Request Example {} Response Example { Description "return_msg": "정상적으로 처리되었습니다", "list": [ { "code": "001", "name": "교 보", "gb": "0" }, { "code": "002", 236 / 528 Response Example }, { }, { }, { }, { }, { }, { }, { }, { } "name": "신한금융투자", "gb": "0" "code": "003", "name": "한국투자증권", "gb": "0" "code": "004", "name": "대 신", "gb": "0" "code": "005", "name": "미래대우", "gb": "0" "code": "006", "name": "신 영", "gb": "0" "code": "008", "name": "유진투자증권", "gb": "0" "code": "009", "name": "한 양", "gb": "0" "code": "010", "name": "메리츠", "gb": "0" "code": "012", "name": "NH투자증권", "gb": "0" } ], "return_code": 0 237 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 기관/외국인 > 기관외국인연속매매현황요청(ka10131) API 명 기관외국인연속매매현황요청 API ID ka10131 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/frgnistt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dt 기간 String Y 3 1:최근일, 3:3일, 5:5일, 10:10일, 20:20일, 120:120일, 0:시작일자/종료일자로 조회 Body strt_dt 시작일자 String N 8 YYYYMMDD Body end_dt 종료일자 String N 8 YYYYMMDD Body mrkt_tp 장구분 String Y 3 001:코스피, 101:코스닥 Body netslmt_tp 순매도수구분 String Y 1 2:순매수(고정값) Body stk_inds_tp 종목업종구분 String Y 1 0:종목(주식),1:업종 Body amt_qty_tp 금액수량구분 String Y 1 0:금액, 1:수량 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body orgn_frgnr_cont_trde _prst 기관외국인연속매매 현황 LIST N Body - rank 순위 String N Body - stk_cd 종목코드 String N 238 / 528 6 Response 구분 Element 한글명 Type Require d Length 40 Body - stk_nm 종목명 String N Body - prid_stkpc_flu_rt 기간중주가등락률 String N Body - orgn_nettrde_amt 기관순매매금액 String N Body - orgn_nettrde_qty 기관순매매량 String N Body - orgn_cont_netprps _dys 기관계연속순매수일 수 String N Body - orgn_cont_netprps _qty 기관계연속순매수량 String N Body - orgn_cont_netprps _amt 기관계연속순매수금 액 String N Body - frgnr_nettrde_qty 외국인순매매량 String N Body - frgnr_nettrde_amt 외국인순매매액 String N Body - frgnr_cont_netprps _dys 외국인연속순매수일 수 String N Body - frgnr_cont_netprps _qty 외국인연속순매수량 String N Body - frgnr_cont_netprps _amt 외국인연속순매수금 액 String N Body - nettrde_qty 순매매량 String N Body - nettrde_amt 순매매액 String N Body - tot_cont_netprps_d ys 합계연속순매수일수 String N Body tot_cont_nettrde_qty 합계연속순매매수량 String N Body - tot_cont_netprps_a mt 합계연속순매수금액 String N Request Example { } "dt": "1", "strt_dt": "", "end_dt": "", "mrkt_tp": "001", "netslmt_tp": "2", "stk_inds_tp": "0", "amt_qty_tp": "0", "stex_tp": "1" Response Example { "orgn_frgnr_cont_trde_prst": [ { "rank": "1", "stk_cd": "005930", "stk_nm": "삼성전자", "prid_stkpc_flu_rt": "-5.80", "orgn_nettrde_amt": "+48", "orgn_nettrde_qty": "+173", "orgn_cont_netprps_dys": "+1", "orgn_cont_netprps_qty": "+173", "orgn_cont_netprps_amt": "+48", "frgnr_nettrde_qty": "+0", "frgnr_nettrde_amt": "+0", "frgnr_cont_netprps_dys": "+1", "frgnr_cont_netprps_qty": "+1", 239 / 528 Description Response Example }, { } "frgnr_cont_netprps_amt": "+0", "nettrde_qty": "+173", "nettrde_amt": "+48", "tot_cont_netprps_dys": "+2", "tot_cont_nettrde_qty": "+174", "tot_cont_netprps_amt": "+48" "rank": "2", "stk_cd": "005930", "stk_nm": "삼성전자", "prid_stkpc_flu_rt": "-4.21", "orgn_nettrde_amt": "+41", "orgn_nettrde_qty": "+159", "orgn_cont_netprps_dys": "+1", "orgn_cont_netprps_qty": "+159", "orgn_cont_netprps_amt": "+41", "frgnr_nettrde_qty": "+0", "frgnr_nettrde_amt": "+0", "frgnr_cont_netprps_dys": "+1", "frgnr_cont_netprps_qty": "+1", "frgnr_cont_netprps_amt": "+0", "nettrde_qty": "+159", "nettrde_amt": "+41", "tot_cont_netprps_dys": "+2", "tot_cont_nettrde_qty": "+160", "tot_cont_netprps_amt": "+42" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 240 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 당일매매일지요청(ka10170) API 명 당일매매일지요청 API ID ka10170 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body base_dt 기준일자 String N 8 YYYYMMDD(공백입력시 금일데이터,최근 2개월까지 제공) Body ottks_tp 단주구분 String Y 1 1:당일매수에 대한 당일매도,2:당일매도 전체 Body ch_crd_tp 현금신용구분 String Y 1 0:전체, 1:현금매매만, 2:신용매매만 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tot_sell_amt 총매도금액 String N Body tot_buy_amt 총매수금액 String N Body tot_cmsn_tax 총수수료_세금 String N Body tot_exct_amt 총정산금액 String N Body tot_pl_amt 총손익금액 String N Body tot_prft_rt 총수익률 String N Body tdy_trde_diary 당일매매일지 LIST N Body - stk_nm 종목명 String N Body - buy_avg_pric 매수평균가 String N 241 / 528 40 Response 구분 Element 한글명 Type Require d Body - buy_qty 매수수량 String N Body - sel_avg_pric 매도평균가 String N Body - sell_qty 매도수량 String N Body - cmsn_alm_tax 수수료_제세금 String N Body - pl_amt 손익금액 String N Body - sell_amt 매도금액 String N Body - buy_amt 매수금액 String N Body - prft_rt 수익률 String N Body - stk_cd 종목코드 String N Length Request Example { } "base_dt": "20241120", "ottks_tp": "1", "ch_crd_tp": "0" Response Example { } "tot_sell_amt": "48240", "tot_buy_amt": "48240", "tot_cmsn_tax": "174", "tot_exct_amt": "-174", "tot_pl_amt": "-174", "tot_prft_rt": "-0.36", "tdy_trde_diary": [ { "stk_nm": "삼성전자", "buy_avg_pric": "16080", "buy_qty": "3", "sel_avg_pric": "16080", "sell_qty": "3", "cmsn_alm_tax": "174", "pl_amt": "-174", "sell_amt": "48240", "buy_amt": "48240", "prft_rt": "-0.36", "stk_cd": "005930" } ], "return_code": 0, "return_msg": " 조회가 완료되었습니다." 242 / 528 6 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 조건검색 > 조건검색 목록조회(ka10171) API 명 조건검색 목록조회 API ID ka10171 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 조건검색은 영웅문4에서 만드실 수 있습니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm TR명 String Y 7 CNSRLST고정값 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 정상 : 0 Body return_msg 결과메시지 String N 정상인 경우는 메시지 없음 Body trnm 서비스명 String N Body data 조건검색식 목록 LIST N Body - seq 조건검색식 일련번호 String N Body - name 조건검색식 명 String N Request Example { } "trnm": "CNSRLST" Response Example { Description 'trnm': 'CNSRLST', 243 / 528 7 CNSRLST 고정값 Response Example } 'return_code': 0, 'return_msg': '', 'data': [ ['0','조건1'], ['1','조건2'], ['2','조건3'], ['3','조건4'], ['4','조건5'] ] 244 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 조건검색 > 조건검색 요청 일반(ka10172) API 명 조건검색 요청 일반 API ID ka10172 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 조건검색은 영웅문4에서 만드실 수 있습니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 7 CNSRREQ 고정값 Body seq 조건검색식 일련번호 String Y 3 Body search_type 조회타입 String Y Body stex_tp 거래소구분 String Y 1 K:KRX Body cont_yn 연속조회여부 String N 1 Y:연속조회요청,N:연속조회미요청 Body next_key 연속조회키 String N 20 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0:조건검색 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 정상:0 나머지:에러 Body return_msg 결과메시지 String N 정상인 경우는 메시지 없음 Body trnm 서비스명 String N CNSRREQ Body seq 조건검색식 일련번호 String N Body cont_yn 연속조회여부 String N 연속 데이터가 존재하는경우 Y, 없으면 N Body next_key 연속조회키 String N 연속조회여부가Y일경우 다음 조회시 필요한 조회값 245 / 528 Response 구분 Element 한글명 Type Require d Body data 검색결과데이터 LIST N Body - 9001 종목코드 String N Body - 302 종목명 String N Body - 10 현재가 String N Body - 25 전일대비기호 String N Body - 11 전일대비 String N Body - 12 등락율 String N Body - 13 누적거래량 String N Body - 16 시가 String N Body - 17 고가 String N Body - 18 저가 String N Length Request Example { } "trnm": "CNSRREQ", "seq": "4", "search_type": "0", "stex_tp": "K", "cont_yn": "N", "next_key": "" Response Example { 'trnm': 'CNSRREQ', 'seq': '2 ', 'cont_yn': 'N', 'next_key': '', 'return_code': 0, 'data': [ { '9001': 'A005930', '302': '삼성전자', '10': '000021850', '25': '3', '11': '000000000', '12': '000000000', '13': '000000000', '16': '000000000', '17': '000000000', '18': '000000000' }, { '9001': 'A005930', '302': '삼성전자', '10': '000044350', '25': '3', '11': '000000000', '12': '000000000', '13': '000000000', '16': '000000000', '17': '000000000', '18': '000000000' }, { '9001': 'A005930', '302': '삼성전자', '10': '000003855', '25': '3', '11': '000000000', '12': '000000000', '13': '000000000', '16': '000000000', 246 / 528 Description Response Example }, { }, { } ] } '17': '000000000', '18': '000000000' '9001': 'A005930', '302': '삼성전자', '10': '000075000', '25': '5', '11': '-00000100', '12': '-00000130', '13': '010386116', '16': '000075100', '17': '000075600', '18': '000074700' '9001': 'A005930', '302': '삼성전자', '10': '000002900', '25': '3', '11': '000000000', '12': '000000000', '13': '000000000', '16': '000000000', '17': '000000000', '18': '000000000' 247 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 조건검색 > 조건검색 요청 실시간(ka10173) API 명 조건검색 요청 실시간 API ID ka10173 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 조건검색 실시간 조회는 시스템 내부구조상 조건검색 목록 조회를 먼저 진행한 후에 실시간 조회를 이용할 수 있습니다. 조건검색은 영웅문4에서 만드실 수 있습니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 7 CNSRREQ 고정값 Body seq 조건검색식 일련번호 String Y 3 Body search_type 조회타입 String Y 1 1: 조건검색+실시간조건검색 Body stex_tp 거래소구분 String Y 1 K:KRX 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body 조회 데이터 Body return_code 결과코드 String N 정상:0 나머지:에러 Body return_msg 결과메시지 String N 정상인 경우는 메시지 없음 Body trnm 서비스명 String N CNSRREQ Body seq 조건검색식 일련번호 String N Body data 검색결과데이터 LIST N Body - jmcode 종목코드 String N Body 실시간 데이터 248 / 528 Response 구분 Element 한글명 Type Require d Body data 검색결과데이터 LIST Y Body trnm 서비스명 String Y Body - type 실시간 항목 String Y Body - name 실시간 항목명 String Y Body - values 실시간 수신 값 Object Y Body - - 841 일련번호 String Y Body - - 9001 종목코드 String Y Body - - 843 삽입삭제 구분 String Y Body - - 20 체결시간 String Y Body - - 907 매도/수 구분 String Y Length Request Example { } "trnm": "CNSRREQ", "seq": "4", "search_type": "1", "stex_tp": "K" Response Example #조회데이터 { 'trnm': 'CNSRREQ', 'seq': '4', 'return_code': 0, 'data': [ {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'}, {'jmcode': 'A005930'} ] } #실시간데이터 { 'data': [ { 249 / 528 Description REAL 2 TR 명(0A,0B....) 종목코드 I: 삽입, D: 삭제 Response Example 'values': { '841': '4', '9001': '005930', '843': 'I', '20': '152028', '907': '2' }, 'type': '02', 'name': '조건검색', 'item': '005930' } } ], 'trnm': 'REAL' 250 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 조건검색 > 조건검색 실시간 해제(ka10174) API 명 조건검색 실시간 해제 API ID ka10174 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 조건검색은 영웅문4에서 만드실 수 있습니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 7 CNSRCLR 고정값 Body seq 조건검색식 일련번호 String Y 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String Y 정상:0 나머지:에러 Body return_msg 결과메시지 String Y 정상인 경우는 메시지 없음 Body trnm 서비스명 String Y CNSRCLR 고정값 Body seq 조건검색식 일련번호 String Y Request Example { } "trnm": "CNSRCLR", "seq": "1" Response Example { Description 'trnm': 'CNSRCLR', 'seq' : '1', 251 / 528 Response Example } 'return_code': 0, 'return_msg': '' 252 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 업종 > 업종현재가요청(ka20001) API 명 업종현재가요청 API ID ka20001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/sect Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 1 0:코스피, 1:코스닥, 2:코스피200 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body cur_prc 현재가 String N 20 Body pred_pre_sig 전일대비기호 String N 20 Body pred_pre 전일대비 String N 20 Body flu_rt 등락률 String N 20 Body trde_qty 거래량 String N 20 Body trde_prica 거래대금 String N 20 Body trde_frmatn_stk_num 거래형성종목수 String N 20 Body trde_frmatn_rt 거래형성비율 String N 20 Body open_pric 시가 String N 20 253 / 528 Response 구분 Element 한글명 Type Require d Length Body high_pric 고가 String N 20 Body low_pric 저가 String N 20 Body upl 상한 String N 20 Body rising 상승 String N 20 Body stdns 보합 String N 20 Body fall 하락 String N 20 Body lst 하한 String N 20 Body 52wk_hgst_pric 52주최고가 String N 20 Body 52wk_hgst_pric_dt 52주최고가일 String N 20 Body 52wk_hgst_pric_pre_ rt 52주최고가대비율 String N 20 Body 52wk_lwst_pric 52주최저가 String N 20 Body 52wk_lwst_pric_dt 52주최저가일 String N 20 Body 52wk_lwst_pric_pre_r t 52주최저가대비율 String N 20 Body inds_cur_prc_tm 업종현재가_시간별 LIST N Body - tm_n 시간n String N 20 Body - cur_prc_n 현재가n String N 20 Body - pred_pre_sig_n 전일대비기호n String N 20 Body - pred_pre_n 전일대비n String N 20 Body - flu_rt_n 등락률n String N 20 Body - trde_qty_n 거래량n String N 20 Body - acc_trde_qty_n 누적거래량n String N 20 Request Example { } "mrkt_tp": "0", "inds_cd": "001" Response Example { "cur_prc": "-2394.49", "pred_pre_sig": "5", "pred_pre": "-278.47", "flu_rt": "-10.42", "trde_qty": "890", "trde_prica": "41867", "trde_frmatn_stk_num": "330", "trde_frmatn_rt": "+34.38", "open_pric": "-2669.53", "high_pric": "-2669.53", "low_pric": "-2375.21", "upl": "0", "rising": "17", "stdns": "183", "fall": "130", "lst": "3", "52wk_hgst_pric": "+3001.91", "52wk_hgst_pric_dt": "20241004", "52wk_hgst_pric_pre_rt": "-20.23", "52wk_lwst_pric": "-1608.07", 254 / 528 Description Response Example } "52wk_lwst_pric_dt": "20241031", "52wk_lwst_pric_pre_rt": "+48.90", "inds_cur_prc_tm": [ { "tm_n": "143000", "cur_prc_n": "-2394.49", "pred_pre_sig_n": "5", "pred_pre_n": "-278.47", "flu_rt_n": "-10.42", "trde_qty_n": "14", "acc_trde_qty_n": "890", "stex_tp": "" }, { "tm_n": "142950", "cur_prc_n": "-2394.49", "pred_pre_sig_n": "5", "pred_pre_n": "-278.47", "flu_rt_n": "-10.42", "trde_qty_n": "14", "acc_trde_qty_n": "876", "stex_tp": "" }, { "tm_n": "142940", "cur_prc_n": "-2394.49", "pred_pre_sig_n": "5", "pred_pre_n": "-278.47", "flu_rt_n": "-10.42", "trde_qty_n": "14", "acc_trde_qty_n": "862", "stex_tp": "" }, { "tm_n": "142930", "cur_prc_n": "-2395.62", "pred_pre_sig_n": "5", "pred_pre_n": "-277.34", "flu_rt_n": "-10.38", "trde_qty_n": "14", "acc_trde_qty_n": "848", "stex_tp": "" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 255 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 업종 > 업종별주가요청(ka20002) API 명 업종별주가요청 API ID ka20002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/sect Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 1 0:코스피, 1:코스닥, 2:코스피200 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_stkpc 업종별주가 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - now_trde_qty 현재거래량 String N 20 256 / 528 Response 구분 Element 한글명 Type Require d Length Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Request Example { } "mrkt_tp": "0", "inds_cd": "001", "stex_tp": "1" Response Example { "inds_stkpc": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "6200", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "116", "sel_bid": "+6990", "buy_bid": "0", "open_pric": "6200", "high_pric": "6200", "low_pric": "6200" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "465", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "0", "buy_bid": "0", "open_pric": "0", "high_pric": "0", "low_pric": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "6090", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "0", "buy_bid": "-5000", "open_pric": "0", "high_pric": "0", "low_pric": "0" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+68100", "pred_pre_sig": "2", "pred_pre": "+600", "flu_rt": "+0.89", "now_trde_qty": "3", "sel_bid": "0", "buy_bid": "+68100", "open_pric": "67500", 257 / 528 Description Response Example }, { } "high_pric": "+68100", "low_pric": "-66000" "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "55300", "pred_pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "now_trde_qty": "0", "sel_bid": "+55400", "buy_bid": "-55000", "open_pric": "0", "high_pric": "0", "low_pric": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 258 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 업종 > 전업종지수요청(ka20003) API 명 전업종지수요청 API ID ka20003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/sect Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 101:종합(KOSDAQ) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body all_inds_idex 전업종지수 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 Body - wght 비중 String N 20 Body - trde_prica 거래대금 String N 20 Body - upl 상한 String N 20 259 / 528 Response 구분 Element 한글명 Type Require d Length Body - rising 상승 String N 20 Body - stdns 보합 String N 20 Body - fall 하락 String N 20 Body - lst 하한 String N 20 Body - flo_stk_num 상장종목수 String N 20 Request Example { } "inds_cd": "001" Response Example { } "all_inds_idex": [ { "stk_cd": "001", "stk_nm": "종합(KOSPI)", "cur_prc": "-2393.33", "pre_sig": "5", "pred_pre": "-279.63", "flu_rt": "-10.46", "trde_qty": "993", "wght": "", "trde_prica": "46494", "upl": "0", "rising": "17", "stdns": "184", "fall": "129", "lst": "4", "flo_stk_num": "960" }, { "stk_cd": "002", "stk_nm": "대형주", "cur_prc": "-2379.14", "pre_sig": "5", "pred_pre": "-326.94", "flu_rt": "-12.08", "trde_qty": "957", "wght": "", "trde_prica": "44563", "upl": "0", "rising": "6", "stdns": "32", "fall": "56", "lst": "2", "flo_stk_num": "100" }, { "stk_cd": "003", "stk_nm": "중형주", "cur_prc": "-2691.27", "pre_sig": "5", "pred_pre": "-58.55", "flu_rt": "-2.13", "trde_qty": "26", "wght": "", "trde_prica": "1823", "upl": "0", "rising": "5", "stdns": "75", "fall": "49", "lst": "2", "flo_stk_num": "200" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 260 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 업종틱차트조회요청(ka20004) API 명 업종틱차트조회요청 API ID ka20004 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 Body tic_scope 틱범위 String Y 2 1:1틱, 3:3틱, 5:5틱, 10:10틱, 30:30틱 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_cd 업종코드 String N 20 Body inds_tic_chart_qry 업종틱차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - cntr_tm 체결시간 String N 20 Body - open_pric 시가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - high_pric 고가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - low_pric 저가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - pred_pre 전일대비 String N 20 현재가 - 전일종가 261 / 528 지수 값은 소수점 제거 후 100배 값으로 반환 Response 구분 Element 한글명 Type Require d Length Body - pred_pre_sig 전일대비 기호 String N 20 Request Example { } "inds_cd": "001", "tic_scope": "1" Response Example { } "inds_cd": "001", "inds_tic_chart_qry": [ { "cur_prc": "388193", "trde_qty": "4", "cntr_tm": "20250917142630", "open_pric": "388193", "high_pric": "388193", "low_pric": "388193", "pred_pre": "18031", "pred_pre_sig": "43" }, { "cur_prc": "383976", "trde_qty": "2", "cntr_tm": "20250917142350", "open_pric": "383976", "high_pric": "383976", "low_pric": "383976", "pred_pre": "13814", "pred_pre_sig": "43" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 262 / 528 Description 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 업종분봉조회요청(ka20005) API 명 업종분봉조회요청 API ID ka20005 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 Body tic_scope 틱범위 String Y 2 1:1틱, 3:3틱, 5:5틱, 10:10틱, 30:30틱 Body base_dt 기준일자 String N 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_cd 업종코드 String N 20 Body inds_min_pole_qry 업종분봉조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - cntr_tm 체결시간 String N 20 Body - open_pric 시가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - high_pric 고가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - low_pric 저가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 263 / 528 지수 값은 소수점 제거 후 100배 값으로 반환 Response Type Require d Length 누적거래량 String N 20 - pred_pre 전일대비 String N 20 현재가 - 전일종가 - pred_pre_sig 전일대비 기호 String N 20 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 구분 Element Body - acc_trde_qty Body Body 한글명 Request Example { } "inds_cd": "001", "tic_scope": "5", "base_dt": "20260202" Response Example { } "inds_cd": "001", "inds_dt_pole_qry": [ { "cur_prc": "252127", "trde_qty": "393564", "dt": "20250210", "open_pric": "251064", "high_pric": "252733", "low_pric": "249918", "trde_prica": "10582466" }, { "cur_prc": "252192", "trde_qty": "419872", "dt": "20250207", "open_pric": "253209", "high_pric": "253763", "low_pric": "251901", "trde_prica": "10240141" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 264 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 업종일봉조회요청(ka20006) API 명 업종일봉조회요청 API ID ka20006 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 Body base_dt 기준일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_cd 업종코드 String N 20 Body inds_dt_pole_qry 업종일봉조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - high_pric 고가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - low_pric 저가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - trde_prica 거래대금 String N 20 265 / 528 지수 값은 소수점 제거 후 100배 값으로 반환 Request Example { } "inds_cd": "001", "base_dt": "20250905" Response Example { } "inds_cd": "001", "inds_dt_pole_qry": [ { "cur_prc": "252127", "trde_qty": "393564", "dt": "20250210", "open_pric": "251064", "high_pric": "252733", "low_pric": "249918", "trde_prica": "10582466" }, { "cur_prc": "252192", "trde_qty": "419872", "dt": "20250207", "open_pric": "253209", "high_pric": "253763", "low_pric": "251901", "trde_prica": "10240141" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 266 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 업종주봉조회요청(ka20007) API 명 업종주봉조회요청 API ID ka20007 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body inds_cd 업종코드 String Y 8 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 Body base_dt 기준일자 String Y 3 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_cd 업종코드 String N 20 Body inds_stk_pole_qry 업종주봉조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - high_pric 고가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - low_pric 저가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - trde_prica 거래대금 String N 20 267 / 528 지수 값은 소수점 제거 후 100배 값으로 반환 Request Example { } "inds_cd": "001", "base_dt": "20250905" Response Example { } "inds_cd": "001", "inds_stk_pole_qry": [ { "cur_prc": "252127", "trde_qty": "393564", "dt": "20250210", "open_pric": "251064", "high_pric": "252733", "low_pric": "249918", "trde_prica": "10582466" }, { "cur_prc": "252192", "trde_qty": "2339138", "dt": "20250203", "open_pric": "246874", "high_pric": "253763", "low_pric": "243761", "trde_prica": "54703685" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 268 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 업종월봉조회요청(ka20008) API 명 업종월봉조회요청 API ID ka20008 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 Body base_dt 기준일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_cd 업종코드 String N 20 Body inds_mth_pole_qry 업종월봉조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - high_pric 고가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - low_pric 저가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - trde_prica 거래대금 String N 20 269 / 528 지수 값은 소수점 제거 후 100배 값으로 반환 Request Example { } "inds_cd": "002", "base_dt": "20250905" Response Example { } "inds_cd": "002", "inds_mth_pole_qry": [ { "cur_prc": "405407", "trde_qty": "366", "dt": "20250917", "open_pric": "380658", "high_pric": "425533", "low_pric": "345789", "trde_prica": "61127" }, { "cur_prc": "251506", "trde_qty": "706969", "dt": "20250203", "open_pric": "246210", "high_pric": "253343", "low_pric": "243269", "trde_prica": "47770055" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 270 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 업종 > 업종현재가일별요청(ka20009) API 명 업종현재가일별요청 API ID ka20009 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/sect Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 1 0:코스피, 1:코스닥, 2:코스피200 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body cur_prc 현재가 String N 20 Body pred_pre_sig 전일대비기호 String N 20 Body pred_pre 전일대비 String N 20 Body flu_rt 등락률 String N 20 Body trde_qty 거래량 String N 20 Body trde_prica 거래대금 String N 20 Body trde_frmatn_stk_num 거래형성종목수 String N 20 Body trde_frmatn_rt 거래형성비율 String N 20 Body open_pric 시가 String N 20 271 / 528 Response 구분 Element 한글명 Type Require d Length Body high_pric 고가 String N 20 Body low_pric 저가 String N 20 Body upl 상한 String N 20 Body rising 상승 String N 20 Body stdns 보합 String N 20 Body fall 하락 String N 20 Body lst 하한 String N 20 Body 52wk_hgst_pric 52주최고가 String N 20 Body 52wk_hgst_pric_dt 52주최고가일 String N 20 Body 52wk_hgst_pric_pre_ rt 52주최고가대비율 String N 20 Body 52wk_lwst_pric 52주최저가 String N 20 Body 52wk_lwst_pric_dt 52주최저가일 String N 20 Body 52wk_lwst_pric_pre_r t 52주최저가대비율 String N 20 Body inds_cur_prc_daly_re pt 업종현재가_일별반복 LIST N Body - dt_n 일자n String N 20 Body - cur_prc_n 현재가n String N 20 Body - pred_pre_sig_n 전일대비기호n String N 20 Body - pred_pre_n 전일대비n String N 20 Body - flu_rt_n 등락률n String N 20 Body - acc_trde_qty_n 누적거래량n String N 20 Request Example { } "mrkt_tp": "0", "inds_cd": "001" Response Example { "cur_prc": "-2384.71", "pred_pre_sig": "5", "pred_pre": "-288.25", "flu_rt": "-10.78", "trde_qty": "1103", "trde_prica": "48151", "trde_frmatn_stk_num": "333", "trde_frmatn_rt": "+34.69", "open_pric": "-2669.53", "high_pric": "-2669.53", "low_pric": "-2375.21", "upl": "0", "rising": "18", "stdns": "183", "fall": "132", "lst": "4", "52wk_hgst_pric": "+3001.91", "52wk_hgst_pric_dt": "20241004", "52wk_hgst_pric_pre_rt": "-20.56", "52wk_lwst_pric": "-1608.07", "52wk_lwst_pric_dt": "20241031", 272 / 528 Description Response Example } "52wk_lwst_pric_pre_rt": "+48.30", "inds_cur_prc_daly_rept": [ { "dt_n": "20241122", "cur_prc_n": "-2384.71", "pred_pre_sig_n": "5", "pred_pre_n": "-288.25", "flu_rt_n": "-10.78", "acc_trde_qty_n": "1103" }, { "dt_n": "20241121", "cur_prc_n": "+2672.96", "pred_pre_sig_n": "2", "pred_pre_n": "+25.56", "flu_rt_n": "+0.97", "acc_trde_qty_n": "444" }, { "dt_n": "20241120", "cur_prc_n": "+2647.40", "pred_pre_sig_n": "2", "pred_pre_n": "+83.56", "flu_rt_n": "+3.26", "acc_trde_qty_n": "195" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 273 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 업종년봉조회요청(ka20019) API 명 업종년봉조회요청 API ID ka20019 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body inds_cd 업종코드 String Y 3 001:종합(KOSPI), 002:대형주, 003:중형주, 004:소형주 101:종합(KOSDAQ), 201:KOSPI200, 302:KOSTAR, 701: KRX100 나머지 ※ 업종코드 참고 Body base_dt 기준일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inds_cd 업종코드 String N 20 Body inds_yr_pole_qry 업종년봉조회 LIST N Body - cur_prc 현재가 String N 20 Body - trde_qty 거래량 String N 20 Body - dt 일자 String N 20 Body - open_pric 시가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - high_pric 고가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - low_pric 저가 String N 20 지수 값은 소수점 제거 후 100배 값으로 반환 Body - trde_prica 거래대금 String N 20 274 / 528 지수 값은 소수점 제거 후 100배 값으로 반환 Request Example { } "inds_cd": "001", "base_dt": "20250905" Response Example { } "inds_cd": "001", "inds_yr_pole_qry": [ { "cur_prc": "387923", "trde_qty": "11034579", "dt": "20250102", "open_pric": "240087", "high_pric": "409075", "low_pric": "238684", "trde_prica": "238469489" }, { "cur_prc": "223424", "trde_qty": "16587474", "dt": "20241105", "open_pric": "258897", "high_pric": "864831", "low_pric": "210288", "trde_prica": "1285406885" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 275 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 대차거래 > 대차거래추이요청(종목별)(ka20068) API 명 대차거래추이요청(종목별) API ID ka20068 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/slb Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String N 8 YYYYMMDD Body end_dt 종료일자 String N 8 YYYYMMDD Body all_tp 전체구분 String N 1 0:종목코드 입력종목만 표시 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dbrt_trde_trnsn 대차거래추이 LIST N Body - dt 일자 String N 20 Body - dbrt_trde_cntrcnt 대차거래체결주수 String N 20 Body - dbrt_trde_rpy 대차거래상환주수 String N 20 Body - dbrt_trde_irds 대차거래증감 String N 20 Body - rmnd 잔고주수 String N 20 Body - remn_amt 잔고금액 String N 20 Request Example 276 / 528 Request Example { } "strt_dt": "20250401", "end_dt": "20250430", "all_tp": "0", "stk_cd": "005930" Response Example { } "dbrt_trde_trnsn": [ { "dt": "20250430", "dbrt_trde_cntrcnt": "1210354", "dbrt_trde_rpy": "2693108", "dbrt_trde_irds": "-1482754", "rmnd": "98242435", "remn_amt": "5452455" }, { "dt": "20250429", "dbrt_trde_cntrcnt": "502018", "dbrt_trde_rpy": "1022714", "dbrt_trde_irds": "-520696", "rmnd": "99725189", "remn_amt": "5564666" }, { "dt": "20250428", "dbrt_trde_cntrcnt": "958772", "dbrt_trde_rpy": "3122807", "dbrt_trde_irds": "-2164035", "rmnd": "100245885", "remn_amt": "5593720" }, { "dt": "20250425", "dbrt_trde_cntrcnt": "1504273", "dbrt_trde_rpy": "5217540", "dbrt_trde_irds": "-3713267", "rmnd": "102409920", "remn_amt": "5704233" }, { "dt": "20250424", "dbrt_trde_cntrcnt": "1803312", "dbrt_trde_rpy": "6076301", "dbrt_trde_irds": "-4272989", "rmnd": "106123187", "remn_amt": "5911062" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 277 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW가격급등락요청(ka30001) API 명 ELW가격급등락요청 API ID ka30001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body flu_tp 등락구분 String Y 1 1:급등, 2:급락 Body tm_tp 시간구분 String Y 1 1:분전, 2:일전 Body tm 시간 String Y 2 분 혹은 일입력 (예 1, 3, 5) Body trde_qty_tp 거래량구분 String Y 4 0:전체, 10:만주이상, 50:5만주이상, 100:10만주이상, 300:30만주이상, 500:50만주이상, 1000:백만주이상 Body isscomp_cd 발행사코드 String Y 12 전체:000000000000, 한국투자증권:3, 미래대우:5, 신영:6, NK투자증권:12, KB증권:17 Body bsis_aset_cd 기초자산코드 String Y 12 전체:000000000000, KOSPI200:201, KOSDAQ150:150, 삼성전자:005930, KT:030200.. Body rght_tp 권리구분 String Y 3 000:전체, 001:콜, 002:풋, 003:DC, 004:DP, 005:EX, 006:조기종료콜, 007:조기종료풋 Body lpcd LP코드 String Y 12 전체:000000000000, 한국투자증권:3, 미래대우:5, 신영:6, NK투자증권:12, KB증권:17 Body trde_end_elwskip 거래종료ELW제외 String Y 1 0:포함, 1:제외 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body base_pric_tm 기준가시간 String N 20 278 / 528 Response Type Require d ELW가격급등락 LIST N - stk_cd 종목코드 String N 20 Body - rank 순위 String N 20 Body - stk_nm 종목명 String N 40 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - trde_end_elwbase_ pric 거래종료ELW기준가 String N 20 Body - cur_prc 현재가 String N 20 Body - base_pre 기준대비 String N 20 Body - trde_qty 거래량 String N 20 Body - jmp_rt 급등율 String N 20 구분 Element Body elwpric_jmpflu Body 한글명 Length Request Example { } "flu_tp": "1", "tm_tp": "2", "tm": "1", "trde_qty_tp": "0", "isscomp_cd": "000000000000", "bsis_aset_cd": "000000000000", "rght_tp": "000", "lpcd": "000000000000", "trde_end_elwskip": "0" Response Example { } "base_pric_tm": "기준가(11/21)", "elwpric_jmpflu": [ { "stk_cd": "57JBHH", "rank": "1", "stk_nm": "한국JBHHKOSPI200풋", "pre_sig": "2", "pred_pre": "+10", "trde_end_elwbase_pric": "20", "cur_prc": "+30", "base_pre": "10", "trde_qty": "30", "jmp_rt": "+50.00" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 279 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > 거래원별ELW순매매상위요청(ka30002) API 명 거래원별ELW순매매상위요청 API ID ka30002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body isscomp_cd 발행사코드 String Y 3 3자리, 영웅문4 0273화면참조 (교보:001, 신한금융투자:002, 한국투자증권:003, 대신:004, 미래대우:005, ,,,) Body trde_qty_tp 거래량구분 String Y 4 0:전체, 5:5천주, 10:만주, 50:5만주, 100:10만주, 500:50만주, 1000:백만주 Body trde_tp 매매구분 String Y 1 1:순매수, 2:순매도 Body dt 기간 String Y 2 1:전일, 5:5일, 10:10일, 40:40일, 60:60일 Body trde_end_elwskip 거래종료ELW제외 String Y 1 0:포함, 1:제외 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trde_ori_elwnettrde_ upper 거래원별ELW순매매 상위 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - stkpc_flu 주가등락 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 280 / 528 Response 구분 Element 한글명 Type Require d Length Body - netprps 순매수 String N 20 Body - buy_trde_qty 매수거래량 String N 20 Body - sel_trde_qty 매도거래량 String N 20 Request Example { } "isscomp_cd": "003", "trde_qty_tp": "0", "trde_tp": "2", "dt": "60", "trde_end_elwskip": "0" Response Example { } "trde_ori_elwnettrde_upper": [ { "stk_cd": "57JBHH", "stk_nm": "한국JBHHKOSPI200풋", "stkpc_flu": "--3140", "flu_rt": "-88.95", "trde_qty": "500290", "netprps": "--846970", "buy_trde_qty": "+719140", "sel_trde_qty": "-1566110" }, { "stk_cd": "57JBHH", "stk_nm": "한국JBHHKOSPI200풋", "stkpc_flu": "+205", "flu_rt": "+73.21", "trde_qty": "4950000", "netprps": "--108850", "buy_trde_qty": "+52450", "sel_trde_qty": "-161300" }, { "stk_cd": "57JBHH", "stk_nm": "한국JBHHKOSPI200풋", "stkpc_flu": "+340", "flu_rt": "+115.25", "trde_qty": "60", "netprps": "--73960", "buy_trde_qty": "+29560", "sel_trde_qty": "-103520" }, { "stk_cd": "57JBHH", "stk_nm": "한국JBHHKOSPI200풋", "stkpc_flu": "--65", "flu_rt": "-86.67", "trde_qty": "20", "netprps": "--23550", "buy_trde_qty": "+422800", "sel_trde_qty": "-446350" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 281 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELWLP보유일별추이요청(ka30003) API 명 ELWLP보유일별추이요청 API ID ka30003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body bsis_aset_cd 기초자산코드 String Y 12 Body base_dt 기준일자 String Y 8 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... YYYYMMDD Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwlpposs_daly_trnsn ELWLP보유일별추이 LIST N Body - dt 일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_tp 대비구분 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Body - chg_qty 변동수량 String N 20 Body - lprmnd_qty LP보유수량 String N 20 282 / 528 Response 구분 Body Element - wght 한글명 비중 Type Require d Length String N 20 Request Example { } "bsis_aset_cd": "57KJ99", "base_dt": "20241122" Response Example { } "elwlpposs_daly_trnsn": [ { "dt": "20241122", "cur_prc": "-125700", "pre_tp": "5", "pred_pre": "-900", "flu_rt": "-0.71", "trde_qty": "54", "trde_prica": "7", "chg_qty": "0", "lprmnd_qty": "0", "wght": "0.00" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 283 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW괴리율요청(ka30004) API 명 ELW괴리율요청 API ID ka30004 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body isscomp_cd 발행사코드 String Y 12 전체:000000000000, 한국투자증권:3, 미래대우:5, 신영:6, NK투자증권:12, KB증권:17 Body bsis_aset_cd 기초자산코드 String Y 12 전체:000000000000, KOSPI200:201, KOSDAQ150:150, 삼성전자:005930, KT:030200.. Body rght_tp 권리구분 String Y 3 000: 전체, 001: 콜, 002: 풋, 003: DC, 004: DP, 005: EX, 006: 조기종료콜, 007: 조기종료풋 Body lpcd LP코드 String Y 12 전체:000000000000, 한국투자증권:3, 미래대우:5, 신영:6, NK투자증권:12, KB증권:17 Body trde_end_elwskip 거래종료ELW제외 String Y 1 1:거래종료ELW제외, 0:거래종료ELW포함 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwdispty_rt ELW괴리율 LIST N Body - stk_cd 종목코드 String N 20 Body - isscomp_nm 발행사명 String N 20 Body - sqnc 회차 String N 20 Body - base_aset_nm 기초자산명 String N 20 284 / 528 Response 구분 Element 한글명 Type Require d Length Body - rght_tp 권리구분 String N 20 Body - dispty_rt 괴리율 String N 20 Body - basis 베이시스 String N 20 Body - srvive_dys 잔존일수 String N 20 Body - theory_pric 이론가 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_tp 대비구분 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - stk_nm 종목명 String N 40 Request Example { } "isscomp_cd": "000000000000", "bsis_aset_cd": "000000000000", "rght_tp": "000", "lpcd": "000000000000", "trde_end_elwskip": "0" Response Example { "elwdispty_rt": [ { "stk_cd": "57JBHH", "isscomp_nm": "키움증권", "sqnc": "KK27", "base_aset_nm": "삼성전자", "rght_tp": "콜", "dispty_rt": "0", "basis": "+5.00", "srvive_dys": "21", "theory_pric": "0", "cur_prc": "5", "pre_tp": "3", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "stk_nm": "한국JBHHKOSPI200풋" }, { "stk_cd": "57JBHH", "isscomp_nm": "키움증권", "sqnc": "KL57", "base_aset_nm": "삼성전자", "rght_tp": "콜", "dispty_rt": "0", "basis": "+10.00", "srvive_dys": "49", "theory_pric": "0", "cur_prc": "10", "pre_tp": "3", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "stk_nm": "한국JBHHKOSPI200풋" }, { "stk_cd": "57JBHH", "isscomp_nm": "키움증권", "sqnc": "KK28", "base_aset_nm": "삼성전자", 285 / 528 Description Response Example "rght_tp": "콜", "dispty_rt": "0", "basis": "+5.00", "srvive_dys": "49", "theory_pric": "0", "cur_prc": "5", "pre_tp": "3", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "stk_nm": "한국JBHHKOSPI200풋" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 286 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW조건검색요청(ka30005) API 명 ELW조건검색요청 API ID ka30005 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body isscomp_cd 발행사코드 String Y 12 12자리입력(전체:000000000000, 한국투자증권:000,,,3, 미래대우:000,,,5, 신영:000,,,6, NK투자증권:000,,,12, KB증권:000,,,17) Body bsis_aset_cd 기초자산코드 String Y 12 전체일때만 12자리입력(전체:000000000000, KOSPI200:201, KOSDAQ150:150, 삼정전자:005930, KT:030200,,) Body rght_tp 권리구분 String Y 1 0:전체, 1:콜, 2:풋, 3:DC, 4:DP, 5:EX, 6:조기종료콜, 7:조기종료풋 Body lpcd LP코드 String Y 12 전체일때만 12자리입력(전체:000000000000, 한국투자증권:003, 미래대우:005, 신영:006, NK투자증권:012, KB증권:017) Body sort_tp 정렬구분 String Y 1 0:정렬없음, 1:상승율순, 2:상승폭순, 3:하락율순, 4:하락폭순, 5:거래량순, 6:거래대금순, 7:잔존일순 Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwcnd_qry ELW조건검색 LIST N Body - stk_cd 종목코드 String N 20 Body - isscomp_nm 발행사명 String N 20 Body - sqnc 회차 String N 20 287 / 528 Response Type Require d Length 기초자산명 String N 20 - rght_tp 권리구분 String N 20 Body - expr_dt 만기일 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_tp 대비구분 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_qty_pre 거래량대비 String N 20 Body - trde_prica 거래대금 String N 20 Body - pred_trde_qty 전일거래량 String N 20 Body - sel_bid 매도호가 String N 20 Body - buy_bid 매수호가 String N 20 Body - prty 패리티 String N 20 Body - gear_rt 기어링비율 String N 20 Body - pl_qutr_rt 손익분기율 String N 20 Body - cfp 자본지지점 String N 20 Body - theory_pric 이론가 String N 20 Body - innr_vltl 내재변동성 String N 20 Body - delta 델타 String N 20 Body - lvrg 레버리지 String N 20 Body - exec_pric 행사가격 String N 20 Body - cnvt_rt 전환비율 String N 20 Body - lpposs_rt LP보유비율 String N 20 Body - pl_qutr_pt 손익분기점 String N 20 Body - fin_trde_dt 최종거래일 String N 20 Body - flo_dt 상장일 String N 20 Body - lpinitlast_suply_dt LP초종공급일 String N 20 Body - stk_nm 종목명 String N 40 Body - srvive_dys 잔존일수 String N 20 Body - dispty_rt 괴리율 String N 20 Body - lpmmcm_nm LP회원사명 String N 20 Body - lpmmcm_nm_1 LP회원사명1 String N 20 Body - lpmmcm_nm_2 LP회원사명2 String N 20 Body - xraymont_cntr_qty_ arng_trde_tp Xray순간체결량정리 매매구분 String N 20 Body - xraymont_cntr_qty_ profa_100tp Xray순간체결량증거 금100구분 String N 20 구분 Element Body - base_aset_nm Body 한글명 288 / 528 Description Request Example { } "isscomp_cd": "000000000017", "bsis_aset_cd": "201", "rght_tp": "1", "lpcd": "000000000000", "sort_tp": "0" Response Example { } "elwcnd_qry": [ { "stk_cd":"57JBHH", "isscomp_nm":"키움증권", "sqnc":"K411", "base_aset_nm":"KOSPI200", "rght_tp":"콜", "expr_dt":"20241216", "cur_prc":"15", "pre_tp":"3", "pred_pre":"0", "flu_rt":"0.00", "trde_qty":"0", "trde_qty_pre":"0.00", "trde_prica":"0", "pred_trde_qty":"0", "sel_bid":"0", "buy_bid":"0", "prty":"90.10", "gear_rt":"2267.53", "pl_qutr_rt":"+11.03" "cfp":"", "theory_pric":"65637", "innr_vltl":"2015", "delta":"282426", "lvrg":"640.409428", "exec_pric":"377.50", "cnvt_rt":"100.0000", "lpposs_rt":"+99.90", "pl_qutr_pt":"+377.65", "fin_trde_dt":"20241212", "flo_dt":"20240320", "lpinitlast_suply_dt":"20241212", "stk_nm":"한국JBHHKOSPI200풋", "srvive_dys":"21", "dispty_rt":"--97.71", "lpmmcm_nm":"키움증권", "lpmmcm_nm_1":"0.00", "lpmmcm_nm_2":"", "xraymont_cntr_qty_arng_trde_tp":"", "xraymont_cntr_qty_profa_100tp":"", } ], "return_code":0, "return_msg":"정상적으로 처리되었습니다" 289 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW등락율순위요청(ka30009) API 명 ELW등락율순위요청 API ID ka30009 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body sort_tp 정렬구분 String Y 1 1:상승률, 2:상승폭, 3:하락률, 4:하락폭 Body rght_tp 권리구분 String Y 3 000:전체, 001:콜, 002:풋, 003:DC, 004:DP, 006:조기종료콜, 007:조기종료풋 Body trde_end_skip 거래종료제외 String Y 1 1:거래종료제외, 0:거래종료포함 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwflu_rt_rank ELW등락율순위 LIST N Body - rank 순위 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - sel_req 매도잔량 String N 20 290 / 528 Response 구분 Element 한글명 Type Require d Length Body - buy_req 매수잔량 String N 20 Body - trde_qty 거래량 String N 20 Body - trde_prica 거래대금 String N 20 Request Example { } "sort_tp": "1", "rght_tp": "000", "trde_end_skip": "0" Response Example { } "elwflu_rt_rank": [ { "rank": "1", "stk_cd": "57JBHH", "stk_nm": "한국JBHHKOSPI200풋", "cur_prc": "+30", "pre_sig": "2", "pred_pre": "+10", "flu_rt": "+50.00", "sel_req": "0", "buy_req": "0", "trde_qty": "30", "trde_prica": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 291 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW잔량순위요청(ka30010) API 명 ELW잔량순위요청 API ID ka30010 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body sort_tp 정렬구분 String Y 1 1:순매수잔량상위, 2: 순매도 잔량상위 Body rght_tp 권리구분 String Y 3 000: 전체, 001: 콜, 002: 풋, 003: DC, 004: DP, 006: 조기종료콜, 007: 조기종료풋 Body trde_end_skip 거래종료제외 String Y 1 1:거래종료제외, 0:거래종료포함 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwreq_rank ELW잔량순위 LIST N Body - stk_cd 종목코드 String N 20 Body - rank 순위 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락률 String N 20 Body - trde_qty 거래량 String N 20 292 / 528 Response 구분 Element 한글명 Type Require d Length Body - sel_req 매도잔량 String N 20 Body - buy_req 매수잔량 String N 20 Body - netprps_req 순매수잔량 String N 20 Body - trde_prica 거래대금 String N 20 Request Example { } "sort_tp": "1", "rght_tp": "000", "trde_end_skip": "0" Response Example { } "elwreq_rank": [ { "stk_cd": "57JBHH", "rank": "1", "stk_nm": "한국JBHHKOSPI200풋", "cur_prc": "170", "pre_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "sel_req": "0", "buy_req": "20", "netprps_req": "20", "trde_prica": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 293 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW근접율요청(ka30011) API 명 ELW근접율요청 API ID ka30011 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body elwalacc_rt ELW근접율 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - alacc_rt 근접율 String N 20 Request Example { Description "stk_cd": "57JBHH" 294 / 528 Request Example } Response Example { } "elwalacc_rt": [ { "stk_cd": "201", "stk_nm": "KOSPI200", "cur_prc": "+431.78", "pre_sig": "2", "pred_pre": "+0.03", "flu_rt": "+0.01", "acc_trde_qty": "31", "alacc_rt": "0.00" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 295 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ELW > ELW종목상세정보요청(ka30012) API 명 ELW종목상세정보요청 API ID ka30012 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/elw Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body aset_cd 자산코드 String N 20 Body cur_prc 현재가 String N 20 Body pred_pre_sig 전일대비기호 String N 20 Body pred_pre 전일대비 String N 20 Body flu_rt 등락율 String N 20 Body lpmmcm_nm LP회원사명 String N 20 Body lpmmcm_nm_1 LP회원사명1 String N 20 Body lpmmcm_nm_2 LP회원사명2 String N 20 Body elwrght_cntn ELW권리내용 String N 20 Body elwexpr_evlt_pric ELW만기평가가격 String N 20 Body elwtheory_pric ELW이론가 String N 20 296 / 528 Response 구분 Element 한글명 Type Require d Length Body dispty_rt 괴리율 String N 20 Body elwinnr_vltl ELW내재변동성 String N 20 Body exp_rght_pric 예상권리가 String N 20 Body elwpl_qutr_rt ELW손익분기율 String N 20 Body elwexec_pric ELW행사가 String N 20 Body elwcnvt_rt ELW전환비율 String N 20 Body elwcmpn_rt ELW보상율 String N 20 Body elwpric_rising_part_rt ELW가격상승참여율 String N 20 Body elwrght_type ELW권리유형 String N 20 Body elwsrvive_dys ELW잔존일수 String N 20 Body stkcnt 주식수 String N 20 Body elwlpord_pos ELWLP주문가능 String N 20 Body lpposs_rt LP보유비율 String N 20 Body lprmnd_qty LP보유수량 String N 20 Body elwspread ELW스프레드 String N 20 Body elwprty ELW패리티 String N 20 Body elwgear ELW기어링 String N 20 Body elwflo_dt ELW상장일 String N 20 Body elwfin_trde_dt ELW최종거래일 String N 20 Body expr_dt 만기일 String N 20 Body exec_dt 행사일 String N 20 Body lpsuply_end_dt LP공급종료일 String N 20 Body elwpay_dt ELW지급일 String N 20 Body elwinvt_ix_comput ELW투자지표산출 String N Body elwpay_agnt ELW지급대리인 String N Body elwappr_way ELW결재방법 String N Body elwrght_exec_way ELW권리행사방식 String N Body elwpblicte_orgn ELW발행기관 String N Body dcsn_pay_amt 확정지급액 String N Body kobarr KO베리어 String N Body iv IV String N Body clsprd_end_elwocr 종기종료ELW발생 String N Body bsis_aset_1 기초자산1 String N Body bsis_aset_comp_rt_1 기초자산구성비율1 String N Body bsis_aset_2 기초자산2 String N Body bsis_aset_comp_rt_2 기초자산구성비율2 String N Body bsis_aset_3 기초자산3 String N 297 / 528 Description Response 구분 Element 한글명 Type Require d Body bsis_aset_comp_rt_3 기초자산구성비율3 String N Body bsis_aset_4 기초자산4 String N Body bsis_aset_comp_rt_4 기초자산구성비율4 String N Body bsis_aset_5 기초자산5 String N Body bsis_aset_comp_rt_5 기초자산구성비율5 String N Body fr_dt 평가시작일자 String N Body to_dt 평가종료일자 String N Body fr_tm 평가시작시간 String N Body evlt_end_tm 평가종료시간 String N Body evlt_pric 평가가격 String N Body evlt_fnsh_yn 평가완료여부 String N Body all_hgst_pric 전체최고가 String N Body all_lwst_pric 전체최저가 String N Body imaf_hgst_pric 직후최고가 String N Body imaf_lwst_pric 직후최저가 String N Body sndhalf_mrkt_hgst_p ric 후반장최고가 String N Body sndhalf_mrkt_lwst_pr ic 후반장최저가 String N Length Request Example { } "stk_cd": "57JBHH" Response Example { "aset_cd":"201", "cur_prc":"10", "pred_pre_sig":"3", "pred_pre":"0", "flu_rt":"0.00", "lpmmcm_nm":"", "lpmmcm_nm_1":"키움증권", "lpmmcm_nm_2":"", "elwrght_cntn":"만기평가가격이 행사가격 초과인 경우, 1워런트당 (만기평가가격-행사가격)*전환비율", "elwexpr_evlt_pric":"최종거래일 종가", "elwtheory_pric":"27412", "dispty_rt":"--96.35", "elwinnr_vltl":"1901", "exp_rght_pric":"3179.00", "elwpl_qutr_rt":"--7.33", "elwexec_pric":"400.00", "elwcnvt_rt":"100.0000", "elwcmpn_rt":"0.00", "elwpric_rising_part_rt":"0.00", "elwrght_type":"CALL", "elwsrvive_dys":"15", "stkcnt":"8000", "elwlpord_pos":"가능", "lpposs_rt":"+95.20", "lprmnd_qty":"7615830", "elwspread":"15.00", "elwprty":"107.94", "elwgear":"4317.90", 298 / 528 Description Response Example } "elwflo_dt":"20240124", "elwfin_trde_dt":"20241212", "expr_dt":"20241216", "exec_dt":"20241216", "lpsuply_end_dt":"20241212", "elwpay_dt":"20241218", "elwinvt_ix_comput":"산출종목", "elwpay_agnt":"국민은행증권타운지점", "elwappr_way":"현금 결제", "elwrght_exec_way":"유럽형", "elwpblicte_orgn":"키움증권(주)", "dcsn_pay_amt":"0.000", "kobarr":"0", "iv":"0.00", "clsprd_end_elwocr":"", "bsis_aset_1":"KOSPI200", "bsis_aset_comp_rt_1":"0.00", "bsis_aset_2":"", "bsis_aset_comp_rt_2":"0.00", "bsis_aset_3":"", "bsis_aset_comp_rt_3":"0.00", "bsis_aset_4":"", "bsis_aset_comp_rt_4":"0.00", "bsis_aset_5":"", "bsis_aset_comp_rt_5":"0.00", "fr_dt":"", "to_dt":"", "fr_tm":"", "evlt_end_tm":"", "evlt_pric":"", "evlt_fnsh_yn":"", "all_hgst_pric":"0.00", "all_lwst_pric":"0.00", "imaf_hgst_pric":"0.00", "imaf_lwst_pric":"0.00", "sndhalf_mrkt_hgst_pric":"0.00", "sndhalf_mrkt_lwst_pric":"0.00", "return_code":0, "return_msg":"정상적으로 처리되었습니다" 299 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF수익율요청(ka40001) API 명 ETF수익율요청 API ID ka40001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 Body etfobjt_idex_cd ETF대상지수코드 String Y 3 Body dt 기간 String Y 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0:1주, 1:1달, 2:6개월, 3:1년 Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body etfprft_rt_lst ETF수익율 LIST N Body - etfprft_rt ETF수익률 String N 20 Body - cntr_prft_rt 체결수익률 String N 20 Body - for_netprps_qty 외인순매수수량 String N 20 Body - orgn_netprps_qty 기관순매수수량 String N 20 Request Example { } Description "stk_cd": "069500", "etfobjt_idex_cd": "207", "dt": "3" 300 / 528 Response Example { } "etfprft_rt_lst": [ { "etfprft_rt": "-1.33", "cntr_prft_rt": "-1.75", "for_netprps_qty": "0", "orgn_netprps_qty": "" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 301 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF종목정보요청(ka40002) API 명 ETF종목정보요청 API ID ka40002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_nm 종목명 String N 40 Body etfobjt_idex_nm ETF대상지수명 String N 20 Body wonju_pric 원주가격 String N 20 Body etftxon_type ETF과세유형 String N 20 Body etntxon_type ETN과세유형 String N 20 Request Example { } "stk_cd": "069500" Response Example { Description "stk_nm": "KODEX 200", "etfobjt_idex_nm": "", "wonju_pric": "10", 302 / 528 Response Example } "etftxon_type": "보유기간과세", "etntxon_type": "보유기간과세", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 303 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF일별추이요청(ka40003) API 명 ETF일별추이요청 API ID ka40003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body etfdaly_trnsn ETF일별추이 LIST N Body - cntr_dt 체결일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - pre_rt 대비율 String N 20 Body - trde_qty 거래량 String N 20 Body - nav NAV String N 20 Body - acc_trde_prica 누적거래대금 String N 20 Body - navidex_dispty_rt NAV/지수괴리율 String N 20 Body - navetfdispty_rt NAV/ETF괴리율 String N 20 304 / 528 Response Type Require d Length 추적오차율 String N 20 - trace_cur_prc 추적현재가 String N 20 Body - trace_pred_pre 추적전일대비 String N 20 Body - trace_pre_sig 추적대비기호 String N 20 구분 Element Body - trace_eor_rt Body 한글명 Request Example { } "stk_cd": "069500" Response Example { } "etfdaly_trnsn": [ { "cntr_dt": "20241125", "cur_prc": "100535", "pre_sig": "0", "pred_pre": "0", "pre_rt": "0.00", "trde_qty": "0", "nav": "0.00", "acc_trde_prica": "0", "navidex_dispty_rt": "0.00", "navetfdispty_rt": "0.00", "trace_eor_rt": "0", "trace_cur_prc": "0", "trace_pred_pre": "0", "trace_pre_sig": "3" }, { "cntr_dt": "20241122", "cur_prc": "100535", "pre_sig": "0", "pred_pre": "0", "pre_rt": "0.00", "trde_qty": "0", "nav": "+100584.57", "acc_trde_prica": "0", "navidex_dispty_rt": "0.00", "navetfdispty_rt": "-0.05", "trace_eor_rt": "0", "trace_cur_prc": "0", "trace_pred_pre": "0", "trace_pre_sig": "3" }, { "cntr_dt": "20241121", "cur_prc": "100535", "pre_sig": "0", "pred_pre": "0", "pre_rt": "0.00", "trde_qty": "0", "nav": "+100563.36", "acc_trde_prica": "0", "navidex_dispty_rt": "0.00", "navetfdispty_rt": "-0.03", "trace_eor_rt": "0", "trace_cur_prc": "0", "trace_pred_pre": "0", "trace_pre_sig": "3" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 305 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF전체시세요청(ka40004) API 명 ETF전체시세요청 API ID ka40004 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body txon_type 과세유형 String Y 1 0:전체, 1:비과세, 2:보유기간과세, 3:회사형, 4:외국, 5:비과세해외(보유기간관세) Body navpre NAV대비 String Y 1 0:전체, 1:NAV > 전일종가, 2:NAV < 전일종가 Body mngmcomp 운용사 String Y 4 0000:전체, 3020:KODEX(삼성), 3027:KOSEF(키움), 3191:TIGER(미래에셋), 3228:KINDEX(한국투자), 3023:KStar(KB), 3022:아리랑(한화), 9999:기타운용사 Body txon_yn 과세여부 String Y 1 0:전체, 1:과세, 2:비과세 Body trace_idex 추적지수 String Y 1 0:전체 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body etfall_mrpr ETF전체시세 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_cls 종목분류 String N 20 Body - stk_nm 종목명 String N 40 Body - close_pric 종가 String N 20 306 / 528 Response 구분 Element 한글명 Type Require d Length Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - pre_rt 대비율 String N 20 Body - trde_qty 거래량 String N 20 Body - nav NAV String N 20 Body - trace_eor_rt 추적오차율 String N 20 Body - txbs 과표기준 String N 20 Body - dvid_bf_base 배당전기준 String N 20 Body - pred_dvida 전일배당금 String N 20 Body - trace_idex_nm 추적지수명 String N 20 Body - drng 배수 String N 20 Body - trace_idex_cd 추적지수코드 String N 20 Body - trace_idex 추적지수 String N 20 Body - trace_flu_rt 추적등락율 String N 20 Request Example { } "txon_type": "0", "navpre": "0", "mngmcomp": "0000", "txon_yn": "0", "trace_idex": "0", "stex_tp": "1" Response Example { "etfall_mrpr": [ { "stk_cd": "069500", "stk_cls": "19", "stk_nm": "KODEX 200", "close_pric": "24200", "pre_sig": "3", "pred_pre": "0", "pre_rt": "0.00", "trde_qty": "0", "nav": "25137.83", "trace_eor_rt": "0.00", "txbs": "", "dvid_bf_base": "", "pred_dvida": "", "trace_idex_nm": "KOSPI100", "drng": "", "trace_idex_cd": "", "trace_idex": "24200", "trace_flu_rt": "0.00" }, { "stk_cd": "069500", "stk_cls": "19", "stk_nm": "KODEX 200", "close_pric": "33120", "pre_sig": "3", "pred_pre": "0", "pre_rt": "0.00", "trde_qty": "0", "nav": "33351.27", "trace_eor_rt": "0.00", "txbs": "", 307 / 528 Description Response Example }, { } "dvid_bf_base": "", "pred_dvida": "", "trace_idex_nm": "KOSPI200", "drng": "", "trace_idex_cd": "", "trace_idex": "33120", "trace_flu_rt": "0.00" "stk_cd": "069660", "stk_cls": "19", "stk_nm": "KOSEF 200", "close_pric": "32090", "pre_sig": "3", "pred_pre": "0", "pre_rt": "0.00", "trde_qty": "0", "nav": "33316.97", "trace_eor_rt": "0.00", "txbs": "", "dvid_bf_base": "", "pred_dvida": "", "trace_idex_nm": "KOSPI200", "drng": "", "trace_idex_cd": "", "trace_idex": "32090", "trace_flu_rt": "0.00" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 308 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF시간대별추이요청(ka40006) API 명 ETF시간대별추이요청 API ID ka40006 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_nm 종목명 String N 40 Body etfobjt_idex_nm ETF대상지수명 String N 20 Body wonju_pric 원주가격 String N 20 Body etftxon_type ETF과세유형 String N 20 Body etntxon_type ETN과세유형 String N 20 Body etftisl_trnsn ETF시간대별추이 LIST N Body - tm 시간 String N 20 Body - close_pric 종가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 309 / 528 Response 구분 Element 한글명 Type Require d Length Body - trde_qty 거래량 String N 20 Body - nav NAV String N 20 Body - trde_prica 거래대금 String N 20 Body - navidex NAV지수 String N 20 Body - navetf NAVETF String N 20 Body - trace 추적 String N 20 Body - trace_idex 추적지수 String N 20 Body trace_idex_pred_pre 추적지수전일대비 String N 20 Body - trace_idex_pred_pr e_sig 추적지수전일대비기 호 String N 20 Request Example { } "stk_cd": "069500" Response Example { } "stk_nm": "KODEX 200", "etfobjt_idex_nm": "KOSPI200", "wonju_pric": "-10", "etftxon_type": "보유기간과세", "etntxon_type": "보유기간과세", "etftisl_trnsn": [ { "tm": "132211", "close_pric": "+4900", "pre_sig": "2", "pred_pre": "+450", "flu_rt": "+10.11", "trde_qty": "1", "nav": "-4548.33", "trde_prica": "0", "navidex": "-72.38", "navetf": "+7.18", "trace": "0.00", "trace_idex": "+164680", "trace_idex_pred_pre": "+123", "trace_idex_pred_pre_sig": "2" }, { "tm": "132210", "close_pric": "+4900", "pre_sig": "2", "pred_pre": "+450", "flu_rt": "+10.11", "trde_qty": "1", "nav": "-4548.33", "trde_prica": "0", "navidex": "-72.38", "navetf": "+7.18", "trace": "0.00", "trace_idex": "+164680", "trace_idex_pred_pre": "+123", "trace_idex_pred_pre_sig": "2" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 310 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF시간대별체결요청(ka40007) API 명 ETF시간대별체결요청 API ID ka40007 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_cls 종목분류 String N 20 Body stk_nm 종목명 String N 40 Body etfobjt_idex_nm ETF대상지수명 String N 20 Body etfobjt_idex_cd ETF대상지수코드 String N 20 Body objt_idex_pre_rt 대상지수대비율 String N 20 Body wonju_pric 원주가격 String N 20 Body etftisl_cntr_array ETF시간대별체결배 열 LIST N Body - cntr_tm 체결시간 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 311 / 528 Response 구분 Element 한글명 Type Require d Length Body - trde_qty 거래량 String N 20 Body - stex_tp 거래소구분 String N 20 Request Example { } "stk_cd": "069500" Response Example { } "stk_cls": "20", "stk_nm": "KODEX 200", "etfobjt_idex_nm": "KOSPI200", "etfobjt_idex_cd": "207", "objt_idex_pre_rt": "10.00", "wonju_pric": "-10", "etftisl_cntr_array": [ { "cntr_tm": "130747", "cur_prc": "+4900", "pre_sig": "2", "pred_pre": "+450", "trde_qty": "1", "stex_tp": "KRX" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 312 / 528 Description KRX , NXT , 통합 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF일자별체결요청(ka40008) API 명 ETF일자별체결요청 API ID ka40008 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body cntr_tm 체결시간 String N 20 Body cur_prc 현재가 String N 20 Body pre_sig 대비기호 String N 20 Body pred_pre 전일대비 String N 20 Body trde_qty 거래량 String N 20 Body etfnetprps_qty_array ETF순매수수량배열 LIST N Body - dt 일자 String N 20 Body - cur_prc_n 현재가n String N 20 Body - pre_sig_n 대비기호n String N 20 Body - pred_pre_n 전일대비n String N 20 Body - acc_trde_qty 누적거래량 String N 20 313 / 528 Response 구분 Element 한글명 Type Require d Length Body - for_netprps_qty 외인순매수수량 String N 20 Body - orgn_netprps_qty 기관순매수수량 String N 20 Request Example { } "stk_cd": "069500" Response Example { } "cntr_tm": "130747", "cur_prc": "+4900", "pre_sig": "2", "pred_pre": "+450", "trde_qty": "1", "etfnetprps_qty_array": [ { "dt": "20241125", "cur_prc_n": "+4900", "pre_sig_n": "2", "pred_pre_n": "+450", "acc_trde_qty": "1", "for_netprps_qty": "0", "orgn_netprps_qty": "0" }, { "dt": "20241122", "cur_prc_n": "-4450", "pre_sig_n": "5", "pred_pre_n": "-60", "acc_trde_qty": "46", "for_netprps_qty": "--10558895", "orgn_netprps_qty": "0" }, { "dt": "20241121", "cur_prc_n": "4510", "pre_sig_n": "3", "pred_pre_n": "0", "acc_trde_qty": "0", "for_netprps_qty": "--8894146", "orgn_netprps_qty": "0" }, { "dt": "20241120", "cur_prc_n": "-4510", "pre_sig_n": "5", "pred_pre_n": "-160", "acc_trde_qty": "0", "for_netprps_qty": "--3073507", "orgn_netprps_qty": "0" }, { "dt": "20241119", "cur_prc_n": "+4670", "pre_sig_n": "2", "pred_pre_n": "+160", "acc_trde_qty": "94", "for_netprps_qty": "--2902200", "orgn_netprps_qty": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 314 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF시간대별체결요청(ka40009) API 명 ETF시간대별체결요청 API ID ka40009 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body etfnavarray ETFNAV배열 LIST N Body - nav NAV String N 20 Body - navpred_pre NAV전일대비 String N 20 Body - navflu_rt NAV등락율 String N 20 Body - trace_eor_rt 추적오차율 String N 20 Body - dispty_rt 괴리율 String N 20 Body - stkcnt 주식수 String N 20 Body - base_pric 기준가 String N 20 Body - for_rmnd_qty 외인보유수량 String N 20 Body - repl_pric 대용가 String N 20 Body - conv_pric 환산가격 String N 20 315 / 528 Response 구분 Element 한글명 Type Require d Length Body - drstk DR/주 String N 20 Body - wonju_pric 원주가격 String N 20 Request Example { } "stk_cd": "069500" Response Example { } "etfnavarray": [ { "nav": "", "navpred_pre": "", "navflu_rt": "", "trace_eor_rt": "", "dispty_rt": "", "stkcnt": "133100", "base_pric": "4450", "for_rmnd_qty": "", "repl_pric": "", "conv_pric": "", "drstk": "", "wonju_pric": "" }, { "nav": "", "navpred_pre": "", "navflu_rt": "", "trace_eor_rt": "", "dispty_rt": "", "stkcnt": "133100", "base_pric": "4510", "for_rmnd_qty": "", "repl_pric": "", "conv_pric": "", "drstk": "", "wonju_pric": "" }, { "nav": "", "navpred_pre": "", "navflu_rt": "", "trace_eor_rt": "", "dispty_rt": "", "stkcnt": "133100", "base_pric": "4510", "for_rmnd_qty": "", "repl_pric": "", "conv_pric": "", "drstk": "", "wonju_pric": "" }, { "nav": "", "navpred_pre": "", "navflu_rt": "", "trace_eor_rt": "", "dispty_rt": "", "stkcnt": "133100", "base_pric": "4670", "for_rmnd_qty": "", "repl_pric": "", "conv_pric": "", "drstk": "", "wonju_pric": "" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 316 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > ETF > ETF시간대별추이요청(ka40010) API 명 ETF시간대별추이요청 API ID ka40010 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/etf Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body etftisl_trnsn ETF시간대별추이 LIST N Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - trde_qty 거래량 String N 20 Body - for_netprps 외인순매수 String N 20 Request Example { } "stk_cd": "069500" Response Example { Description "etftisl_trnsn": [ 317 / 528 Response Example { }, { }, { }, { }, { }, { }, { }, { }, { } "cur_prc": "4450", "pre_sig": "3", "pred_pre": "0", "trde_qty": "0", "for_netprps": "0" "cur_prc": "-4450", "pre_sig": "5", "pred_pre": "-60", "trde_qty": "46", "for_netprps": "--10558895" "cur_prc": "4510", "pre_sig": "3", "pred_pre": "0", "trde_qty": "0", "for_netprps": "--8894146" "cur_prc": "-4510", "pre_sig": "5", "pred_pre": "-160", "trde_qty": "0", "for_netprps": "--3073507" "cur_prc": "+4670", "pre_sig": "2", "pred_pre": "+160", "trde_qty": "94", "for_netprps": "--2902200" "cur_prc": "-4510", "pre_sig": "5", "pred_pre": "-275", "trde_qty": "0", "for_netprps": "--1249609" "cur_prc": "-4510", "pre_sig": "5", "pred_pre": "-315", "trde_qty": "0", "for_netprps": "--2634816" "cur_prc": "-4510", "pre_sig": "5", "pred_pre": "-285", "trde_qty": "0", "for_netprps": "--2365477" "cur_prc": "-4450", "pre_sig": "5", "pred_pre": "-225", "trde_qty": "6", "for_netprps": "--571909" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 318 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 금현물체결추이(ka50010) API 명 금현물체결추이 API ID ka50010 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gold_cntr 금현물체결추이 LIST N Body - cntr_pric 체결가 String N 20 Body - pred_pre 전일 대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 누적 거래량 String N 20 Body - acc_trde_prica 누적 거래대금 String N 20 Body - cntr_trde_qty 거래량(체결량) String N 20 Body - tm 체결시간 String N 20 Body - pre_sig 전일대비기호 String N 20 Body - pri_sel_bid_unit 매도호가 String N 20 Body - pri_buy_bid_unit 매수호가 String N 20 319 / 528 Response 구분 Element 한글명 Type Require d Length Body - trde_pre 전일 거래량 대비 비율 String N 20 Body - trde_tern_rt 전일 거래량 대비 순간 거래량 비율 String N 20 Body - cntr_str 체결강도 String N 20 Request Example { } "stk_cd": "M04020000" Response Example { } "gold_cntr": [ { "cntr_pric": "+152300", "pred_pre": "+620", "flu_rt": "+0.41", "trde_qty": "1385", "acc_trde_prica": "210926180", "cntr_trde_qty": "-10", "tm": "090106", "pre_sig": "2", "pri_sel_bid_unit": "+152400", "pri_buy_bid_unit": "+152300", "trde_pre": "+0.45", "trde_tern_rt": "0.00", "cntr_str": "138.06" }, { "cntr_pric": "+152400", "pred_pre": "+720", "flu_rt": "+0.47", "trde_qty": "1375", "acc_trde_prica": "209403180", "cntr_trde_qty": "+9", "tm": "090100", "pre_sig": "2", "pri_sel_bid_unit": "+152400", "pri_buy_bid_unit": "+152300", "trde_pre": "+0.45", "trde_tern_rt": "0.00", "cntr_str": "141.18" }, ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 320 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 금현물일별추이(ka50012) API 명 금현물일별추이 API ID ka50012 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body base_dt 기준일자 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gold_daly_trnsn 금현물일별추이 LIST N Body - cur_prc 종가 String N 20 Body - pred_pre 전일 대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 누적 거래량 String N 20 Body - acc_trde_prica 누적 거래대금(백만) String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - dt 일자 String N 20 321 / 528 Response 구분 Element 한글명 Type Require d Length Body - pre_sig 전일대비기호 String N 20 Body - orgn_netprps 기관 순매수 수량 String N 20 Body - for_netprps 외국인 순매수 수량 String N 20 Body - ind_netprps 순매매량(개인) String N 20 Request Example { } "stk_cd": "M04020000", "base_dt": "20250820" Response Example { } "gold_daly_trnsn": [ { "cur_prc": "+151680", "pred_pre": "+1280", "flu_rt": "+0.85", "trde_qty": "304439", "acc_trde_prica": "45980", "open_pric": "150400", "high_pric": "+151680", "low_pric": "-150250", "dt": "20250826", "pre_sig": "2", "orgn_netprps": "112", "for_netprps": "-1", "ind_netprps": "-51" }, { "cur_prc": "+150400", "pred_pre": "+1010", "flu_rt": "+0.68", "trde_qty": "257827", "acc_trde_prica": "38741", "open_pric": "+150890", "high_pric": "+150890", "low_pric": "+150100", "dt": "20250825", "pre_sig": "2", "orgn_netprps": "88", "for_netprps": "0", "ind_netprps": "30" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 322 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 금현물틱차트조회요청(ka50079) API 명 금현물틱차트조회요청 API ID ka50079 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body tic_scope 틱범위 String Y 2 1:1틱, 3:3틱, 5:5틱, 10:10틱, 30:30틱 Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gds_tic_chart_qry 금현물틱차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - pred_pre 전일대비 String N 20 Body - trde_qty 거래량 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N Body - cntr_tm 체결시간 String N 20 Body - dt 일자 String N 20 323 / 528 Response 구분 Element 한글명 Type Require d Length Body - pred_pre_sig 전일대비기호 String N 20 Request Example { } "stk_cd": "M04020000", "tic_scope": "", "upd_stkpc_tp": "1" Response Example { } "gds_tic_chart_qry": [ { "cur_prc": "152390", "pred_pre": "710", "trde_qty": "4", "open_pric": "152390", "high_pric": "152390", "low_pric": "152390", "cntr_tm": "20250827090215", "dt": "20250827090215", "pred_pre_sig": "2", }, { "cur_prc": "152390", "pred_pre": "710", "trde_qty": "5", "open_pric": "152390", "high_pric": "152390", "low_pric": "152390", "cntr_tm": "20250827090215", "dt": "20250827090215", "pred_pre_sig": "2", } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 324 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 금현물분봉차트조회요청(ka50080) API 명 금현물분봉차트조회요청 API ID ka50080 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body tic_scope 틱범위 String Y 3 1:1분, 3:3분, 5:5분, 10:10분, 15:15분, 30:30분, 45:45분, 60:60분 Body upd_stkpc_tp 수정주가구분 String N 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gds_min_chart_qry 금현물분봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - pred_pre 전일대비 String N 20 Body - acc_trde_qty 누적거래량 String N 20 Body - trde_qty 거래량 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - cntr_tm 체결시간 String N 20 325 / 528 Response 구분 Element 한글명 Type Require d Length Body - dt 일자 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Request Example { } "stk_cd": "M04020000", "tic_scope": "", "upd_stkpc_tp": "1" Response Example { } "gds_min_chart_qry": [ { "cur_prc": "142170", "pred_pre": "230", "acc_trde_qty": "98963", "trde_qty": "76", "open_pric": "+142180", "high_pric": "+142180", "low_pric": "142170", "cntr_tm": "20250408132100", "dt": "20250408132100", "pred_pre_sig": "" }, { "cur_prc": "142170", "pred_pre": "230", "acc_trde_qty": "98887", "trde_qty": "104", "open_pric": "+142180", "high_pric": "+142180", "low_pric": "142170", "cntr_tm": "20250408132000", "dt": "20250408132000", "pred_pre_sig": "" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 326 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 금현물일봉차트조회요청(ka50081) API 명 금현물일봉차트조회요청 API ID ka50081 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body base_dt 기준일자 String Y 8 YYYYMMDD Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gds_day_chart_qry 금현물일봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - acc_trde_qty 누적 거래량 String N 20 Body - acc_trde_prica 누적 거래대금 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - dt 일자 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 327 / 528 Request Example { } "stk_cd": "M04020000", "base_dt": "20250826", "upd_stkpc_tp": "1" Response Example { } "gds_day_chart_qry": [ { "cur_prc": "152400", "acc_trde_qty": "3739", "acc_trde_prica": "570", "open_pric": "152200", "high_pric": "152470", "low_pric": "152200", "dt": "20250827", "pred_pre_sig": "2", }, { "cur_prc": "151680", "acc_trde_qty": "304439", "acc_trde_prica": "45980", "open_pric": "150400", "high_pric": "151680", "low_pric": "150250", "dt": "20250826", "pred_pre_sig": "2", } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 328 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 금현물주봉차트조회요청(ka50082) API 명 금현물주봉차트조회요청 API ID ka50082 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body base_dt 기준일자 String Y 8 YYYYMMDD Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gds_week_chart_qry 금현물일봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - acc_trde_qty 누적 거래량 String N 20 Body - acc_trde_prica 누적 거래대금 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - dt 일자 String N 20 Request Example 329 / 528 Request Example { } "stk_cd": "M04020000", "base_dt": "20250826", "upd_stkpc_tp": "1" Response Example { } "gds_week_chart_qry": [ { "cur_prc": "152430", "acc_trde_qty": "567619", "acc_trde_prica": "8553629", "open_pric": "150890", "high_pric": "152470", "low_pric": "150100", "dt": "20250825000000", }, { "cur_prc": "149390", "acc_trde_qty": "1738711", "acc_trde_prica": "2604597", "open_pric": "149800", "high_pric": "150700", "low_pric": "149030", "dt": "20250818000000", } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 330 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 금현물월봉차트조회요청(ka50083) API 명 금현물월봉차트조회요청 API ID ka50083 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body base_dt 기준일자 String Y 8 YYYYMMDD Body upd_stkpc_tp 수정주가구분 String Y 1 0 or 1 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gds_month_chart_qr y 금현물일봉차트조회 LIST N Body - cur_prc 현재가 String N 20 Body - acc_trde_qty 누적 거래량 String N 20 Body - acc_trde_prica 누적 거래대금 String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - dt 일자 String N 20 Request Example 331 / 528 Request Example { } "stk_cd": "M04020000", "base_dt": "20250826", "upd_stkpc_tp": "1" Response Example { } "gds_month_chart_qry": [ { "cur_prc": "152430", "acc_trde_qty": "5269714", "acc_trde_prica": "793461419830", "open_pric": "150000", "high_pric": "153240", "low_pric": "149000", "dt": "20250804000000", }, { "cur_prc": "145190", "acc_trde_qty": "3707641", "acc_trde_prica": "545938604940", "open_pric": "149340", "high_pric": "153730", "low_pric": "141600", "dt": "20250502000000", } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 332 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 금현물예상체결(ka50087) API 명 금현물예상체결 API ID ka50087 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gold_expt_exec 금현물예상체결 LIST N Body - exp_cntr_pric 예상 체결가 String N 20 Body - exp_pred_pre 예상 체결가 전일대비 String N 20 Body - exp_flu_rt 예상 체결가 등락율 String N 20 Body - exp_acc_trde_qty 예상 체결 수량(누적) String N 20 Body - exp_cntr_trde_qty 예상 체결 수량 String N 20 Body - exp_tm 예상 체결 시간 String N 20 Body - exp_pre_sig 예상 체결가 전일대비기호 String N 20 Body - stex_tp 거래소 구분 String N Request Example 333 / 528 Request Example { } "stk_cd": "M04020000" Response Example { } "gold_expt_exec": [ { "exp_cntr_pric": "+152200", "exp_pred_pre": "+520", "exp_flu_rt": "++0.34", "exp_acc_trde_qty": "309", "exp_cntr_trde_qty": "+100", "exp_tm": "085957", "exp_pre_sig": "2", "stex_tp": "KRX" }, { "exp_cntr_pric": "+152200", "exp_pred_pre": "+520", "exp_flu_rt": "++0.34", "exp_acc_trde_qty": "209", "exp_cntr_trde_qty": "+-121", "exp_tm": "085957", "exp_pre_sig": "2", "stex_tp": "KRX" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 334 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 금현물당일틱차트조회요청(ka50091) API 명 금현물당일틱차트조회요청 API ID ka50091 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body tic_scope 틱범위 String Y 2 1:1틱, 3:3틱, 5:5틱, 10:10틱, 30:30틱 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gds_tic_chart_qry 금현물일봉차트조회 LIST N Body - cntr_pric 체결가 String N 20 Body - pred_pre 전일 대비(원) String N 20 Body - trde_qty 거래량(체결량) String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - cntr_tm 체결시간 String N 20 Body - dt 일자 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 335 / 528 Request Example { } "stk_cd": "M04020000", "tic_scope": "1" Response Example { } "gds_tic_chart_qry": [ { "cntr_pric": "152460", "pred_pre": "780", "trde_qty": "5", "open_pric": "152460", "high_pric": "152460", "low_pric": "152460", "cntr_tm": "20250827090734", "dt": "20250827090734", "pred_pre_sig": "2", }, { "cntr_pric": "152470", "pred_pre": "790", "trde_qty": "1", "open_pric": "152470", "high_pric": "152470", "low_pric": "152470", "cntr_tm": "20250827090732", "dt": "20250827090732", "pred_pre_sig": "2", } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 336 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 차트 > 금현물당일분봉차트조회요청(ka50092) API 명 금현물당일분봉차트조회요청 API ID ka50092 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/chart Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body tic_scope 틱범위 String Y 2 1:1틱, 3:3틱, 5:5틱, 10:10틱, 30:30틱 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gds_min_chart_qry 금현물일봉차트조회 LIST N Body - cntr_pric 체결가 String N 20 Body - pred_pre 전일 대비(원) String N 20 Body - acc_trde_qty 누적 거래량 String N 20 Body - acc_trde_prica 누적 거래대금 String N 20 Body - trde_qty 거래량(체결량) String N 20 Body - open_pric 시가 String N 20 Body - high_pric 고가 String N 20 Body - low_pric 저가 String N 20 Body - cntr_tm 체결시간 String N 20 337 / 528 Response 구분 Element 한글명 Type Require d Length Body - dt 일자 String N 20 Body - pred_pre_sig 전일대비기호 String N 20 Request Example { } "stk_cd": "M04020000", "tic_scope": "1" Response Example { } "gds_min_chart_qry": [ { "cntr_pric": "+152480", "pred_pre": "+800", "acc_trde_qty": "10289", "acc_trde_prica": "", "trde_qty": "663", "open_pric": "+152470", "high_pric": "+152490", "low_pric": "+152470", "cntr_tm": "20250827090800", "dt": "20250827090800", "pred_pre_sig": "2" }, { "cntr_pric": "+152470", "pred_pre": "+790", "acc_trde_qty": "9626", "acc_trde_prica": "", "trde_qty": "2547", "open_pric": "+152450", "high_pric": "+152480", "low_pric": "+152450", "cntr_tm": "20250827090700", "dt": "20250827090700", "pred_pre_sig": "2" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 338 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 금현물 시세정보(ka50100) API 명 금현물 시세정보 API ID ka50100 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body pred_pre_sig 전일대비기호 String N 20 Body pred_pre 전일대비 String N 20 Body flu_rt 등락율 String N 20 Body trde_qty 거래량 String N 20 Body open_pric 시가 String N 20 Body high_pric 고가 String N 20 Body low_pric 저가 String N 20 Body pred_rt 전일비 String N 20 Body upl_pric 상한가 String N 20 Body lst_pric 하한가 String N 20 Body pred_close_pric 전일종가 String N 20 339 / 528 Request Example { } "stk_cd": "M04020000" Response Example { } "pred_pre_sig": "2", "pred_pre": "+870", "flu_rt": "+0.57", "trde_qty": "16326", "open_pric": "+152200", "high_pric": "+152560", "low_pric": "+152200", "pred_rt": "-5.36", "upl_pric": "+166840", "lst_pric": "-136520", "pred_close_pric": "151680", "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 340 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 금현물 호가(ka50101) API 명 금현물 호가 API ID ka50101 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 20 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body tic_scope 틱범위 String Y 2 1:1틱, 3:3틱, 5:5틱, 10:10틱, 30:30틱 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body gold_bid 금현물호가 LIST N Body - cntr_pric 체결가 String N 20 Body - pred_pre 전일 대비(원) String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 누적 거래량 String N 20 Body - acc_trde_prica 누적 거래대금 String N 20 Body - cntr_trde_qty 거래량(체결량) String N 20 Body - tm 체결시간 String N 20 Body - pre_sig 전일대비기호 String N 20 Body - pri_sel_bid_unit 매도호가 String N 20 341 / 528 Response Type Require d Length 매수호가 String N 20 - trde_pre 전일 거래량 대비 비율 String N 20 Body - trde_tern_rt 전일 거래량 대비 순간 거래량 비율 String N Body - cntr_str 체결강도 String N 20 Body - lpmmcm_nm_1 K.O 접근도 String N 20 Body - stex_tp 거래소구분 String N 20 구분 Element Body - pri_buy_bid_unit Body 한글명 Request Example { } "stk_cd": "M04020000", "tic_scope": "1" Response Example { } "gold_bid": [ { "cntr_pric": "+152560", "pred_pre": "+880", "flu_rt": "+0.58", "trde_qty": "16454", "acc_trde_prica": "", "cntr_trde_qty": "124", "tm": "090900", "pre_sig": "2", "pri_sel_bid_unit": "", "pri_buy_bid_unit": "", "trde_pre": "+5.40", "trde_tern_rt": "+0.04", "cntr_str": "", "lpmmcm_nm_1": "", "stex_tp": "" }, { "cntr_pric": "+152550", "pred_pre": "+870", "flu_rt": "+0.57", "trde_qty": "16330", "acc_trde_prica": "", "cntr_trde_qty": "6704", "tm": "090800", "pre_sig": "2", "pri_sel_bid_unit": "", "pri_buy_bid_unit": "", "trde_pre": "+5.36", "trde_tern_rt": "+2.20", "cntr_str": "", "lpmmcm_nm_1": "", "stex_tp": "" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 342 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 기관/외국인 > 금현물투자자현황(ka52301) API 명 금현물투자자현황 API ID ka52301 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/frgnistt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body inve_trad_stat 금현물투자자현황 LIST N Body - all_dfrt_trst_sell_qty 투자자별 매도 수량(천) String N 20 Body - sell_qty_irds 투자자별 매도 수량 증감(천) String N 20 Body all_dfrt_trst_sell_amt 투자자별 매도 금액(억) String N 20 Body - sell_amt_irds 투자자별 매도 금액 증감(억) String N 20 Body all_dfrt_trst_buy_qty 투자자별 매수 수량(천) String N 20 Body - buy_qty_irds 투자자별 매수 수량 증감(천) String N 20 Body all_dfrt_trst_buy_amt 투자자별 매수 금액(억) String N 20 Body - buy_amt_irds 투자자별 매수 금액 String N 20 343 / 528 Response 구분 Element 한글명 Type Require d Length 증감(억) Body - all_dfrt_trst_netprp s_qty 투자자별 순매수 수량(천) String N 20 Body - netprps_qty_irds 투자자별 순매수 수량 증감(천) String N 20 Body - all_dfrt_trst_netprp s_amt 투자자별 순매수 금액(억) String N 20 Body - netprps_amt_irds 투자자별 순매수 금액 증감(억) String N 20 Body - sell_uv 투자자별 매도 단가 String N 20 Body - buy_uv 투자자별 매수 단가 String N 20 Body - stk_nm 투자자 구분명 String N 20 Body - acc_netprps_amt 누적 순매수 금액(억) String N 20 Body - acc_netprps_qty 누적 순매수 수량(천) String N 20 Body - stk_cd 투자자 코드 String N 20 Request Example {} Response Example { "inve_trad_stat": [ { "all_dfrt_trst_sell_qty": "14", "sell_qty_irds": "7", "all_dfrt_trst_sell_amt": "22", "sell_amt_irds": "11", "all_dfrt_trst_buy_qty": "6", "buy_qty_irds": "1", "all_dfrt_trst_buy_amt": "9", "buy_amt_irds": "1", "all_dfrt_trst_netprps_qty": "-8", "netprps_qty_irds": "-6", "all_dfrt_trst_netprps_amt": "-12", "netprps_amt_irds": "-10", "sell_uv": "307", "buy_uv": "311", "stk_nm": "개인", "acc_netprps_amt": "-12", "acc_netprps_qty": "-8", "stk_cd": "T94008" }, { "all_dfrt_trst_sell_qty": "0", "sell_qty_irds": "0", "all_dfrt_trst_sell_amt": "0", "sell_amt_irds": "0", "all_dfrt_trst_buy_qty": "0", "buy_qty_irds": "0", "all_dfrt_trst_buy_amt": "0", "buy_amt_irds": "0", "all_dfrt_trst_netprps_qty": "0", "netprps_qty_irds": "0", "all_dfrt_trst_netprps_amt": "0", "netprps_amt_irds": "0", "sell_uv": "0", "buy_uv": "0", "stk_nm": "외국인", "acc_netprps_amt": "0", "acc_netprps_qty": "0", "stk_cd": "T94009" }, { 344 / 528 Description Response Example "all_dfrt_trst_sell_qty": "0", "sell_qty_irds": "0", "all_dfrt_trst_sell_amt": "0", "sell_amt_irds": "0", "all_dfrt_trst_buy_qty": "10", "buy_qty_irds": "9", "all_dfrt_trst_buy_amt": "16", "buy_amt_irds": "13", "chg_qty": "10", "mont_trde_qty": "9", "all_dfrt_trst_netprps_amt": "15", "netprps_amt_irds": "12", "sell_uv": "0", "buy_uv": "314", "stk_nm": "기관계", "acc_netprps_amt": "15", "acc_netprps_qty": "10", "stk_cd": "T94014" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 345 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 테마 > 테마그룹별요청(ka90001) API 명 테마그룹별요청 API ID ka90001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/thme Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body qry_tp 검색구분 String Y 1 0:전체검색, 1:테마검색, 2:종목검색 Body stk_cd 종목코드 String N 6 검색하려는 종목코드 Body date_tp 날짜구분 String Y 2 n일전 (1일 ~ 99일 날짜입력) Body thema_nm 테마명 String N 50 검색하려는 테마명 Body flu_pl_amt_tp 등락수익구분 String Y 1 1:상위기간수익률, 2:하위기간수익률, 3:상위등락률, 4:하위등락률 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body thema_grp 테마그룹별 LIST N Body - thema_grp_cd 테마그룹코드 String N 20 Body - thema_nm 테마명 String N 20 Body - stk_num 종목수 String N 20 Body - flu_sig 등락기호 String N 20 Body - flu_rt 등락율 String N 20 346 / 528 Response 구분 Element 한글명 Type Require d Length Body - rising_stk_num 상승종목수 String N 20 Body - fall_stk_num 하락종목수 String N 20 Body - dt_prft_rt 기간수익률 String N 20 Body - main_stk 주요종목 String N 20 Request Example { } "qry_tp": "0", "stk_cd": "", "date_tp": "10", "thema_nm": "", "flu_pl_amt_tp": "1", "stex_tp": "1" Response Example { } "thema_grp": [ { "thema_grp_cd": "319", "thema_nm": "건강식품", "stk_num": "5", "flu_sig": "2", "flu_rt": "+0.02", "rising_stk_num": "1", "fall_stk_num": "0", "dt_prft_rt": "+157.80", "main_stk": "삼성전자" }, { "thema_grp_cd": "452", "thema_nm": "SNS(Social Network Service)", "stk_num": "3", "flu_sig": "5", "flu_rt": "-0.09", "rising_stk_num": "0", "fall_stk_num": "1", "dt_prft_rt": "+67.60", "main_stk": "삼성전자" }, { "thema_grp_cd": "553", "thema_nm": "반도체_후공정장비", "stk_num": "5", "flu_sig": "5", "flu_rt": "-0.27", "rising_stk_num": "0", "fall_stk_num": "1", "dt_prft_rt": "+56.88", "main_stk": "삼성전자" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 347 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 테마 > 테마구성종목요청(ka90002) API 명 테마구성종목요청 API ID ka90002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/thme Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body date_tp 날짜구분 String N 1 1일 ~ 99일 날짜입력 Body thema_grp_cd 테마그룹코드 String Y 6 테마그룹코드 번호 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body flu_rt 등락률 String N 20 Body dt_prft_rt 기간수익률 String N 20 Body thema_comp_stk 테마구성종목 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - flu_sig 등락기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 348 / 528 1: 상한가, 2:상승, 3:보합, 4:하한가, 5:하락 Response Type Require d Length 누적거래량 String N 20 - sel_bid 매도호가 String N 20 Body - sel_req 매도잔량 String N 20 Body - buy_bid 매수호가 String N 20 Body - buy_req 매수잔량 String N 20 Body - dt_prft_rt_n 기간수익률n String N 20 구분 Element Body - acc_trde_qty Body 한글명 Request Example { } "date_tp": "2", "thema_grp_cd": "100", "stex_tp": "1" Response Example { "flu_rt": "0.00", "dt_prft_rt": "0.00", "thema_comp_stk": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "57800", "flu_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "acc_trde_qty": "0", "sel_bid": "0", "sel_req": "0", "buy_bid": "0", "buy_req": "0", "dt_prft_rt_n": "0.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "36700", "flu_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "acc_trde_qty": "0", "sel_bid": "0", "sel_req": "0", "buy_bid": "0", "buy_req": "0", "dt_prft_rt_n": "0.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "17380", "flu_sig": "3", "pred_pre": "0", "flu_rt": "0.00", "acc_trde_qty": "0", "sel_bid": "0", "sel_req": "0", "buy_bid": "0", "buy_req": "0", "dt_prft_rt_n": "0.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "1410", "flu_sig": "3", "pred_pre": "0", "flu_rt": "0.00", 349 / 528 Description Response Example "acc_trde_qty": "0", "sel_bid": "0", "sel_req": "0", "buy_bid": "1410", "buy_req": "1000", "dt_prft_rt_n": "0.00" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 350 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 프로그램순매수상위50요청(ka90003) API 명 프로그램순매수상위50요청 API ID ka90003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trde_upper_tp 매매상위구분 String Y 1 1:순매도상위, 2:순매수상위 Body amt_qty_tp 금액수량구분 String Y 2 1:금액, 2:수량 Body mrkt_tp 시장구분 String Y 10 P00101:코스피, P10102:코스닥 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body prm_netprps_upper_ 50 프로그램순매수상위 50 LIST N Body - rank 순위 String N 20 Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 Body - cur_prc 현재가 String N 20 Body - flu_sig 등락기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 351 / 528 Response Type Require d Length 누적거래량 String N 20 - prm_sell_amt 프로그램매도금액 String N 20 Body - prm_buy_amt 프로그램매수금액 String N 20 Body - prm_netprps_amt 프로그램순매수금액 String N 20 구분 Element Body - acc_trde_qty Body 한글명 Request Example { } "trde_upper_tp": "1", "amt_qty_tp": "1", "mrkt_tp": "P00101", "stex_tp": "1" Response Example { } "prm_trde_trnsn": [ { "cntr_tm": "170500", "dfrt_trde_sel": "0", "dfrt_trde_buy": "0", "dfrt_trde_netprps": "0", "ndiffpro_trde_sel": "1", "ndiffpro_trde_buy": "17", "ndiffpro_trde_netprps": "+17", "dfrt_trde_sell_qty": "0", "dfrt_trde_buy_qty": "0", "dfrt_trde_netprps_qty": "0", "ndiffpro_trde_sell_qty": "0", "ndiffpro_trde_buy_qty": "0", "ndiffpro_trde_netprps_qty": "+0", "all_sel": "1", "all_buy": "17", "all_netprps": "+17", "kospi200": "+47839", "basis": "-146.59" }, { "cntr_tm": "170400", "dfrt_trde_sel": "0", "dfrt_trde_buy": "0", "dfrt_trde_netprps": "0", "ndiffpro_trde_sel": "1", "ndiffpro_trde_buy": "17", "ndiffpro_trde_netprps": "+17", "dfrt_trde_sell_qty": "0", "dfrt_trde_buy_qty": "0", "dfrt_trde_netprps_qty": "0", "ndiffpro_trde_sell_qty": "0", "ndiffpro_trde_buy_qty": "0", "ndiffpro_trde_netprps_qty": "+0", "all_sel": "1", "all_buy": "17", "all_netprps": "+17", "kospi200": "+47839", "basis": "-146.59" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 352 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 종목별프로그램매매현황요청(ka90004) API 명 종목별프로그램매매현황요청 API ID ka90004 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dt 일자 String Y 8 YYYYMMDD Body mrkt_tp 시장구분 String Y 10 P00101:코스피, P10102:코스닥 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tot_1 매수체결수량합계 String N 20 Body tot_2 매수체결금액합계 String N 20 Body tot_3 매도체결수량합계 String N 20 Body tot_4 매도체결금액합계 String N 20 Body tot_5 순매수대금합계 String N 20 Body tot_6 합계6 String N 20 Body stk_prm_trde_prst 종목별프로그램매매 현황 LIST N Body - stk_cd 종목코드 String N 20 Body - stk_nm 종목명 String N 40 353 / 528 Response 구분 Element 한글명 Type Require d Length Body - cur_prc 현재가 String N 20 Body - flu_sig 등락기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - buy_cntr_qty 매수체결수량 String N 20 Body - buy_cntr_amt 매수체결금액 String N 20 Body - sel_cntr_qty 매도체결수량 String N 20 Body - sel_cntr_amt 매도체결금액 String N 20 Body - netprps_prica 순매수대금 String N 20 Body - all_trde_rt 전체거래비율 String N 20 Request Example { } "dt": "20241125", "mrkt_tp": "P00101", "stex_tp": "1" Response Example { "tot_1": "0", "tot_2": "2", "tot_3": "0", "tot_4": "2", "tot_5": "0", "tot_6": "", "stk_prm_trde_prst": [ { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "-75000", "flu_sig": "5", "pred_pre": "-2800", "buy_cntr_qty": "0", "buy_cntr_amt": "0", "sel_cntr_qty": "0", "sel_cntr_amt": "0", "netprps_prica": "0", "all_trde_rt": "+0.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "+130000", "flu_sig": "2", "pred_pre": "+6800", "buy_cntr_qty": "0", "buy_cntr_amt": "0", "sel_cntr_qty": "0", "sel_cntr_amt": "0", "netprps_prica": "0", "all_trde_rt": "+0.00" }, { "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "360000", "flu_sig": "3", "pred_pre": "0", "buy_cntr_qty": "0", "buy_cntr_amt": "0", "sel_cntr_qty": "0", "sel_cntr_amt": "0", "netprps_prica": "0", "all_trde_rt": "+0.00" }, 354 / 528 Description Response Example { } "stk_cd": "005930", "stk_nm": "삼성전자", "cur_prc": "1000000", "flu_sig": "3", "pred_pre": "0", "buy_cntr_qty": "0", "buy_cntr_amt": "0", "sel_cntr_qty": "0", "sel_cntr_amt": "0", "netprps_prica": "0", "all_trde_rt": "+0.00" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 355 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 프로그램매매추이요청 시간대별(ka90005) API 명 프로그램매매추이요청 시간대별 API ID ka90005 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body date 날짜 String Y 8 YYYYMMDD Body amt_qty_tp 금액수량구분 String Y 1 1:금액(백만원), 2:수량(천주) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body mrkt_tp 시장구분 String Y 10 코스피- 거래소구분값 1일경우:P00101, 2일경우:P001_NX01, 3일경우:P001_AL01 코스닥- 거래소구분값 1일경우:P10102, 2일경우:P101_NX02, 3일경우:P101_AL02 Body min_tic_tp 분틱구분 String Y 1 0:틱, 1:분 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body prm_trde_trnsn 프로그램매매추이 LIST N Body - cntr_tm 체결시간 String N 20 Body - dfrt_trde_sel 차익거래매도 String N 20 Body - dfrt_trde_buy 차익거래매수 String N 20 Body - dfrt_trde_netprps 차익거래순매수 String N 20 Body - ndiffpro_trde_sel 비차익거래매도 String N 20 356 / 528 Response Type Require d Length 비차익거래매수 String N 20 - ndiffpro_trde_netpr ps 비차익거래순매수 String N 20 Body - dfrt_trde_sell_qty 차익거래매도수량 String N 20 Body - dfrt_trde_buy_qty 차익거래매수수량 String N 20 Body - dfrt_trde_netprps_ qty 차익거래순매수수량 String N 20 Body - ndiffpro_trde_sell_ qty 비차익거래매도수량 String N 20 Body - ndiffpro_trde_buy_ qty 비차익거래매수수량 String N 20 Body - ndiffpro_trde_netpr ps_qty 비차익거래순매수수 량 String N 20 Body - all_sel 전체매도 String N 20 Body - all_buy 전체매수 String N 20 Body - all_netprps 전체순매수 String N 20 Body - kospi200 KOSPI200 String N 20 Body - basis BASIS String N 20 구분 Element Body - ndiffpro_trde_buy Body 한글명 Request Example { } "date": "20241101", "amt_qty_tp": "1", "mrkt_tp": "P00101", "min_tic_tp": "1", "stex_tp": "1" Response Example { "prm_trde_trnsn": [ { "cntr_tm": "170500", "dfrt_trde_sel": "0", "dfrt_trde_buy": "0", "dfrt_trde_netprps": "0", "ndiffpro_trde_sel": "1", "ndiffpro_trde_buy": "17", "ndiffpro_trde_netprps": "+17", "dfrt_trde_sell_qty": "0", "dfrt_trde_buy_qty": "0", "dfrt_trde_netprps_qty": "0", "ndiffpro_trde_sell_qty": "0", "ndiffpro_trde_buy_qty": "0", "ndiffpro_trde_netprps_qty": "+0", "all_sel": "1", "all_buy": "17", "all_netprps": "+17", "kospi200": "+47839", "basis": "-146.59" }, { "cntr_tm": "170400", "dfrt_trde_sel": "0", "dfrt_trde_buy": "0", "dfrt_trde_netprps": "0", "ndiffpro_trde_sel": "1", "ndiffpro_trde_buy": "17", "ndiffpro_trde_netprps": "+17", "dfrt_trde_sell_qty": "0", "dfrt_trde_buy_qty": "0", 357 / 528 Description Response Example "dfrt_trde_netprps_qty": "0", "ndiffpro_trde_sell_qty": "0", "ndiffpro_trde_buy_qty": "0", "ndiffpro_trde_netprps_qty": "+0", "all_sel": "1", "all_buy": "17", "all_netprps": "+17", "kospi200": "+47839", "basis": "-146.59" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 358 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 프로그램매매차익잔고추이요청(ka90006) API 명 프로그램매매차익잔고추이요청 API ID ka90006 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body date 날짜 String Y 8 YYYYMMDD Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body prm_trde_dfrt_remn_ trnsn 프로그램매매차익잔 고추이 LIST N Body - dt 일자 String N 20 Body - buy_dfrt_trde_qty 매수차익거래수량 String N 20 Body - buy_dfrt_trde_amt 매수차익거래금액 String N 20 Body - buy_dfrt_trde_irds_ amt 매수차익거래증감액 String N 20 Body - sel_dfrt_trde_qty 매도차익거래수량 String N 20 Body - sel_dfrt_trde_amt 매도차익거래금액 String N 20 Body - sel_dfrt_trde_irds_a mt 매도차익거래증감액 String N 20 Request Example 359 / 528 Request Example { } "date": "20241125", "stex_tp": "1" Response Example { } "prm_trde_dfrt_remn_trnsn": [ { "dt": "20241125", "buy_dfrt_trde_qty": "0", "buy_dfrt_trde_amt": "0", "buy_dfrt_trde_irds_amt": "0", "sel_dfrt_trde_qty": "0", "sel_dfrt_trde_amt": "0", "sel_dfrt_trde_irds_amt": "0" }, { "dt": "20241122", "buy_dfrt_trde_qty": "0", "buy_dfrt_trde_amt": "0", "buy_dfrt_trde_irds_amt": "-25", "sel_dfrt_trde_qty": "0", "sel_dfrt_trde_amt": "0", "sel_dfrt_trde_irds_amt": "0" }, { "dt": "20241121", "buy_dfrt_trde_qty": "0", "buy_dfrt_trde_amt": "25", "buy_dfrt_trde_irds_amt": "25", "sel_dfrt_trde_qty": "0", "sel_dfrt_trde_amt": "0", "sel_dfrt_trde_irds_amt": "0" }, { "dt": "20241120", "buy_dfrt_trde_qty": "0", "buy_dfrt_trde_amt": "0", "buy_dfrt_trde_irds_amt": "-48", "sel_dfrt_trde_qty": "0", "sel_dfrt_trde_amt": "0", "sel_dfrt_trde_irds_amt": "0" }, { "dt": "20241119", "buy_dfrt_trde_qty": "0", "buy_dfrt_trde_amt": "48", "buy_dfrt_trde_irds_amt": "43", "sel_dfrt_trde_qty": "0", "sel_dfrt_trde_amt": "0", "sel_dfrt_trde_irds_amt": "0" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 360 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 프로그램매매누적추이요청(ka90007) API 명 프로그램매매누적추이요청 API ID ka90007 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body date 날짜 String Y 8 YYYYMMDD (종료일기준 1년간 데이터만 조회가능) Body amt_qty_tp 금액수량구분 String Y 1 1:금액, 2:수량 Body mrkt_tp 시장구분 String Y 5 0:코스피 , 1:코스닥 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body prm_trde_acc_trnsn 프로그램매매누적추 이 LIST N Body - dt 일자 String N 20 Body - kospi200 KOSPI200 String N 20 Body - basis BASIS String N 20 Body - dfrt_trde_tdy 차익거래당일 String N 20 Body - dfrt_trde_acc 차익거래누적 String N 20 Body - ndiffpro_trde_tdy 비차익거래당일 String N 20 Body - ndiffpro_trde_acc 비차익거래누적 String N 20 361 / 528 Response 구분 Element 한글명 Type Require d Length Body - all_tdy 전체당일 String N 20 Body - all_acc 전체누적 String N 20 Request Example { } "date": "20240525", "amt_qty_tp": "1", "mrkt_tp": "0", "stex_tp": "3" Response Example { } "prm_trde_acc_trnsn": [ { "dt": "20241125", "kospi200": "0.00", "basis": "0.00", "dfrt_trde_tdy": "0", "dfrt_trde_acc": "+353665", "ndiffpro_trde_tdy": "0", "ndiffpro_trde_acc": "+671219", "all_tdy": "0", "all_acc": "+1024884" }, { "dt": "20241122", "kospi200": "+341.13", "basis": "-8.48", "dfrt_trde_tdy": "+8444", "dfrt_trde_acc": "+353665", "ndiffpro_trde_tdy": "+36403", "ndiffpro_trde_acc": "+671219", "all_tdy": "+44846", "all_acc": "+1024884" }, { "dt": "20241121", "kospi200": "+364.03", "basis": "-33.68", "dfrt_trde_tdy": "+17443", "dfrt_trde_acc": "+345221", "ndiffpro_trde_tdy": "+46164", "ndiffpro_trde_acc": "+634816", "all_tdy": "+63607", "all_acc": "+980038" }, { "dt": "20241120", "kospi200": "+361.00", "basis": "-31.00", "dfrt_trde_tdy": "+10734", "dfrt_trde_acc": "+327778", "ndiffpro_trde_tdy": "+35664", "ndiffpro_trde_acc": "+588652", "all_tdy": "+46399", "all_acc": "+916431" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 362 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 종목시간별프로그램매매추이요청(ka90008) API 명 종목시간별프로그램매매추이요청 API ID ka90008 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body amt_qty_tp 금액수량구분 String Y 1 1:금액, 2:수량 Body stk_cd 종목코드 String Y 6 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body date 날짜 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_tm_prm_trde_trn sn 종목시간별프로그램 매매추이 LIST N Body - tm 시간 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - prm_sell_amt 프로그램매도금액 String N 20 363 / 528 Response 한글명 Type Require d Length - prm_buy_amt 프로그램매수금액 String N 20 Body - prm_netprps_amt 프로그램순매수금액 String N 20 Body - prm_netprps_amt_i rds 프로그램순매수금액 증감 String N 20 Body - prm_sell_qty 프로그램매도수량 String N 20 Body - prm_buy_qty 프로그램매수수량 String N 20 Body - prm_netprps_qty 프로그램순매수수량 String N 20 Body - prm_netprps_qty_ir ds 프로그램순매수수량 증감 String N 20 Body - base_pric_tm 기준가시간 String N 20 Body - dbrt_trde_rpy_sum 대차거래상환주수합 String N 20 Body - remn_rcvord_sum 잔고수주합 String N 20 Body - stex_tp 거래소구분 String N 20 구분 Element Body Request Example { } "amt_qty_tp": "1", "stk_cd": "005930", "date": "20241125" Response Example { "stk_tm_prm_trde_trnsn": [ { "tm": "153029", "cur_prc": "+245500", "pre_sig": "2", "pred_pre": "+40000", "flu_rt": "+19.46", "trde_qty": "104006", "prm_sell_amt": "14245", "prm_buy_amt": "10773", "prm_netprps_amt": "--3472", "prm_netprps_amt_irds": "+771", "prm_sell_qty": "58173", "prm_buy_qty": "43933", "prm_netprps_qty": "--14240", "prm_netprps_qty_irds": "+3142", "base_pric_tm": "", "dbrt_trde_rpy_sum": "", "remn_rcvord_sum": "", "stex_tp": "KRX" }, { "tm": "153001", "cur_prc": "+245500", "pre_sig": "2", "pred_pre": "+40000", "flu_rt": "+19.46", "trde_qty": "94024", "prm_sell_amt": "12596", "prm_buy_amt": "8353", "prm_netprps_amt": "--4243", "prm_netprps_amt_irds": "0", "prm_sell_qty": "51455", "prm_buy_qty": "34073", "prm_netprps_qty": "--17382", "prm_netprps_qty_irds": "0", "base_pric_tm": "", "dbrt_trde_rpy_sum": "", "remn_rcvord_sum": "", "stex_tp": "KRX" 364 / 528 Description KRX , NXT , 통합 Response Example } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 365 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 순위정보 > 외국인기관매매상위요청(ka90009) API 명 외국인기관매매상위요청 API ID ka90009 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/rkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 영4 [0785] 외국인기관매매 화면의 내용을 API로 제공합니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body mrkt_tp 시장구분 String Y 3 000:전체, 001:코스피, 101:코스닥 Body amt_qty_tp 금액수량구분 String Y 1 1:금액(천만), 2:수량(천) Body qry_dt_tp 조회일자구분 String Y 1 0:조회일자 미포함, 1:조회일자 포함 Body date 날짜 String N 8 YYYYMMDD (연도4자리, 월 2자리, 일 2자리 형식) Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT, 3:통합 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body frgnr_orgn_trde_upp er 외국인기관매매상위 LIST N Body - for_netslmt_stk_cd 외인순매도종목코드 String N 20 Body - for_netslmt_stk_nm 외인순매도종목명 String N 20 Body - for_netslmt_amt 외인순매도금액 String N 20 Body - for_netslmt_qty 외인순매도수량 String N 20 Body - for_netprps_stk_cd 외인순매수종목코드 String N 20 366 / 528 Response 구분 Element 한글명 Type Require d Length Body - for_netprps_stk_nm 외인순매수종목명 String N 20 Body - for_netprps_amt 외인순매수금액 String N 20 Body - for_netprps_qty 외인순매수수량 String N 20 Body orgn_netslmt_stk_cd 기관순매도종목코드 String N 20 Body - orgn_netslmt_stk_n m 기관순매도종목명 String N 20 Body - orgn_netslmt_amt 기관순매도금액 String N 20 Body - orgn_netslmt_qty 기관순매도수량 String N 20 Body orgn_netprps_stk_cd 기관순매수종목코드 String N 20 Body - orgn_netprps_stk_n m 기관순매수종목명 String N 20 Body - orgn_netprps_amt 기관순매수금액 String N 20 Body - orgn_netprps_qty 기관순매수수량 String N 20 Request Example { } "mrkt_tp": "000", "amt_qty_tp": "1", "qry_dt_tp": "1", "date": "20241101", "stex_tp": "1" Response Example { "frgnr_orgn_trde_upper": [ { "for_netslmt_stk_cd": "069500", "for_netslmt_stk_nm": "KODEX 200", "for_netslmt_amt": "-130811", "for_netslmt_qty": "-50312", "for_netprps_stk_cd": "069500", "for_netprps_stk_nm": "KODEX 200", "for_netprps_amt": "-130811", "for_netprps_qty": "-50312", "orgn_netslmt_stk_cd": "069500", "orgn_netslmt_stk_nm": "KODEX 200", "orgn_netslmt_amt": "-130811", "orgn_netslmt_qty": "-50312", "orgn_netprps_stk_cd": "069500", "orgn_netprps_stk_nm": "KODEX 200", "orgn_netprps_amt": "-130811", "orgn_netprps_qty": "-50312" }, { "for_netslmt_stk_cd": "069500", "for_netslmt_stk_nm": "KODEX 200", "for_netslmt_amt": "-130811", "for_netslmt_qty": "-50312", "for_netprps_stk_cd": "069500", "for_netprps_stk_nm": "KODEX 200", "for_netprps_amt": "-130811", "for_netprps_qty": "-50312", "orgn_netslmt_stk_cd": "069500", "orgn_netslmt_stk_nm": "KODEX 200", "orgn_netslmt_amt": "-130811", "orgn_netslmt_qty": "-50312", "orgn_netprps_stk_cd": "069500", "orgn_netprps_stk_nm": "KODEX 200", "orgn_netprps_amt": "-130811", "orgn_netprps_qty": "-50312" 367 / 528 Description Response Example } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 368 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 프로그램매매추이요청 일자별(ka90010) API 명 프로그램매매추이요청 일자별 API ID ka90010 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body date 날짜 String Y 8 YYYYMMDD Body amt_qty_tp 금액수량구분 String Y 1 1:금액(백만원), 2:수량(천주) 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body mrkt_tp 시장구분 String Y 10 코스피- 거래소구분값 1일경우:P00101, 2일경우:P001_NX01, 3일경우:P001_AL01 코스닥- 거래소구분값 1일경우:P10102, 2일경우:P101_NX02, 3일경우:P001_AL02 Body min_tic_tp 분틱구분 String Y 1 0:틱, 1:분 Body stex_tp 거래소구분 String Y 1 1:KRX, 2:NXT 3.통합 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body prm_trde_trnsn 프로그램매매추이 LIST N Body - cntr_tm 체결시간 String N 20 Body - dfrt_trde_sel 차익거래매도 String N 20 Body - dfrt_trde_buy 차익거래매수 String N 20 Body - dfrt_trde_netprps 차익거래순매수 String N 20 Body - ndiffpro_trde_sel 비차익거래매도 String N 20 369 / 528 Response Type Require d Length 비차익거래매수 String N 20 - ndiffpro_trde_netpr ps 비차익거래순매수 String N 20 Body - dfrt_trde_sell_qty 차익거래매도수량 String N 20 Body - dfrt_trde_buy_qty 차익거래매수수량 String N 20 Body - dfrt_trde_netprps_ qty 차익거래순매수수량 String N 20 Body - ndiffpro_trde_sell_ qty 비차익거래매도수량 String N 20 Body - ndiffpro_trde_buy_ qty 비차익거래매수수량 String N 20 Body - ndiffpro_trde_netpr ps_qty 비차익거래순매수수 량 String N 20 Body - all_sel 전체매도 String N 20 Body - all_buy 전체매수 String N 20 Body - all_netprps 전체순매수 String N 20 Body - kospi200 KOSPI200 String N 20 Body - basis BASIS String N 20 구분 Element Body - ndiffpro_trde_buy Body 한글명 Request Example { } "date": "20241125", "amt_qty_tp": "1", "mrkt_tp": "P00101", "min_tic_tp": "0", "stex_tp": "1" Response Example { "prm_trde_trnsn": [ { "cntr_tm": "20241125000000", "dfrt_trde_sel": "0", "dfrt_trde_buy": "0", "dfrt_trde_netprps": "0", "ndiffpro_trde_sel": "0", "ndiffpro_trde_buy": "0", "ndiffpro_trde_netprps": "0", "dfrt_trde_sell_qty": "0", "dfrt_trde_buy_qty": "0", "dfrt_trde_netprps_qty": "0", "ndiffpro_trde_sell_qty": "0", "ndiffpro_trde_buy_qty": "0", "ndiffpro_trde_netprps_qty": "0", "all_sel": "0", "all_buy": "0", "all_netprps": "0", "kospi200": "0.00", "basis": "" }, { "cntr_tm": "20241122000000", "dfrt_trde_sel": "0", "dfrt_trde_buy": "0", "dfrt_trde_netprps": "-0", "ndiffpro_trde_sel": "96", "ndiffpro_trde_buy": "608", "ndiffpro_trde_netprps": "+512", "dfrt_trde_sell_qty": "0", "dfrt_trde_buy_qty": "0", 370 / 528 Description Response Example "dfrt_trde_netprps_qty": "-0", "ndiffpro_trde_sell_qty": "1", "ndiffpro_trde_buy_qty": "7", "ndiffpro_trde_netprps_qty": "+6", "all_sel": "96", "all_buy": "608", "all_netprps": "512", "kospi200": "+341.13", "basis": "-8.48" } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 371 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 대차거래 > 대차거래내역요청(ka90012) API 명 대차거래내역요청 API ID ka90012 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/slb Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dt 일자 String Y 8 YYYYMMDD Body mrkt_tp 시장구분 String Y 3 001:코스피, 101:코스닥 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body dbrt_trde_prps 대차거래내역 LIST N Body - stk_nm 종목명 String N 40 Body - stk_cd 종목코드 String N 20 Body - dbrt_trde_cntrcnt 대차거래체결주수 String N 20 Body - dbrt_trde_rpy 대차거래상환주수 String N 20 Body - rmnd 잔고주수 String N 20 Body - remn_amt 잔고금액 String N 20 Request Example { } Description "dt": "20241101", "mrkt_tp": "101" 372 / 528 Response Example { } "dbrt_trde_prps": [ { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "20262", "dbrt_trde_rpy": "3493", "rmnd": "12812813", "remn_amt": "1026306" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "336116", "dbrt_trde_rpy": "145001", "rmnd": "9689378", "remn_amt": "1644287" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "55055", "dbrt_trde_rpy": "68866", "rmnd": "9341419", "remn_amt": "595983" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "6704", "dbrt_trde_rpy": "16000", "rmnd": "7167500", "remn_amt": "25803" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "0", "dbrt_trde_rpy": "6500", "rmnd": "6730107", "remn_amt": "13595" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "13550", "dbrt_trde_rpy": "1198", "rmnd": "5584633", "remn_amt": "27784" }, { "stk_nm": "삼성전자", "stk_cd": "005930", "dbrt_trde_cntrcnt": "5000", "dbrt_trde_rpy": "0", "rmnd": "5568717", "remn_amt": "6755" } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 373 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 시세 > 종목일별프로그램매매추이요청(ka90013) API 명 종목일별프로그램매매추이요청 API ID ka90013 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/mrkcond Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body amt_qty_tp 금액수량구분 String N 1 1:금액, 2:수량 Body stk_cd 종목코드 String Y 20 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body date 날짜 String N 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_daly_prm_trde_tr nsn 종목일별프로그램매 매추이 LIST N Body - dt 일자 String N 20 Body - cur_prc 현재가 String N 20 Body - pre_sig 대비기호 String N 20 Body - pred_pre 전일대비 String N 20 Body - flu_rt 등락율 String N 20 Body - trde_qty 거래량 String N 20 Body - prm_sell_amt 프로그램매도금액 String N 20 374 / 528 Response 한글명 Type Require d Length - prm_buy_amt 프로그램매수금액 String N 20 Body - prm_netprps_amt 프로그램순매수금액 String N 20 Body - prm_netprps_amt_i rds 프로그램순매수금액 증감 String N 20 Body - prm_sell_qty 프로그램매도수량 String N 20 Body - prm_buy_qty 프로그램매수수량 String N 20 Body - prm_netprps_qty 프로그램순매수수량 String N 20 Body - prm_netprps_qty_ir ds 프로그램순매수수량 증감 String N 20 Body - base_pric_tm 기준가시간 String N 20 Body - dbrt_trde_rpy_sum 대차거래상환주수합 String N 20 Body - remn_rcvord_sum 잔고수주합 String N 20 Body - stex_tp 거래소구분 String N 20 구분 Element Body Request Example { } "amt_qty_tp": "", "stk_cd": "005930", "date": "" Response Example { "stk_daly_prm_trde_trnsn": [ { "dt": "20241125", "cur_prc": "+267000", "pre_sig": "2", "pred_pre": "+60000", "flu_rt": "+28.99", "trde_qty": "3", "prm_sell_amt": "0", "prm_buy_amt": "0", "prm_netprps_amt": "0", "prm_netprps_amt_irds": "0", "prm_sell_qty": "0", "prm_buy_qty": "0", "prm_netprps_qty": "0", "prm_netprps_qty_irds": "0", "base_pric_tm": "", "dbrt_trde_rpy_sum": "", "remn_rcvord_sum": "", "stex_tp": "통합" }, { "dt": "20241122", "cur_prc": "0", "pre_sig": "0", "pred_pre": "0", "flu_rt": "0.00", "trde_qty": "0", "prm_sell_amt": "0", "prm_buy_amt": "0", "prm_netprps_amt": "0", "prm_netprps_amt_irds": "--6", "prm_sell_qty": "0", "prm_buy_qty": "0", "prm_netprps_qty": "0", "prm_netprps_qty_irds": "--19", "base_pric_tm": "", "dbrt_trde_rpy_sum": "", "remn_rcvord_sum": "", "stex_tp": "KRX" 375 / 528 Description KRX , NXT , 통합 Response Example } } ], "return_code": 0, "return_msg": "정상적으로 처리되었습니다" 376 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 예수금상세현황요청(kt00001) API 명 예수금상세현황요청 API ID kt00001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body qry_tp 조회구분 String Y 1 3:추정조회, 2:일반조회 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body entr 예수금 String N 15 Body profa_ch 주식증거금현금 String N 15 Body bncr_profa_ch 수익증권증거금현금 String N 15 Body nxdy_bncr_sell_exct 익일수익증권매도정 산대금 String N 15 Body fc_stk_krw_repl_set_a mt 해외주식원화대용설 정금 String N 15 Body crd_grnta_ch 신용보증금현금 String N 15 Body crd_grnt_ch 신용담보금현금 String N 15 Body add_grnt_ch 추가담보금현금 String N 15 Body etc_profa 기타증거금 String N 15 Body uncl_stk_amt 미수확보금 String N 15 377 / 528 Response 구분 Element 한글명 Type Require d Length Body shrts_prica 공매도대금 String N 15 Body crd_set_grnta 신용설정평가금 String N 15 Body chck_ina_amt 수표입금액 String N 15 Body etc_chck_ina_amt 기타수표입금액 String N 15 Body crd_grnt_ruse 신용담보재사용 String N 15 Body knx_asset_evltv 코넥스기본예탁금 String N 15 Body elwdpst_evlta ELW예탁평가금 String N 15 Body crd_ls_rght_frcs_amt 신용대주권리예정금 액 String N 15 Body lvlh_join_amt 생계형가입금액 String N 15 Body lvlh_trns_alowa 생계형입금가능금액 String N 15 Body repl_amt 대용금평가금액(합계 ) String N 15 Body remn_repl_evlta 잔고대용평가금액 String N 15 Body trst_remn_repl_evlta 위탁대용잔고평가금 액 String N 15 Body bncr_remn_repl_evlta 수익증권대용평가금 액 String N 15 Body profa_repl 위탁증거금대용 String N 15 Body crd_grnta_repl 신용보증금대용 String N 15 Body crd_grnt_repl 신용담보금대용 String N 15 Body add_grnt_repl 추가담보금대용 String N 15 Body rght_repl_amt 권리대용금 String N 15 Body pymn_alow_amt 출금가능금액 String N 15 Body wrap_pymn_alow_a mt 랩출금가능금액 String N 15 Body ord_alow_amt 주문가능금액 String N 15 Body bncr_buy_alowa 수익증권매수가능금 액 String N 15 Body 20stk_ord_alow_amt 20%종목주문가능금 액 String N 15 Body 30stk_ord_alow_amt 30%종목주문가능금 액 String N 15 Body 40stk_ord_alow_amt 40%종목주문가능금 액 String N 15 Body 100stk_ord_alow_am t 100%종목주문가능금 액 String N 15 Body ch_uncla 현금미수금 String N 15 Body ch_uncla_dlfe 현금미수연체료 String N 15 Body ch_uncla_tot 현금미수금합계 String N 15 Body crd_int_npay 신용이자미납 String N 15 Body int_npay_amt_dlfe 신용이자미납연체료 String N 15 378 / 528 Description Response 구분 Element 한글명 Type Require d Length Body int_npay_amt_tot 신용이자미납합계 String N 15 Body etc_loana 기타대여금 String N 15 Body etc_loana_dlfe 기타대여금연체료 String N 15 Body etc_loan_tot 기타대여금합계 String N 15 Body nrpy_loan 미상환융자금 String N 15 Body loan_sum 융자금합계 String N 15 Body ls_sum 대주금합계 String N 15 Body crd_grnt_rt 신용담보비율 String N 15 Body mdstrm_usfe 중도이용료 String N 15 Body min_ord_alow_yn 최소주문가능금액 String N 15 Body loan_remn_evlt_amt 대출총평가금액 String N 15 Body dpst_grntl_remn 예탁담보대출잔고 String N 15 Body sell_grntl_remn 매도담보대출잔고 String N 15 Body d1_entra d+1추정예수금 String N 15 Body d1_slby_exct_amt d+1매도매수정산금 String N 15 Body d1_buy_exct_amt d+1매수정산금 String N 15 Body d1_out_rep_mor d+1미수변제소요금 String N 15 Body d1_sel_exct_amt d+1매도정산금 String N 15 Body d1_pymn_alow_amt d+1출금가능금액 String N 15 Body d2_entra d+2추정예수금 String N 15 Body d2_slby_exct_amt d+2매도매수정산금 String N 15 Body d2_buy_exct_amt d+2매수정산금 String N 15 Body d2_out_rep_mor d+2미수변제소요금 String N 15 Body d2_sel_exct_amt d+2매도정산금 String N 15 Body d2_pymn_alow_amt d+2출금가능금액 String N 15 Body 50stk_ord_alow_amt 50%종목주문가능금 액 String N 15 Body 60stk_ord_alow_amt 60%종목주문가능금 액 String N 15 Body stk_entr_prst 종목별예수금 LIST N Body - crnc_cd 통화코드 String N 3 Body - fx_entr 외화예수금 String N 15 Body - fc_krw_repl_evlta 원화대용평가금 String N 15 Body - fc_trst_profa 해외주식증거금 String N 15 Body - pymn_alow_amt 출금가능금액 String N 15 Body pymn_alow_amt_entr 출금가능금액(예수금 ) String N 15 Body - ord_alow_amt_entr 주문가능금액(예수금 ) String N 15 379 / 528 Description Response 구분 Element 한글명 Type Require d Length Body - fc_uncla 외화미수(합계) String N 15 Body - fc_ch_uncla 외화현금미수금 String N 15 Body - dly_amt 연체료 String N 15 Body - d1_fx_entr d+1외화예수금 String N 15 Body - d2_fx_entr d+2외화예수금 String N 15 Body - d3_fx_entr d+3외화예수금 String N 15 Body - d4_fx_entr d+4외화예수금 String N 15 Request Example { } "qry_tp": "3" Response Example { "entr": "000000000017534", "profa_ch": "000000000032193", "bncr_profa_ch": "000000000000000", "nxdy_bncr_sell_exct": "000000000000000", "fc_stk_krw_repl_set_amt": "000000000000000", "crd_grnta_ch": "000000000000000", "crd_grnt_ch": "000000000000000", "add_grnt_ch": "000000000000000", "etc_profa": "000000000000000", "uncl_stk_amt": "000000000000000", "shrts_prica": "000000000000000", "crd_set_grnta": "000000000000000", "chck_ina_amt": "000000000000000", "etc_chck_ina_amt": "000000000000000", "crd_grnt_ruse": "000000000000000", "knx_asset_evltv": "000000000000000", "elwdpst_evlta": "000000000031269", "crd_ls_rght_frcs_amt": "000000000000000", "lvlh_join_amt": "000000000000000", "lvlh_trns_alowa": "000000000000000", "repl_amt": "000000003915500", "remn_repl_evlta": "000000003915500", "trst_remn_repl_evlta": "000000000000000", "bncr_remn_repl_evlta": "000000000000000", "profa_repl": "000000000000000", "crd_grnta_repl": "000000000000000", "crd_grnt_repl": "000000000000000", "add_grnt_repl": "000000000000000", "rght_repl_amt": "000000000000000", "pymn_alow_amt": "000000000085341", "wrap_pymn_alow_amt": "000000000000000", "ord_alow_amt": "000000000085341", "bncr_buy_alowa": "000000000085341", "20stk_ord_alow_amt": "000000000012550", "30stk_ord_alow_amt": "000000000012550", "40stk_ord_alow_amt": "000000000012550", "100stk_ord_alow_amt": "000000000012550", "ch_uncla": "000000000000000", "ch_uncla_dlfe": "000000000000000", "ch_uncla_tot": "000000000000000", "crd_int_npay": "000000000000000", "int_npay_amt_dlfe": "000000000000000", "int_npay_amt_tot": "000000000000000", "etc_loana": "000000000000000", "etc_loana_dlfe": "000000000000000", "etc_loan_tot": "000000000000000", "nrpy_loan": "000000000000000", "loan_sum": "000000000000000", "ls_sum": "000000000000000", "crd_grnt_rt": "0.00", "mdstrm_usfe": "000000000388388", "min_ord_alow_yn": "000000000000000", 380 / 528 Description Response Example } "loan_remn_evlt_amt": "000000000000000", "dpst_grntl_remn": "000000000000000", "sell_grntl_remn": "000000000000000", "d1_entra": "000000000017450", "d1_slby_exct_amt": "-00000000000084", "d1_buy_exct_amt": "000000000048240", "d1_out_rep_mor": "000000000000000", "d1_sel_exct_amt": "000000000048156", "d1_pymn_alow_amt": "000000000012550", "d2_entra": "000000000012550", "d2_slby_exct_amt": "-00000000004900", "d2_buy_exct_amt": "000000000004900", "d2_out_rep_mor": "000000000000000", "d2_sel_exct_amt": "000000000000000", "d2_pymn_alow_amt": "000000000012550", "50stk_ord_alow_amt": "000000000012550", "60stk_ord_alow_amt": "000000000012550", "stk_entr_prst": [], "return_code": 0, "return_msg": "조회가 완료되었습니다." 381 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 일별추정예탁자산현황요청(kt00002) API 명 일별추정예탁자산현황요청 API ID kt00002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body start_dt 시작조회기간 String Y 8 YYYYMMDD Body end_dt 종료조회기간 String Y 8 YYYYMMDD 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body daly_prsm_dpst_aset _amt_prst 일별추정예탁자산현 황 LIST N Body - dt 일자 String N 8 Body - entr 예수금 String N 12 Body - grnt_use_amt 담보대출금 String N 12 Body - crd_loan 신용융자금 String N 12 Body - ls_grnt 대주담보금 String N 12 Body - repl_amt 대용금 String N 12 Body prsm_dpst_aset_amt 추정예탁자산 String N 12 Body - prsm_dpst_aset_a mt_bncr_skip 추정예탁자산수익증 권제외 String N 12 382 / 528 Request Example { } "start_dt": "20241111", "end_dt": "20241125" Response Example { } "daly_prsm_dpst_aset_amt_prst": [ { "dt": "20241111", "entr": "000000100000", "grnt_use_amt": "000000000000", "crd_loan": "000000000000", "ls_grnt": "000000000000", "repl_amt": "000000000000", "prsm_dpst_aset_amt": "000000000000", "prsm_dpst_aset_amt_bncr_skip": "000000000000" }, { "dt": "20241112", "entr": "000000100000", "grnt_use_amt": "000000000000", "crd_loan": "000000000000", "ls_grnt": "000000000000", "repl_amt": "000000000000", "prsm_dpst_aset_amt": "000000000000", "prsm_dpst_aset_amt_bncr_skip": "000000000000" }, { "dt": "20241113", "entr": "000000100000", "grnt_use_amt": "000000000000", "crd_loan": "000000000000", "ls_grnt": "000000000000", "repl_amt": "000000000000", "prsm_dpst_aset_amt": "000000000000", "prsm_dpst_aset_amt_bncr_skip": "000000000000" }, { "dt": "20241114", "entr": "000000999748", "grnt_use_amt": "000000000000", "crd_loan": "000000000000", "ls_grnt": "000000000000", "repl_amt": "000000000165", "prsm_dpst_aset_amt": "000000000000", "prsm_dpst_aset_amt_bncr_skip": "000000000000" } ], "return_code": 0, "return_msg": "일자별 계좌별 추정예탁자산 내역이 조회 되었습니다." 383 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 추정자산조회요청(kt00003) API 명 추정자산조회요청 API ID kt00003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body qry_tp 상장폐지조회구분 String Y 1 0:전체, 1:상장폐지종목제외 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body prsm_dpst_aset_amt 추정예탁자산 String N 12 Request Example { } "qry_tp": "0" Response Example { } Description "prsm_dpst_aset_amt": "00000530218", "return_code": 0, "return_msg": "조회가 완료되었습니다.." 384 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌평가현황요청(kt00004) API 명 계좌평가현황요청 API ID kt00004 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body qry_tp 상장폐지조회구분 String Y 1 0:전체, 1:상장폐지종목제외 Body dmst_stex_tp 국내거래소구분 String Y 6 KRX:한국거래소,NXT:넥스트트레이드 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acnt_nm 계좌명 String N 30 Body brch_nm 지점명 String N 30 Body entr 예수금 String N 12 Body d2_entra D+2추정예수금 String N 12 Body tot_est_amt 유가잔고평가액 String N 12 Body aset_evlt_amt 예탁자산평가액 String N 12 Body tot_pur_amt 총매입금액 String N 12 Body prsm_dpst_aset_amt 추정예탁자산 String N 12 Body tot_grnt_sella 매도담보대출금 String N 12 Body tdy_lspft_amt 당일투자원금 String N 12 385 / 528 Response 구분 Element 한글명 Type Require d Length Body invt_bsamt 당월투자원금 String N 12 Body lspft_amt 누적투자원금 String N 12 Body tdy_lspft 당일투자손익 String N 12 Body lspft2 당월투자손익 String N 12 Body lspft 누적투자손익 String N 12 Body tdy_lspft_rt 당일손익율 String N 12 Body lspft_ratio 당월손익율 String N 12 Body lspft_rt 누적손익율 String N 12 Body stk_acnt_evlt_prst 종목별계좌평가현황 LIST N Body - stk_cd 종목코드 String N 12 Body - stk_nm 종목명 String N 30 Body - rmnd_qty 보유수량 String N 12 Body - avg_prc 평균단가 String N 12 Body - cur_prc 현재가 String N 12 Body - evlt_amt 평가금액 String N 12 Body - pl_amt 손익금액 String N 12 Body - pl_rt 손익율 String N 12 Body - loan_dt 대출일 String N 10 Body - pur_amt 매입금액 String N 12 Body - setl_remn 결제잔고 String N 12 Body - pred_buyq 전일매수수량 String N 12 Body - pred_sellq 전일매도수량 String N 12 Body - tdy_buyq 금일매수수량 String N 12 Body - tdy_sellq 금일매도수량 String N 12 Request Example { } "qry_tp": "0", "dmst_stex_tp": "KRX" Response Example { "acnt_nm": "김키움", "brch_nm": "키움은행", "entr": "000000017534", "d2_entra": "000000012550", "tot_est_amt": "000000000342", "aset_evlt_amt": "000000761950", "tot_pur_amt": "000000002786", "prsm_dpst_aset_amt": "000000749792", "tot_grnt_sella": "000000000000", "tdy_lspft_amt": "000000000000", "invt_bsamt": "000000000000", "lspft_amt": "000000000000", "tdy_lspft": "000000000000", "lspft2": "000000000000", "lspft": "000000000000", "tdy_lspft_rt": "0.00", 386 / 528 Description Response Example } "lspft_ratio": "0.00", "lspft_rt": "0.00", "stk_acnt_evlt_prst": [ { "stk_cd": "A005930", "stk_nm": "삼성전자", "rmnd_qty": "000000000003", "avg_prc": "000000124500", "cur_prc": "000000070000", "evlt_amt": "000000209542", "pl_amt": "-00000163958", "pl_rt": "-43.8977", "loan_dt": "", "pur_amt": "000000373500", "setl_remn": "000000000003", "pred_buyq": "000000000000", "pred_sellq": "000000000000", "tdy_buyq": "000000000000", "tdy_sellq": "000000000000" } ], "return_code": 0, "return_msg": "조회가 완료되었습니다." 387 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 체결잔고요청(kt00005) API 명 체결잔고요청 API ID kt00005 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 6 KRX:한국거래소,NXT:넥스트트레이드 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body entr 예수금 String N 12 Body entr_d1 예수금D+1 String N 12 Body entr_d2 예수금D+2 String N 12 Body pymn_alow_amt 출금가능금액 String N 12 Body uncl_stk_amt 미수확보금 String N 12 Body repl_amt 대용금 String N 12 Body rght_repl_amt 권리대용금 String N 12 Body ord_alowa 주문가능현금 String N 12 Body ch_uncla 현금미수금 String N 12 Body crd_int_npay_gold 신용이자미납금 String N 12 Body etc_loana 기타대여금 String N 12 388 / 528 Response 구분 Element 한글명 Type Require d Length Body nrpy_loan 미상환융자금 String N 12 Body profa_ch 증거금현금 String N 12 Body repl_profa 증거금대용 String N 12 Body stk_buy_tot_amt 주식매수총액 String N 12 Body evlt_amt_tot 평가금액합계 String N 12 Body tot_pl_tot 총손익합계 String N 12 Body tot_pl_rt 총손익률 String N 12 Body tot_re_buy_alowa 총재매수가능금액 String N 12 Body 20ord_alow_amt 20%주문가능금액 String N 12 Body 30ord_alow_amt 30%주문가능금액 String N 12 Body 40ord_alow_amt 40%주문가능금액 String N 12 Body 50ord_alow_amt 50%주문가능금액 String N 12 Body 60ord_alow_amt 60%주문가능금액 String N 12 Body 100ord_alow_amt 100%주문가능금액 String N 12 Body crd_loan_tot 신용융자합계 String N 12 Body crd_loan_ls_tot 신용융자대주합계 String N 12 Body crd_grnt_rt 신용담보비율 String N 12 Body dpst_grnt_use_amt_a mt 예탁담보대출금액 String N 12 Body grnt_loan_amt 매도담보대출금액 String N 12 Body stk_cntr_remn 종목별체결잔고 LIST N Body - crd_tp 신용구분 String N 2 Body - loan_dt 대출일 String N 8 Body - expr_dt 만기일 String N 8 Body - stk_cd 종목번호 String N 12 Body - stk_nm 종목명 String N 30 Body - setl_remn 결제잔고 String N 12 Body - cur_qty 현재잔고 String N 12 Body - cur_prc 현재가 String N 12 Body - buy_uv 매입단가 String N 12 Body - pur_amt 매입금액 String N 12 Body - evlt_amt 평가금액 String N 12 Body - evltv_prft 평가손익 String N 12 Body - pl_rt 손익률 String N 12 Request Example { } "dmst_stex_tp": "KRX" 389 / 528 Description Response Example { } "entr": "000000017534", "entr_d1": "000000017450", "entr_d2": "000000012550", "pymn_alow_amt": "000000085341", "uncl_stk_amt": "000000000000", "repl_amt": "000003915500", "rght_repl_amt": "000000000000", "ord_alowa": "000000085341", "ch_uncla": "000000000000", "crd_int_npay_gold": "000000000000", "etc_loana": "000000000000", "nrpy_loan": "000000000000", "profa_ch": "000000032193", "repl_profa": "000000000000", "stk_buy_tot_amt": "000006122786", "evlt_amt_tot": "000006236342", "tot_pl_tot": "000000113556", "tot_pl_rt": "1.8546", "tot_re_buy_alowa": "000000135970", "20ord_alow_amt": "000000012550", "30ord_alow_amt": "000000012550", "40ord_alow_amt": "000000012550", "50ord_alow_amt": "000000012550", "60ord_alow_amt": "000000012550", "100ord_alow_amt": "000000012550", "crd_loan_tot": "000000000000", "crd_loan_ls_tot": "000000000000", "crd_grnt_rt": "0.00", "dpst_grnt_use_amt_amt": "000000000000", "grnt_loan_amt": "000000000000", "stk_cntr_remn": [ { "crd_tp": "00", "loan_dt": "", "expr_dt": "", "stk_cd": "A005930", "stk_nm": "삼성전자", "setl_remn": "000000000003", "cur_qty": "000000000003", "cur_prc": "000000070000", "buy_uv": "000000124500", "pur_amt": "000000373500", "evlt_amt": "000000209542", "evltv_prft": "-00000163958", "pl_rt": "-43.8977" } ], "return_code": 0, "return_msg": "조회가 완료되었습니다." 390 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌별주문체결내역상세요청(kt00007) API 명 계좌별주문체결내역상세요청 API ID kt00007 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body ord_dt 주문일자 String N 8 YYYYMMDD Body qry_tp 조회구분 String Y 1 1:주문순, 2:역순, 3:미체결, 4:체결내역만 Body stk_bond_tp 주식채권구분 String Y 1 0:전체, 1:주식, 2:채권 Body sell_tp 매도수구분 String Y 1 0:전체, 1:매도, 2:매수 Body stk_cd 종목코드 String N 12 공백허용 (공백일때 전체종목) Body fr_ord_no 시작주문번호 String N 7 공백허용 (공백일때 전체주문) Body dmst_stex_tp 국내거래소구분 String Y 6 %:(전체),KRX:한국거래소,NXT:넥스트트레이드,SOR:최선주문 집행 Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acnt_ord_cntr_prps_ dtl 계좌별주문체결내역 상세 LIST N Body - ord_no 주문번호 String N 7 Body - stk_cd 종목번호 String N 12 Body - trde_tp 매매구분 String N 20 391 / 528 Response 구분 Element 한글명 Type Require d Length Body - crd_tp 신용구분 String N 20 Body - ord_qty 주문수량 String N 10 Body - ord_uv 주문단가 String N 10 Body - cnfm_qty 확인수량 String N 10 Body - acpt_tp 접수구분 String N 20 Body - rsrv_tp 반대여부 String N 20 Body - ord_tm 주문시간 String N 8 Body - ori_ord 원주문 String N 7 Body - stk_nm 종목명 String N 40 Body - io_tp_nm 주문구분 String N 20 Body - loan_dt 대출일 String N 8 Body - cntr_qty 체결수량 String N 10 Body - cntr_uv 체결단가 String N 10 Body - ord_remnq 주문잔량 String N 10 Body - comm_ord_tp 통신구분 String N 20 Body - mdfy_cncl 정정취소 String N 20 Body - cnfm_tm 확인시간 String N 8 Body - dmst_stex_tp 국내거래소구분 String N 8 Body - cond_uv 스톱가 String N 10 Request Example { } "ord_dt": "", "qry_tp": "1", "stk_bond_tp": "0", "sell_tp": "0", "stk_cd": "005930", "fr_ord_no": "", "dmst_stex_tp": "%" Response Example { "acnt_ord_cntr_prps_dtl": [ { "ord_no": "0000050", "stk_cd": "A069500", "trde_tp": "시장가", "crd_tp": "보통매매", "ord_qty": "0000000001", "ord_uv": "0000000000", "cnfm_qty": "0000000000", "acpt_tp": "접수", "rsrv_tp": "", "ord_tm": "13:05:43", "ori_ord": "0000000", "stk_nm": "KODEX 200", "io_tp_nm": "현금매수", "loan_dt": "", "cntr_qty": "0000000001", "cntr_uv": "0000004900", "ord_remnq": "0000000000", "comm_ord_tp": "영웅문4", "mdfy_cncl": "", 392 / 528 Description Response Example "cnfm_tm": "", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" } } ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 393 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌별익일결제예정내역요청(kt00008) API 명 계좌별익일결제예정내역요청 API ID kt00008 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dcd_seq 시작결제번호 String N 7 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trde_dt 매매일자 String N 8 Body setl_dt 결제일자 String N 8 Body sell_amt_sum 매도정산합 String N 12 Body buy_amt_sum 매수정산합 String N 12 Body acnt_nxdy_setl_frcs_p rps_array 계좌별익일결제예정 내역배열 LIST N Body - seq 일련번호 String N 7 Body - stk_cd 종목번호 String N 12 Body - loan_dt 대출일 String N 8 Body - qty 수량 String N 12 Body - engg_amt 약정금액 String N 12 Body - cmsn 수수료 String N 12 394 / 528 Response 구분 Element 한글명 Type Require d Length Body - incm_tax 소득세 String N 12 Body - rstx 농특세 String N 12 Body - stk_nm 종목명 String N 40 Body - sell_tp 매도수구분 String N 10 Body - unp 단가 String N 12 Body - exct_amt 정산금액 String N 12 Body - trde_tax 거래세 String N 12 Body - resi_tax 주민세 String N 12 Body - crd_tp 신용구분 String N 20 Request Example { } "strt_dcd_seq": "" Response Example { } "trde_dt": "20241122", "setl_dt": "20241126", "sell_amt_sum": "000000048156", "buy_amt_sum": "000000048240", "acnt_nxdy_setl_frcs_prps_array": [ { "seq": "0010006", "stk_cd": "A005930", "loan_dt": "", "qty": "000000000001", "engg_amt": "000000016080", "cmsn": "000000000000", "incm_tax": "000000000000", "rstx": "000000000000", "stk_nm": "삼성전자", "sell_tp": "매도", "unp": "000000016080", "exct_amt": "000000016052", "trde_tax": "000000000028", "resi_tax": "000000000000", "crd_tp": "현금매도 K" }, { "seq": "0010007", "stk_cd": "A005930", "loan_dt": "", "qty": "000000000002", "engg_amt": "000000032160", "cmsn": "000000000000", "incm_tax": "000000000000", "rstx": "000000000000", "stk_nm": "삼성전자", "sell_tp": "매도", "unp": "000000016080", "exct_amt": "000000032104", "trde_tax": "000000000056", "resi_tax": "000000000000", "crd_tp": "프로그램매도 K" } ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 395 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌별주문체결현황요청(kt00009) API 명 계좌별주문체결현황요청 API ID kt00009 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body ord_dt 주문일자 String N 8 YYYYMMDD Body stk_bond_tp 주식채권구분 String Y 1 0:전체, 1:주식, 2:채권 Body mrkt_tp 시장구분 String Y 1 0:전체, 1:코스피, 2:코스닥, 3:OTCBB, 4:ECN Body sell_tp 매도수구분 String Y 1 0:전체, 1:매도, 2:매수 Body qry_tp 조회구분 String Y 1 0:전체, 1:체결 Body stk_cd 종목코드 String N 12 전문 조회할 종목코드 Body fr_ord_no 시작주문번호 String N 7 Body dmst_stex_tp 국내거래소구분 String Y 6 %:(전체),KRX:한국거래소,NXT:넥스트트레이드,SOR:최선주문 집행 Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body sell_grntl_engg_amt 매도약정금액 String N 12 Body buy_engg_amt 매수약정금액 String N 12 Body engg_amt 약정금액 String N 12 Body acnt_ord_cntr_prst_a 계좌별주문체결현황 LIST N 396 / 528 Response 한글명 Type Require d Length rray 배열 Body - stk_bond_tp 주식채권구분 String N 1 Body - ord_no 주문번호 String N 7 Body - stk_cd 종목번호 String N 12 Body - trde_tp 매매구분 String N 15 Body - io_tp_nm 주문유형구분 String N 20 Body - ord_qty 주문수량 String N 10 Body - ord_uv 주문단가 String N 10 Body - cnfm_qty 확인수량 String N 10 Body - rsrv_oppo 예약/반대 String N 4 Body - cntr_no 체결번호 String N 7 Body - acpt_tp 접수구분 String N 8 Body - orig_ord_no 원주문번호 String N 7 Body - stk_nm 종목명 String N 20 Body - setl_tp 결제구분 String N 8 Body - crd_deal_tp 신용거래구분 String N 20 Body - cntr_qty 체결수량 String N 10 Body - cntr_uv 체결단가 String N 10 Body - comm_ord_tp 통신구분 String N 8 Body - mdfy_cncl_tp 정정/취소구분 String N 12 Body - cntr_tm 체결시간 String N 8 Body - dmst_stex_tp 국내거래소구분 String N 6 Body - cond_uv 스톱가 String N 10 구분 Element Request Example { } "ord_dt": "", "stk_bond_tp": "0", "mrkt_tp": "0", "sell_tp": "0", "qry_tp": "0", "stk_cd": "", "fr_ord_no": "", "dmst_stex_tp": "KRX" Response Example { "sell_grntl_engg_amt": "000000000000", "buy_engg_amt": "000000004900", "engg_amt": "000000004900", "acnt_ord_cntr_prst_array": [ { "stk_bond_tp": "1", "ord_no": "0000050", "stk_cd": "A069500", "trde_tp": "시장가", "io_tp_nm": "현금매수", "ord_qty": "0000000001", "ord_uv": "0000000000", 397 / 528 Description Response Example "cnfm_qty": "0000000000", "rsrv_oppo": "", "cntr_no": "0000001", "acpt_tp": "접수", "orig_ord_no": "0000000", "stk_nm": "KODEX 200", "setl_tp": "삼일결제", "crd_deal_tp": "보통매매", "cntr_qty": "0000000001", "cntr_uv": "0000004900", "comm_ord_tp": "영웅문4", "mdfy_cncl_tp": "", "cntr_tm": "13:07:47", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" } } ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 398 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 주문인출가능금액요청(kt00010) API 명 주문인출가능금액요청 API ID kt00010 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body io_amt 입출금액 String N 12 Body stk_cd 종목번호 String Y 12 Body trde_tp 매매구분 String Y 1 Body trde_qty 매매수량 String N 10 Body uv 매수가격 String Y 10 Body exp_buy_unp 예상매수단가 String N 10 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 1:매도, 2:매수 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body profa_20ord_alow_a mt 증거금20%주문가능 금액 String N 12 Body profa_20ord_alowq 증거금20%주문가능 수량 String N 10 Body profa_30ord_alow_a mt 증거금30%주문가능 금액 String N 12 Body profa_30ord_alowq 증거금30%주문가능 수량 String N 10 399 / 528 Response 구분 Element 한글명 Type Require d Length Body profa_40ord_alow_a mt 증거금40%주문가능 금액 String N 12 Body profa_40ord_alowq 증거금40%주문가능 수량 String N 10 Body profa_50ord_alow_a mt 증거금50%주문가능 금액 String N 12 Body profa_50ord_alowq 증거금50%주문가능 수량 String N 10 Body profa_60ord_alow_a mt 증거금60%주문가능 금액 String N 12 Body profa_60ord_alowq 증거금60%주문가능 수량 String N 10 Body profa_rdex_60ord_al ow_amt 증거금감면60%주문 가능금 String N 12 Body profa_rdex_60ord_al owq 증거금감면60%주문 가능수 String N 10 Body profa_100ord_alow_a mt 증거금100%주문가능 금액 String N 12 Body profa_100ord_alowq 증거금100%주문가능 수량 String N 10 Body pred_reu_alowa 전일재사용가능금액 String N 12 Body tdy_reu_alowa 금일재사용가능금액 String N 12 Body entr 예수금 String N 12 Body repl_amt 대용금 String N 12 Body uncla 미수금 String N 12 Body ord_pos_repl 주문가능대용 String N 12 Body ord_alowa 주문가능현금 String N 12 Body wthd_alowa 인출가능금액 String N 12 Body nxdy_wthd_alowa 익일인출가능금액 String N 12 Body pur_amt 매입금액 String N 12 Body cmsn 수수료 String N 12 Body pur_exct_amt 매입정산금 String N 12 Body d2entra D2추정예수금 String N 12 Body profa_rdex_aplc_tp 증거금감면적용구분 String N 1 Request Example { } "io_amt": "", "stk_cd": "005930", "trde_tp": "2", "trde_qty": "", "uv": "267000", "exp_buy_unp": "" Response Example { "profa_20ord_alow_amt": "000000012550", "profa_20ord_alowq": "0000000000", 400 / 528 Description 0:일반,1:60%감면 Response Example } "profa_30ord_alow_amt": "000000012550", "profa_30ord_alowq": "0000000000", "profa_40ord_alow_amt": "000000012550", "profa_40ord_alowq": "0000000000", "profa_50ord_alow_amt": "000000012550", "profa_50ord_alowq": "0000000000", "profa_60ord_alow_amt": "000000012550", "profa_60ord_alowq": "0000000000", "profa_rdex_60ord_alow_amt": "000000012550", "profa_rdex_60ord_alowq": "0000000000", "profa_100ord_alow_amt": "000000012550", "profa_100ord_alowq": "0000000000", "pred_reu_alowa": "000000027194", "tdy_reu_alowa": "000000000000", "entr": "000000017534", "repl_amt": "000003915500", "uncla": "000000000000", "ord_pos_repl": "000003915500", "ord_alowa": "000000085341", "wthd_alowa": "000000085341", "nxdy_wthd_alowa": "000000012550", "pur_amt": "000000000000", "cmsn": "000000000000", "pur_exct_amt": "000000000000", "d2entra": "000000012550", "profa_rdex_aplc_tp": "0", "return_code": 0, "return_msg": "주문/인출가능금액 시뮬레이션 조회완료하였습니다." 401 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 증거금율별주문가능수량조회요청(kt00011) API 명 증거금율별주문가능수량조회요청 API ID kt00011 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목번호 String Y 12 Body uv 매수가격 String N 10 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_profa_rt 종목증거금율 String N 15 Body profa_rt 계좌증거금율 String N 15 Body aplc_rt 적용증거금율 String N 15 Body profa_20ord_alow_a mt 증거금20%주문가능 금액 String N 12 Body profa_20ord_alowq 증거금20%주문가능 수량 String N 12 Body profa_20pred_reu_a mt 증거금20%전일재사 용금액 String N 12 Body profa_20tdy_reu_amt 증거금20%금일재사 용금액 String N 12 Body profa_30ord_alow_a mt 증거금30%주문가능 금액 String N 12 402 / 528 Response 구분 Element 한글명 Type Require d Length Body profa_30ord_alowq 증거금30%주문가능 수량 String N 12 Body profa_30pred_reu_a mt 증거금30%전일재사 용금액 String N 12 Body profa_30tdy_reu_amt 증거금30%금일재사 용금액 String N 12 Body profa_40ord_alow_a mt 증거금40%주문가능 금액 String N 12 Body profa_40ord_alowq 증거금40%주문가능 수량 String N 12 Body profa_40pred_reu_a mt 증거금40전일재사용 금액 String N 12 Body profa_40tdy_reu_amt 증거금40%금일재사 용금액 String N 12 Body profa_50ord_alow_a mt 증거금50%주문가능 금액 String N 12 Body profa_50ord_alowq 증거금50%주문가능 수량 String N 12 Body profa_50pred_reu_a mt 증거금50%전일재사 용금액 String N 12 Body profa_50tdy_reu_amt 증거금50%금일재사 용금액 String N 12 Body profa_60ord_alow_a mt 증거금60%주문가능 금액 String N 12 Body profa_60ord_alowq 증거금60%주문가능 수량 String N 12 Body profa_60pred_reu_a mt 증거금60%전일재사 용금액 String N 12 Body profa_60tdy_reu_amt 증거금60%금일재사 용금액 String N 12 Body profa_100ord_alow_a mt 증거금100%주문가능 금액 String N 12 Body profa_100ord_alowq 증거금100%주문가능 수량 String N 12 Body profa_100pred_reu_a mt 증거금100%전일재사 용금액 String N 12 Body profa_100tdy_reu_a mt 증거금100%금일재사 용금액 String N 12 Body min_ord_alow_amt 미수불가주문가능금 액 String N 12 Body min_ord_alowq 미수불가주문가능수 량 String N 12 Body min_pred_reu_amt 미수불가전일재사용 금액 String N 12 Body min_tdy_reu_amt 미수불가금일재사용 금액 String N 12 Body entr 예수금 String N 12 Body repl_amt 대용금 String N 12 Body uncla 미수금 String N 12 403 / 528 Description Response 구분 Element 한글명 Type Require d Length Body ord_pos_repl 주문가능대용 String N 12 Body ord_alowa 주문가능현금 String N 12 Request Example { } "stk_cd": "005930", "uv": "" Response Example { } "stk_profa_rt": "20%", "profa_rt": "100%", "aplc_rt": "100%", "profa_20ord_alow_amt": "", "profa_20ord_alowq": "", "profa_20pred_reu_amt": "", "profa_20tdy_reu_amt": "", "profa_30ord_alow_amt": "", "profa_30ord_alowq": "", "profa_30pred_reu_amt": "", "profa_30tdy_reu_amt": "", "profa_40ord_alow_amt": "", "profa_40ord_alowq": "", "profa_40pred_reu_amt": "", "profa_40tdy_reu_amt": "", "profa_50ord_alow_amt": "", "profa_50ord_alowq": "", "profa_50pred_reu_amt": "", "profa_50tdy_reu_amt": "", "profa_60ord_alow_amt": "", "profa_60ord_alowq": "", "profa_60pred_reu_amt": "", "profa_60tdy_reu_amt": "", "profa_100ord_alow_amt": "", "profa_100ord_alowq": "", "profa_100pred_reu_amt": "", "profa_100tdy_reu_amt": "", "min_ord_alow_amt": "000000063380", "min_ord_alowq": "000000000000", "min_pred_reu_amt": "000000027194", "min_tdy_reu_amt": "000000000000", "entr": "000000017534", "repl_amt": "000003915500", "uncla": "000000000000", "ord_pos_repl": "000003915500", "ord_alowa": "000000085341", "return_code": 0, "return_msg": "자료를 조회하였습니다." 404 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 신용보증금율별주문가능수량조회요청(kt00012) API 명 신용보증금율별주문가능수량조회요청 API ID kt00012 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목번호 String Y 12 Body uv 매수가격 String N 10 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body stk_assr_rt 종목보증금율 String N 1 Body stk_assr_rt_nm 종목보증금율명 String N 4 Body assr_30ord_alow_am t 보증금30%주문가능 금액 String N 12 Body assr_30ord_alowq 보증금30%주문가능 수량 String N 12 Body assr_30pred_reu_amt 보증금30%전일재사 용금액 String N 12 Body assr_30tdy_reu_amt 보증금30%금일재사 용금액 String N 12 Body assr_40ord_alow_am t 보증금40%주문가능 금액 String N 12 Body assr_40ord_alowq 보증금40%주문가능 String N 12 405 / 528 Response 구분 Element 한글명 Type Require d Length 수량 Body assr_40pred_reu_amt 보증금40%전일재사 용금액 String N 12 Body assr_40tdy_reu_amt 보증금40%금일재사 용금액 String N 12 Body assr_50ord_alow_am t 보증금50%주문가능 금액 String N 12 Body assr_50ord_alowq 보증금50%주문가능 수량 String N 12 Body assr_50pred_reu_amt 보증금50%전일재사 용금액 String N 12 Body assr_50tdy_reu_amt 보증금50%금일재사 용금액 String N 12 Body assr_60ord_alow_am t 보증금60%주문가능 금액 String N 12 Body assr_60ord_alowq 보증금60%주문가능 수량 String N 12 Body assr_60pred_reu_amt 보증금60%전일재사 용금액 String N 12 Body assr_60tdy_reu_amt 보증금60%금일재사 용금액 String N 12 Body entr 예수금 String N 12 Body repl_amt 대용금 String N 12 Body uncla 미수금 String N 12 Body ord_pos_repl 주문가능대용 String N 12 Body ord_alowa 주문가능현금 String N 12 Body out_alowa 미수가능금액 String N 12 Body out_pos_qty 미수가능수량 String N 12 Body min_amt 미수불가금액 String N 12 Body min_qty 미수불가수량 String N 12 Request Example { } "stk_cd": "005930", "uv": "" Response Example { "stk_assr_rt": "B", "stk_assr_rt_nm": "45%", "assr_30ord_alow_amt": "003312045139", "assr_30ord_alowq": "000000000000", "assr_30pred_reu_amt": "000000000000", "assr_30tdy_reu_amt": "000000048994", "assr_40ord_alow_amt": "002208030092", "assr_40ord_alowq": "000000000000", "assr_40pred_reu_amt": "000000000000", "assr_40tdy_reu_amt": "000000048994", "assr_50ord_alow_amt": "001987227084", "assr_50ord_alowq": "000000000000", "assr_50pred_reu_amt": "000000000000", "assr_50tdy_reu_amt": "000000048994", 406 / 528 Description Response Example } "assr_60ord_alow_amt": "001656022569", "assr_60ord_alowq": "000000000000", "assr_60pred_reu_amt": "000000000000", "assr_60tdy_reu_amt": "000000048994", "entr": "000994946131", "repl_amt": "000001643660", "uncla": "000000000000", "ord_pos_repl": "000002420949", "ord_alowa": "000993564548", "out_alowa": "002208030092", "out_pos_qty": "000000000000", "min_amt": "002207294240", "min_qty": "000000000000", "return_code": 0, "return_msg": "신용보증금율별 주문가능수량 조회(한도정상)" 407 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 증거금세부내역조회요청(kt00013) API 명 증거금세부내역조회요청 API ID kt00013 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tdy_reu_objt_amt 금일재사용대상금액 String N 15 Body tdy_reu_use_amt 금일재사용사용금액 String N 15 Body tdy_reu_alowa 금일재사용가능금액 String N 15 Body tdy_reu_lmtt_amt 금일재사용제한금액 String N 15 Body tdy_reu_alowa_fin 금일재사용가능금액 최종 String N 15 Body pred_reu_objt_amt 전일재사용대상금액 String N 15 Body pred_reu_use_amt 전일재사용사용금액 String N 15 Body pred_reu_alowa 전일재사용가능금액 String N 15 Body pred_reu_lmtt_amt 전일재사용제한금액 String N 15 Body pred_reu_alowa_fin 전일재사용가능금액 최종 String N 15 Body ch_amt 현금금액 String N 15 408 / 528 Response 구분 Element 한글명 Type Require d Length Body ch_profa 현금증거금 String N 15 Body use_pos_ch 사용가능현금 String N 15 Body ch_use_lmtt_amt 현금사용제한금액 String N 15 Body use_pos_ch_fin 사용가능현금최종 String N 15 Body repl_amt_amt 대용금액 String N 15 Body repl_profa 대용증거금 String N 15 Body use_pos_repl 사용가능대용 String N 15 Body repl_use_lmtt_amt 대용사용제한금액 String N 15 Body use_pos_repl_fin 사용가능대용최종 String N 15 Body crd_grnta_ch 신용보증금현금 String N 15 Body crd_grnta_repl 신용보증금대용 String N 15 Body crd_grnt_ch 신용담보금현금 String N 15 Body crd_grnt_repl 신용담보금대용 String N 15 Body uncla 미수금 String N 12 Body ls_grnt_reu_gold 대주담보금재사용금 String N 15 Body 20ord_alow_amt 20%주문가능금액 String N 15 Body 30ord_alow_amt 30%주문가능금액 String N 15 Body 40ord_alow_amt 40%주문가능금액 String N 15 Body 50ord_alow_amt 50%주문가능금액 String N 15 Body 60ord_alow_amt 60%주문가능금액 String N 15 Body 100ord_alow_amt 100%주문가능금액 String N 15 Body tdy_crd_rpya_loss_a mt 금일신용상환손실금 액 String N 15 Body pred_crd_rpya_loss_a mt 전일신용상환손실금 액 String N 15 Body tdy_ls_rpya_loss_repl _profa 금일대주상환손실대 용증거금 String N 15 Body pred_ls_rpya_loss_re pl_profa 전일대주상환손실대 용증거금 String N 15 Body evlt_repl_amt_spg_us e_skip 평가대용금(현물사용 제외) String N 15 Body evlt_repl_rt 평가대용비율 String N 15 Body crd_repl_profa 신용대용증거금 String N 15 Body ch_ord_repl_profa 현금주문대용증거금 String N 15 Body crd_ord_repl_profa 신용주문대용증거금 String N 15 Body crd_repl_conv_gold 신용대용환산금 String N 15 Body repl_alowa 대용가능금액(현금제 한) String N 15 Body repl_alowa_2 대용가능금액2(신용 제한) String N 15 409 / 528 Description Response 구분 Element 한글명 Type Require d Length Body ch_repl_lck_gold 현금대용부족금 String N 15 Body crd_repl_lck_gold 신용대용부족금 String N 15 Body ch_ord_alow_repla 현금주문가능대용금 String N 15 Body crd_ord_alow_repla 신용주문가능대용금 String N 15 Body d2vexct_entr D2가정산예수금 String N 15 Body d2ch_ord_alow_amt D2현금주문가능금액 String N 15 Request Example {} Response Example { } "tdy_reu_objt_amt": "000000000000000", "tdy_reu_use_amt": "000000000000000", "tdy_reu_alowa": "000000000000000", "tdy_reu_lmtt_amt": "000000000000000", "tdy_reu_alowa_fin": "000000000000000", "pred_reu_objt_amt": "000000000048141", "pred_reu_use_amt": "000000000020947", "pred_reu_alowa": "000000000027194", "pred_reu_lmtt_amt": "000000000000000", "pred_reu_alowa_fin": "000000000027194", "ch_amt": "000000000017534", "ch_profa": "000000000032193", "use_pos_ch": "000000000085341", "ch_use_lmtt_amt": "000000000000000", "use_pos_ch_fin": "000000000085341", "repl_amt_amt": "000000003915500", "repl_profa": "000000000000000", "use_pos_repl": "000000003915500", "repl_use_lmtt_amt": "000000000000000", "use_pos_repl_fin": "000000003915500", "crd_grnta_ch": "000000000000000", "crd_grnta_repl": "000000000000000", "crd_grnt_ch": "000000000000000", "crd_grnt_repl": "000000000000000", "uncla": "000000000000", "ls_grnt_reu_gold": "000000000000000", "20ord_alow_amt": "000000000012550", "30ord_alow_amt": "000000000012550", "40ord_alow_amt": "000000000012550", "50ord_alow_amt": "000000000012550", "60ord_alow_amt": "000000000012550", "100ord_alow_amt": "000000000012550", "tdy_crd_rpya_loss_amt": "000000000000000", "pred_crd_rpya_loss_amt": "000000000000000", "tdy_ls_rpya_loss_repl_profa": "000000000000000", "pred_ls_rpya_loss_repl_profa": "000000000000000", "evlt_repl_amt_spg_use_skip": "000000006193400", "evlt_repl_rt": "0.6322053", "crd_repl_profa": "000000000000000", "ch_ord_repl_profa": "000000000000000", "crd_ord_repl_profa": "000000000000000", "crd_repl_conv_gold": "000000000000000", "repl_alowa": "000000003915500", "repl_alowa_2": "000000003915500", "ch_repl_lck_gold": "000000000000000", "crd_repl_lck_gold": "000000000000000", "ch_ord_alow_repla": "000000003915500", "crd_ord_alow_repla": "000000006193400", "d2vexct_entr": "000000000012550", "d2ch_ord_alow_amt": "000000000012550", "return_code": 0, "return_msg": "조회가 완료되었습니다." 410 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 위탁종합거래내역요청(kt00015) API 명 위탁종합거래내역요청 API ID kt00015 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String Y 8 Body end_dt 종료일자 String Y 8 Body tp 구분 String Y 1 Body stk_cd 종목코드 String N 12 Body crnc_cd 통화코드 String N 3 Body gds_tp 상품구분 String Y 1 Body frgn_stex_code 해외거래소코드 String N 10 Body dmst_stex_tp 국내거래소구분 String Y 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0:전체,1:입출금,2:입출고,3:매매,4:매수,5:매도,6:입금,7:출금,A: 예탁담보대출입금,B:매도담보대출입금,C:현금상환(융자,담보 상환),F:환전,M:입출금+환전,G:외화매수,H:외화매도,I:환전정 산입금,J:환전정산출금 0:전체, 1:국내주식, 2:수익증권, 3:해외주식, 4:금융상품 %:(전체),KRX:한국거래소,NXT:넥스트트레이드 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body trst_ovrl_trde_prps_a rray 위탁종합거래내역배 열 LIST N Body - trde_dt 거래일자 String N 411 / 528 8 Response 구분 Element 한글명 Type Require d Length Body - trde_no 거래번호 String N 9 Body - rmrk_nm 적요명 String N 60 Body - crd_deal_tp_nm 신용거래구분명 String N 20 Body - exct_amt 정산금액 String N 15 Body - loan_amt_rpya 대출금상환 String N 15 Body - fc_trde_amt 거래금액(외) String N 15 Body - fc_exct_amt 정산금액(외) String N 15 Body - entra_remn 예수금잔고 String N 15 Body - crnc_cd 통화코드 String N 3 Body - trde_ocr_tp 거래종류구분 String N 2 Body - trde_kind_nm 거래종류명 String N 20 Body - stk_nm 종목명 String N 40 Body - trde_amt 거래금액 String N 15 Body - trde_agri_tax 거래및농특세 String N 15 Body - rpy_diffa 상환차금 String N 15 Body - fc_trde_tax 거래세(외) String N 15 Body - dly_sum 연체합 String N 15 Body - fc_entra 외화예수금잔고 String N 15 Body - mdia_tp_nm 매체구분명 String N 20 Body - io_tp 입출구분 String N 1 Body - io_tp_nm 입출구분명 String N 10 Body - orig_deal_no 원거래번호 String N 9 Body - stk_cd 종목코드 String N 12 Body - trde_qty_jwa_cnt 거래수량/좌수 String N 30 Body - cmsn 수수료 String N 15 Body - int_ls_usfe 이자/대주이용 String N 15 Body - fc_cmsn 수수료(외) String N 15 Body - fc_dly_sum 연체합(외) String N 15 Body - vlbl_nowrm 유가금잔 String N 30 Body - proc_tm 처리시간 String N 111 Body - isin_cd ISIN코드 String N 12 Body - stex_cd 거래소코드 String N 10 Body - stex_nm 거래소명 String N 20 Body - trde_unit 거래단가/환율 String N 20 Body - incm_resi_tax 소득/주민세 String N 15 Body - loan_dt 대출일 String N 8 412 / 528 Description 1:입출금, 2:펀드, 3:ELS, 4:채권, 5:해외채권, 6:외화RP, 7:외화발행어음 Response 구분 Element 한글명 Type Require d Length Body - uncl_ocr 미수(원/주) String N 30 Body - rpym_sum 변제합 String N 30 Body - cntr_dt 체결일 String N 8 Body - rcpy_no 출납번호 String N 20 Body - prcsr 처리자 String N 20 Body - proc_brch 처리점 String N 20 Body - trde_stle 매매형태 String N 40 Body - txon_base_pric 과세기준가 String N 15 Body - tax_sum_cmsn 세금수수료합 String N 15 Body - frgn_pay_txam 외국납부세액(외) String N 15 Body - fc_uncl_ocr 미수(외) String N 15 Body - rpym_sum_fr 변제합(외) String N 30 Body - rcpmnyer 입금자 String N 20 Body - trde_prtc_tp 거래내역구분 String N 2 Request Example { } "strt_dt": "20241121", "end_dt": "20241125", "tp": "0", "stk_cd": "", "crnc_cd": "", "gds_tp": "0", "frgn_stex_code": "", "dmst_stex_tp": "%" Response Example { "acnt_no": "6081-2***-11 [김키움]", "trst_ovrl_trde_prps_array": [ { "trde_dt": "20241121", "trde_no": "000000001", "rmrk_nm": "장내매도", "crd_deal_tp_nm": "보통매매", "exct_amt": "000000000056798", "loan_amt_rpya": "000000000000000", "fc_trde_amt": "0.00", "fc_exct_amt": "0.00", "entra_remn": "000000994658290", "crnc_cd": "KRW", "trde_ocr_tp": "9", "trde_kind_nm": "매매", "stk_nm": "삼성전자", "trde_amt": "000000000056900", "trde_agri_tax": "000000000000102", "rpy_diffa": "000000000000000", "fc_trde_tax": "0.00", "dly_sum": "000000000000000", "fc_entra": "0.00", "mdia_tp_nm": "REST API", "io_tp": "1", "io_tp_nm": "매도", "orig_deal_no": "000000000", "stk_cd": "A005930", "trde_qty_jwa_cnt": "1", "cmsn": "000000000000000", "int_ls_usfe": "000000000000000", "fc_cmsn": "0.00", 413 / 528 Description Response Example "fc_dly_sum": "0.00", "vlbl_nowrm": "21", "proc_tm": "08:12:35", "isin_cd": "KR7005930003", "stex_cd": "", "stex_nm": "", "trde_unit": "56,900", "incm_resi_tax": "000000000000000", "loan_dt": "", "uncl_ocr": "", "rpym_sum": "", "cntr_dt": "20241119", "rcpy_no": "", "prcsr": "DAILY", "proc_brch": "키움은행", "trde_stle": "", "txon_base_pric": "0.00", "tax_sum_cmsn": "000000000000102", "frgn_pay_txam": "0.00", "fc_uncl_ocr": "0.00", "rpym_sum_fr": "", "rcpmnyer": "", "trde_prtc_tp": "11" } } ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 414 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 일별계좌수익률상세현황요청(kt00016) API 명 일별계좌수익률상세현황요청 API ID kt00016 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body fr_dt 평가시작일 String Y 8 Body to_dt 평가종료일 String Y 8 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body mang_empno 관리사원번호 String N 8 Body mngr_nm 관리자명 String N 8 Body dept_nm 관리자지점 String N 30 Body entr_fr 예수금_초 String N 30 Body entr_to 예수금_말 String N 12 Body scrt_evlt_amt_fr 유가증권평가금액_초 String N 12 Body scrt_evlt_amt_to 유가증권평가금액_말 String N 12 Body ls_grnt_fr 대주담보금_초 String N 12 Body ls_grnt_to 대주담보금_말 String N 12 Body crd_loan_fr 신용융자금_초 String N 12 415 / 528 Response 구분 Element 한글명 Type Require d Length Body crd_loan_to 신용융자금_말 String N 12 Body ch_uncla_fr 현금미수금_초 String N 12 Body ch_uncla_to 현금미수금_말 String N 12 Body krw_asgna_fr 원화대용금_초 String N 12 Body krw_asgna_to 원화대용금_말 String N 12 Body ls_evlta_fr 대주평가금_초 String N 12 Body ls_evlta_to 대주평가금_말 String N 12 Body rght_evlta_fr 권리평가금_초 String N 12 Body rght_evlta_to 권리평가금_말 String N 12 Body loan_amt_fr 대출금_초 String N 12 Body loan_amt_to 대출금_말 String N 12 Body etc_loana_fr 기타대여금_초 String N 12 Body etc_loana_to 기타대여금_말 String N 12 Body crd_int_npay_gold_fr 신용이자미납금_초 String N 12 Body crd_int_npay_gold_to 신용이자미납금_말 String N 12 Body crd_int_fr 신용이자_초 String N 12 Body crd_int_to 신용이자_말 String N 12 Body tot_amt_fr 순자산액계_초 String N 12 Body tot_amt_to 순자산액계_말 String N 12 Body invt_bsamt 투자원금평잔 String N 12 Body evltv_prft 평가손익 String N 12 Body prft_rt 수익률 String N 12 Body tern_rt 회전율 String N 12 Body termin_tot_trns 기간내총입금 String N 12 Body termin_tot_pymn 기간내총출금 String N 12 Body termin_tot_inq 기간내총입고 String N 12 Body termin_tot_outq 기간내총출고 String N 12 Body futr_repl_sella 선물대용매도금액 String N 12 Body trst_repl_sella 위탁대용매도금액 String N 12 Request Example { } "fr_dt": "20241111", "to_dt": "20241125" Response Example { "mang_empno": "081", "mngr_nm": "키움은행", "dept_nm": "키움은행", "entr_fr": "000000000000", "entr_to": "000000017534", 416 / 528 Description Response Example } "scrt_evlt_amt_fr": "000000000000", "scrt_evlt_amt_to": "000000000000", "ls_grnt_fr": "000000000000", "ls_grnt_to": "000000000000", "crd_loan_fr": "000000000000", "crd_loan_to": "000000000000", "ch_uncla_fr": "000000000000", "ch_uncla_to": "000000000000", "krw_asgna_fr": "000000000000", "krw_asgna_to": "000000000000", "ls_evlta_fr": "000000000000", "ls_evlta_to": "000000000000", "rght_evlta_fr": "000000000000", "rght_evlta_to": "000000000000", "loan_amt_fr": "000000000000", "loan_amt_to": "000000000000", "etc_loana_fr": "000000000000", "etc_loana_to": "000000000000", "crd_int_npay_gold_fr": "000000000000", "crd_int_npay_gold_to": "000000000000", "crd_int_fr": "000000000000", "crd_int_to": "000000000000", "tot_amt_fr": "000000000000", "tot_amt_to": "000000017534", "invt_bsamt": "000000000000", "evltv_prft": "-00005482466", "prft_rt": "-0.91", "tern_rt": "0.84", "termin_tot_trns": "000000000000", "termin_tot_pymn": "000000000000", "termin_tot_inq": "000000000000", "termin_tot_outq": "000000000000", "futr_repl_sella": "000000000000", "trst_repl_sella": "000000000000", "return_code": 0, "return_msg": "조회가 완료되었습니다." 417 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌별당일현황요청(kt00017) API 명 계좌별당일현황요청 API ID kt00017 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body d2_entra D+2추정예수금 String N 12 Body crd_int_npay_gold 신용이자미납금 String N 12 Body etc_loana 기타대여금 String N 12 Body gnrl_stk_evlt_amt_d2 일반주식평가금액D+ 2 String N 12 Body dpst_grnt_use_amt_d 2 예탁담보대출금D+2 String N 12 Body crd_stk_evlt_amt_d2 예탁담보주식평가금 액D+2 String N 12 Body crd_loan_d2 신용융자금D+2 String N 12 Body crd_loan_evlta_d2 신용융자평가금D+2 String N 12 Body crd_ls_grnt_d2 신용대주담보금D+2 String N 12 Body crd_ls_evlta_d2 신용대주평가금D+2 String N 12 Body ina_amt 입금금액 String N 12 418 / 528 Response 구분 Element 한글명 Type Require d Length Body outa 출금금액 String N 12 Body inq_amt 입고금액 String N 12 Body outq_amt 출고금액 String N 12 Body sell_amt 매도금액 String N 12 Body buy_amt 매수금액 String N 12 Body cmsn 수수료 String N 12 Body tax 세금 String N 12 Body stk_pur_cptal_loan_a mt 주식매입자금대출금 String N 12 Body rp_evlt_amt RP평가금액 String N 12 Body bd_evlt_amt 채권평가금액 String N 12 Body elsevlt_amt ELS평가금액 String N 12 Body crd_int_amt 신용이자금액 String N 12 Body sel_prica_grnt_loan_i nt_amt_amt 매도대금담보대출이 자금액 String N 12 Body dvida_amt 배당금액 String N 12 Request Example {} Response Example { } "d2_entra": "000000012550", "crd_int_npay_gold": "000000000000", "etc_loana": "000000000000", "gnrl_stk_evlt_amt_d2": "000005724100", "dpst_grnt_use_amt_d2": "000000000000", "crd_stk_evlt_amt_d2": "000000000000", "crd_loan_d2": "000000000000", "crd_loan_evlta_d2": "000000000000", "crd_ls_grnt_d2": "000000000000", "crd_ls_evlta_d2": "000000000000", "ina_amt": "000000000000", "outa": "000000000000", "inq_amt": "000000000000", "outq_amt": "000000000000", "sell_amt": "000000000000", "buy_amt": "000000000000", "cmsn": "000000000000", "tax": "000000000000", "stk_pur_cptal_loan_amt": "000000000000", "rp_evlt_amt": "000000000000", "bd_evlt_amt": "000000000000", "elsevlt_amt": "000000000000", "crd_int_amt": "000000000000", "sel_prica_grnt_loan_int_amt_amt": "000000000000", "dvida_amt": "000000000000", "return_code": 0, "return_msg": "조회가 완료되었습니다.." 419 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 계좌평가잔고내역요청(kt00018) API 명 계좌평가잔고내역요청 API ID kt00018 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body qry_tp 조회구분 String Y 1 1:합산, 2:개별 Body dmst_stex_tp 국내거래소구분 String Y 6 KRX:한국거래소,NXT:넥스트트레이드 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tot_pur_amt 총매입금액 String N 15 Body tot_evlt_amt 총평가금액 String N 15 Body tot_evlt_pl 총평가손익금액 String N 15 Body tot_prft_rt 총수익률(%) String N 12 Body prsm_dpst_aset_amt 추정예탁자산 String N 15 Body tot_loan_amt 총대출금 String N 15 Body tot_crd_loan_amt 총융자금액 String N 15 Body tot_crd_ls_amt 총대주금액 String N 15 Body acnt_evlt_remn_indv_ tot 계좌평가잔고개별합 산 LIST N Body - stk_cd 종목번호 String N 420 / 528 12 Response 구분 Element 한글명 Type Require d Length Body - stk_nm 종목명 String N 40 Body - evltv_prft 평가손익 String N 15 Body - prft_rt 수익률(%) String N 12 Body - pur_pric 매입가 String N 15 Body - pred_close_pric 전일종가 String N 12 Body - rmnd_qty 보유수량 String N 15 Body - trde_able_qty 매매가능수량 String N 15 Body - cur_prc 현재가 String N 12 Body - pred_buyq 전일매수수량 String N 15 Body - pred_sellq 전일매도수량 String N 15 Body - tdy_buyq 금일매수수량 String N 15 Body - tdy_sellq 금일매도수량 String N 15 Body - pur_amt 매입금액 String N 15 Body - pur_cmsn 매입수수료 String N 15 Body - evlt_amt 평가금액 String N 15 Body - sell_cmsn 평가수수료 String N 15 Body - tax 세금 String N 15 Body - sum_cmsn 수수료합 String N 15 Body - poss_rt 보유비중(%) String N 12 Body - crd_tp 신용구분 String N 2 Body - crd_tp_nm 신용구분명 String N 4 Body - crd_loan_dt 대출일 String N 8 Request Example { } "qry_tp": "1", "dmst_stex_tp": "KRX" Response Example { "tot_pur_amt": "000000017598258", "tot_evlt_amt": "000000025789890", "tot_evlt_pl": "000000008138825", "tot_prft_rt": "46.25", "prsm_dpst_aset_amt": "000001012632507", "tot_loan_amt": "000000000000000", "tot_crd_loan_amt": "000000000000000", "tot_crd_ls_amt": "000000000000000", "acnt_evlt_remn_indv_tot": [ { "stk_cd": "A005930", "stk_nm": "삼성전자", "evltv_prft": "-00000000196888", "prft_rt": "-52.71", "pur_pric": "000000000124500", "pred_close_pric": "000000045400", "rmnd_qty": "000000000000003", "trde_able_qty": "000000000000003", "cur_prc": "000000059000", "pred_buyq": "000000000000000", 421 / 528 Description 매입수수료 + 평가수수료 Response Example }, { } "pred_sellq": "000000000000000", "tdy_buyq": "000000000000000", "tdy_sellq": "000000000000000", "pur_amt": "000000000373500", "pur_cmsn": "000000000000050", "evlt_amt": "000000000177000", "sell_cmsn": "000000000000020", "tax": "000000000000318", "sum_cmsn": "000000000000070", "poss_rt": "2.12", "crd_tp": "00", "crd_tp_nm": "", "crd_loan_dt": "" "stk_cd": "A005930", "stk_nm": "삼성전자", "evltv_prft": "-00000000995004", "prft_rt": "-59.46", "pur_pric": "000000000209178", "pred_close_pric": "000000097600", "rmnd_qty": "000000000000008", "trde_able_qty": "000000000000008", "cur_prc": "000000085000", "pred_buyq": "000000000000000", "pred_sellq": "000000000000000", "tdy_buyq": "000000000000000", "tdy_sellq": "000000000000000", "pur_amt": "000000001673430", "pur_cmsn": "000000000000250", "evlt_amt": "000000000680000", "sell_cmsn": "000000000000100", "tax": "000000000001224", "sum_cmsn": "000000000000350", "poss_rt": "9.51", "crd_tp": "00", "crd_tp_nm": "", "crd_loan_dt": "" } ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 422 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 주식 매수주문(kt10000) API 명 주식 매수주문 API ID kt10000 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body stk_cd 종목코드 String Y 12 Body ord_qty 주문수량 String Y 12 Body ord_uv 주문단가 String N 12 Body trde_tp 매매구분 String Y 2 Body cond_uv 조건단가 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0:보통 , 3:시장가 , 5:조건부지정가 , 81:장마감후시간외 , 61:장시작전시간외, 62:시간외단일가 , 6:최유리지정가 , 7:최우선지정가 , 10:보통(IOC) , 13:시장가(IOC) , 16:최유리(IOC) , 20:보통(FOK) , 23:시장가(FOK) , 26:최유리(FOK) , 28:스톱지정가,29:중간가,30:중간가(IOC),31:중간가(FOK) Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body dmst_stex_tp 국내거래소구분 String N 6 Request Example { 423 / 528 Request Example } "dmst_stex_tp": "KRX", "stk_cd": "005930", "ord_qty": "1", "ord_uv": "", "trde_tp": "3", "cond_uv": "" Response Example { } "ord_no" : "00024" "return_code":0, "return_msg":"정상적으로 처리되었습니다" 424 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 주식 매도주문(kt10001) API 명 주식 매도주문 API ID kt10001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body stk_cd 종목코드 String Y 12 Body ord_qty 주문수량 String Y 12 Body ord_uv 주문단가 String N 12 Body trde_tp 매매구분 String Y 2 Body cond_uv 조건단가 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0:보통 , 3:시장가 , 5:조건부지정가 , 81:장마감후시간외 , 61:장시작전시간외, 62:시간외단일가 , 6:최유리지정가 , 7:최우선지정가 , 10:보통(IOC) , 13:시장가(IOC) , 16:최유리(IOC) , 20:보통(FOK) , 23:시장가(FOK) , 26:최유리(FOK) , 28:스톱지정가,29:중간가,30:중간가(IOC),31:중간가(FOK) Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body dmst_stex_tp 국내거래소구분 String N 6 Request Example { 425 / 528 Request Example } "dmst_stex_tp": "KRX", "stk_cd": "005930", "ord_qty": "1", "ord_uv": "", "trde_tp": "3", "cond_uv": "" Response Example { } "ord_no": "0000138", "dmst_stex_tp": "KRX", "return_code": 0, "return_msg": "매도주문이 완료되었습니다." 426 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 주식 정정주문(kt10002) API 명 주식 정정주문 API ID kt10002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body orig_ord_no 원주문번호 String Y 7 Body stk_cd 종목코드 String Y 12 Body mdfy_qty 정정수량 String Y 12 Body mdfy_uv 정정단가 String Y 12 Body mdfy_cond_uv 정정조건단가 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body base_orig_ord_no 모주문번호 String N 7 Body mdfy_qty 정정수량 String N 12 Body dmst_stex_tp 국내거래소구분 String N 6 Request Example { Description "dmst_stex_tp": "KRX", 427 / 528 Request Example } "orig_ord_no": "0000139", "stk_cd": "005930", "mdfy_qty": "1", "mdfy_uv": "199700", "mdfy_cond_uv": "" Response Example { } "ord_no": "0000140", "base_orig_ord_no": "0000139", "mdfy_qty": "000000000001", "dmst_stex_tp": "KRX", "return_code": 0, "return_msg": "매수정정 주문입력이 완료되었습니다" 428 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 주식 취소주문(kt10003) API 명 주식 취소주문 API ID kt10003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body orig_ord_no 원주문번호 String Y 7 Body stk_cd 종목코드 String Y 12 Body cncl_qty 취소수량 String Y 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... '0' 입력시 잔량 전부 취소 Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body base_orig_ord_no 모주문번호 String N 7 Body cncl_qty 취소수량 String N 12 Request Example { } Description "dmst_stex_tp": "KRX", "orig_ord_no": "0000140", "stk_cd": "005930", "cncl_qty": "1" Response Example 429 / 528 Response Example { } "ord_no": "0000141", "base_orig_ord_no": "0000139", "cncl_qty": "000000000001", "return_code": 0, "return_msg": "매수취소 주문입력이 완료되었습니다" 430 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 신용주문 > 신용 매수주문(kt10006) API 명 신용 매수주문 API ID kt10006 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/crdordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body stk_cd 종목코드 String Y 12 Body ord_qty 주문수량 String Y 12 Body ord_uv 주문단가 String N 12 Body trde_tp 매매구분 String Y 2 Body cond_uv 조건단가 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0:보통 , 3:시장가 , 5:조건부지정가 , 81:장마감후시간외 , 61:장시작전시간외, 62:시간외단일가 , 6:최유리지정가 , 7:최우선지정가 , 10:보통(IOC) , 13:시장가(IOC) , 16:최유리(IOC) , 20:보통(FOK) , 23:시장가(FOK) , 26:최유리(FOK) , 28:스톱지정가,29:중간가,30:중간가(IOC),31:중간가(FOK) Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body dmst_stex_tp 국내거래소구분 String N 6 Request Example { 431 / 528 Request Example } "dmst_stex_tp": "KRX", "stk_cd": "005930", "ord_qty": "1", "ord_uv": "2580", "trde_tp": "0", "cond_uv": "" Response Example { } "ord_no": "0001615", "dmst_stex_tp": "KRX", "return_code": 0, "return_msg": "신용 매수주문이 완료되었습니다." 432 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 신용주문 > 신용 매도주문(kt10007) API 명 신용 매도주문 API ID kt10007 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/crdordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body stk_cd 종목코드 String Y 12 Body ord_qty 주문수량 String Y 12 Body ord_uv 주문단가 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Body trde_tp 매매구분 String Y 2 0:보통 , 3:시장가 , 5:조건부지정가 , 81:장마감후시간외 , 61:장시작전시간외, 62:시간외단일가 , 6:최유리지정가 , 7:최우선지정가 , 10:보통(IOC) , 13:시장가(IOC) , 16:최유리(IOC) , 20:보통(FOK) , 23:시장가(FOK) , 26:최유리(FOK) , 28:스톱지정가,29:중간가,30:중간가(IOC),31:중간가(FOK) Body crd_deal_tp 신용거래구분 String Y 2 33:융자 , 99:융자합 Body crd_loan_dt 대출일 String N 8 YYYYMMDD(융자일경우필수) Body cond_uv 조건단가 String N 12 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body dmst_stex_tp 국내거래소구분 String N 6 433 / 528 Request Example { } "dmst_stex_tp": "KRX", "stk_cd": "005930", "ord_qty": "3", "ord_uv": "6450", "trde_tp": "0", "crd_deal_tp": "99", "crd_loan_dt": "", "cond_uv": "" Response Example { } "ord_no": "0001614", "dmst_stex_tp": "KRX", "return_code": 0, "return_msg": "신용 매도주문이 완료되었습니다." 434 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 신용주문 > 신용 정정주문(kt10008) API 명 신용 정정주문 API ID kt10008 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/crdordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body orig_ord_no 원주문번호 String Y 7 Body stk_cd 종목코드 String Y 12 Body mdfy_qty 정정수량 String Y 12 Body mdfy_uv 정정단가 String Y 12 Body mdfy_cond_uv 정정조건단가 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body base_orig_ord_no 모주문번호 String N 7 Body mdfy_qty 정정수량 String N 12 Body dmst_stex_tp 국내거래소구분 String N 6 Request Example { Description "dmst_stex_tp": "KRX", 435 / 528 Request Example } "orig_ord_no": "0000455", "stk_cd": "005930", "mdfy_qty": "1", "mdfy_uv": "2590", "mdfy_cond_uv": "" Response Example { } "ord_no": "0000509", "base_orig_ord_no": "0000454", "mdfy_qty": "000000000001", "dmst_stex_tp": "KRX", "return_code": 0, "return_msg": "매수정정 주문입력이 완료되었습니다" 436 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 신용주문 > 신용 취소주문(kt10009) API 명 신용 취소주문 API ID kt10009 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/crdordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body dmst_stex_tp 국내거래소구분 String Y 3 KRX,NXT,SOR Body orig_ord_no 원주문번호 String Y 7 Body stk_cd 종목코드 String Y 12 Body cncl_qty 취소수량 String Y 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... '0' 입력시 잔량 전부 취소 Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body base_orig_ord_no 모주문번호 String N 7 Body cncl_qty 취소수량 String N 12 Request Example { } Description "dmst_stex_tp": "KRX", "orig_ord_no": "0001615", "stk_cd": "005930", "cncl_qty": "1" Response Example 437 / 528 Response Example { } "ord_no": "0001695", "base_orig_ord_no": "0001614", "cncl_qty": "000000000001", "return_code": 0, "return_msg": "매도취소 주문입력이 완료되었습니다." 438 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 신용융자 가능종목요청(kt20016) API 명 신용융자 가능종목요청 API ID kt20016 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body crd_stk_grde_tp 신용종목등급구분 String N 1 %:전체, A:A군, B:B군, C:C군, D:D군, E:E군 Body mrkt_deal_tp 시장거래구분 String Y 1 %:전체, 1:코스피, 0:코스닥 Body stk_cd 종목코드 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body crd_loan_able 신용융자가능여부 String N 40 Body crd_loan_pos_stk 신용융자가능종목 LIST N Body - stk_cd 종목코드 String N 12 Body - stk_nm 종목명 String N 40 Body - crd_assr_rt 신용보증금율 String N 4 Body - repl_pric 대용가 String N 12 Body - pred_close_pric 전일종가 String N 12 Body - crd_limit_over_yn 신용한도초과여부 String N 1 Body - crd_limit_over_txt 신용한도초과 String N 40 439 / 528 N:공란,Y:회사한도 초과 Request Example { } "crd_stk_grde_tp": "A", "mrkt_deal_tp": "%", "stk_cd": "039490" Response Example { } "crd_loan_able": "", "crd_loan_pos_stk": [ { "stk_cd": "A039490", "stk_nm": "키움증권", "crd_assr_rt": "45%", "repl_pric": "000000087390", "pred_close_pric": "000000117500", "crd_limit_over_yn": "N", "crd_limit_over_txt": "" }, { "stk_cd": "A039490", "stk_nm": "키움증권", "crd_assr_rt": "45%", "repl_pric": "000000069420", "pred_close_pric": "000000105400", "crd_limit_over_yn": "N", "crd_limit_over_txt": "" }, ], "return_code": 0, "return_msg": "조회가 완료 되었습니다. 연속자료가 존재합니다." 440 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 종목정보 > 신용융자 가능문의(kt20017) API 명 신용융자 가능문의 API ID kt20017 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/stkinfo Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body crd_alow_yn 신용가능여부 String N 40 Request Example { } "stk_cd": "039490" Response Example { } Description "crd_alow_yn": "< A군 신용융자 가능 >", "return_code": 0, "return_msg": "조회가 완료 되었습니다." 441 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 금현물 매수주문(kt50000) API 명 금현물 매수주문 API ID kt50000 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 12 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body ord_qty 주문수량 String Y 12 Body ord_uv 주문단가 String N 12 Body trde_tp 매매구분 String Y 2 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 00:보통, 10:보통(IOC), 20:보통(FOK) Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Request Example { } "stk_cd": "M04020000", "ord_qty": "1", "ord_uv": "160000", "trde_tp": "00" Response Example { Description "ord_no": "0000010", "return_code": 0, 442 / 528 Response Example } "return_msg": "매수주문이 완료되었습니다." 443 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 금현물 매도주문(kt50001) API 명 금현물 매도주문 API ID kt50001 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 12 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body ord_qty 주문수량 String Y 12 Body ord_uv 주문단가 String N 12 Body trde_tp 매매구분 String Y 2 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 00:보통, 10:보통(IOC), 20:보통(FOK) Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Request Example { } "stk_cd": "M04020000", "ord_qty": "1", "ord_uv": "160000", "trde_tp": "00" Response Example { Description "ord_no": "0000016", "return_code": 0, 444 / 528 Response Example } "return_msg": "매도주문이 완료되었습니다." 445 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 금현물 정정주문(kt50002) API 명 금현물 정정주문 API ID kt50002 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body stk_cd 종목코드 String Y 12 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body orig_ord_no 원주문번호 String Y 7 Body mdfy_qty 정정수량 String Y 12 Body mdfy_uv 정정단가 String Y 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body base_orig_ord_no 모주문번호 String N 7 Body mdfy_qty 정정수량 String N 12 Request Example { } Description "stk_cd": "M04020000", "orig_ord_no": "0000012", "mdfy_qty": "1", "mdfy_uv": "150000" Response Example 446 / 528 Response Example { } "ord_no": "0000013", "base_orig_ord_no": "0000012", "mdfy_qty": "000000000001", "return_code": 0, "return_msg": "매수정정 주문입력이 완료되었습니다" 447 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 주문 > 금현물 취소주문(kt50003) API 명 금현물 취소주문 API ID kt50003 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/ordr Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body orig_ord_no 원주문번호 String Y 7 Body stk_cd 종목코드 String Y 12 M04020000 금 99.99_1kg, M04020100 미니금 99.99_100g Body cncl_qty 취소수량 String Y 12 '0' 입력시 잔량 전부 취소 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body ord_no 주문번호 String N 7 Body base_orig_ord_no 모주문번호 String N 7 Body cncl_qty 취소수량 String N 12 Request Example { } "orig_ord_no": "0000014", "stk_cd": "M04020000", "cncl_qty": "1" Response Example { Description "ord_no": "0000015", 448 / 528 Response Example } "base_orig_ord_no": "0000014", "cncl_qty": "000000000001", "return_code": 0, "return_msg": "매수취소주문입력이 완료되었습니다" 449 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 금현물 잔고확인(kt50020) API 명 금현물 잔고확인 API ID kt50020 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body tot_entr 예수금 String N 12 Body net_entr 추정예수금 String N 12 Body tot_est_amt 잔고평가액 String N 12 Body net_amt 예탁자산평가액 String N 12 Body tot_book_amt2 총매입금액 String N 12 Body tot_dep_amt 추정예탁자산 String N 12 Body paym_alowa 출금가능금액 String N 12 Body pl_amt 실현손익 String N 12 Body gold_acnt_evlt_prst 금현물계좌평가현황 LIST N Body - stk_cd 종목코드 String N 30 Body - stk_nm 종목명 String N 12 Body - real_qty 보유수량 String N 12 450 / 528 Response 구분 Element 한글명 Type Require d Length Body - avg_prc 평균단가 String N 12 Body - cur_prc 현재가 String N 12 Body - est_amt 평가금액 String N 12 Body - est_lspft 손익금액 String N 12 Body - est_ratio 손익율 String N 12 Body - cmsn 수수료 String N 12 Body - vlad_tax 부가가치세 String N 12 Body - book_amt2 매입금액 String N 12 Body - pl_prch_prc 손익분기매입가 String N 12 Body - qty 결제잔고 String N 12 Body - buy_qty 매수수량 String N 12 Body - sell_qty 매도수량 String N 12 Body - able_qty 가능수량 String N 12 Request Example {} Response Example { "tot_entr": "000098740486", "net_entr": "000098740486", "tot_est_amt": "000001207273", "net_amt": "000099955866", "tot_book_amt2": "000001254780", "tot_dep_amt": "000099951884", "paym_alowa": "000098740486", "pl_amt": "000000000000", "gold_acnt_evlt_prst": [ { "stk_cd": "M04020000", "stk_nm": "금 99.99_1Kg", "real_qty": "000000000002", "avg_prc": "000000152385", "cur_prc": "000000151780", "est_amt": "000000301569", "est_lspft": "-00000003201", "est_ratio": "-1.0503", "cmsn": "000000001810", "vlad_tax": "000000000181", "book_amt2": "000000304770", "pl_prch_prc": "153380.50", "qty": "000000000002", "buy_qty": "000000000000", "sell_qty": "000000000000", "able_qty": "000000000002" }, { "stk_cd": "M04020100", "stk_nm": "미니금 99.99_100g", "real_qty": "000000000006", "avg_prc": "000000158335", "cur_prc": "000000151970", "est_amt": "000000905704", "est_lspft": "-00000044306", "est_ratio": "-4.6637", "cmsn": "000000005560", "vlad_tax": "000000000556", "book_amt2": "000000950010", "pl_prch_prc": "159354.33", "qty": "000000000006", "buy_qty": "000000000000", 451 / 528 Description Response Example "sell_qty": "000000000000", "able_qty": "000000000006" } } ], "return_code": 0, "return_msg": "조회가 완료되었습니다." 452 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 금현물 예수금(kt50021) API 명 금현물 예수금 API ID kt50021 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body entra 예수금 String N 15 Body profa_ch 증거금현금 String N 15 Body chck_ina_amt 수표입금액 String N 15 Body etc_loan 기타대여금 String N 15 Body etc_loan_dlfe 기타대여금연체료 String N 15 Body etc_loan_tot 기타대여금합계 String N 15 Body prsm_entra 추정예수금 String N 15 Body buy_exct_amt 매수정산금 String N 15 Body sell_exct_amt 매도정산금 String N 15 Body sell_buy_exct_amt 매도매수정산금 String N 15 Body dly_amt 미수변제소요금 String N 15 Body prsm_pymn_alow_a mt 추정출금가능금액 String N 15 453 / 528 Response 구분 Element 한글명 Type Require d Length Body pymn_alow_amt 출금가능금액 String N 15 Body ord_alow_amt 주문가능금액 String N 15 Request Example {} Response Example { } "entra": "000000098740486", "profa_ch": "000000000000000", "chck_ina_amt": "000000000000000", "etc_loan": "000000000000000", "etc_loan_dlfe": "000000000000000", "etc_loan_tot": "000000000000000", "prsm_entra": "000000098740486", "buy_exct_amt": "000000000000000", "sell_exct_amt": "000000000000000", "sell_buy_exct_amt": "000000000000000", "dly_amt": "000000000000000", "prsm_pymn_alow_amt": "000000098740486", "pymn_alow_amt": "000000098740486", "ord_alow_amt": "000000098740486", "return_code": 0, "return_msg": "조회가 완료되었습니다." 454 / 528 Description 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 금현물 주문체결전체조회(kt50030) API 명 금현물 주문체결전체조회 API ID kt50030 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body ord_dt 주문일자 String Y 8 Body qry_tp 조회구분 String N 1 Body mrkt_deal_tp 시장구분 String Y 1 Body stk_bond_tp 주식채권구분 String Y 1 0:전체, 1:주식, 2:채권 Body slby_tp 매도수구분 String Y 1 0:전체, 1:매도, 2:매수 Body stk_cd 종목코드 String N 12 Body fr_ord_no 시작주문번호 String N 7 Body dmst_stex_tp 국내거래소구분 String N 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 1: 주문순, 2: 역순 %:(전체), KRX, NXT, SOR Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acnt_ord_cntr_prst 계좌별주문체결현황 LIST N Body - stk_bond_tp 주식채권구분 String N 1 Body - ord_no 주문번호 String N 7 Body - stk_cd 상품코드 String N 12 455 / 528 Response 구분 Element 한글명 Type Require d Length Body - trde_tp 매매구분 String N 12 Body - io_tp_nm 주문유형구분 String N 20 Body - ord_qty 주문수량 String N 10 Body - ord_uv 주문단가 String N 10 Body - cnfm_qty 확인수량 String N 10 Body - data_send_end_tp 접수구분 String N 12 Body - mrkt_deal_tp 시장구분 String N 1 Body - rsrv_tp 예약/반대여부 String N 4 Body - orig_ord_no 원주문번호 String N 7 Body - stk_nm 종목명 String N 40 Body - dcd_tp_nm 결제구분 String N 4 Body - crd_deal_tp 신용거래구분 String N 20 Body - cntr_qty 체결수량 String N 10 Body - cntr_uv 체결단가 String N 10 Body - ord_remnq 미체결수량 String N 10 Body - comm_ord_tp 통신구분 String N 10 Body - mdfy_cncl_tp 정정취소구분 String N 20 Body - dmst_stex_tp 국내거래소구분 String N 6 Body - cond_uv 스톱가 String N 10 Request Example { } "ord_dt": "20250821", "qry_tp": "1", "mrkt_deal_tp": "1", "stk_bond_tp": "0", "slby_tp": "0", "stk_cd": "M04020000", "fr_ord_no": "", "dmst_stex_tp": "KRX" Response Example { "acnt_ord_cntr_prst": [ { "stk_bond_tp": "1", "ord_no": "0000010", "stk_cd": "M04020000", "trde_tp": "지정가", "io_tp_nm": "매수", "ord_qty": "0000000001", "ord_uv": "0000140000", "cnfm_qty": "0000000000", "data_send_end_tp": "접수", "mrkt_deal_tp": "5", "rsrv_tp": "", "orig_ord_no": "0000000", "stk_nm": "금 99.99_1Kg", "dcd_tp_nm": "당일", "crd_deal_tp": "", "cntr_qty": "0000000000", "cntr_uv": "0000000000", "ord_remnq": "", 456 / 528 Description Response Example }, { } "comm_ord_tp": "REST API", "mdfy_cncl_tp": "", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" "stk_bond_tp": "1", "ord_no": "0000011", "stk_cd": "M04020000", "trde_tp": "지정가", "io_tp_nm": "매수", "ord_qty": "0000000001", "ord_uv": "0000140000", "cnfm_qty": "0000000000", "data_send_end_tp": "접수", "mrkt_deal_tp": "5", "rsrv_tp": "", "orig_ord_no": "0000000", "stk_nm": "금 99.99_1Kg", "dcd_tp_nm": "당일", "crd_deal_tp": "", "cntr_qty": "0000000000", "cntr_uv": "0000000000", "ord_remnq": "", "comm_ord_tp": "REST API", "mdfy_cncl_tp": "", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" }, ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 457 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 금현물 주문체결조회(kt50031) API 명 금현물 주문체결조회 API ID kt50031 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body ord_dt 주문일자 String N 8 YYYYMMDD Body qry_tp 조회구분 String Y 1 1:주문순, 2:역순, 3:미체결, 4:체결내역만 Body stk_bond_tp 주식채권구분 String Y 1 0:전체, 1:주식, 2:채권 Body sell_tp 매도수구분 String Y 1 0:전체, 1:매도, 2:매수 Body stk_cd 종목코드 String N 12 공백허용 (공백일때 전체종목) Body fr_ord_no 시작주문번호 String N 7 공백허용 (공백일때 전체주문) Body dmst_stex_tp 국내거래소구분 String Y 6 %:(전체),KRX:한국거래소,NXT:넥스트트레이드,SOR:최선주문 집행 Description 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Response 구분 Element 한글명 Type Require d Length Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acnt_ord_cntr_prps_ dtl 계좌별주문체결내역 상세 LIST N Body - ord_no 주문번호 String N 7 Body - stk_cd 종목번호 String N 12 Body - trde_tp 매매구분 String N 20 458 / 528 Response 구분 Element 한글명 Type Require d Length Body - crd_tp 신용구분 String N 20 Body - ord_qty 주문수량 String N 10 Body - ord_uv 주문단가 String N 10 Body - cnfm_qty 확인수량 String N 10 Body - acpt_tp 접수구분 String N 20 Body - rsrv_tp 반대여부 String N 20 Body - ord_tm 주문시간 String N 8 Body - ori_ord 원주문 String N 7 Body - stk_nm 종목명 String N 40 Body - io_tp_nm 주문구분 String N 20 Body - loan_dt 대출일 String N 8 Body - cntr_qty 체결수량 String N 10 Body - cntr_uv 체결단가 String N 10 Body - ord_remnq 주문잔량 String N 10 Body - comm_ord_tp 통신구분 String N 20 Body - mdfy_cncl 정정취소 String N 20 Body - cnfm_tm 확인시간 String N 8 Body - dmst_stex_tp 국내거래소구분 String N 8 Body - cond_uv 스톱가 String N 10 Request Example { } "ord_dt": "20250821", "qry_tp": "1", "stk_bond_tp": "0", "sell_tp": "0", "stk_cd": "M04020000", "fr_ord_no": "", "dmst_stex_tp": "%" Response Example { "acnt_ord_cntr_prps_dtl": [ { "ord_no": "0000010", "stk_cd": "M04020000", "trde_tp": "지정가", "crd_tp": "보통매매", "ord_qty": "0000000001", "ord_uv": "0000140000", "cnfm_qty": "0000000000", "acpt_tp": "접수", "rsrv_tp": "", "ord_tm": "13:20:37", "ori_ord": "0000000", "stk_nm": "금 99.99_1Kg", "io_tp_nm": "매수", "loan_dt": "", "cntr_qty": "0000000000", "cntr_uv": "0000000000", "ord_remnq": "0000000000", "comm_ord_tp": "REST API", "mdfy_cncl": "", 459 / 528 Description Response Example }, { }, } "cnfm_tm": "", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" "ord_no": "0000011", "stk_cd": "M04020000", "trde_tp": "지정가", "crd_tp": "보통매매", "ord_qty": "0000000001", "ord_uv": "0000140000", "cnfm_qty": "0000000000", "acpt_tp": "접수", "rsrv_tp": "", "ord_tm": "13:20:39", "ori_ord": "0000000", "stk_nm": "금 99.99_1Kg", "io_tp_nm": "매수", "loan_dt": "", "cntr_qty": "0000000000", "cntr_uv": "0000000000", "ord_remnq": "0000000001", "comm_ord_tp": "REST API", "mdfy_cncl": "", "cnfm_tm": "", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 460 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 금현물 거래내역조회(kt50032) API 명 금현물 거래내역조회 API ID kt50032 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 각 일자별로 계좌번호/계좌일련번호/지점코드/종목코드/매도 매수구분/ 매체 값이 같은 거래끼리는 수수료 및 부가가치세가 합산됩니다. 또한, 각 합계는 마지막 거래 내역에만 노출됩니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body strt_dt 시작일자 String N 8 Body end_dt 종료일자 String N 8 Body tp 구분 String N 1 Body stk_cd 종목코드 String N 12 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 0:전체, 1:입출금, 2:출고, 3:매매, 4:매수, 5:매도, 6:입금, 7:출금 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acnt_print 계좌번호 String N 62 계좌번호 출력용 Body gold_trde_hist 금현물거래내역 LIST N Body - deal_dt 거래일자 String N Body - deal_no 거래번호 String N Body - rmrk_nm 적요명 String N Body - deal_qty 거래수량 String N Body - gold_spot_vat 금현물부가가치세 String N Body - exct_amt 정산금액 String N 461 / 528 Response 구분 Element 한글명 Type Require d Body - dly_sum 연체합 String N Body - entra_remn 예수금잔고 String N Body - mdia_nm 메체구분명 String N Body - orig_deal_no 원거래번호 String N Body - stk_nm 종목명 String N Body - uv_exrt 거래단가 String N Body - cmsn 수수료 String N Body - uncl_ocr 미수(원/g) String N Body - rpym_sum 변제합 String N Body - spot_remn 현물잔고 String N Body - proc_time 처리시간 String N Body - rcpy_no 출납번호 String N Body - stk_cd 종목코드 String N Body - deal_amt 거래금액 String N Body - tax_tot_amt 소득/주민세 String N Body - cntr_dt 체결일 String N Body - proc_brch_nm 처리점 String N Body - prcsr 처리자 String N Length Request Example { } "strt_dt": "20250819", "end_dt": "20250820", "tp": "0", "stk_cd": "" Response Example { "acnt_print": "****-****-** [***]", "gold_trde_hist": [ { "deal_dt": "20250905", "deal_no": "000000001", "rmrk_nm": "금현물매수", "deal_qty": "000000000000008", "gold_spot_vat": "000000000000382", "exct_amt": "000000001278522", "dly_sum": "000000000000000", "entra_remn": "000000097004944", "mdia_nm": "REST API", "orig_deal_no": "000000000", "stk_nm": "금99.99_1Kg", "uv_exrt": "159290.00", "cmsn": "000000000003820", "uncl_ocr": "000000000000000", "rpym_sum": "000000000000000", "spot_remn": "000000000000012", "proc_time": "17:40:04", "rcpy_no": "000000000", "stk_cd": "M04020000", "deal_amt": "000000001274320", "tax_tot_amt": "000000000000000", "cntr_dt": "20250905", "proc_brch_nm": "온라인지점13", 462 / 528 Description Response Example }, { } "prcsr": "DAILY" "deal_dt": "20250908", "deal_no": "000000001", "rmrk_nm": "금현물매도", "deal_qty": "000000000000003", "gold_spot_vat": "000000000000000", "exct_amt": "000000000000000", "dly_sum": "000000000000000", "entra_remn": "000000097004944", "mdia_nm": "REST API", "orig_deal_no": "000000000", "stk_nm": "금99.99_1Kg", "uv_exrt": "161700.00", "cmsn": "000000000000000", "uncl_ocr": "000000000000000", "rpym_sum": "000000000000000", "spot_remn": "000000000000009", "proc_time": "17:40:05", "rcpy_no": "000000000", "stk_cd": "M04020000", "deal_amt": "000000000485100", "tax_tot_amt": "000000000000000", "cntr_dt": "20250908", "proc_brch_nm": "온라인지점13", "prcsr": "DAILY" }, ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 463 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 계좌 > 금현물 미체결조회(kt50075) API 명 금현물 미체결조회 API ID kt50075 기본정보 Method POST 운영 도메인 https://api.kiwoom.com 모의투자 도메인 https://mockapi.kiwoom.com(KRX만 지원가능) URL /api/dostk/acnt Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body ord_dt 주문일자 String Y 8 Body qry_tp 조회구분 String N 1 Body mrkt_deal_tp 시장구분 String Y 1 Body stk_bond_tp 주식채권구분 String Y 1 0:전체, 1:주식, 2:채권 Body sell_tp 매도수구분 String Y 1 0:전체, 1:매도, 2:매수 Body stk_cd 종목코드 String N 12 Body fr_ord_no 시작주문번호 String N 7 Body dmst_stex_tp 국내거래소구분 String N 6 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 1: 주문순, 2: 역순 %:(전체), KRX, NXT, SOR Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body acnt_ord_oso_prst 계좌별주문미체결현 황 LIST N Body - stk_bond_tp 주식채권구분 String N 1 Body - ord_no 주문번호 String N 7 Body - stk_cd 상품코드 String N 12 464 / 528 Response 구분 Element 한글명 Type Require d Length Body - trde_tp 매매구분 String N 12 Body - io_tp_nm 주문유형구분 String N 20 Body - ord_qty 주문수량 String N 10 Body - ord_uv 주문단가 String N 10 Body - cnfm_qty 확인수량 String N 10 Body - data_send_end_tp 접수구분 String N 12 Body - mrkt_deal_tp 시장구분 String N 1 Body - rsrv_tp 예약/반대여부 String N 4 Body - orig_ord_no 원주문번호 String N 7 Body - stk_nm 종목명 String N 40 Body - dcd_tp_nm 결제구분 String N 4 Body - crd_deal_tp 신용거래구분 String N 20 Body - cntr_qty 체결수량 String N 10 Body - cntr_uv 체결단가 String N 10 Body - ord_remnq 미체결수량 String N 10 Body - comm_ord_tp 통신구분 String N 10 Body - mdfy_cncl_tp 정정취소구분 String N 20 Body - dmst_stex_tp 국내거래소구분 String N 6 Body - cond_uv 스톱가 String N 10 Request Example { } "ord_dt": "20250821", "qry_tp": "1", "mrkt_deal_tp": "1", "stk_bond_tp": "0", "sell_tp": "0", "stk_cd": "M04020000", "fr_ord_no": "", "dmst_stex_tp": "KRX" Response Example { "acnt_ord_oso_prst": [ { "stk_bond_tp": "1", "ord_no": "0000016", "stk_cd": "M04020000", "trde_tp": "지정가", "io_tp_nm": "매수", "ord_qty": "0000000001", "ord_uv": "0000140000", "cnfm_qty": "0000000000", "data_send_end_tp": "접수", "mrkt_deal_tp": "5", "rsrv_tp": "", "orig_ord_no": "0000000", "stk_nm": "금 99.99_1Kg", "dcd_tp_nm": "당일", "crd_deal_tp": "", "cntr_qty": "0000000000", "cntr_uv": "0000000000", "ord_remnq": "0000000001", 465 / 528 Description Response Example }, { } "comm_ord_tp": "REST API", "mdfy_cncl_tp": "", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" "stk_bond_tp": "1", "ord_no": "0000015", "stk_cd": "M04020000", "trde_tp": "지정가", "io_tp_nm": "매수", "ord_qty": "0000000001", "ord_uv": "0000140000", "cnfm_qty": "0000000000", "data_send_end_tp": "접수", "mrkt_deal_tp": "5", "rsrv_tp": "", "orig_ord_no": "0000000", "stk_nm": "금 99.99_1Kg", "dcd_tp_nm": "당일", "crd_deal_tp": "", "cntr_qty": "0000000000", "cntr_uv": "0000000000", "ord_remnq": "0000000001", "comm_ord_tp": "REST API", "mdfy_cncl_tp": "", "dmst_stex_tp": "KRX", "cond_uv": "0000000000" }, ], "return_code": 0, "return_msg": "조회가 완료되었습니다" 466 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주문체결(00) API 명 주문체결 API ID 00 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 실시간 항목 00(주문체결)은 종목코드(item) 등록과 상관 없이 ACCESS TOKEN을 발급한 계좌에 주문 접수, 체결, 정정, 취소 등 매매가 발생할 경우 데이터가 수신됩니다. ACCESS TOKEN 발급과 상관없이 해당 종목의 체결내역을 보고싶으신 경우에 0B를 이용 부탁드립니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 등록(REG)시 0:기존유지안함 1:기존유지(Default) Body refresh 기존등록유지여부 String Y 1 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 String N 100 Body - type 실시간 항목 String Y 2 TR 명(0A,0B....) Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 467 / 528 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 Response 구분 Element 한글명 Type Require d Length Description 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 9201 계좌번호 String N Body - - 9203 주문번호 String N Body - - 9205 관리자사번 String N Body - - 9001 종목코드,업종코드 String N Body - - 912 주문업무분류 String N Body - - 913 주문상태 String N Body - - 302 종목명 String N Body - - 900 주문수량 String N Body - - 901 주문가격 String N Body - - 902 미체결수량 String N Body - - 903 체결누계금액 String N Body - - 904 원주문번호 String N TR 명(0A,0B....) 종목코드 접수, 체결, 확인, 취소, 거부 "+/-", 매도, 매수, 매도정정, 매수정정, 매수취소, 매도취소 Body - - 905 주문구분 String N ※ 영웅문4에서 적색으로 표기되어있으면 +가, 청색으로 표기되어있으면 -가 앞에 기재됩니다 Body - - 906 매매구분 String N 보통, 시장가, 조건부지정가, 최유리지정가, 최우선지정가, 보통(IOC), 시장가(IOC), 최유리(IOC), 보통(FOK), 시장가(FOK), 최유리(FOK), 스톰지정가, 중간가, 중간가(IOC), 중간가(FOK), 장전시간외, 장후시간외, 시간외대량, 시간외바스켓, 시간외자사주, 시간외단일가 Body - - 907 매도수구분 String N 1:매도, 2:매수 Body - - 908 주문/체결시간 String N Body - - 909 체결번호 String N Body - - 910 체결가 String N Body - - 911 체결량 String N Body - - 10 현재가 String N Body - - 27 (최우선)매도호가 String N Body - - 28 (최우선)매수호가 String N Body - - 914 단위체결가 String N Body - - 915 단위체결량 String N Body - - 938 당일매매수수료 String N 468 / 528 Response 구분 Element 한글명 Type Require d Length Body - - 939 당일매매세금 String N Body - - 919 거부사유 String N Body - - 920 화면번호 String N Body - - 921 터미널번호 String N Body - - 922 신용구분 String N 실시간 체결용 Body - - 923 대출일 String N 실시간 체결용 Body - - 10010 시간외단일가_현재가 String N Body - - 2134 거래소구분 String N 0:통합,1:KRX,2:NXT Body - - 2135 거래소구분명 String N 통합,KRX,NXT Body - - 2136 SOR여부 String N Y,N Request Example { } Description "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "" ], "type": [ "00" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data':[ { 'values': { '9201':'1111111111', '9203':'0000018', '9205':'', '9001':'005930', '912':'JJ', '913':'접수', '302':'삼성전자', '900':'1', '901':'0', '902':'1', '903':'0', '904':'0000000', '905':'+매수', '906':'시장가', '907':'2', '908':'094022', '909':'', '910':'', '911':'', '10':'+60700', '27':'+60700', '28':'-60000', '914':'', 469 / 528 Response Example '915':'', '938':'0', '939':'0', '919':'0', '920':'', '921':'0701002', '922':'00', '923':'00000000', '10010':'', '2134':'1', '2135':'KRX', '2136':'Y' }, 'type':'00', 'name':'주문체결', 'item':'005930' } } ], 'trnm': 'REAL' 470 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 잔고(04) API 명 잔고 API ID 04 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 실시간 항목 04(잔고)는 종목코드(item) 등록과 상관 없이 ACCESS TOKEN을 발급한 계좌에 주문 체결이 발생할 경우 데이터가 수신됩니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 등록(REG)시 0:기존유지안함 1:기존유지(Default) Body refresh 기존등록유지여부 String Y 1 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 String N 104 Body - type 실시간 항목 String Y 2 TR 명(0A,0B....) Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 471 / 528 Response 구분 Element 한글명 Type Require d Body trnm 서비스명 String N Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 9201 계좌번호 String N Body - - 9001 종목코드,업종코드 String N Body - - 917 신용구분 String N Body - - 916 대출일 String N Body - - 302 종목명 String N Body - - 10 현재가 String N Body - - 930 보유수량 String N Body - - 931 매입단가 String N Body - - 932 총매입가(당일누적) String N Body - - 933 주문가능수량 String N Body - - 945 당일순매수량 String N Body - - 946 매도/매수구분 String N Body - - 950 당일총매도손익 String N Body - - 951 Extra Item String N Body - - 27 (최우선)매도호가 String N Body - - 28 (최우선)매수호가 String N Body - - 307 기준가 String N Body - - 8019 손익률(실현손익) String N Body - - 957 신용금액 String N Body - - 958 신용이자 String N Body - - 918 만기일 String N Body - - 990 당일실현손익(유가) String N Body - - 991 당일실현손익율(유가 ) String N Body - - 992 당일실현손익(신용) String N Body - - 993 당일실현손익율(신용 ) String N Body - - 959 담보대출수량 String N Body - - 924 Extra Item String N Length Request Example { "trnm": "REG", "grp_no": "1", 472 / 528 Description 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 TR 명(0A,0B....) 종목코드 계약,주 Request Example } "refresh": "1", "data": [ { "item": [ "" ], "type": [ "04" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '9201': '1111111111', '9001': '005930', '917': '00', '916': '00000000', '302': '삼성전자', '10': '-60150', '930': '102', '931': '154116', '932': '15719834', '933': '102', '945': '4', '946': '2', '950': '0', '951': '0', '27': '-60200', '28': '-60100', '307': '60300', '8019': '0.00', '957': '0', '958': '0', '918': '00000000', '990': '0', '991': '0.00', '992': '0', '993': '0.00', '959': '0', '924': '0' }, 'type': '04', 'name': '현물잔고', 'item': '005930' } ], 'trnm': 'REAL' } 473 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식기세(0A) API 명 주식기세 API ID 0A 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 특정 종목이 기세일때 발생하는 데이터로 시장에서 체결없이 현재가가 변경되는 대량매매나 거래소에서 종목 종가데이터 보정시 발생하는 실시간 입니다. Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 등록(REG)시 0:기존유지안함 1:기존유지(Default) Body refresh 기존등록유지여부 String Y 1 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) Body - type 실시간 항목 String Y 2 TR 명(0A,0B....) Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 474 / 528 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Response 구분 Element 한글명 Type Require d Length Body return_msg 결과메시지 String N 통신결과에대한메시지(등록,해지시에만 값 전송,데이터 실시간 수신시 미전송) Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 10 현재가 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Body - - 27 (최우선)매도호가 String N Body - - 28 (최우선)매수호가 String N Body - - 13 누적거래량 String N Body - - 14 누적거래대금 String N Body - - 16 시가 String N Body - - 17 고가 String N Body - - 18 저가 String N Body - - 25 전일대비기호 String N Body - - 26 전일거래량대비(계약 ,주) String N Body - - 29 거래대금증감 String N Body - - 30 전일거래량대비(비율 ) String N Body - - 31 거래회전율 String N Body - - 32 거래비용 String N Body - - 311 시가총액(억) String N Body - - 567 상한가발생시간 String N Body - - 568 하한가발생시간 String N Request Example { } Description "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0A" ] } ] Response Example 475 / 528 TR 명(0A,0B....) 종목코드 Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '10': '+86800', '11': '+19500', '12': '+28.97', '27': '+85200', '28': '+85100', '13': '367090', '14': '31642', '16': '+87400', '17': '+87400', '18': ' 67300', '25': '2', '26': '+131995', '29': '+15843118000', '30': '+156.15', '31': '0.01', '32': '157', '311': '5181771', '567': '154912', '568': '000000' }, 'type': '0A', 'name': '주식기세', 'item': '005930' } ], 'trnm': 'REAL' } 476 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식체결(0B) API 명 주식체결 API ID 0B 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 477 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 20 체결시간 String N Body - - 10 현재가 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Body - - 27 (최우선)매도호가 String N Body - - 28 (최우선)매수호가 String N Body - - 15 거래량 String N Body - - 13 누적거래량 String N Body - - 14 누적거래대금 String N Body - - 16 시가 String N Body - - 17 고가 String N Body - - 18 저가 String N Body - - 25 전일대비기호 String N Body - - 26 전일거래량대비(계약 ,주) String N Body - - 29 거래대금증감 String N Body - - 30 전일거래량대비(비율 ) String N Body - - 31 거래회전율 String N Body - - 32 거래비용 String N Body - - 228 체결강도 String N Body - - 311 시가총액(억) String N Body - - 290 장구분 String N Body - - 691 K.O 접근도 String N Body - - 567 상한가발생시간 String N Body - - 568 하한가발생시간 String N Body - - 851 전일 동시간 거래량 비율 String N Body - - 1890 시가시간 String N Body - - 1891 고가시간 String N Body - - 1892 저가시간 String N Body - - 1030 매도체결량 String N Body - - 1031 매수체결량 String N 478 / 528 Length Description TR 명(0B,0B....) 종목코드 +는 매수체결,-는 매도체결 1: 장전 시간외 , 2: 장중 , 3: 장후 시간외 Response 구분 Element 한글명 Type Require d Body - - 1032 매수비율 String N Body - - 1071 매도체결건수 String N Body - - 1072 매수체결건수 String N Body - - 1313 순간거래대금 String N Body - - 1315 매도체결량_단건 String N Body - - 1316 매수체결량_단건 String N Body - - 1314 순매수체결량 String N Body - - 1497 CFD증거금 String N Body - - 1498 유지증거금 String N Body - - 620 당일거래평균가 String N Body - - 732 CFD거래비용 String N Body - - 852 대주거래비용 String N Body - - 9081 거래소구분 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0B" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'trnm': 'REAL', 'data': [ { 'type': '0B', 'name': '주식체결', 'item': '005930', 'values': { '20': '165208', '10': '-20800', '11': '-50', '12': '-0.24', '27': '-20800', '28': '-20700', '15': '+82', '13': '30379732', '14': '632640', '16': '20850', '17': '+21150', '18': '-20450', '25': '5', 479 / 528 Description Response Example } ] } } '26': '-1057122', '29': '-22041267850', '30': '-96.64', '31': '36.67', '32': '44', '228': '98.92', '311': '17230', '290': '2', '691': '0', '567': '000000', '568': '000000', '851': '', '1890': '', '1891': '', '1892': '', '1030': '', '1031': '', '1032': '', '1071': '', '1072': '', '1313': '', '1315': '', '1316': '', '1314': '', '1497': '', '1498': '', '620': '', '732': '', '852': '', '9081': '1' 480 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식우선호가(0C) API 명 주식우선호가 API ID 0C 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 481 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 27 (최우선)매도호가 String N Body - - 28 (최우선)매수호가 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0C" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'trnm': 'REAL', 'data': [ { 'type': '0C', 'name': '주식우선호가', 'item': '005930', 'values': { '27': '-20800', '28': '-20700' } } ] } 482 / 528 Description TR 명(0A,0B....) 종목코드 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식호가잔량(0D) API 명 주식호가잔량 API ID 0D 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 483 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 21 호가시간 String N Body - - 41 매도호가1 String N Body - - 61 매도호가수량1 String N Body - - 81 매도호가직전대비1 String N Body - - 51 매수호가1 String N Body - - 71 매수호가수량1 String N Body - - 91 매수호가직전대비1 String N Body - - 42 매도호가2 String N Body - - 62 매도호가수량2 String N Body - - 82 매도호가직전대비2 String N Body - - 52 매수호가2 String N Body - - 72 매수호가수량2 String N Body - - 92 매수호가직전대비2 String N Body - - 43 매도호가3 String N Body - - 63 매도호가수량3 String N Body - - 83 매도호가직전대비3 String N Body - - 53 매수호가3 String N Body - - 73 매수호가수량3 String N Body - - 93 매수호가직전대비3 String N Body - - 44 매도호가4 String N Body - - 64 매도호가수량4 String N Body - - 84 매도호가직전대비4 String N Body - - 54 매수호가4 String N Body - - 74 매수호가수량4 String N Body - - 94 매수호가직전대비4 String N Body - - 45 매도호가5 String N Body - - 65 매도호가수량5 String N Body - - 85 매도호가직전대비5 String N Body - - 55 매수호가5 String N Body - - 75 매수호가수량5 String N Body - - 95 매수호가직전대비5 String N Body - - 46 매도호가6 String N 484 / 528 Length Description TR 명(0A,0B....) 종목코드 Response 구분 Element 한글명 Type Require d Body - - 66 매도호가수량6 String N Body - - 86 매도호가직전대비6 String N Body - - 56 매수호가6 String N Body - - 76 매수호가수량6 String N Body - - 96 매수호가직전대비6 String N Body - - 47 매도호가7 String N Body - - 67 매도호가수량7 String N Body - - 87 매도호가직전대비7 String N Body - - 57 매수호가7 String N Body - - 77 매수호가수량7 String N Body - - 97 매수호가직전대비7 String N Body - - 48 매도호가8 String N Body - - 68 매도호가수량8 String N Body - - 88 매도호가직전대비8 String N Body - - 58 매수호가8 String N Body - - 78 매수호가수량8 String N Body - - 98 매수호가직전대비8 String N Body - - 49 매도호가9 String N Body - - 69 매도호가수량9 String N Body - - 89 매도호가직전대비9 String N Body - - 59 매수호가9 String N Body - - 79 매수호가수량9 String N Body - - 99 매수호가직전대비9 String N Body - - 50 매도호가10 String N Body - - 70 매도호가수량10 String N Body - - 60 매수호가10 String N Body - - 90 매도호가직전대비10 String N Body - - 80 매수호가수량10 String N Body - - 100 매수호가직전대비10 String N Body - - 121 매도호가총잔량 String N Body - - 122 매도호가총잔량직전 대비 String N Body - - 125 매수호가총잔량 String N Body - - 126 매수호가총잔량직전 대비 String N Body - - 23 예상체결가 String N Body - - 24 예상체결수량 String N Body - - 128 순매수잔량 String N 485 / 528 Length Description Response 구분 Element 한글명 Type Require d Body - - 129 매수비율 String N Body - - 138 순매도잔량 String N Body - - 139 매도비율 String N Body - - 200 예상체결가전일종가 대비 String N Body - - 201 예상체결가전일종가 대비등락율 String N Body - - 238 예상체결가전일종가 대비기호 String N Body - - 291 예상체결가 String N Body - - 292 예상체결량 String N Body - - 293 예상체결가전일대비 기호 String N Body - - 294 예상체결가전일대비 String N Body - - 295 예상체결가전일대비 등락율 String N Body - - 621 LP매도호가수량1 String N Body - - 631 LP매수호가수량1 String N Body - - 622 LP매도호가수량2 String N Body - - 632 LP매수호가수량2 String N Body - - 623 LP매도호가수량3 String N Body - - 633 LP매수호가수량3 String N Body - - 624 LP매도호가수량4 String N Body - - 634 LP매수호가수량4 String N Body - - 625 LP매도호가수량5 String N Body - - 635 LP매수호가수량5 String N Body - - 626 LP매도호가수량6 String N Body - - 636 LP매수호가수량6 String N Body - - 627 LP매도호가수량7 String N Body - - 637 LP매수호가수량7 String N Body - - 628 LP매도호가수량8 String N Body - - 638 LP매수호가수량8 String N Body - - 629 LP매도호가수량9 String N Body - - 639 LP매수호가수량9 String N Body - - 630 LP매도호가수량10 String N Body - - 640 LP매수호가수량10 String N Body - - 13 누적거래량 String N Body - - 299 전일거래량대비예상 체결율 String N Body - - 215 장운영구분 String N 486 / 528 Length Description 예상체결 시간동안에만 유효한 값 Response 구분 Element 한글명 Type Require d Body - - 216 투자자별ticker String N Body - - 6044 KRX 매도호가잔량1 String N Body - - 6045 KRX 매도호가잔량2 String N Body - - 6046 KRX 매도호가잔량3 String N Body - - 6047 KRX 매도호가잔량4 String N Body - - 6048 KRX 매도호가잔량5 String N Body - - 6049 KRX 매도호가잔량6 String N Body - - 6050 KRX 매도호가잔량7 String N Body - - 6051 KRX 매도호가잔량8 String N Body - - 6052 KRX 매도호가잔량9 String N Body - - 6053 KRX 매도호가잔량10 String N Body - - 6054 KRX 매수호가잔량1 String N Body - - 6055 KRX 매수호가잔량2 String N Body - - 6056 KRX 매수호가잔량3 String N Body - - 6057 KRX 매수호가잔량4 String N Body - - 6058 KRX 매수호가잔량5 String N Body - - 6059 KRX 매수호가잔량6 String N Body - - 6060 KRX 매수호가잔량7 String N Body - - 6061 KRX 매수호가잔량8 String N Body - - 6062 KRX 매수호가잔량9 String N Body - - 6063 KRX 매수호가잔량10 String N Body - - 6064 KRX 매도호가총잔량 String N Body - - 6065 KRX 매수호가총잔량 String N Body - - 6066 NXT 매도호가잔량1 String N Body - - 6067 NXT 매도호가잔량2 String N Body - - 6068 NXT 매도호가잔량3 String N Body - - 6069 NXT 매도호가잔량4 String N Body - - 6070 NXT 매도호가잔량5 String N Body - - 6071 NXT 매도호가잔량6 String N Body - - 6072 NXT 매도호가잔량7 String N Body - - 6073 NXT 매도호가잔량8 String N Body - - 6074 NXT 매도호가잔량9 String N Body - - 6075 NXT 매도호가잔량10 String N Body - - 6076 NXT 매수호가잔량1 String N Body - - 6077 NXT 매수호가잔량2 String N Body - - 6078 NXT 매수호가잔량3 String N Body - - 6079 NXT 매수호가잔량4 String N 487 / 528 Length Description Response 구분 Element 한글명 Type Require d Length Body - - 6080 NXT 매수호가잔량5 String N Body - - 6081 NXT 매수호가잔량6 String N Body - - 6082 NXT 매수호가잔량7 String N Body - - 6083 NXT 매수호가잔량8 String N Body - - 6084 NXT 매수호가잔량9 String N Body - - 6085 NXT 매수호가잔량10 String N Body - - 6086 NXT 매도호가총잔량 String N Body - - 6087 NXT 매수호가총잔량 String N Body - - 6100 KRX 중간가 매도 총잔량 증감 String N Body - - 6101 KRX 중간가 매도 총잔량 String N Body - - 6102 KRX 중간가 String N Body - - 6103 KRX 중간가 매수 총잔량 String N Body - - 6104 KRX 중간가 매수 총잔량 증감 String N Body - - 6105 NXT중간가 매도 총잔량 증감 String N Body - - 6106 NXT중간가 매도 총잔량 String N Body - - 6107 NXT중간가 String N Body - - 6108 NXT중간가 매수 총잔량 String N Body - - 6109 NXT중간가 매수 총잔량 증감 String N Body - - 6110 KRX중간가대비 String N 기준가대비 Body - - 6111 KRX중간가대비 기호 String N 기준가대비 Body - - 6112 KRX중간가대비등락 율 String N 기준가대비 Body - - 6113 NXT중간가대비 String N 기준가대비 Body - - 6114 NXT중간가대비 기호 String N 기준가대비 Body - - 6115 NXT중간가대비등락 율 String N 기준가대비 Request Example { Description "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0D" ] } ] 488 / 528 Request Example } Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'trnm': 'REAL', 'data': [ { 'type': '0D', 'name': '주식호가잔량', 'item': '005930', 'values': { '21': '165207', '41': '-20800', '61': '82', '81': '0', '51': '-20700', '71': '23847', '91': '0', '42': '+20900', '62': '393', '82': '0', '52': '-20650', '72': '834748', '92': '0', '43': '+21000', '63': '674739', '83': '0', '53': '-20600', '73': '2145799', '93': '0', '44': '+21050', '64': '2055055', '84': '0', '54': '-20550', '74': '2134689', '94': '0', '45': '+21100', '65': '1998461', '85': '0', '55': '-20500', '75': '1982298', '95': '0', '46': '+21150', '66': '1932347', '86': '0', '56': '-20450', '76': '1853788', '96': '0', '47': '+21200', '67': '1723333', '87': '0', '57': '-20400', '77': '1687992', '97': '0', '48': '+21250', '68': '1621835', '88': '0', '58': '-20350', '78': '1467869', '98': '0', '49': '+21300', '69': '1373291', '89': '0', '59': '-20300', '79': '1259995', '99': '0', '50': '+21350', '70': '1242991', '90': '0', '60': '-20250', 489 / 528 Response Example '80': '1062405', '100': '0', '121': '12622527', '122': '-1036021', '125': '14453430', '126': '+1062126', '23': '20850', '24': '332941', '128': '+1830903', '129': '114.51', '138': '-1830903', '139': '87.33', '200': '0', '201': '0.00', '238': '3', '291': '0', '292': '0', '293': '3', '294': '0', '295': '0.00', '621': '0', '631': '0', '622': '0', '632': '0', '623': '0', '633': '0', '624': '0', '634': '0', '625': '0', '635': '0', '626': '0', '636': '0', '627': '0', '637': '0', '628': '0', '638': '0', '629': '0', '639': '0', '630': '0', '640': '0', '13': '30379650', '299': '-1.06', '215': '', '216': '', '6044':'0', '6045':'0', '6046':'0', '6047':'0', '6048':'0', '6049':'0', '6050':'0', '6051':'0', '6052':'0', '6053':'0', '6054':'0', '6055':'0', '6056':'0', '6057':'0', '6058':'0', '6059':'0', '6060':'0', '6061':'0', '6062':'0', '6063':'0', '6064':'0', '6065':'0', '6066':'0', '6067':'0', '6068':'0', '6069':'0', '6070':'0', '6071':'0', '6072':'0', '6073':'0', '6074':'0', '6075':'0', '6076':'0', '6077':'0', '6078':'0', 490 / 528 Response Example } ] } } '6079':'0', '6080':'0', '6081':'0', '6082':'0', '6083':'0', '6084':'0', '6085':'0', '6086':'0', '6087':'0', '6100':'0', '6101':'0', '6102':'0', '6103':'0', '6104':'0', '6105':'0', '6106':'0', '6107':'0', '6108':'0', '6109':'0', '6110':'0', '6111':'0', '6112':'0', '6113':'0', '6114':'0', '6115':'0' 491 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식시간외호가(0E) API 명 주식시간외호가 API ID 0E 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 492 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 21 호가시간 String N Body - - 131 시간외매도호가총잔 량 String N Body - - 132 시간외매도호가총잔 량직전대비 String N Body - - 135 시간외매수호가총잔 량 String N Body - - 136 시간외매수호가총잔 량직전대비 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0E" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'trnm': 'REAL', 'data': [ { 'type': '0E', 'name': '주식시간외호가', 'item': '005930', 'values': { '21': '165208', '131': '43955', '132': '+156', '135': '0', '136': '0' } } ] } 493 / 528 Description TR 명(0A,0B....) 거래소별 종목코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식당일거래원(0F) API 명 주식당일거래원 API ID 0F 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 494 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 141 매도거래원1 String N Body - - 161 매도거래원수량1 String N Body - - 166 매도거래원별증감1 String N Body - - 146 매도거래원코드1 String N Body - - 271 매도거래원색깔1 String N Body - - 151 매수거래원1 String N Body - - 171 매수거래원수량1 String N Body - - 176 매수거래원별증감1 String N Body - - 156 매수거래원코드1 String N Body - - 281 매수거래원색깔1 String N Body - - 142 매도거래원2 String N Body - - 162 매도거래원수량2 String N Body - - 167 매도거래원별증감2 String N Body - - 147 매도거래원코드2 String N Body - - 272 매도거래원색깔2 String N Body - - 152 매수거래원2 String N Body - - 172 매수거래원수량2 String N Body - - 177 매수거래원별증감2 String N Body - - 157 매수거래원코드2 String N Body - - 282 매수거래원색깔2 String N Body - - 143 매도거래원3 String N Body - - 163 매도거래원수량3 String N Body - - 168 매도거래원별증감3 String N Body - - 148 매도거래원코드3 String N Body - - 273 매도거래원색깔3 String N Body - - 153 매수거래원3 String N Body - - 173 매수거래원수량3 String N Body - - 178 매수거래원별증감3 String N Body - - 158 매수거래원코드3 String N Body - - 283 매수거래원색깔3 String N Body - - 144 매도거래원4 String N Body - - 164 매도거래원수량4 String N 495 / 528 Length Description TR 명(0A,0B....) 종목코드 Response 구분 Element 한글명 Type Require d Body - - 169 매도거래원별증감4 String N Body - - 149 매도거래원코드4 String N Body - - 274 매도거래원색깔4 String N Body - - 154 매수거래원4 String N Body - - 174 매수거래원수량4 String N Body - - 179 매수거래원별증감4 String N Body - - 159 매수거래원코드4 String N Body - - 284 매수거래원색깔4 String N Body - - 145 매도거래원5 String N Body - - 165 매도거래원수량5 String N Body - - 170 매도거래원별증감5 String N Body - - 150 매도거래원코드5 String N Body - - 275 매도거래원색깔5 String N Body - - 155 매수거래원5 String N Body - - 175 매수거래원수량5 String N Body - - 180 매수거래원별증감5 String N Body - - 160 매수거래원코드5 String N Body - - 285 매수거래원색깔5 String N Body - - 261 외국계매도추정합 String N Body - - 262 외국계매도추정합변 동 String N Body - - 263 외국계매수추정합 String N Body - - 264 외국계매수추정합변 동 String N Body - - 267 외국계순매수추정합 String N Body - - 268 외국계순매수변동 String N Body - - 337 거래소구분 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0F" ] } ] Response Example #요청 { 496 / 528 Description Response Example } 'trnm': 'REG', 'return_code': 0, 'return_msg': '' #실시간 수신 { 'trnm': 'REAL', 'data': [ { 'type': '0F', 'name': '주식당일거래원', 'item': '005930', 'values': { '141': '', '161': '9350409', '166': '+8593585', '146': '993', '271': '!!!!', '151': '', '171': '9321128', '176': '+8557163', '156': '993', '281': '!!!!', '142': '', '162': '9341349', '167': '-9060', '147': '994', '272': '!!!!', '152': '', '172': '9315193', '177': '-5935', '157': '991', '282': '!!!!', '143': '', '163': '9305540', '168': '-35809', '148': '991', '273': '!!!!', '153': '', '173': '9301275', '178': '-13918', '158': '994', '283': '!!!!', '144': '', '164': '757643', '169': '-8547897', '149': '992', '274': '!!!!', '154': '', '174': '763965', '179': '-8537310', '159': '992', '284': '!!!!', '145': '미래에셋', '165': '100', '170': '0', '150': '005', '275': '!!!!', '155': '미래에셋', '175': '50100', '180': '0', '160': '005', '285': '!!!!', '261': '0', '262': '0', '263': '0', '264': '0', '267': '0', '268': '0', '337': '2' } } ] } 497 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > ETF NAV(0G) API 명 ETF NAV API ID 0G 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 498 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 36 NAV String N Body - - 37 NAV전일대비 String N Body - - 38 NAV등락율 String N Body - - 39 추적오차율 String N Body - - 20 체결시간 String N Body - - 10 현재가 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Body - - 13 누적거래량 String N Body - - 25 전일대비기호 String N Body - - 667 ELW기어링비율 String N Body - - 668 ELW손익분기율 String N Body - - 669 ELW자본지지점 String N Body - - 265 NAV/지수괴리율 String N Body - - 266 NAV/ETF괴리율 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "069500" ], "type": [ "0G" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '36': '+7488.27', '37': '+9.57', 499 / 528 Description TR 명(0A,0B....) 종목코드 Response Example '38': '+0.13', '39': '1.82', '20': '105732', '10': '+7485', '11': '+45', '12': '+0.60', '13': '16874', '25': '2', '265': '+10.04', '266': '-0.04' }, 'type': '0G', 'name': 'ETF NAV', 'item': '069500' } } ], 'trnm': 'REAL' 500 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식예상체결(0H) API 명 주식예상체결 API ID 0H 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 501 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 20 체결시간 String N Body - - 10 현재가 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Body - - 15 거래량 String N Body - - 13 누적거래량 String N Body - - 25 전일대비기호 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0H" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '20': '110206', '10': '+60500', '11': '+200', '12': '+0.33', '15': '-7805', '13': '768293', '25': '2' }, 'type': '0H', 'name': '주식예상체결', 'item': '005930' } ], 'trnm': 'REAL' } 502 / 528 Description TR 명(0A,0B....) 종목코드 +는 매수체결, -는 매도체결 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 국제금환산가격(0I) API 명 국제금환산가격 API ID 0I 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 N 100 MGD: 원/g, MGU: $/온스,소수점2자리 Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Y Body data 실시간 등록 리스트 LIST N Body - item 실시간 등록 요소 String Body - type 실시간 항목 String Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N 503 / 528 TR 명(0B,0B....) Response 구분 Element 한글명 Type Require d Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 10 현재가 String N Body - - 25 전일대비기호 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "MGD" ], "type": [ "0I" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '10': '-337782', '25': '5', '11': '-1674', '12': '-0.49' }, 'type': '0I', 'name': '국제금환산가격', 'item': 'MGU' } ], 'trnm': 'REAL' } 504 / 528 Description 종목코드 1:상한, 2:상승, 3:없음, 4:하한, 5:하락 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 업종지수(0J) API 명 업종지수 API ID 0J 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 505 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 20 체결시간 String N Body - - 10 현재가 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Body - - 15 거래량 String N Body - - 13 누적거래량 String N Body - - 14 누적거래대금 String N Body - - 16 시가 String N Body - - 17 고가 String N Body - - 18 저가 String N Body - - 25 전일대비기호 String N Body - - 26 전일거래량대비 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "001" ], "type": [ "0J" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '20': '110430', '10': '-1762.61', '11': '-189.51', '12': '-9.71', '15': '2800', '13': '725277', '14': '60711859', '16': '-1949.04', 506 / 528 Description TR 명(0A,0B....) 종목코드 +는 매수체결,-는 매도체결 계약,주 Response Example '17': '+1961.28', '18': '-1756.13', '25': '5', '26': '-1482363' }, 'type': '0J', 'name': '업종지수', 'item': '001' } } ], 'trnm': 'REAL' 507 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 업종등락(0U) API 명 업종등락 API ID 0U 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 508 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 20 체결시간 String N Body - - 252 상승종목수 String N Body - - 251 상한종목수 String N Body - - 253 보합종목수 String N Body - - 255 하락종목수 String N Body - - 254 하한종목수 String N Body - - 13 누적거래량 String N Body - - 14 누적거래대금 String N Body - - 10 현재가 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Body - - 256 거래형성종목수 String N Body - - 257 거래형성비율 String N Body - - 25 전일대비기호 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "001" ], "type": [ "0U" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '20': '110710', '252': '46', '251': '1', '253': '166', 509 / 528 Description TR 명(0A,0B....) 종목코드 계약,주 Response Example '255': '204', '254': '16', '13': '741784', '14': '62093941', '10': '-1757.42', '11': '-194.70', '12': '-9.97', '256': '416', '257': '43.20', '25': '5' }, 'type': '0U', 'name': '업종등락', 'item': '001' } } ], 'trnm': 'REAL' 510 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 주식종목정보(0g) API 명 주식종목정보 API ID 0g 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 511 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 297 임의연장 String N Body - - 592 장전임의연장 String N Body - - 593 장후임의연장 String N Body - - 305 상한가 String N Body - - 306 하한가 String N Body - - 307 기준가 String N Body - - 689 조기종료ELW발생 String N Body - - 594 통화단위 String N Body - - 382 증거금율표시 String N Body - - 370 종목정보 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0g" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '297': '동정적VI', '592': ' ', '593': ' ', '305': '+78300', '306': '-42300', '307': '60300', '689': '', '594': '', '382': '', '370': '' }, 'type': '0g', 512 / 528 Description TR 명(0A,0B....) 종목코드 Response Example 'name': '주식종목정보', 'item': '005930' } } ], 'trnm': 'REAL' 513 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > ELW 이론가(0m) API 명 ELW 이론가 API ID 0m 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 514 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 20 체결시간 String N Body - - 10 현재가 String N Body - - 670 ELW이론가 String N Body - - 671 ELW내재변동성 String N Body - - 672 ELW델타 String N Body - - 673 ELW감마 String N Body - - 674 ELW쎄타 String N Body - - 675 ELW베가 String N Body - - 676 ELW로 String N Body - - 706 LP호가내재변동성 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "57JBHH" ], "type": [ "0m" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '20': '140000', '10': ' 450', '670': '0', '671': '0.00', '672': '0', '673': '0', '674': '0.000000', '675': '0.000000', '676': '0.000000', '706': ' 0.00' }, 'type': '0m', 515 / 528 Description TR 명(0A,0B....) 종목코드 Response Example 'name': 'ELW 이론가', 'item': '57JBHH' } } ], 'trnm': 'REAL' 516 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 장시작시간(0s) API 명 장시작시간 API ID 0s 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 517 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 215 장운영구분 String N Body - - 20 체결시간 String N Body - - 214 장시작예상잔여시간 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "" ], "type": [ "0s" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data':[ { 'values': { '215':'b', '20':'170000', '214':'000000' }, 'type':'0s', 'name':'장시작시간', 'item':'' 518 / 528 Description TR 명(0A,0B....) 종목코드 0 : 장시작전 알림(8:40~), 3 : 장시작(09:00), 2 : 장마감 알림(15:20~), 4 : 장마감(15:30), 8 : 정규장마감(거래소 수신시 15:30 이후), 9 : 전체장마감(거래소 수신시 18:00 이후), a : 시간외 종가매매 시작(15:40), b : 시간외 종가매매 종료(16:00), c : 시간외 단일가 시작(16:00), d : 시간외 단일가 종료(18:00), e : 선옵 장마감전 동시호가 종료, f : 선물옵션 장운영시간 알림(조기개장 상품), o : 선옵 장시작, s : 선옵 장마감전 동시호가 시작, P : NXT 프리마켓 시작 알림, Q : NXT 프리마켓 종료 알림, R : NXT 메인마켓 시작 알림, S : NXT 메인마켓 종료 알림, T : NXT 에프터마켓 단일가 시작 알림, U : NXT 에프터마켓 시작 알림, V : NXT 에프터마켓 종료 알림 Response Example } } ], 'trnm': 'REAL' 519 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > ELW 지표(0u) API 명 ELW 지표 API ID 0u 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 520 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 20 체결시간 String N Body - - 666 ELW패리티 String N Body - - 1211 ELW프리미엄 String N Body - - 667 ELW기어링비율 String N Body - - 668 ELW손익분기율 String N Body - - 669 ELW자본지지점 String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "57JBHH" ], "type": [ "0u" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ { 'values': { '20': '111847', '666': '69.13', '1211': '0', '667': '1037.04', '668': '+44.73', '669': '+44.78' }, 'type': '0u', 'name': 'ELW 지표', 'item': '57JBHH' } ], 'trnm': 'REAL' } 521 / 528 Description TR 명(0A,0B....) 종목코드 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > 종목프로그램매매(0w) API 명 종목프로그램매매 API ID 0w 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 522 / 528 Response 구분 Element 한글명 Type Require d Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 20 체결시간 String N Body - - 10 현재가 String N Body - - 25 전일대비기호 String N Body - - 11 전일대비 String N Body - - 12 등락율 String N Body - - 13 누적거래량 String N Body - - 202 매도수량 String N Body - - 204 매도금액 String N Body - - 206 매수수량 String N Body - - 208 매수금액 String N Body - - 210 순매수수량 String N Body - - 211 순매수수량증감 String N Body - - 212 순매수금액 String N Body - - 213 순매수금액증감 String N Body - - 214 장시작예상잔여시간 String N Body - - 215 장운영구분 String N Body - - 216 투자자별ticker String N Length Request Example { } "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "005930" ], "type": [ "0w" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' } #실시간 수신 { 'data': [ 523 / 528 Description TR 명(0A,0B....) 종목코드 계약,주 Response Example { } 'values': { '20': '113442', '10': '-60200', '25': '5', '11': '-100', '12': '-0.17', '13': '128152628', '202': '0', '204': '0', '206': '8043', '208': '483', '210': '8043', '212': '483', '213': '0', '211': '0' }, 'type': '0w', 'name': '종목별프로그램매매', 'item': '005930' } ], 'trnm': 'REAL' 524 / 528 키움 REST API API 정보 메뉴 위치 국내주식 > 실시간시세 > VI발동/해제(1h) API 명 VI발동/해제 API ID 1h 기본정보 Method POST 운영 도메인 wss://api.kiwoom.com:10000 모의투자 도메인 wss://mockapi.kiwoom.com:10000(KRX만 지원가능) URL /api/dostk/websocket Format JSON Content-Type application/json;charset=UTF-8 개요 Request 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header authorization 접근토큰 String Y 1000 Header cont-yn 연속조회여부 String N 1 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 cont-yn값 세팅 Header next-key 연속조회키 String N 50 응답 Header의 연속조회여부값이 Y일 경우 다음데이터 요청시 응답 Header의 next-key값 세팅 Body trnm 서비스명 String Y 10 REG : 등록 , REMOVE : 해지 Body grp_no 그룹번호 String Y 4 토큰 지정시 토큰타입("Bearer") 붙혀서 호출 예) Bearer Egicyx... Y 1 등록(REG)시 0:기존유지안함 1:기존유지(Default) 0일경우 기존등록한 item/type은 해지, 1일경우 기존등록한 item/type 유지 해지(REMOVE)시 값 불필요 String N 100 거래소별 종목코드, 업종코드 (KRX:039490,NXT:039490_NX,SOR:039490_AL) String Y 2 TR 명(0A,0B....) Body refresh 기존등록유지여부 String Body data 실시간 등록 리스트 LIST Body - item 실시간 등록 요소 Body - type 실시간 항목 Response 구분 Element 한글명 Type Require d Length Description Header api-id TR명 String Y 10 Header cont-yn 연속조회여부 String N 1 다음 데이터가 있을시 Y값 전달 Header next-key 연속조회키 String N 50 다음 데이터가 있을시 다음 키값 전달 Body return_code 결과코드 String N 통신결과에대한 코드 (등록,해지요청시에만 값 전송 0:정상,1:오류 , 데이터 실시간 수신시 미전송) Body return_msg 결과메시지 String N 통신결과에대한메시지 Body trnm 서비스명 String N 등록,해지요청시 요청값 반환 , 실시간수신시 REAL 반환 525 / 528 Response 구분 Element 한글명 Type Require d Length Body data 실시간 등록리스트 LIST N Body - type 실시간항목 String N Body - name 실시간 항목명 String N Body - item 실시간 등록 요소 String N Body - values 실시간 값 리스트 LIST N Body - - 9001 종목코드 String N Body - - 302 종목명 String N Body - - 13 누적거래량 String N Body - - 14 누적거래대금 String N Body - - 9068 VI발동구분 String N Body - - 9008 KOSPI,KOSDAQ,전체 구분 String N Body - - 9075 장전구분 String N Body - - 1221 VI발동가격 String N Body - - 1223 매매체결처리시각 String N Body - - 1224 VI해제시각 String N Body - - 1225 VI적용구분 String N 정적/동적/동적+정적 Body - - 1236 기준가격 정적 String N 계약,주 Body - - 1237 기준가격 동적 String N Body - - 1238 괴리율 정적 String N Body - - 1239 괴리율 동적 String N Body - - 1489 VI발동가 등락율 String N Body - - 1490 VI발동횟수 String N Body - - 9069 발동방향구분 String N Body - - 1279 Extra Item String N Request Example { } Description "trnm": "REG", "grp_no": "1", "refresh": "1", "data": [ { "item": [ "" ], "type": [ "1h" ] } ] Response Example #요청 { 'trnm': 'REG', 'return_code': 0, 'return_msg': '' 526 / 528 TR 명(0A,0B....) 종목코드 Response Example } #실시간 수신 { 'data': [ { 'values': { '9001':'005930', '302':'삼성전자', '13':'1077818', '14':'4201', '9068':'1', '9008':'101', '9075':'1', '1221':'4125', '1223':'111454', '1224':'111703', '1225':'정적', '1236':'3750', '1237':'0', '1238':'+10.00', '1239':'0.00', '1489':'+10.00', '1490':'1', '9069':'1', '1279':'+정적' }, 'type':'1h', 'name':'VI발동/해제', 'item':'005930' } ], 'trnm':'REAL' } 527 / 528 키움 REST API No, 오류코드 오류메시지 1 1501 API ID가 Null이거나 값이 없습니다 2 1504 해당 URI에서는 지원하는 API ID가 아닙니다. API ID={?}, URI={?} 3 1505 해당 API ID는 존재하지 않습니다. API ID={?} 4 1511 필수 입력 값에 값이 존재하지 않습니다. 필수입력 파라미터={?} 5 1512 Http header에 값이 설정되지 않았거나 읽을 수 없습니다 6 1513 Http Header에 authorization 필드가 설정되어 있어야 합니다 7 1514 입력으로 들어온 Http Header의 authorization 필드 형식이 맞지 않습니다 8 1515 Http Header의 authorization 필드 내 Grant Type이 미리 정의된 형식이 아닙니다 9 1516 Http Header의 authorization 필드 내 Token이 정의되어 있지 않습니다 10 1517 입력 값 형식이 올바르지 않습니다. 파라미터={?} 실패사유= {?} 11 1687 재귀 호출이 발생하여 API 호출을 제한합니다, API ID={?} 12 1700 허용된 요청 개수를 초과하였습니다. API ID={?} 13 1901 시장 코드값이 존재하지 않습니다. 종목코드={?} 14 1902 종목 정보가 없습니다. 입력한 종목코드 값을 확인바랍니다. 종목코드={?} 15 1999 예기치 못한 에러가 발생했습니다. 실패사유={?} 16 8001 App Key와 Secret Key 검증에 실패했습니다 17 8002 App Key와 Secret Key 검증에 실패했습니다. 실패사유={?} 18 8003 Access Token을 조회하는데 실패했습니다. 실패사유={?} 19 8005 Token이 유효하지 않습니다 20 8006 Access Token을 생성하는데 실패했습니다. 실패사유={?} 21 8009 Access Token을 발급하는데 실패했습니다. 실패사유={?} 22 8010 Token을 발급받은 IP와 서비스를 요청한 IP가 동일하지 않습니다 23 8011 Access Token을 발급하는데 실패했습니다. 입력값에 grant_type이 들어오지 않았습니다 24 8012 Access Token을 발급하는데 실패했습니다. grant_type의 값이 맞지 않습니다 25 8015 Access Token을 폐기하는데 실패했습니다. 실패사유={?} 26 8016 Access Token을 폐기하는데 실패했습니다. 입력값에 Token이 들어오지 않았습니다 27 8020 입력파라미터로 appkey 또는 secretkey가 들어오지 않았습니다. 28 8030 투자구분(실전/모의)이 달라서 Appkey를 사용할수가 없습니다 29 8031 투자구분(실전/모의)이 달라서 Token를 사용할수가 없습니다 30 8040 단말기 인증에 실패했습니다 31 8050 지정단말기 인증에 실패했습니다 32 8103 토큰 인증 또는 단말기인증에 실패했습니다. 실패사유={?} 528 / 528