api.theme — 테마 (Theme)¶
요청·응답 필드는 키움 공식 REST API 명세에서 만든 TR 카탈로그(출처·라이선스)에서 옮긴 필드 ID·한글명·필수·길이입니다. 필드 설명·코드값은 싣지 않으니 키움 REST API 포털 문서를 보세요(자주 쓰는 코드값은 kiwoom_client.codes). 값은 모두 문자열로 넘깁니다.
공통 헤더(api-id·cont-yn·next-key·authorization)는 라이브러리가 채웁니다 — 연속조회는 메서드의 cont_yn·next_key 인자나 request_all() 을 쓰세요.
| api_id | 메서드 | 이름 |
|---|---|---|
ka90001 |
theme_group_list() |
테마그룹별요청 |
ka90002 |
theme_component_stocks() |
테마구성종목요청 |
ka90001 · theme_group_list() — 테마그룹별요청¶
테마그룹별요청 (Theme Group List) · POST /api/dostk/thme
요청
| 필드 | 한글명 | 필수 | 길이 |
|---|---|---|---|
qry_tp |
검색구분 | Y | 1 |
stk_cd |
종목코드 | 6 | |
date_tp |
날짜구분 | Y | 2 |
thema_nm |
테마명 | 50 | |
flu_pl_amt_tp |
등락수익구분 | Y | 1 |
stex_tp |
거래소구분 | Y | 1 |
응답
| 필드 | 한글명 | 길이 |
|---|---|---|
thema_grp (list) |
테마그룹별 | |
thema_grp[].thema_grp_cd |
테마그룹코드 | 20 |
thema_grp[].thema_nm |
테마명 | 20 |
thema_grp[].stk_num |
종목수 | 20 |
thema_grp[].flu_sig |
등락기호 | 20 |
thema_grp[].flu_rt |
등락율 | 20 |
thema_grp[].rising_stk_num |
상승종목수 | 20 |
thema_grp[].fall_stk_num |
하락종목수 | 20 |
thema_grp[].dt_prft_rt |
기간수익률 | 20 |
thema_grp[].main_stk |
주요종목 | 20 |
ka90002 · theme_component_stocks() — 테마구성종목요청¶
테마구성종목요청 (Theme Component Stocks) · POST /api/dostk/thme
요청
| 필드 | 한글명 | 필수 | 길이 |
|---|---|---|---|
date_tp |
날짜구분 | 1 | |
thema_grp_cd |
테마그룹코드 | Y | 6 |
stex_tp |
거래소구분 | Y | 1 |
응답
| 필드 | 한글명 | 길이 |
|---|---|---|
flu_rt |
등락률 | 20 |
dt_prft_rt |
기간수익률 | 20 |
thema_comp_stk (list) |
테마구성종목 | |
thema_comp_stk[].stk_cd |
종목코드 | 20 |
thema_comp_stk[].stk_nm |
종목명 | 40 |
thema_comp_stk[].cur_prc |
현재가 | 20 |
thema_comp_stk[].flu_sig |
등락기호 | 20 |
thema_comp_stk[].pred_pre |
전일대비 | 20 |
thema_comp_stk[].flu_rt |
등락율 | 20 |
thema_comp_stk[].acc_trde_qty |
누적거래량 | 20 |
thema_comp_stk[].sel_bid |
매도호가 | 20 |
thema_comp_stk[].sel_req |
매도잔량 | 20 |
thema_comp_stk[].buy_bid |
매수호가 | 20 |
thema_comp_stk[].buy_req |
매수잔량 | 20 |
thema_comp_stk[].dt_prft_rt_n |
기간수익률n | 20 |