키움 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

