모델 (models)¶
요청·응답 데이터 구조 및 타입 별칭을 정의하는 모듈입니다.
kiwoompy.models
¶
kiwoompy 공통 데이터 모델 — 타입 별칭 및 TR별 요청/응답 dataclass.
AccountNo
¶
계좌번호. "12345678-01" 형식 (8자리 계좌번호 + 상품코드).
입력값 정규화는 :func:kiwoompy.utils.normalize_account_no 사용.
AfterAmtQtyType
¶
금액수량구분 (장마감후투자자별).
"amount": 금액 — API"1""qty": 수량 — API"2"
AfterTradeType
¶
장마감후 매매구분.
"net_buy": 순매수 — API"0""buy": 매수 — API"1""sell": 매도 — API"2"
AmtQtyType
¶
금액수량구분 (종목별투자자기관별).
"amount": 금액 — API"1""qty": 수량 — API"2"
ChartAdjustedPrice
¶
수정주가구분.
"adjusted": 수정주가 반영 — API"1""raw": 미반영 — API"0"
ChartAmtQtyType
¶
금액수량구분 (투자자 차트).
"amount": 금액 — API"1""qty": 수량 — API"2"
ChartMinScope
¶
주식 분봉 범위.
"1": 1분"3": 3분"5": 5분"10": 10분"15": 15분"30": 30분"45": 45분"60": 60분
ChartSectorMarket
¶
업종차트 시장구분.
"kospi": 코스피 — API"0""kosdaq": 코스닥 — API"1""kospi200": 코스피200 — API"2"
ChartTickScope
¶
주식/업종 틱 범위.
"1": 1틱"3": 3틱"5": 5틱"10": 10틱"30": 30틱
ChartTradeType
¶
매매구분 (투자자 차트).
"net_buy": 순매수 — API"0""buy": 매수 — API"1""sell": 매도 — API"2"
ChartUnitType
¶
단위구분 (종목별투자자기관별차트).
"thousand": 천주 — API"1000""single": 단주 — API"1"
CreditQueryType
¶
신용매매동향 조회구분.
"loan": 융자 — API"1""short": 대주 — API"2"
CreditStockGradeType
¶
신용종목등급구분.
"%": 전체"A"~"E": 각 등급
DisplayType
¶
일별주가 표시구분.
"qty": 수량 — API"0""amount": 금액(백만원) — API"1"
ElwRightType
¶
ELW 권리구분.
"all": 전체 (000)"call": 콜 (001)"put": 풋 (002)"dc": DC (003)"dp": DP (004)"ex": EX (005)"early_call": 조기종료콜 (006)"early_put": 조기종료풋 (007)
ElwSortType
¶
ElwSortType = Literal['rise_rate', 'rise_gap', 'fall_rate', 'fall_gap', 'volume', 'amount', 'expire']
ELW 정렬구분.
"rise_rate": 상승율순 (1)"rise_gap": 상승폭순 (2)"fall_rate": 하락율순 (3)"fall_gap": 하락폭순 (4)"volume": 거래량순 (5)"amount": 거래대금순 (6)"expire": 잔존일순 (7)
EstimatedPriceType
¶
추정단가구분.
"buy": 매수단가 — API"1""sell": 매도단가 — API"2"
EtfDuration
¶
ETF 기간구분.
"1w": 1주 (0)"1m": 1달 (1)"6m": 6개월 (2)"1y": 1년 (3)
FrgnDuration
¶
기관/외국인 연속매매 기간.
"1": 최근 1일"3": 3일"5": 5일"10": 10일"20": 20일"120": 120일"custom": 시작일자/종료일자로 직접 지정 ("0"전달)
FrgnStockSectType
¶
기관/외국인 종목업종구분.
"stock": 종목(주식) (0)"sector": 업종 (1)
GoldOrderTradeType
¶
금현물 매매구분.
"normal": 보통 (00)"normal_ioc": 보통(IOC) (10)"normal_fok": 보통(FOK) (20)
GoldStockCode
¶
금현물 종목코드.
"M04020000": 금 99.99_1kg"M04020100": 미니금 99.99_100g
HighLowSelectType
¶
신고저구분.
"high": 신고가 — API"1""low": 신저가 — API"2"
InstitutionTradeType
¶
기관 매매구분 (순매도/순매수).
"sell": 순매도 — API"1""buy": 순매수 — API"2"
IntraAmtQtyType
¶
금액수량구분 (장중투자자별).
"amount_qty": 금액&수량 — API"1"
InvestorTradeType
¶
종목별투자자 매매구분.
"net_buy": 순매수 — API"0""buy": 매수 — API"1""sell": 매도 — API"2"
InvestorType
¶
InvestorType = Literal['foreign', 'institution', 'trust', 'insurance', 'bank', 'pension', 'gov', 'other_corp']
투자자별 (장중투자자별).
"foreign": 외국인 — API"6""institution": 기관계 — API"7""trust": 투신 — API"1""insurance": 보험 — API"0""bank": 은행 — API"2""pension": 연기금 — API"3""gov": 국가 — API"4""other_corp": 기타법인 — API"5"
InvestorType2
¶
InvestorType2 = Literal['individual', 'foreign', 'financial_inv', 'trust', 'private_fund', 'other_fin', 'bank', 'insurance', 'pension', 'gov', 'other_corp', 'institution']
투자자구분 (투자자별일별매매종목).
"individual": 개인 — API"8000""foreign": 외국인 — API"9000""financial_inv": 금융투자 — API"1000""trust": 투신 — API"3000""private_fund": 사모펀드 — API"3100""other_fin": 기타금융 — API"5000""bank": 은행 — API"4000""insurance": 보험 — API"2000""pension": 연기금 — API"6000""gov": 국가 — API"7000""other_corp": 기타법인 — API"7100""institution": 기관계 — API"9999"
MrkcondExchangeType
¶
시세·종목정보 거래소구분.
"krx": KRX — API"1""nxt": NXT — API"2""all": 통합 — API"3"
MrktType3
¶
시장구분 3자리 코드 (전체/코스피/코스닥).
"all": 전체 — API"000""kospi": 코스피 — API"001""kosdaq": 코스닥 — API"101"
MrktType3Ext
¶
시장구분 3자리 (가격급등락용, KOSPI200 포함).
"all": 전체 — API"000""kospi": 코스피 — API"001""kosdaq": 코스닥 — API"101""kospi200": 코스피200 — API"201"
NewStockRightsType
¶
신주인수권구분.
"all": 전체 — API"00""rights_cert": 신주인수권증권 — API"05""rights_deed": 신주인수권증서 — API"07"
OrderExchange
¶
주문 국내거래소구분.
"KRX": 한국거래소"NXT": 넥스트트레이드"SOR": 최선주문집행
OrderTradeType
¶
OrderTradeType = Literal['limit', 'market', 'conditional', 'best', 'priority', 'limit_ioc', 'market_ioc', 'best_ioc', 'limit_fok', 'market_fok', 'best_fok', 'stop', 'mid', 'mid_ioc', 'mid_fok', 'pre_market', 'after_hours', 'post_market']
매매구분 (사람이 읽기 쉬운 키 → API 코드로 자동 변환됨).
"limit": 보통(지정가) — API"0""market": 시장가 — API"3""conditional": 조건부지정가 — API"5""best": 최유리지정가 — API"6""priority": 최우선지정가 — API"7""limit_ioc": 보통(IOC) — API"10""market_ioc": 시장가(IOC) — API"13""best_ioc": 최유리(IOC) — API"16""limit_fok": 보통(FOK) — API"20""market_fok": 시장가(FOK) — API"23""best_fok": 최유리(FOK) — API"26""stop": 스톱지정가 — API"28""mid": 중간가 — API"29""mid_ioc": 중간가(IOC) — API"30""mid_fok": 중간가(FOK) — API"31""pre_market": 장시작전시간외 — API"61""after_hours": 시간외단일가 — API"62""post_market": 장마감후시간외 — API"81"
PERType
¶
고저PER 구분.
"low_pbr": 저PBR — API"1""high_pbr": 고PBR — API"2""low_per": 저PER — API"3""high_per": 고PER — API"4""low_roe": 저ROE — API"5""high_roe": 고ROE — API"6"
RealtimeType
¶
RealtimeType = Literal['00', '04', '0A', '0B', '0C', '0D', '0E', '0F', '0G', '0H', '0I', '0J', '0U', '0g', '0m', '0s', '0u', '0w', '1h']
실시간 수신 TR 타입.
"00": 주문체결"04": 잔고"0A": 주식기세"0B": 주식체결"0C": 주식우선호가"0D": 주식호가잔량"0E": 주식시간외호가"0F": 주식당일거래원"0G": ETF NAV"0H": 주식예상체결"0I": 국제금환산가격"0J": 업종지수"0U": 업종등락"0g": 주식종목정보"0m": ELW 이론가"0s": 장시작시간"0u": ELW 지표"0w": 종목프로그램매매"1h": VI발동/해제
RkinfoBaseDateType
¶
기준일구분.
"today": 당일기준 — API"0""prev": 전일기준 — API"1"
RkinfoBidSortType
¶
호가잔량상위 정렬구분 (ka10020).
"net_buy_qty": 순매수잔량순 — API"1""net_sell_qty": 순매도잔량순 — API"2""buy_ratio": 매수비율순 — API"3""sell_ratio": 매도비율순 — API"4"
RkinfoBidTradeType
¶
호가잔량급증 매매구분 (ka10021).
"buy": 매수잔량 — API"1""sell": 매도잔량 — API"2"
RkinfoMarketType
¶
순위정보 시장구분.
"all": 전체 — API"000""kospi": 코스피 — API"001""kosdaq": 코스닥 — API"101"
RkinfoOrgType
¶
RkinfoOrgType = Literal['foreign', 'foreign_corp', 'financial_inv', 'trust', 'other_finance', 'bank', 'insurance', 'pension', 'gov', 'other_corp', 'institution']
장중투자자별 기관구분 (ka10065).
"foreign": 외국인 — API"9000""foreign_corp": 외국계 — API"9100""financial_inv": 금융투자 — API"1000""trust": 투신 — API"3000""other_finance": 기타금융 — API"5000""bank": 은행 — API"4000""insurance": 보험 — API"2000""pension": 연기금 — API"6000""gov": 국가 — API"7000""other_corp": 기타법인 — API"7100""institution": 기관계 — API"9999"
RkinfoPriceChangeSortType
¶
전일대비등락률상위 정렬구분 (ka10027).
"rise_ratio": 상승률 — API"1""rise_gap": 상승폭 — API"2""fall_ratio": 하락률 — API"3""fall_gap": 하락폭 — API"4""flat": 보합 — API"5"
RkinfoSortCndType
¶
동일순매매 정렬조건 (ka10062).
"qty": 수량 — API"1""amount": 금액 — API"2"
RkinfoStexType
¶
순위정보 거래소구분.
"krx": KRX — API"1""nxt": NXT — API"2""all": 통합 — API"3"
RkinfoSurgeSort2Type
¶
급증 정렬구분 (ka10021/ka10022).
"surge_qty": 급증량 — API"1""surge_ratio": 급증률 — API"2"
SectAmtQtyType
¶
업종별 금액수량구분.
"amount": 금액 (0)"qty": 수량 (1)
SectExchangeType
¶
업종 거래소구분.
"krx": KRX (1)"nxt": NXT (2)"all": 통합 (3)
SectMrktType
¶
업종 시장구분.
"kospi": 코스피 (0)"kosdaq": 코스닥 (1)"kospi200": 코스피200 (2)
SectorMarketType
¶
업종코드 리스트 시장구분.
"kospi": 코스피(거래소) — API"0""kosdaq": 코스닥 — API"1""kospi200": KOSPI200 — API"2""kospi100": KOSPI100 — API"4""krx100": KRX100(통합지수) — API"7"
SlbMrktType
¶
대차거래 시장구분.
"kospi": 코스피 (001)"kosdaq": 코스닥 (101)
StkMarketType
¶
StkMarketType = Literal['kospi', 'kosdaq', 'kotc', 'konex', 'etn', 'loss_etn', 'gold', 'vol_etn', 'infra', 'elw', 'mutual_fund', 'rights', 'reit', 'etf', 'high_yield']
종목정보 리스트 시장구분.
"kospi": 코스피 — API"0""kosdaq": 코스닥 — API"10""kotc": K-OTC — API"30""konex": 코넥스 — API"50""etn": ETN — API"60""loss_etn": 손실제한 ETN — API"70""gold": 금현물 — API"80""vol_etn": 변동성 ETN — API"90""infra": 인프라투융자 — API"2""elw": ELW — API"3""mutual_fund": 뮤추얼펀드 — API"4""rights": 신주인수권 — API"5""reit": 리츠종목 — API"6""rights_deed": 신주인수권증서 — API"7""etf": ETF — API"8""high_yield": 하이일드펀드 — API"9"
ThemeSearchType
¶
테마 검색구분.
"all": 전체검색 (0)"theme": 테마검색 (1)"stock": 종목검색 (2)
TickMinType
¶
틱/분 구분.
"tick": 틱 — API"0""minute": 분 — API"1"
TodayPrevType
¶
당일전일구분.
"today": 당일 — API"1""prev": 전일 — API"2"
UnitType
¶
단위구분.
"thousand": 천주 — API"1000""single": 단주 — API"1"
AccountBalance
dataclass
¶
AccountBalance(tot_pur_amt: str, tot_evlt_amt: str, tot_evlt_pl: str, tot_prft_rt: str, prsm_dpst_aset_amt: str, tot_loan_amt: str, tot_crd_loan_amt: str, tot_crd_ls_amt: str, holdings: list[HoldingItem] = list())
계좌평가잔고내역 응답 (kt00018).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tot_pur_amt
|
str
|
총매입금액 (단위: 원). |
required |
tot_evlt_amt
|
str
|
총평가금액 (단위: 원). |
required |
tot_evlt_pl
|
str
|
총평가손익금액 (단위: 원). |
required |
tot_prft_rt
|
str
|
총수익률(%) (단위: %). |
required |
prsm_dpst_aset_amt
|
str
|
추정예탁자산 (단위: 원). |
required |
holdings
|
list[HoldingItem]
|
종목별 잔고 목록. |
list()
|
AccountEvaluation
dataclass
¶
AccountEvaluation(acnt_nm: str, brch_nm: str, entr: str, d2_entra: str, tot_est_amt: str, aset_evlt_amt: str, tot_pur_amt: str, prsm_dpst_aset_amt: str, tdy_lspft: str, tdy_lspft_rt: str, lspft_ratio: str, lspft_rt: str, holdings: list[AccountEvaluationItem] = list())
계좌평가현황 응답 (kt00004).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
acnt_nm
|
str
|
계좌명. |
required |
entr
|
str
|
예수금 (단위: 원). |
required |
aset_evlt_amt
|
str
|
예탁자산평가액 (단위: 원). |
required |
tot_pur_amt
|
str
|
총매입금액 (단위: 원). |
required |
prsm_dpst_aset_amt
|
str
|
추정예탁자산 (단위: 원). |
required |
tdy_lspft_rt
|
str
|
당일손익율 (단위: %). |
required |
holdings
|
list[AccountEvaluationItem]
|
종목별 평가 목록. |
list()
|
AccountEvaluationItem
dataclass
¶
AccountEvaluationItem(stk_cd: str, stk_nm: str, rmnd_qty: str, avg_prc: str, cur_prc: str, evlt_amt: str, pl_amt: str, pl_rt: str, loan_dt: str, pur_amt: str, setl_remn: str, pred_buyq: str, pred_sellq: str, tdy_buyq: str, tdy_sellq: str)
종목별계좌평가현황 항목 (kt00004 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
rmnd_qty
|
str
|
보유수량 (단위: 주). |
required |
avg_prc
|
str
|
평균단가 (단위: 원). |
required |
cur_prc
|
str
|
현재가 (단위: 원). |
required |
evlt_amt
|
str
|
평가금액 (단위: 원). |
required |
pl_amt
|
str
|
손익금액 (단위: 원). |
required |
pl_rt
|
str
|
손익율 (단위: %). |
required |
AccountNumbers
dataclass
¶
계좌번호조회 응답 (ka00001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
account_numbers
|
list[str]
|
계좌번호 목록. |
required |
AccountReturnItem
dataclass
¶
AccountReturnItem(dt: str, stk_cd: str, stk_nm: str, cur_prc: str, pur_pric: str, pur_amt: str, rmnd_qty: str, tdy_sel_pl: str, tdy_trde_cmsn: str, tdy_trde_tax: str, crd_tp: str, loan_dt: str, setl_remn: str, clrn_alow_qty: str, crd_amt: str, crd_int: str, expr_dt: str)
계좌수익률 항목 (ka10085 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (단위: 원). |
required |
pur_pric
|
str
|
매입가 (단위: 원). |
required |
rmnd_qty
|
str
|
보유수량 (단위: 주). |
required |
tdy_sel_pl
|
str
|
당일매도손익 (단위: 원). |
required |
AfterCloseInvestorItem
dataclass
¶
AfterCloseInvestorItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, trde_qty: str, ind_invsr: str, frgnr_invsr: str, orgn: str)
장마감후투자자별매매 단일 항목 (ka10066).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
ind_invsr
|
str
|
개인투자자. |
required |
frgnr_invsr
|
str
|
외국인투자자. |
required |
orgn
|
str
|
기관계. |
required |
AfterCloseInvestorTrading
dataclass
¶
장마감후투자자별매매 응답 (ka10066).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[AfterCloseInvestorItem]
|
종목별 투자자 매매 리스트. |
required |
AfterHoursRank
dataclass
¶
시간외단일가등락율순위 응답 (ka10098).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[AfterHoursRankItem]
|
시간외단일가등락율순위 종목 리스트. |
required |
AfterHoursRankItem
dataclass
¶
AfterHoursRankItem(rank: str, stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, sel_tot_req: str, buy_tot_req: str, acc_trde_qty: str, acc_trde_prica: str, tdy_close_pric: str, tdy_close_pric_flu_rt: str)
시간외단일가등락율순위 단일 항목 (ka10098).
AfterhoursOrderbook
dataclass
¶
AfterhoursOrderbook(base_time: str, ovt_cur_prc: str, ovt_flu_rt: str, ovt_acc_trde_qty: str, ovt_sell_tot: str, ovt_buy_tot: str, sel_bid_tot: str, buy_bid_tot: str)
시간외단일가 호가 응답 (ka10087).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
base_time
|
str
|
호가잔량기준시간 (HHMMSS). |
required |
ovt_cur_prc
|
str
|
시간외단일가 현재가 (원). |
required |
ovt_flu_rt
|
str
|
시간외단일가 등락률 (%). |
required |
ovt_acc_trde_qty
|
str
|
시간외단일가 누적거래량 (주). |
required |
ovt_sell_tot
|
str
|
시간외단일가 매도호가총잔량. |
required |
ovt_buy_tot
|
str
|
시간외단일가 매수호가총잔량. |
required |
sel_bid_tot
|
str
|
매도호가총잔량. |
required |
buy_bid_tot
|
str
|
매수호가총잔량. |
required |
AllSectorIndex
dataclass
¶
전업종지수요청 응답 (ka20003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[AllSectorIndexItem]
|
전업종지수 리스트. |
required |
AllSectorIndexItem
dataclass
¶
AllSectorIndexItem(stk_cd: str, stk_nm: str, cur_prc: str, pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, wght: str, trde_prica: str, upl: str, rising: str, stdns: str, fall: str, lst: str, flo_stk_num: str)
전업종지수 단일 항목.
BidQtySurge
dataclass
¶
호가잔량급증 응답 (ka10021).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[BidQtySurgeItem]
|
호가잔량급증 종목 리스트. |
required |
BidQtySurgeItem
dataclass
¶
BidQtySurgeItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, base_rt: str, now: str, sdnin_qty: str, sdnin_rt: str, tot_buy_qty: str)
호가잔량급증 단일 항목 (ka10021).
BidQtyUpper
dataclass
¶
호가잔량상위 응답 (ka10020).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[BidQtyUpperItem]
|
호가잔량상위 종목 리스트. |
required |
BidQtyUpperItem
dataclass
¶
BidQtyUpperItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, trde_qty: str, tot_sel_req: str, tot_buy_req: str, netprps_req: str, buy_rt: str)
호가잔량상위 단일 항목 (ka10020).
BrokerEntry
dataclass
¶
거래원 단일 항목 (ka10002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
거래원명. |
required |
code
|
str
|
거래원 코드. |
required |
qty
|
str
|
거래량 (주). |
required |
BrokerInstantVolume
dataclass
¶
거래원순간거래량 응답 (ka10052).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[BrokerInstantVolumeItem]
|
순간거래량 리스트. |
required |
BrokerInstantVolumeItem
dataclass
¶
BrokerInstantVolumeItem(tm: str, stk_cd: str, stk_nm: str, trde_ori_nm: str, tp: str, mont_trde_qty: str, acc_netprps: str, cur_prc: str, flu_rt: str)
거래원순간거래량 단일 항목 (ka10052).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tm
|
str
|
시간 (HHMMSS). |
required |
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
trde_ori_nm
|
str
|
거래원명. |
required |
tp
|
str
|
구분 (매도/매수). |
required |
mont_trde_qty
|
str
|
순간거래량 (주). |
required |
acc_netprps
|
str
|
누적순매수 (주). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
BrokerItem
dataclass
¶
회원사 단일 항목 (ka10102).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
code
|
str
|
회원사 코드. |
required |
name
|
str
|
회원사명. |
required |
gb
|
str
|
구분. |
required |
BrokerList
dataclass
¶
회원사 리스트 응답 (ka10102).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[BrokerItem]
|
회원사 리스트. |
required |
BrokerStockTrend
dataclass
¶
증권사별종목매매동향 응답 (ka10078).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[BrokerStockTrendItem]
|
일별 매매동향 리스트. |
required |
BrokerStockTrendItem
dataclass
¶
BrokerStockTrendItem(dt: str, cur_prc: str, flu_rt: str, acc_trde_qty: str, netprps_qty: str, buy_qty: str, sell_qty: str)
증권사별종목매매동향 단일 항목 (ka10078).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자 (YYYYMMDD). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
netprps_qty
|
str
|
순매수수량 (주). |
required |
buy_qty
|
str
|
매수수량 (주). |
required |
sell_qty
|
str
|
매도수량 (주). |
required |
BrokerSupplyAnalysis
dataclass
¶
거래원매물대분석 응답 (ka10043).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[BrokerSupplyItem]
|
일별 분석 리스트. |
required |
BrokerSupplyItem
dataclass
¶
BrokerSupplyItem(dt: str, close_pric: str, sel_qty: str, buy_qty: str, netprps_qty: str, trde_wght: str)
거래원매물대분석 단일 항목 (ka10043).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자 (YYYYMMDD). |
required |
close_pric
|
str
|
종가 (원). |
required |
sel_qty
|
str
|
매도량 (주). |
required |
buy_qty
|
str
|
매수량 (주). |
required |
netprps_qty
|
str
|
순매수수량 (주). |
required |
trde_wght
|
str
|
거래비중 (%). |
required |
BrokerTradeUpper
dataclass
¶
증권사별매매상위 응답 (ka10039).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[BrokerTradeUpperItem]
|
증권사별매매상위 종목 리스트. |
required |
BrokerTradeUpperItem
dataclass
¶
BrokerTradeUpperItem(rank: str, stk_cd: str, stk_nm: str, prid_stkpc_flu: str, flu_rt: str, prid_trde_qty: str, netprps: str, buy_trde_qty: str, sel_trde_qty: str, netprps_amt: str, buy_amt: str, sell_amt: str)
증권사별매매상위 단일 항목 (ka10039).
CancelOrderResponse
dataclass
¶
주식 취소주문 응답 (kt10003, kt10009).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호 (새로 발급된 취소 주문번호). |
required |
base_orig_ord_no
|
str
|
모주문번호 (최초 원주문번호). |
required |
cncl_qty
|
str
|
취소수량 (단위: 주). |
required |
ConditionItem
dataclass
¶
조건검색식 단일 항목.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
seq
|
str
|
조건검색식 일련번호. |
required |
name
|
str
|
조건검색식 이름. |
required |
ConditionList
dataclass
¶
조건검색 목록조회 응답 (ka10171).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ConditionItem]
|
조건검색식 목록. |
required |
ConditionRealtimeItem
dataclass
¶
조건검색 실시간 단일 이벤트.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
type
|
str
|
실시간 항목 TR명 (예: |
required |
name
|
str
|
실시간 항목명. |
required |
item
|
str
|
종목코드. |
required |
values
|
ConditionRealtimeValues
|
실시간 수신 값. |
required |
ConditionRealtimeValues
dataclass
¶
ConditionRealtimeValues(serial: str, stock_code: str, insert_delete: str, exec_time: str, sell_buy: str)
조건검색 실시간 단일 이벤트 값.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
serial
|
str
|
일련번호 (841). |
required |
stock_code
|
str
|
종목코드 (9001). |
required |
insert_delete
|
str
|
삽입삭제 구분 — |
required |
exec_time
|
str
|
체결시간 (20). |
required |
sell_buy
|
str
|
매도수 구분 (907). |
required |
ConditionSearchItem
dataclass
¶
ConditionSearchItem(stock_code: str, stock_name: str, current_price: str, change_sign: str, change: str, change_rate: str, volume: str, open_price: str, high_price: str, low_price: str)
조건검색 결과 단일 종목 항목.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stock_code
|
str
|
종목코드 (예: |
required |
stock_name
|
str
|
종목명. |
required |
current_price
|
str
|
현재가. |
required |
change_sign
|
str
|
전일대비기호. |
required |
change
|
str
|
전일대비. |
required |
change_rate
|
str
|
등락율. |
required |
volume
|
str
|
누적거래량. |
required |
open_price
|
str
|
시가. |
required |
high_price
|
str
|
고가. |
required |
low_price
|
str
|
저가. |
required |
ConditionSearchResult
dataclass
¶
조건검색 요청 일반 응답 (ka10172).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
seq
|
str
|
조건검색식 일련번호. |
required |
cont_yn
|
str
|
연속조회 여부 ( |
required |
next_key
|
str
|
연속조회키. |
required |
items
|
list[ConditionSearchItem]
|
검색 결과 종목 리스트. |
required |
ConditionStopResult
dataclass
¶
조건검색 실시간 해제 응답 (ka10174).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
seq
|
str
|
해제된 조건검색식 일련번호. |
required |
CreditLoanAvailability
dataclass
¶
신용융자 가능문의 응답 (kt20017).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
crd_alow_yn
|
str
|
신용가능여부 안내 문자열 (예: |
required |
CreditLoanStockItem
dataclass
¶
CreditLoanStockItem(stk_cd: str, stk_nm: str, crd_assr_rt: str, repl_pric: str, pred_close_pric: str, crd_limit_over_yn: str, crd_limit_over_txt: str)
신용융자 가능종목 단일 항목.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
crd_assr_rt
|
str
|
신용보증금율. |
required |
repl_pric
|
str
|
대용가. |
required |
pred_close_pric
|
str
|
전일종가. |
required |
crd_limit_over_yn
|
str
|
신용한도초과여부. |
required |
crd_limit_over_txt
|
str
|
신용한도초과 텍스트 ( |
required |
CreditLoanStocks
dataclass
¶
신용융자 가능종목요청 응답 (kt20016).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
crd_loan_able
|
str
|
신용융자가능여부 안내 문자열. |
required |
items
|
list[CreditLoanStockItem]
|
신용융자 가능종목 리스트. |
required |
CreditOrderableQuantity
dataclass
¶
CreditOrderableQuantity(stk_assr_rt: str, stk_assr_rt_nm: str, assr_30ord_alow_amt: str, assr_30ord_alowq: str, assr_40ord_alow_amt: str, assr_40ord_alowq: str, assr_50ord_alow_amt: str, assr_50ord_alowq: str, assr_60ord_alow_amt: str, assr_60ord_alowq: str, entr: str, repl_amt: str, ord_alowa: str, out_alowa: str, min_amt: str)
신용보증금율별주문가능수량 응답 (kt00012).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_assr_rt
|
str
|
종목보증금율. |
required |
entr
|
str
|
예수금 (단위: 원). |
required |
ord_alowa
|
str
|
주문가능현금 (단위: 원). |
required |
CreditRatioUpper
dataclass
¶
신용비율상위 응답 (ka10033).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[CreditRatioUpperItem]
|
신용비율상위 종목 리스트. |
required |
CreditRatioUpperItem
dataclass
¶
CreditRatioUpperItem(stk_infr: str, stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, crd_rt: str, sel_req: str, buy_req: str, now_trde_qty: str)
신용비율상위 단일 항목 (ka10033).
CreditTradingItem
dataclass
¶
CreditTradingItem(dt: str, cur_prc: str, trde_qty: str, new: str, rpya: str, remn: str, remn_rt: str)
신용매매동향 단일 항목 (ka10013).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자 (YYYYMMDD). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
new
|
str
|
신규. |
required |
rpya
|
str
|
상환. |
required |
remn
|
str
|
잔고. |
required |
remn_rt
|
str
|
잔고율 (%). |
required |
CreditTradingTrend
dataclass
¶
신용매매동향 응답 (ka10013).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[CreditTradingItem]
|
일별 신용매매동향 리스트. |
required |
DailyAccountReturn
dataclass
¶
DailyAccountReturn(mang_empno: str, mngr_nm: str, dept_nm: str, entr_fr: str, entr_to: str, scrt_evlt_amt_fr: str, scrt_evlt_amt_to: str, tot_amt_fr: str, tot_amt_to: str, evltv_prft: str, prft_rt: str, tern_rt: str, termin_tot_trns: str, termin_tot_pymn: str)
일별계좌수익률상세현황 응답 (kt00016).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
evltv_prft
|
str
|
평가손익 (단위: 원). |
required |
prft_rt
|
str
|
수익률 (단위: %). |
required |
tot_amt_fr
|
str
|
순자산액계_초 (단위: 원). |
required |
tot_amt_to
|
str
|
순자산액계_말 (단위: 원). |
required |
DailyAccountStatus
dataclass
¶
DailyAccountStatus(d2_entra: str, gnrl_stk_evlt_amt_d2: str, crd_loan_d2: str, ina_amt: str, outa: str, sell_amt: str, buy_amt: str, cmsn: str, tax: str, dvida_amt: str)
계좌별당일현황 응답 (kt00017).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
d2_entra
|
str
|
D+2추정예수금 (단위: 원). |
required |
sell_amt
|
str
|
매도금액 (단위: 원). |
required |
buy_amt
|
str
|
매수금액 (단위: 원). |
required |
cmsn
|
str
|
수수료 (단위: 원). |
required |
tax
|
str
|
세금 (단위: 원). |
required |
DailyBalanceReturn
dataclass
¶
DailyBalanceReturn(dt: str, tot_buy_amt: str, tot_evlt_amt: str, tot_evltv_prft: str, tot_prft_rt: str, dbst_bal: str, day_stk_asst: str, items: list[DailyBalanceReturnItem] = list())
일별잔고수익률 응답 (ka01690).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자. |
required |
tot_buy_amt
|
str
|
총 매입가 (단위: 원). |
required |
tot_evlt_amt
|
str
|
총 평가금액 (단위: 원). |
required |
tot_prft_rt
|
str
|
수익률 (단위: %). |
required |
day_bal_rt
|
종목별 잔고수익률 목록. |
required |
DailyBalanceReturnItem
dataclass
¶
DailyBalanceReturnItem(cur_prc: str, stk_cd: str, stk_nm: str, rmnd_qty: str, buy_uv: str, buy_wght: str, evltv_prft: str, prft_rt: str, evlt_amt: str, evlt_wght: str)
일별잔고수익률 종목 항목 (ka01690 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
rmnd_qty
|
str
|
보유수량 (단위: 주). |
required |
buy_uv
|
str
|
매입단가 (단위: 원). |
required |
evlt_amt
|
str
|
평가금액 (단위: 원). |
required |
evltv_prft
|
str
|
평가손익 (단위: 원). |
required |
prft_rt
|
str
|
수익률 (단위: %). |
required |
DailyEstimatedAssetItem
dataclass
¶
DailyEstimatedAssetItem(dt: str, entr: str, grnt_use_amt: str, crd_loan: str, ls_grnt: str, repl_amt: str, prsm_dpst_aset_amt: str, prsm_dpst_aset_amt_bncr_skip: str)
일별추정예탁자산 항목 (kt00002 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자 ( |
required |
entr
|
str
|
예수금 (단위: 원). |
required |
prsm_dpst_aset_amt
|
str
|
추정예탁자산 (단위: 원). |
required |
DailyInstitutionStockItem
dataclass
¶
일별기관매매종목 단일 항목 (ka10044).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
netprps_qty
|
str
|
순매수수량 (주). |
required |
netprps_amt
|
str
|
순매수금액 (백만원). |
required |
DailyInstitutionStocks
dataclass
¶
일별기관매매종목 응답 (ka10044).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[DailyInstitutionStockItem]
|
기관매매종목 리스트. |
required |
DailyMainBroker
dataclass
¶
DailyMainBroker(sel_trde_ori_1: str, sel_trde_ori_qty_1: str, sel_trde_ori_irds_1: str, buy_trde_ori_1: str, buy_trde_ori_qty_1: str, buy_trde_ori_irds_1: str, sel_trde_ori_2: str, sel_trde_ori_qty_2: str, sel_trde_ori_irds_2: str, buy_trde_ori_2: str, buy_trde_ori_qty_2: str, buy_trde_ori_irds_2: str, sel_trde_ori_3: str, sel_trde_ori_qty_3: str, sel_trde_ori_irds_3: str, buy_trde_ori_3: str, buy_trde_ori_qty_3: str, buy_trde_ori_irds_3: str, sel_trde_ori_4: str, sel_trde_ori_qty_4: str, sel_trde_ori_irds_4: str, buy_trde_ori_4: str, buy_trde_ori_qty_4: str, buy_trde_ori_irds_4: str, sel_trde_ori_5: str, sel_trde_ori_qty_5: str, sel_trde_ori_irds_5: str, buy_trde_ori_5: str, buy_trde_ori_qty_5: str, buy_trde_ori_irds_5: str, frgn_sel_prsm_sum: str, frgn_sel_prsm_sum_chang: str, frgn_buy_prsm_sum: str, frgn_buy_prsm_sum_chang: str, items: list[DailyMainBrokerEntry])
당일주요거래원 응답 (ka10040).
매도/매수 거래원 상위 5개를 번호별 필드로 제공하고, 당일주요거래원 이탈 리스트를 별도로 포함합니다.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
sel_trde_ori_1 ~ 5
|
매도거래원명 1~5위. |
required | |
sel_trde_ori_qty_1 ~ 5
|
매도거래원수량 1~5위. |
required | |
buy_trde_ori_1 ~ 5
|
매수거래원명 1~5위. |
required | |
buy_trde_ori_qty_1 ~ 5
|
매수거래원수량 1~5위. |
required | |
frgn_sel_prsm_sum
|
str
|
외국계매도추정합. |
required |
frgn_buy_prsm_sum
|
str
|
외국계매수추정합. |
required |
items
|
list[DailyMainBrokerEntry]
|
당일주요거래원 이탈 리스트. |
required |
DailyMainBrokerEntry
dataclass
¶
DailyMainBrokerEntry(sel_scesn_tm: str, sell_qty: str, sel_upper_scesn_ori: str, buy_scesn_tm: str, buy_qty: str, buy_upper_scesn_ori: str, qry_dt: str, qry_tm: str)
당일주요거래원 매도/매수 이탈 단일 항목 (ka10040).
DailyPriceItem
dataclass
¶
DailyPriceItem(date: str, open_pric: str, high_pric: str, low_pric: str, close_pric: str, flu_rt: str, trde_qty: str, for_netprps: str, orgn_netprps: str, ind_netprps: str, for_poss: str, for_wght: str, crd_remn_rt: str)
일별주가 단일 항목 (ka10086).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
date
|
str
|
날짜 (YYYYMMDD). |
required |
open_pric
|
str
|
시가 (원). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
close_pric
|
str
|
종가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
for_netprps
|
str
|
외인순매수 (주). |
required |
orgn_netprps
|
str
|
기관순매수 (주). |
required |
ind_netprps
|
str
|
개인순매수 (주). |
required |
for_poss
|
str
|
외인보유 (%). |
required |
for_wght
|
str
|
외인비중 (%). |
required |
crd_remn_rt
|
str
|
신용잔고율 (%). |
required |
DailyPrices
dataclass
¶
일별주가 응답 (ka10086).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[DailyPriceItem]
|
일별 OHLCV 리스트. |
required |
DailyRealizedProfit
dataclass
¶
DailyRealizedProfit(tot_buy_amt: str, tot_sell_amt: str, rlzt_pl: str, trde_cmsn: str, trde_tax: str, items: list[DailyRealizedProfitItem] = list())
일자별실현손익 응답 (ka10074).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tot_buy_amt
|
str
|
총매수금액 (단위: 원). |
required |
tot_sell_amt
|
str
|
총매도금액 (단위: 원). |
required |
rlzt_pl
|
str
|
실현손익 (단위: 원). |
required |
items
|
list[DailyRealizedProfitItem]
|
일자별 실현손익 목록. |
list()
|
DailyRealizedProfitDetail
dataclass
¶
당일실현손익상세 응답 (ka10077).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tdy_rlzt_pl
|
str
|
당일실현손익 (단위: 원). |
required |
items
|
list[DailyRealizedProfitDetailItem]
|
당일실현손익 상세 목록. |
list()
|
DailyRealizedProfitDetailItem
dataclass
¶
DailyRealizedProfitDetailItem(stk_nm: str, cntr_qty: str, buy_uv: str, cntr_pric: str, tdy_sel_pl: str, pl_rt: str, tdy_trde_cmsn: str, tdy_trde_tax: str, stk_cd: str)
당일실현손익상세 항목 (ka10077 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cntr_qty
|
str
|
체결량 (단위: 주). |
required |
tdy_sel_pl
|
str
|
당일매도손익 (단위: 원). |
required |
pl_rt
|
str
|
손익율 (단위: %). |
required |
DailyRealizedProfitItem
dataclass
¶
DailyRealizedProfitItem(dt: str, buy_amt: str, sell_amt: str, tdy_sel_pl: str, tdy_trde_cmsn: str, tdy_trde_tax: str)
일자별실현손익 항목 (ka10074 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자. |
required |
buy_amt
|
str
|
매수금액 (단위: 원). |
required |
sell_amt
|
str
|
매도금액 (단위: 원). |
required |
tdy_sel_pl
|
str
|
당일매도손익 (단위: 원). |
required |
DailyTopExit
dataclass
¶
당일상위이탈원 응답 (ka10053).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[DailyTopExitItem]
|
당일상위이탈원 리스트. |
required |
DailyTopExitItem
dataclass
¶
DailyTopExitItem(sel_scesn_tm: str, sell_qty: str, sel_upper_scesn_ori: str, buy_scesn_tm: str, buy_qty: str, buy_upper_scesn_ori: str, qry_dt: str, qry_tm: str)
당일상위이탈원 단일 항목 (ka10053).
DailyTradeJournal
dataclass
¶
DailyTradeJournal(tot_sell_amt: str, tot_buy_amt: str, tot_cmsn_tax: str, tot_exct_amt: str, tot_pl_amt: str, tot_prft_rt: str, items: list[DailyTradeJournalItem] = list())
당일매매일지 응답 (ka10170).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tot_sell_amt
|
str
|
총매도금액 (단위: 원). |
required |
tot_buy_amt
|
str
|
총매수금액 (단위: 원). |
required |
tot_pl_amt
|
str
|
총손익금액 (단위: 원). |
required |
tot_prft_rt
|
str
|
총수익률 (단위: %). |
required |
items
|
list[DailyTradeJournalItem]
|
당일매매일지 목록. |
list()
|
DailyTradeJournalItem
dataclass
¶
DailyTradeJournalItem(stk_nm: str, buy_avg_pric: str, buy_qty: str, sel_avg_pric: str, sell_qty: str, cmsn_alm_tax: str, pl_amt: str, sell_amt: str, buy_amt: str, prft_rt: str, stk_cd: str)
당일매매일지 항목 (ka10170 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
buy_qty
|
str
|
매수수량 (단위: 주). |
required |
sell_qty
|
str
|
매도수량 (단위: 주). |
required |
pl_amt
|
str
|
손익금액 (단위: 원). |
required |
prft_rt
|
str
|
수익률 (단위: %). |
required |
DailyTradeQtyUpper
dataclass
¶
당일거래량상위 응답 (ka10030).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[DailyTradeQtyUpperItem]
|
당일거래량상위 종목 리스트. |
required |
DailyTradeQtyUpperItem
dataclass
¶
DailyTradeQtyUpperItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, pred_rt: str, trde_tern_rt: str, trde_amt: str, opmr_trde_qty: str, opmr_pred_rt: str, opmr_trde_rt: str, opmr_trde_amt: str, af_mkrt_trde_qty: str, af_mkrt_pred_rt: str, af_mkrt_trde_rt: str, af_mkrt_trde_amt: str, bf_mkrt_trde_qty: str, bf_mkrt_pred_rt: str, bf_mkrt_trde_rt: str, bf_mkrt_trde_amt: str)
당일거래량상위 단일 항목 (ka10030).
DailyTradingDetail
dataclass
¶
일별거래상세 응답 (ka10015).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[DailyTradingDetailItem]
|
일별 거래상세 리스트. |
required |
DailyTradingDetailItem
dataclass
¶
DailyTradingDetailItem(dt: str, close_pric: str, flu_rt: str, trde_qty: str, trde_prica: str, cntr_str: str, for_netprps: str, orgn_netprps: str, ind_netprps: str)
일별거래상세 단일 항목 (ka10015).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자 (YYYYMMDD). |
required |
close_pric
|
str
|
종가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
trde_prica
|
str
|
거래대금 (백만원). |
required |
cntr_str
|
str
|
체결강도. |
required |
for_netprps
|
str
|
외인순매수 (주). |
required |
orgn_netprps
|
str
|
기관순매수 (주). |
required |
ind_netprps
|
str
|
개인순매수 (주). |
required |
DepositDetail
dataclass
¶
DepositDetail(entr: str, profa_ch: str, pymn_alow_amt: str, ord_alow_amt: str, d1_entra: str, d1_pymn_alow_amt: str, d2_entra: str, d2_pymn_alow_amt: str, repl_amt: str, ch_uncla: str, nrpy_loan: str, crd_grnt_rt: str, fx_deposits: list[FxDepositItem] = list())
예수금상세현황 응답 (kt00001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
entr
|
str
|
예수금 (단위: 원). |
required |
pymn_alow_amt
|
str
|
출금가능금액 (단위: 원). |
required |
ord_alow_amt
|
str
|
주문가능금액 (단위: 원). |
required |
d1_entra
|
str
|
D+1 추정예수금 (단위: 원). |
required |
d2_entra
|
str
|
D+2 추정예수금 (단위: 원). |
required |
fx_deposits
|
list[FxDepositItem]
|
외화예수금 목록. |
list()
|
ElwAccessRate
dataclass
¶
ELW근접율요청 응답 (ka30011).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwAccessRateItem]
|
ELW근접율 리스트. |
required |
ElwAccessRateItem
dataclass
¶
ElwAccessRateItem(stk_cd: str, stk_nm: str, cur_prc: str, pre_sig: str, pred_pre: str, flu_rt: str, acc_trde_qty: str, alacc_rt: str)
ELW근접율 단일 항목.
ElwBalRank
dataclass
¶
ELW잔량순위요청 응답 (ka30010).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwBalRankItem]
|
ELW잔량순위 리스트. |
required |
ElwBalRankItem
dataclass
¶
ElwBalRankItem(stk_cd: str, rank: str, stk_nm: str, cur_prc: str, pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, sel_req: str, buy_req: str, netprps_req: str, trde_prica: str)
ELW잔량순위 단일 항목.
ElwBrokerNetTrade
dataclass
¶
거래원별ELW순매매상위요청 응답 (ka30002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwBrokerNetTradeItem]
|
거래원별ELW순매매상위 리스트. |
required |
ElwBrokerNetTradeItem
dataclass
¶
ElwBrokerNetTradeItem(stk_cd: str, stk_nm: str, stkpc_flu: str, flu_rt: str, trde_qty: str, netprps: str, buy_trde_qty: str, sel_trde_qty: str)
거래원별ELW순매매상위 단일 항목.
ElwDailySens
dataclass
¶
ELW일별민감도지표요청 응답 (ka10048).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwDailySensItem]
|
ELW일별민감도지표 리스트. |
required |
ElwDailySensItem
dataclass
¶
ELW일별민감도지표 단일 항목.
ElwDetail
dataclass
¶
ElwDetail(aset_cd: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, lpmmcm_nm: str, lpmmcm_nm_1: str, lpmmcm_nm_2: str, elwrght_cntn: str, elwexpr_evlt_pric: str, elwtheory_pric: str, dispty_rt: str, elwinnr_vltl: str, exp_rght_pric: str, elwpl_qutr_rt: str, elwexec_pric: str, elwcnvt_rt: str, elwcmpn_rt: str, elwpric_rising_part_rt: str, elwrght_type: str, elwsrvive_dys: str, stkcnt: str, elwlpord_pos: str, lpposs_rt: str, lprmnd_qty: str, elwspread: str, elwprty: str, elwgear: str, elwflo_dt: str, elwfin_trde_dt: str, expr_dt: str, exec_dt: str, lpsuply_end_dt: str, elwpay_dt: str, elwinvt_ix_comput: str, elwpay_agnt: str, elwappr_way: str, elwrght_exec_way: str, elwpblicte_orgn: str, dcsn_pay_amt: str, kobarr: str, iv: str, clsprd_end_elwocr: str, bsis_aset_1: str, bsis_aset_comp_rt_1: str, bsis_aset_2: str, bsis_aset_comp_rt_2: str, bsis_aset_3: str, bsis_aset_comp_rt_3: str, bsis_aset_4: str, bsis_aset_comp_rt_4: str, bsis_aset_5: str, bsis_aset_comp_rt_5: str, fr_dt: str, to_dt: str, fr_tm: str, evlt_end_tm: str, evlt_pric: str, evlt_fnsh_yn: str, all_hgst_pric: str, all_lwst_pric: str, imaf_hgst_pric: str, imaf_lwst_pric: str, sndhalf_mrkt_hgst_pric: str, sndhalf_mrkt_lwst_pric: str)
ELW종목상세정보요청 응답 (ka30012).
ElwFlucRank
dataclass
¶
ELW등락율순위요청 응답 (ka30009).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwFlucRankItem]
|
ELW등락율순위 리스트. |
required |
ElwFlucRankItem
dataclass
¶
ElwFlucRankItem(rank: str, stk_cd: str, stk_nm: str, cur_prc: str, pre_sig: str, pred_pre: str, flu_rt: str, sel_req: str, buy_req: str, trde_qty: str, trde_prica: str)
ELW등락율순위 단일 항목.
ElwGap
dataclass
¶
ELW괴리율요청 응답 (ka30004).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwGapItem]
|
ELW괴리율 리스트. |
required |
ElwGapItem
dataclass
¶
ElwGapItem(stk_cd: str, isscomp_nm: str, sqnc: str, base_aset_nm: str, rght_tp: str, dispty_rt: str, basis: str, srvive_dys: str, theory_pric: str, cur_prc: str, pre_tp: str, pred_pre: str, flu_rt: str, trde_qty: str, stk_nm: str)
ELW괴리율 단일 항목.
ElwLpDaily
dataclass
¶
ELWLP보유일별추이요청 응답 (ka30003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwLpDailyItem]
|
ELWLP보유일별추이 리스트. |
required |
ElwLpDailyItem
dataclass
¶
ElwLpDailyItem(dt: str, cur_prc: str, pre_tp: str, pred_pre: str, flu_rt: str, trde_qty: str, trde_prica: str, chg_qty: str, lprmnd_qty: str, wght: str)
ELWLP보유일별추이 단일 항목.
ElwPriceSurge
dataclass
¶
ELW가격급등락요청 응답 (ka30001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
base_pric_tm
|
str
|
기준가시간. |
required |
items
|
list[ElwPriceSurgeItem]
|
ELW가격급등락 리스트. |
required |
ElwPriceSurgeItem
dataclass
¶
ElwPriceSurgeItem(stk_cd: str, rank: str, stk_nm: str, pre_sig: str, pred_pre: str, trde_end_elwbase_pric: str, cur_prc: str, base_pre: str, trde_qty: str, jmp_rt: str)
ELW가격급등락 단일 항목.
ElwSearch
dataclass
¶
ELW조건검색요청 응답 (ka30005).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwSearchItem]
|
ELW조건검색 리스트. |
required |
ElwSearchItem
dataclass
¶
ElwSearchItem(stk_cd: str, isscomp_nm: str, sqnc: str, base_aset_nm: str, rght_tp: str, expr_dt: str, cur_prc: str, pre_tp: str, pred_pre: str, flu_rt: str, trde_qty: str, trde_qty_pre: str, trde_prica: str, pred_trde_qty: str, sel_bid: str, buy_bid: str, prty: str, gear_rt: str, pl_qutr_rt: str, cfp: str, theory_pric: str, innr_vltl: str, delta: str, lvrg: str, exec_pric: str, cnvt_rt: str, lpposs_rt: str, pl_qutr_pt: str, fin_trde_dt: str, flo_dt: str, lpinitlast_suply_dt: str, stk_nm: str, srvive_dys: str, dispty_rt: str, lpmmcm_nm: str, lpmmcm_nm_1: str, lpmmcm_nm_2: str, xraymont_cntr_qty_arng_trde_tp: str, xraymont_cntr_qty_profa_100tp: str)
ELW조건검색 단일 항목.
ElwSens
dataclass
¶
ELW민감도지표요청 응답 (ka10050).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ElwSensItem]
|
ELW민감도지표 리스트. |
required |
ElwSensItem
dataclass
¶
ElwSensItem(cntr_tm: str, cur_prc: str, elwtheory_pric: str, iv: str, delta: str, gam: str, theta: str, vega: str, law: str, lp: str)
ELW민감도지표 단일 항목.
EstimatedAsset
dataclass
¶
추정자산조회 응답 (kt00003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
prsm_dpst_aset_amt
|
str
|
추정예탁자산 (단위: 원). |
required |
EtfAllQuote
dataclass
¶
ETF전체시세요청 응답 (ka40004).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[EtfAllQuoteItem]
|
ETF전체시세 리스트. |
required |
EtfAllQuoteItem
dataclass
¶
EtfAllQuoteItem(stk_cd: str, stk_cls: str, stk_nm: str, close_pric: str, pre_sig: str, pred_pre: str, pre_rt: str, trde_qty: str, nav: str, trace_eor_rt: str, txbs: str, dvid_bf_base: str, pred_dvida: str, trace_idex_nm: str, drng: str, trace_idex_cd: str, trace_idex: str, trace_flu_rt: str)
ETF전체시세 단일 항목.
EtfDailyFill
dataclass
¶
EtfDailyFill(cntr_tm: str, cur_prc: str, pre_sig: str, pred_pre: str, trde_qty: str, items: list[EtfDailyFillItem])
ETF일자별체결요청 응답 (ka40008).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
cntr_tm
|
str
|
체결시간. |
required |
cur_prc
|
str
|
현재가. |
required |
pre_sig
|
str
|
대비기호. |
required |
pred_pre
|
str
|
전일대비. |
required |
trde_qty
|
str
|
거래량. |
required |
items
|
list[EtfDailyFillItem]
|
ETF일자별체결 리스트. |
required |
EtfDailyFillItem
dataclass
¶
EtfDailyFillItem(dt: str, cur_prc_n: str, pre_sig_n: str, pred_pre_n: str, acc_trde_qty: str, for_netprps_qty: str, orgn_netprps_qty: str)
ETF일자별체결 단일 항목 (ka40008).
EtfDailyTrend
dataclass
¶
ETF일별추이요청 응답 (ka40003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[EtfDailyTrendItem]
|
ETF일별추이 리스트. |
required |
EtfDailyTrendItem
dataclass
¶
EtfDailyTrendItem(cntr_dt: str, cur_prc: str, pre_sig: str, pred_pre: str, pre_rt: str, trde_qty: str, nav: str, acc_trde_prica: str, navidex_dispty_rt: str, navetfdispty_rt: str, trace_eor_rt: str, trace_cur_prc: str, trace_pred_pre: str, trace_pre_sig: str)
ETF일별추이 단일 항목.
EtfInfo
dataclass
¶
ETF종목정보요청 응답 (ka40002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_nm
|
str
|
종목명. |
required |
etfobjt_idex_nm
|
str
|
ETF대상지수명. |
required |
wonju_pric
|
str
|
원주가격. |
required |
etftxon_type
|
str
|
ETF과세유형. |
required |
etntxon_type
|
str
|
ETN과세유형. |
required |
EtfNav
dataclass
¶
ETF시간대별체결요청 응답 (ka40009).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[EtfNavItem]
|
ETFNAV 리스트. |
required |
EtfNavItem
dataclass
¶
EtfNavItem(nav: str, navpred_pre: str, navflu_rt: str, trace_eor_rt: str, dispty_rt: str, stkcnt: str, base_pric: str, for_rmnd_qty: str, repl_pric: str, conv_pric: str, drstk: str, wonju_pric: str)
ETFNAV 단일 항목 (ka40009).
EtfReturn
dataclass
¶
ETF수익율요청 응답 (ka40001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[EtfReturnItem]
|
ETF수익율 리스트. |
required |
EtfReturnItem
dataclass
¶
ETF수익율 단일 항목.
EtfTimeFill
dataclass
¶
EtfTimeFill(stk_cls: str, stk_nm: str, etfobjt_idex_nm: str, etfobjt_idex_cd: str, objt_idex_pre_rt: str, wonju_pric: str, items: list[EtfTimeFillItem])
ETF시간대별체결요청 응답 (ka40007).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cls
|
str
|
종목분류. |
required |
stk_nm
|
str
|
종목명. |
required |
etfobjt_idex_nm
|
str
|
ETF대상지수명. |
required |
etfobjt_idex_cd
|
str
|
ETF대상지수코드. |
required |
objt_idex_pre_rt
|
str
|
대상지수대비율. |
required |
wonju_pric
|
str
|
원주가격. |
required |
items
|
list[EtfTimeFillItem]
|
ETF시간대별체결 리스트. |
required |
EtfTimeFillItem
dataclass
¶
EtfTimeFillItem(cntr_tm: str, cur_prc: str, pre_sig: str, pred_pre: str, trde_qty: str, stex_tp: str)
ETF시간대별체결 단일 항목 (ka40007).
EtfTimeTrend
dataclass
¶
EtfTimeTrend(stk_nm: str, etfobjt_idex_nm: str, wonju_pric: str, etftxon_type: str, etntxon_type: str, items: list[EtfTimeTrendItem])
ETF시간대별추이요청 응답 (ka40006).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_nm
|
str
|
종목명. |
required |
etfobjt_idex_nm
|
str
|
ETF대상지수명. |
required |
wonju_pric
|
str
|
원주가격. |
required |
etftxon_type
|
str
|
ETF과세유형. |
required |
etntxon_type
|
str
|
ETN과세유형. |
required |
items
|
list[EtfTimeTrendItem]
|
ETF시간대별추이 리스트. |
required |
EtfTimeTrend2
dataclass
¶
ETF시간대별추이요청 응답 (ka40010).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[EtfTimeTrend2Item]
|
ETF시간대별추이 리스트. |
required |
EtfTimeTrend2Item
dataclass
¶
ETF시간대별추이 단일 항목 (ka40010).
EtfTimeTrendItem
dataclass
¶
EtfTimeTrendItem(tm: str, close_pric: str, pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, nav: str, trde_prica: str, navidex: str, navetf: str, trace: str, trace_idex: str, trace_idex_pred_pre: str, trace_idex_pred_pre_sig: str)
ETF시간대별추이 단일 항목 (ka40006).
ExecutionBalance
dataclass
¶
ExecutionBalance(entr: str, entr_d1: str, entr_d2: str, pymn_alow_amt: str, ord_alowa: str, evlt_amt_tot: str, tot_pl_tot: str, tot_pl_rt: str, holdings: list[ExecutionBalanceItem] = list())
체결잔고 응답 (kt00005).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
entr
|
str
|
예수금 (단위: 원). |
required |
evlt_amt_tot
|
str
|
평가금액합계 (단위: 원). |
required |
tot_pl_tot
|
str
|
총손익합계 (단위: 원). |
required |
tot_pl_rt
|
str
|
총손익률 (단위: %). |
required |
holdings
|
list[ExecutionBalanceItem]
|
종목별 체결잔고 목록. |
list()
|
ExecutionBalanceItem
dataclass
¶
ExecutionBalanceItem(crd_tp: str, loan_dt: str, expr_dt: str, stk_cd: str, stk_nm: str, setl_remn: str, cur_qty: str, cur_prc: str, buy_uv: str, pur_amt: str, evlt_amt: str, evltv_prft: str, pl_rt: str)
종목별체결잔고 항목 (kt00005 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목번호. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_qty
|
str
|
현재잔고 (단위: 주). |
required |
cur_prc
|
str
|
현재가 (단위: 원). |
required |
buy_uv
|
str
|
매입단가 (단위: 원). |
required |
evlt_amt
|
str
|
평가금액 (단위: 원). |
required |
evltv_prft
|
str
|
평가손익 (단위: 원). |
required |
pl_rt
|
str
|
손익률 (단위: %). |
required |
ExecutionInfo
dataclass
¶
체결정보 응답 (ka10003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ExecutionInfoItem]
|
체결 리스트. |
required |
ExecutionInfoItem
dataclass
¶
ExecutionInfoItem(tm: str, cur_prc: str, cntr_trde_qty: str, acc_trde_qty: str, cntr_str: str, stex_tp: str)
체결정보 단일 항목 (ka10003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tm
|
str
|
시간 (HHMMSS). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
cntr_trde_qty
|
str
|
체결거래량 (주). |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
cntr_str
|
str
|
체결강도. |
required |
stex_tp
|
str
|
거래소구분. |
required |
ExecutionStrength
dataclass
¶
체결강도추이 응답 (ka10046, ka10047).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ExecutionStrengthItem]
|
체결강도 시계열 리스트. |
required |
ExecutionStrengthItem
dataclass
¶
ExecutionStrengthItem(time_or_dt: str, cur_prc: str, flu_rt: str, trde_qty: str, cntr_str: str, cntr_str_5: str, cntr_str_20: str, cntr_str_60: str)
체결강도추이 단일 항목 (ka10046, ka10047).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
time_or_dt
|
str
|
시간(HHMMSS) 또는 일자(YYYYMMDD). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
cntr_str
|
str
|
체결강도. |
required |
cntr_str_5
|
str
|
체결강도 5분/5일. |
required |
cntr_str_20
|
str
|
체결강도 20분/20일. |
required |
cntr_str_60
|
str
|
체결강도 60분/60일. |
required |
ExpectedTradeUpper
dataclass
¶
예상체결등락률상위 응답 (ka10029).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ExpectedTradeUpperItem]
|
예상체결등락률상위 종목 리스트. |
required |
ExpectedTradeUpperItem
dataclass
¶
ExpectedTradeUpperItem(stk_cd: str, stk_nm: str, exp_cntr_pric: str, base_pric: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, exp_cntr_qty: str, sel_req: str, sel_bid: str, buy_bid: str, buy_req: str)
예상체결등락률상위 단일 항목 (ka10029).
FilledOrderItem
dataclass
¶
FilledOrderItem(ord_no: str, stk_nm: str, io_tp_nm: str, ord_pric: str, ord_qty: str, cntr_pric: str, cntr_qty: str, oso_qty: str, tdy_trde_cmsn: str, tdy_trde_tax: str, ord_stt: str, trde_tp: str, orig_ord_no: str, ord_tm: str, stk_cd: str, stex_tp: str, stex_tp_txt: str, sor_yn: str)
체결 주문 항목 (ka10076 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cntr_pric
|
str
|
체결가 (단위: 원). |
required |
cntr_qty
|
str
|
체결량 (단위: 주). |
required |
oso_qty
|
str
|
미체결수량 (단위: 주). |
required |
ord_stt
|
str
|
주문상태. |
required |
ForeignBrokerTradeUpper
dataclass
¶
외국계창구매매상위 응답 (ka10037).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ForeignBrokerTradeUpperItem]
|
외국계창구매매상위 종목 리스트. |
required |
ForeignBrokerTradeUpperItem
dataclass
¶
ForeignBrokerTradeUpperItem(rank: str, stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, sel_trde_qty: str, buy_trde_qty: str, netprps_trde_qty: str, netprps_prica: str, trde_qty: str, trde_prica: str)
외국계창구매매상위 단일 항목 (ka10037).
ForeignConsecTradeUpper
dataclass
¶
외인연속순매매상위 응답 (ka10035).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ForeignConsecTradeUpperItem]
|
외인연속순매매상위 종목 리스트. |
required |
ForeignConsecTradeUpperItem
dataclass
¶
ForeignConsecTradeUpperItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, dm1: str, dm2: str, dm3: str, tot: str, limit_exh_rt: str, pred_pre_1: str, pred_pre_2: str, pred_pre_3: str)
외인연속순매매상위 단일 항목 (ka10035).
ForeignInstitutionTradeUpper
dataclass
¶
외국인기관매매상위 응답 (ka90009).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ForeignInstitutionTradeUpperItem]
|
외국인기관매매상위 리스트. |
required |
ForeignInstitutionTradeUpperItem
dataclass
¶
ForeignInstitutionTradeUpperItem(for_netslmt_stk_cd: str, for_netslmt_stk_nm: str, for_netslmt_amt: str, for_netslmt_qty: str, for_netprps_stk_cd: str, for_netprps_stk_nm: str, for_netprps_amt: str, for_netprps_qty: str, orgn_netslmt_stk_cd: str, orgn_netslmt_stk_nm: str, orgn_netslmt_amt: str, orgn_netslmt_qty: str, orgn_netprps_stk_cd: str, orgn_netprps_stk_nm: str, orgn_netprps_amt: str, orgn_netprps_qty: str)
외국인기관매매상위 단일 항목 (ka90009).
ForeignLimitExhaustUpper
dataclass
¶
외인한도소진율증가상위 응답 (ka10036).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ForeignLimitExhaustUpperItem]
|
외인한도소진율증가상위 종목 리스트. |
required |
ForeignLimitExhaustUpperItem
dataclass
¶
ForeignLimitExhaustUpperItem(rank: str, stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, trde_qty: str, poss_stkcnt: str, gain_pos_stkcnt: str, base_limit_exh_rt: str, limit_exh_rt: str, exh_rt_incrs: str)
외인한도소진율증가상위 단일 항목 (ka10036).
ForeignPeriodTradeUpper
dataclass
¶
외인기간별매매상위 응답 (ka10034).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ForeignPeriodTradeUpperItem]
|
외인기간별매매상위 종목 리스트. |
required |
ForeignPeriodTradeUpperItem
dataclass
¶
ForeignPeriodTradeUpperItem(rank: str, stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, sel_bid: str, buy_bid: str, trde_qty: str, netprps_qty: str, gain_pos_stkcnt: str)
외인기간별매매상위 단일 항목 (ka10034).
ForeignTrade
dataclass
¶
주식외국인종목별매매동향 응답 (ka10008).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ForeignTradeItem]
|
외국인 매매동향 리스트. |
required |
ForeignTradeItem
dataclass
¶
ForeignTradeItem(dt: str, close_pric: str, pred_pre: str, trde_qty: str, chg_qty: str, poss_stkcnt: str, wght: str, gain_pos_stkcnt: str, frgnr_limit: str, frgnr_limit_irds: str, limit_exh_rt: str)
주식외국인 종목별 매매동향 단일 항목.
FxDepositItem
dataclass
¶
FxDepositItem(crnc_cd: str, fx_entr: str, fc_krw_repl_evlta: str, fc_trst_profa: str, pymn_alow_amt: str, pymn_alow_amt_entr: str, ord_alow_amt_entr: str, fc_uncla: str, fc_ch_uncla: str, dly_amt: str, d1_fx_entr: str, d2_fx_entr: str, d3_fx_entr: str, d4_fx_entr: str)
외화예수금 항목 (kt00001 stk_entr_prst 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
crnc_cd
|
str
|
통화코드 (예: |
required |
fx_entr
|
str
|
외화예수금. |
required |
pymn_alow_amt
|
str
|
출금가능금액. |
required |
ord_alow_amt_entr
|
str
|
주문가능금액(예수금). |
required |
GoldBalance
dataclass
¶
GoldBalance(tot_entr: str, net_entr: str, tot_est_amt: str, net_amt: str, tot_book_amt2: str, tot_dep_amt: str, paym_alowa: str, pl_amt: str, items: list[GoldBalanceItem])
금현물 잔고확인 응답 (kt50020).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tot_entr
|
str
|
예수금. |
required |
net_entr
|
str
|
추정예수금. |
required |
tot_est_amt
|
str
|
잔고평가액. |
required |
net_amt
|
str
|
예탁자산평가액. |
required |
tot_book_amt2
|
str
|
총매입금액. |
required |
tot_dep_amt
|
str
|
추정예탁자산. |
required |
paym_alowa
|
str
|
출금가능금액. |
required |
pl_amt
|
str
|
실현손익. |
required |
items
|
list[GoldBalanceItem]
|
금현물계좌평가현황 리스트. |
required |
GoldBalanceItem
dataclass
¶
GoldBalanceItem(stk_cd: str, stk_nm: str, real_qty: str, avg_prc: str, cur_prc: str, est_amt: str, est_lspft: str, est_ratio: str, cmsn: str, vlad_tax: str, book_amt2: str, pl_prch_prc: str, qty: str, buy_qty: str, sell_qty: str, able_qty: str)
금현물계좌평가현황 단일 항목.
GoldBid
dataclass
¶
금현물 호가 응답 (ka50101).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldBidItem]
|
금현물 호가 리스트. |
required |
GoldBidItem
dataclass
¶
GoldBidItem(cntr_pric: str, pred_pre: str, flu_rt: str, trde_qty: str, acc_trde_prica: str, cntr_trde_qty: str, tm: str, pre_sig: str, pri_sel_bid_unit: str, pri_buy_bid_unit: str, trde_pre: str, trde_tern_rt: str, cntr_str: str, lpmmcm_nm_1: str, stex_tp: str)
금현물 호가 단일 항목.
GoldCancelOrderResponse
dataclass
¶
금현물 취소주문 응답 (kt50003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
base_orig_ord_no
|
str
|
모주문번호. |
required |
cncl_qty
|
str
|
취소수량. |
required |
GoldContractTrend
dataclass
¶
금현물체결추이요청 응답 (ka50010).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldContractTrendItem]
|
금현물체결추이 리스트. |
required |
GoldContractTrendItem
dataclass
¶
GoldContractTrendItem(cntr_pric: str, pred_pre: str, flu_rt: str, trde_qty: str, acc_trde_prica: str, cntr_trde_qty: str, tm: str, pre_sig: str, pri_sel_bid_unit: str, pri_buy_bid_unit: str, trde_pre: str, trde_tern_rt: str, cntr_str: str)
금현물체결추이 단일 항목.
GoldDailyChart
dataclass
¶
금현물일봉차트조회요청 응답 (ka50081).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldDailyChartItem]
|
금현물일봉차트 리스트. |
required |
GoldDailyChartItem
dataclass
¶
GoldDailyChartItem(cur_prc: str, acc_trde_qty: str, acc_trde_prica: str, open_pric: str, high_pric: str, low_pric: str, dt: str, pred_pre_sig: str)
금현물일봉차트 단일 항목.
GoldDailyMinuteChart
dataclass
¶
금현물당일분봉차트조회요청 응답 (ka50092).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldDailyMinuteChartItem]
|
금현물당일분봉차트 리스트. |
required |
GoldDailyMinuteChartItem
dataclass
¶
GoldDailyMinuteChartItem(cntr_pric: str, pred_pre: str, acc_trde_qty: str, acc_trde_prica: str, trde_qty: str, open_pric: str, high_pric: str, low_pric: str, cntr_tm: str, dt: str, pred_pre_sig: str)
금현물당일분봉차트 단일 항목.
GoldDailyTickChart
dataclass
¶
금현물당일틱차트조회요청 응답 (ka50091).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldDailyTickChartItem]
|
금현물당일틱차트 리스트. |
required |
GoldDailyTickChartItem
dataclass
¶
GoldDailyTickChartItem(cntr_pric: str, pred_pre: str, trde_qty: str, open_pric: str, high_pric: str, low_pric: str, cntr_tm: str, dt: str, pred_pre_sig: str)
금현물당일틱차트 단일 항목.
GoldDailyTrend
dataclass
¶
금현물일별추이요청 응답 (ka50012).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldDailyTrendItem]
|
금현물일별추이 리스트. |
required |
GoldDailyTrendItem
dataclass
¶
GoldDailyTrendItem(cur_prc: str, pred_pre: str, flu_rt: str, trde_qty: str, acc_trde_prica: str, open_pric: str, high_pric: str, low_pric: str, dt: str, pre_sig: str, orgn_netprps: str, for_netprps: str, ind_netprps: str)
금현물일별추이 단일 항목.
GoldDeposit
dataclass
¶
GoldDeposit(entra: str, profa_ch: str, chck_ina_amt: str, etc_loan: str, etc_loan_dlfe: str, etc_loan_tot: str, prsm_entra: str, buy_exct_amt: str, sell_exct_amt: str, sell_buy_exct_amt: str, dly_amt: str, prsm_pymn_alow_amt: str, pymn_alow_amt: str, ord_alow_amt: str)
금현물 예수금 응답 (kt50021).
GoldExpectedContract
dataclass
¶
금현물예상체결요청 응답 (ka50087).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldExpectedContractItem]
|
금현물예상체결 리스트. |
required |
GoldExpectedContractItem
dataclass
¶
GoldExpectedContractItem(exp_cntr_pric: str, exp_pred_pre: str, exp_flu_rt: str, exp_acc_trde_qty: str, exp_cntr_trde_qty: str, exp_tm: str, exp_pre_sig: str, stex_tp: str)
금현물예상체결 단일 항목.
GoldInvestorStatus
dataclass
¶
금현물투자자현황 응답 (ka52301).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldInvestorStatusItem]
|
투자자현황 리스트. |
required |
GoldInvestorStatusItem
dataclass
¶
GoldInvestorStatusItem(stk_nm: str, stk_cd: str, all_dfrt_trst_sell_qty: str, sell_qty_irds: str, all_dfrt_trst_sell_amt: str, sell_amt_irds: str, all_dfrt_trst_buy_qty: str, buy_qty_irds: str, all_dfrt_trst_buy_amt: str, buy_amt_irds: str, all_dfrt_trst_netprps_qty: str, netprps_qty_irds: str, all_dfrt_trst_netprps_amt: str, netprps_amt_irds: str, sell_uv: str, buy_uv: str, acc_netprps_amt: str, acc_netprps_qty: str)
금현물투자자현황 단일 항목.
GoldMarketInfo
dataclass
¶
GoldMarketInfo(pred_pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, open_pric: str, high_pric: str, low_pric: str, pred_rt: str, upl_pric: str, lst_pric: str, pred_close_pric: str)
금현물 시세정보 응답 (ka50100).
GoldMinuteChart
dataclass
¶
금현물분봉차트조회요청 응답 (ka50080).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldMinuteChartItem]
|
금현물분봉차트 리스트. |
required |
GoldMinuteChartItem
dataclass
¶
GoldMinuteChartItem(cur_prc: str, pred_pre: str, acc_trde_qty: str, trde_qty: str, open_pric: str, high_pric: str, low_pric: str, cntr_tm: str, dt: str, pred_pre_sig: str)
금현물분봉차트 단일 항목.
GoldModifyOrderResponse
dataclass
¶
금현물 정정주문 응답 (kt50002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
base_orig_ord_no
|
str
|
모주문번호. |
required |
mdfy_qty
|
str
|
정정수량. |
required |
GoldMonthlyChart
dataclass
¶
금현물월봉차트조회요청 응답 (ka50083).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldMonthlyChartItem]
|
금현물월봉차트 리스트. |
required |
GoldMonthlyChartItem
dataclass
¶
GoldMonthlyChartItem(cur_prc: str, acc_trde_qty: str, acc_trde_prica: str, open_pric: str, high_pric: str, low_pric: str, dt: str)
금현물월봉차트 단일 항목.
GoldOrderDetail
dataclass
¶
금현물 주문체결조회 응답 (kt50031).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldOrderDetailItem]
|
계좌별주문체결내역상세 리스트. |
required |
GoldOrderDetailItem
dataclass
¶
GoldOrderDetailItem(ord_no: str, stk_cd: str, trde_tp: str, crd_tp: str, ord_qty: str, ord_uv: str, cnfm_qty: str, acpt_tp: str, rsrv_tp: str, ord_tm: str, ori_ord: str, stk_nm: str, io_tp_nm: str, loan_dt: str, cntr_qty: str, cntr_uv: str, ord_remnq: str, comm_ord_tp: str, mdfy_cncl: str, cnfm_tm: str, dmst_stex_tp: str, cond_uv: str)
금현물 주문체결조회 단일 항목.
GoldOrderResponse
dataclass
¶
금현물 매수/매도주문 응답 (kt50000, kt50001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
GoldOrderStatus
dataclass
¶
금현물 주문체결전체조회 응답 (kt50030).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldOrderStatusItem]
|
계좌별주문체결현황 리스트. |
required |
GoldOrderStatusItem
dataclass
¶
GoldOrderStatusItem(stk_bond_tp: str, ord_no: str, stk_cd: str, trde_tp: str, io_tp_nm: str, ord_qty: str, ord_uv: str, cnfm_qty: str, data_send_end_tp: str, mrkt_deal_tp: str, rsrv_tp: str, orig_ord_no: str, stk_nm: str, dcd_tp_nm: str, crd_deal_tp: str, cntr_qty: str, cntr_uv: str, ord_remnq: str, comm_ord_tp: str, mdfy_cncl_tp: str, dmst_stex_tp: str, cond_uv: str)
금현물 주문체결전체조회 단일 항목.
GoldTickChart
dataclass
¶
금현물틱차트조회요청 응답 (ka50079).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldTickChartItem]
|
금현물틱차트 리스트. |
required |
GoldTickChartItem
dataclass
¶
GoldTickChartItem(cur_prc: str, pred_pre: str, trde_qty: str, open_pric: str, high_pric: str, low_pric: str, cntr_tm: str, dt: str, pred_pre_sig: str)
금현물틱차트 단일 항목.
GoldTradeHistory
dataclass
¶
금현물 거래내역조회 응답 (kt50032).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
acnt_print
|
str
|
계좌번호 출력용. |
required |
items
|
list[GoldTradeHistoryItem]
|
금현물거래내역 리스트. |
required |
GoldTradeHistoryItem
dataclass
¶
GoldTradeHistoryItem(deal_dt: str, deal_no: str, rmrk_nm: str, deal_qty: str, gold_spot_vat: str, exct_amt: str, dly_sum: str, entra_remn: str, mdia_nm: str, orig_deal_no: str, stk_nm: str, uv_exrt: str, cmsn: str, uncl_ocr: str, rpym_sum: str, spot_remn: str, proc_time: str, rcpy_no: str, stk_cd: str, deal_amt: str, tax_tot_amt: str, cntr_dt: str, proc_brch_nm: str, prcsr: str)
금현물 거래내역조회 단일 항목.
GoldUnfilled
dataclass
¶
금현물 미체결조회 응답 (kt50075).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldUnfilledItem]
|
계좌별주문미체결현황 리스트. |
required |
GoldUnfilledItem
dataclass
¶
GoldUnfilledItem(stk_bond_tp: str, ord_no: str, stk_cd: str, trde_tp: str, io_tp_nm: str, ord_qty: str, ord_uv: str, cnfm_qty: str, data_send_end_tp: str, mrkt_deal_tp: str, rsrv_tp: str, orig_ord_no: str, stk_nm: str, dcd_tp_nm: str, crd_deal_tp: str, cntr_qty: str, cntr_uv: str, ord_remnq: str, comm_ord_tp: str, mdfy_cncl_tp: str, dmst_stex_tp: str, cond_uv: str)
금현물 미체결조회 단일 항목.
GoldWeeklyChart
dataclass
¶
금현물주봉차트조회요청 응답 (ka50082).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[GoldWeeklyChartItem]
|
금현물주봉차트 리스트. |
required |
GoldWeeklyChartItem
dataclass
¶
GoldWeeklyChartItem(cur_prc: str, acc_trde_qty: str, acc_trde_prica: str, open_pric: str, high_pric: str, low_pric: str, dt: str)
금현물주봉차트 단일 항목.
HighLowPER
dataclass
¶
고저PER 응답 (ka10026).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[HighLowPERItem]
|
고저PER 종목 리스트. |
required |
HighLowPERItem
dataclass
¶
고저PER 단일 항목 (ka10026).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
per
|
str
|
PER 값. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
now_trde_qty
|
str
|
현재거래량 (주). |
required |
HighLowStockItem
dataclass
¶
HighLowStockItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, trde_qty: str, high_pric: str, low_pric: str)
신고저가 단일 항목 (ka10016).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
HighLowStocks
dataclass
¶
신고저가 응답 (ka10016).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[HighLowStockItem]
|
신고저가 종목 리스트. |
required |
HoldingItem
dataclass
¶
HoldingItem(stk_cd: str, stk_nm: str, evltv_prft: str, prft_rt: str, pur_pric: str, pred_close_pric: str, rmnd_qty: str, trde_able_qty: str, cur_prc: str, pred_buyq: str, pred_sellq: str, tdy_buyq: str, tdy_sellq: str, pur_amt: str, pur_cmsn: str, evlt_amt: str, sell_cmsn: str, tax: str, sum_cmsn: str, poss_rt: str, crd_tp: str, crd_tp_nm: str, crd_loan_dt: str)
계좌평가잔고 종목 항목 (kt00018 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목번호. |
required |
stk_nm
|
str
|
종목명. |
required |
rmnd_qty
|
str
|
보유수량 (단위: 주). |
required |
trde_able_qty
|
str
|
매매가능수량 (단위: 주). |
required |
cur_prc
|
str
|
현재가 (단위: 원). |
required |
pur_pric
|
str
|
매입가 (단위: 원). |
required |
pur_amt
|
str
|
매입금액 (단위: 원). |
required |
evlt_amt
|
str
|
평가금액 (단위: 원). |
required |
evltv_prft
|
str
|
평가손익 (단위: 원). |
required |
prft_rt
|
str
|
수익률(%) (단위: %). |
required |
poss_rt
|
str
|
보유비중(%) (단위: %). |
required |
InstFrgnConsecutiveItem
dataclass
¶
InstFrgnConsecutiveItem(rank: str, stk_cd: str, stk_nm: str, prid_stkpc_flu_rt: str, orgn_nettrde_amt: str, orgn_nettrde_qty: str, orgn_cont_netprps_dys: str, orgn_cont_netprps_qty: str, orgn_cont_netprps_amt: str, frgnr_nettrde_qty: str, frgnr_nettrde_amt: str, frgnr_cont_netprps_dys: str, frgnr_cont_netprps_qty: str, frgnr_cont_netprps_amt: str, nettrde_qty: str, nettrde_amt: str, tot_cont_netprps_dys: str, tot_cont_nettrde_qty: str, tot_cont_netprps_amt: str)
기관외국인연속매매현황 단일 항목.
InstFrgnConsecutiveTrade
dataclass
¶
기관외국인연속매매현황요청 응답 (ka10131).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[InstFrgnConsecutiveItem]
|
기관외국인연속매매현황 리스트. |
required |
InstitutionTrade
dataclass
¶
InstitutionTrade(date: str, close_pric: str, pre: str, orgn_dt_acc: str, orgn_daly_nettrde: str, frgnr_daly_nettrde: str, frgnr_qota_rt: str)
주식기관요청 응답 (ka10009).
IntraInvestorChart
dataclass
¶
장중투자자별매매차트 응답 (ka10064).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[IntraInvestorChartItem]
|
장중투자자 매매 차트 리스트. |
required |
IntraInvestorChartItem
dataclass
¶
IntraInvestorChartItem(tm: str, frgnr_invsr: str, orgn: str, invtrt: str, insrnc: str, bank: str, penfnd_etc: str, etc_corp: str, natn: str)
장중투자자별매매차트 단일 항목 (ka10064).
IntradayInvestorItem
dataclass
¶
IntradayInvestorItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, acc_trde_qty: str, netprps_qty: str, buy_qty: str, sell_qty: str)
장중투자자별매매 단일 항목 (ka10063).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
netprps_qty
|
str
|
순매수수량 (주). |
required |
buy_qty
|
str
|
매수수량 (주). |
required |
sell_qty
|
str
|
매도수량 (주). |
required |
IntradayInvestorTrading
dataclass
¶
장중투자자별매매 응답 (ka10063).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[IntradayInvestorItem]
|
종목별 투자자 매매 리스트. |
required |
InvestorChart
dataclass
¶
종목별투자자기관별차트 응답 (ka10060).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[InvestorChartItem]
|
투자자기관별 차트 리스트. |
required |
InvestorChartItem
dataclass
¶
InvestorChartItem(dt: str, cur_prc: str, pred_pre: str, acc_trde_prica: str, ind_invsr: str, frgnr_invsr: str, orgn: str, fnnc_invt: str, insrnc: str, invtrt: str, etc_fnnc: str, bank: str, penfnd_etc: str, samo_fund: str, natn: str, etc_corp: str, natfor: str)
종목별투자자기관별차트 단일 항목 (ka10060).
InvestorDailyStockItem
dataclass
¶
InvestorDailyStockItem(stk_cd: str, stk_nm: str, netslmt_qty: str, netslmt_amt: str, cur_prc: str, pre_rt: str)
투자자별일별매매종목 단일 항목 (ka10058).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
netslmt_qty
|
str
|
순매도수량 (주). |
required |
netslmt_amt
|
str
|
순매도금액 (백만원). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
pre_rt
|
str
|
대비율 (%). |
required |
InvestorDailyStocks
dataclass
¶
투자자별일별매매종목 응답 (ka10058).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[InvestorDailyStockItem]
|
종목별 리스트. |
required |
InvestorTradeUpper
dataclass
¶
장중투자자별매매상위 응답 (ka10065).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[InvestorTradeUpperItem]
|
장중투자자별매매상위 종목 리스트. |
required |
InvestorTradeUpperItem
dataclass
¶
장중투자자별매매상위 단일 항목 (ka10065).
LimitStockItem
dataclass
¶
LimitStockItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, trde_qty: str, sel_bid: str, buy_bid: str, cnt: str)
상하한가 단일 항목 (ka10017).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
sel_bid
|
str
|
매도호가 (원). |
required |
buy_bid
|
str
|
매수호가 (원). |
required |
cnt
|
str
|
연속횟수. |
required |
LimitStocks
dataclass
¶
상하한가 응답 (ka10017).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[LimitStockItem]
|
상하한가 종목 리스트. |
required |
MarginDetail
dataclass
¶
MarginDetail(tdy_reu_alowa: str, tdy_reu_alowa_fin: str, pred_reu_alowa: str, pred_reu_alowa_fin: str, use_pos_ch: str, use_pos_ch_fin: str, use_pos_repl: str, use_pos_repl_fin: str, uncla: str, ord_alow_20: str, ord_alow_30: str, ord_alow_40: str, ord_alow_50: str, ord_alow_60: str, ord_alow_100: str, d2vexct_entr: str, d2ch_ord_alow_amt: str)
증거금세부내역 응답 (kt00013).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
use_pos_ch
|
str
|
사용가능현금 (단위: 원). |
required |
use_pos_repl
|
str
|
사용가능대용 (단위: 원). |
required |
uncla
|
str
|
미수금 (단위: 원). |
required |
MarketSummary
dataclass
¶
MarketSummary(stk_nm: str, stk_cd: str, date: str, tm: str, cur_prc: str, flu_rt: str, open_pric: str, high_pric: str, low_pric: str, trde_qty: str, trde_prica: str, pred_close_pric: str, upl_pric: str, lst_pric: str, exp_cntr_pric: str, exp_cntr_qty: str, tot_buy_req: str, tot_sel_req: str)
시세표성정보 응답 (ka10007). 종목의 현재가·호가·예상체결 등 종합 시세.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_nm
|
str
|
종목명. |
required |
stk_cd
|
str
|
종목코드. |
required |
date
|
str
|
날짜 (YYYYMMDD). |
required |
tm
|
str
|
시간 (HHMMSS). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
open_pric
|
str
|
시가 (원). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
trde_prica
|
str
|
거래대금 (백만원). |
required |
pred_close_pric
|
str
|
전일종가 (원). |
required |
upl_pric
|
str
|
상한가 (원). |
required |
lst_pric
|
str
|
하한가 (원). |
required |
exp_cntr_pric
|
str
|
예상체결가 (원). |
required |
exp_cntr_qty
|
str
|
예상체결량 (주). |
required |
tot_buy_req
|
str
|
총매수잔량. |
required |
tot_sel_req
|
str
|
총매도잔량. |
required |
ModifyOrderResponse
dataclass
¶
주식 정정주문 응답 (kt10002, kt10008).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호 (새로 발급된 정정 주문번호). |
required |
base_orig_ord_no
|
str
|
모주문번호 (최초 원주문번호). |
required |
mdfy_qty
|
str
|
정정수량 (단위: 주). |
required |
dmst_stex_tp
|
str
|
국내거래소구분. |
required |
NearHighLow
dataclass
¶
고저가근접 응답 (ka10018).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[NearHighLowItem]
|
고저가근접 종목 리스트. |
required |
NearHighLowItem
dataclass
¶
NearHighLowItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, trde_qty: str, tdy_high_pric: str, tdy_low_pric: str)
고저가근접 단일 항목 (ka10018).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
tdy_high_pric
|
str
|
당일고가 (원). |
required |
tdy_low_pric
|
str
|
당일저가 (원). |
required |
NetBuyBrokerRank
dataclass
¶
순매수거래원순위 응답 (ka10042).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[NetBuyBrokerRankItem]
|
순매수거래원순위 리스트. |
required |
NetBuyBrokerRankItem
dataclass
¶
순매수거래원순위 단일 항목 (ka10042).
NewStockRightsItem
dataclass
¶
NewStockRightsItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre: str, flu_rt: str, acc_trde_qty: str, open_pric: str, high_pric: str, low_pric: str)
신주인수권 시세 단일 항목 (ka10011).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
pred_pre
|
str
|
전일대비 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
open_pric
|
str
|
시가 (원). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
NewStockRightsPrices
dataclass
¶
신주인수권전체시세 응답 (ka10011).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[NewStockRightsItem]
|
신주인수권 시세 리스트. |
required |
NextDaySettlement
dataclass
¶
NextDaySettlement(trde_dt: str, setl_dt: str, sell_amt_sum: str, buy_amt_sum: str, items: list[NextDaySettlementItem] = list())
계좌별익일결제예정내역 응답 (kt00008).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
trde_dt
|
str
|
매매일자. |
required |
setl_dt
|
str
|
결제일자. |
required |
sell_amt_sum
|
str
|
매도정산합 (단위: 원). |
required |
buy_amt_sum
|
str
|
매수정산합 (단위: 원). |
required |
items
|
list[NextDaySettlementItem]
|
결제예정내역 목록. |
list()
|
NextDaySettlementItem
dataclass
¶
NextDaySettlementItem(seq: str, stk_cd: str, loan_dt: str, qty: str, engg_amt: str, cmsn: str, incm_tax: str, rstx: str, stk_nm: str, sell_tp: str, unp: str, exct_amt: str, trde_tax: str, resi_tax: str, crd_tp: str)
계좌별익일결제예정내역 항목 (kt00008 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목번호. |
required |
stk_nm
|
str
|
종목명. |
required |
qty
|
str
|
수량 (단위: 주). |
required |
engg_amt
|
str
|
약정금액 (단위: 원). |
required |
exct_amt
|
str
|
정산금액 (단위: 원). |
required |
sell_tp
|
str
|
매도수구분. |
required |
OpenPriceChange
dataclass
¶
시가대비등락률 응답 (ka10028).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[OpenPriceChangeItem]
|
시가대비등락률 종목 리스트. |
required |
OpenPriceChangeItem
dataclass
¶
OpenPriceChangeItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, open_pric: str, open_pric_pre: str, now_trde_qty: str)
시가대비등락률 단일 항목 (ka10028).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
open_pric
|
str
|
시가 (원). |
required |
open_pric_pre
|
str
|
시가대비 (%). |
required |
now_trde_qty
|
str
|
현재거래량 (주). |
required |
OrderExecutionStatus
dataclass
¶
OrderExecutionStatus(sell_grntl_engg_amt: str, buy_engg_amt: str, engg_amt: str, items: list[OrderExecutionStatusItem] = list())
계좌별주문체결현황 응답 (kt00009).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
sell_grntl_engg_amt
|
str
|
매도약정금액 (단위: 원). |
required |
buy_engg_amt
|
str
|
매수약정금액 (단위: 원). |
required |
engg_amt
|
str
|
약정금액 (단위: 원). |
required |
items
|
list[OrderExecutionStatusItem]
|
주문체결현황 목록. |
list()
|
OrderExecutionStatusItem
dataclass
¶
OrderExecutionStatusItem(stk_bond_tp: str, ord_no: str, stk_cd: str, trde_tp: str, io_tp_nm: str, ord_qty: str, ord_uv: str, cnfm_qty: str, rsrv_oppo: str, cntr_no: str, acpt_tp: str, orig_ord_no: str, stk_nm: str, setl_tp: str, crd_deal_tp: str, cntr_qty: str, cntr_uv: str, comm_ord_tp: str, mdfy_cncl_tp: str, cntr_tm: str, dmst_stex_tp: str, cond_uv: str)
계좌별주문체결현황 항목 (kt00009 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
stk_cd
|
str
|
종목번호. |
required |
stk_nm
|
str
|
종목명. |
required |
trde_tp
|
str
|
매매구분. |
required |
ord_qty
|
str
|
주문수량 (단위: 주). |
required |
cntr_qty
|
str
|
체결수량 (단위: 주). |
required |
cntr_uv
|
str
|
체결단가 (단위: 원). |
required |
OrderHistoryDetailItem
dataclass
¶
OrderHistoryDetailItem(ord_no: str, stk_cd: str, trde_tp: str, crd_tp: str, ord_qty: str, ord_uv: str, cnfm_qty: str, acpt_tp: str, rsrv_tp: str, ord_tm: str, ori_ord: str, stk_nm: str, io_tp_nm: str, loan_dt: str, cntr_qty: str, cntr_uv: str, ord_remnq: str, comm_ord_tp: str, mdfy_cncl: str, cnfm_tm: str, dmst_stex_tp: str, cond_uv: str)
계좌별주문체결내역상세 항목 (kt00007 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
stk_cd
|
str
|
종목번호. |
required |
stk_nm
|
str
|
종목명. |
required |
trde_tp
|
str
|
매매구분. |
required |
ord_qty
|
str
|
주문수량 (단위: 주). |
required |
cntr_qty
|
str
|
체결수량 (단위: 주). |
required |
cntr_uv
|
str
|
체결단가 (단위: 원). |
required |
ord_tm
|
str
|
주문시간. |
required |
OrderResponse
dataclass
¶
주식 매수/매도 주문 응답 (kt10000, kt10001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
dmst_stex_tp
|
str
|
국내거래소구분. |
required |
OrderableAmount
dataclass
¶
OrderableAmount(profa_20ord_alow_amt: str, profa_20ord_alowq: str, profa_30ord_alow_amt: str, profa_30ord_alowq: str, profa_40ord_alow_amt: str, profa_40ord_alowq: str, profa_50ord_alow_amt: str, profa_50ord_alowq: str, profa_60ord_alow_amt: str, profa_60ord_alowq: str, profa_100ord_alow_amt: str, profa_100ord_alowq: str, entr: str, repl_amt: str, ord_alowa: str, wthd_alowa: str, nxdy_wthd_alowa: str, d2entra: str)
주문인출가능금액 응답 (kt00010).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
entr
|
str
|
예수금 (단위: 원). |
required |
ord_alowa
|
str
|
주문가능현금 (단위: 원). |
required |
wthd_alowa
|
str
|
인출가능금액 (단위: 원). |
required |
profa_20ord_alow_amt
|
str
|
증거금20% 주문가능금액 (단위: 원). |
required |
profa_20ord_alowq
|
str
|
증거금20% 주문가능수량 (단위: 주). |
required |
OrderableQuantity
dataclass
¶
OrderableQuantity(stk_profa_rt: str, profa_rt: str, aplc_rt: str, profa_20ord_alow_amt: str, profa_20ord_alowq: str, profa_30ord_alow_amt: str, profa_30ord_alowq: str, profa_40ord_alow_amt: str, profa_40ord_alowq: str, profa_50ord_alow_amt: str, profa_50ord_alowq: str, profa_60ord_alow_amt: str, profa_60ord_alowq: str, profa_100ord_alow_amt: str, profa_100ord_alowq: str, entr: str, repl_amt: str, ord_alowa: str)
증거금율별주문가능수량 응답 (kt00011).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_profa_rt
|
str
|
종목증거금율. |
required |
profa_rt
|
str
|
계좌증거금율. |
required |
entr
|
str
|
예수금 (단위: 원). |
required |
ord_alowa
|
str
|
주문가능현금 (단위: 원). |
required |
Orderbook
dataclass
¶
Orderbook(base_time: str, sell_levels: list[OrderbookLevel], buy_levels: list[OrderbookLevel], tot_sell_qty: str, tot_buy_qty: str, tot_sell_qty_change: str, tot_buy_qty_change: str, ovt_sell_qty: str, ovt_buy_qty: str, ovt_sell_qty_change: str, ovt_buy_qty_change: str)
주식호가 응답 (ka10004).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
base_time
|
str
|
호가잔량기준시간 (HHMMSS). |
required |
sell_levels
|
list[OrderbookLevel]
|
매도호가 1~10차선 리스트 (인덱스 0=최우선). |
required |
buy_levels
|
list[OrderbookLevel]
|
매수호가 1~10차선 리스트 (인덱스 0=최우선). |
required |
tot_sell_qty
|
str
|
총매도잔량. |
required |
tot_buy_qty
|
str
|
총매수잔량. |
required |
tot_sell_qty_change
|
str
|
총매도잔량직전대비. |
required |
tot_buy_qty_change
|
str
|
총매수잔량직전대비. |
required |
ovt_sell_qty
|
str
|
시간외매도잔량. |
required |
ovt_buy_qty
|
str
|
시간외매수잔량. |
required |
ovt_sell_qty_change
|
str
|
시간외매도잔량대비. |
required |
ovt_buy_qty_change
|
str
|
시간외매수잔량대비. |
required |
OrderbookLevel
dataclass
¶
호가 단일 레벨 (매도/매수 각 호가·잔량·직전대비).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
price
|
str
|
호가 (단위: 원). |
required |
qty
|
str
|
잔량 (단위: 주). |
required |
qty_change
|
str
|
잔량직전대비. |
required |
PrevTradeQtyUpper
dataclass
¶
전일거래량상위 응답 (ka10031).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[PrevTradeQtyUpperItem]
|
전일거래량상위 종목 리스트. |
required |
PrevTradeQtyUpperItem
dataclass
¶
PrevTradeQtyUpperItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, trde_qty: str)
전일거래량상위 단일 항목 (ka10031).
PriceChangeUpper
dataclass
¶
전일대비등락률상위 응답 (ka10027).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[PriceChangeUpperItem]
|
등락률상위 종목 리스트. |
required |
PriceChangeUpperItem
dataclass
¶
PriceChangeUpperItem(stk_cls: str, stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, sel_req: str, buy_req: str, now_trde_qty: str, cntr_str: str, cnt: str)
전일대비등락률상위 단일 항목 (ka10027).
PriceSurgeItem
dataclass
¶
PriceSurgeItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, base_pric: str, jmp_rt: str, trde_qty: str)
가격급등락 단일 항목 (ka10019).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
base_pric
|
str
|
기준가 (원). |
required |
jmp_rt
|
str
|
급등률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
PriceSurgeStocks
dataclass
¶
가격급등락 응답 (ka10019).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[PriceSurgeItem]
|
급등락 종목 리스트. |
required |
ProgramAccTrend
dataclass
¶
프로그램매매누적추이요청 응답 (ka90007).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ProgramAccTrendItem]
|
프로그램매매누적추이 리스트. |
required |
ProgramAccTrendItem
dataclass
¶
ProgramAccTrendItem(dt: str, kospi200: str, basis: str, dfrt_trde_tdy: str, dfrt_trde_acc: str, ndiffpro_trde_tdy: str, ndiffpro_trde_acc: str, all_tdy: str, all_acc: str)
프로그램매매누적추이 단일 항목.
ProgramArbitrageBal
dataclass
¶
프로그램매매차익잔고추이요청 응답 (ka90006).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ProgramArbitrageBalItem]
|
프로그램매매차익잔고추이 리스트. |
required |
ProgramArbitrageBalItem
dataclass
¶
ProgramArbitrageBalItem(dt: str, buy_dfrt_trde_qty: str, buy_dfrt_trde_amt: str, buy_dfrt_trde_irds_amt: str, sel_dfrt_trde_qty: str, sel_dfrt_trde_amt: str, sel_dfrt_trde_irds_amt: str)
프로그램매매차익잔고추이 단일 항목.
ProgramTop50
dataclass
¶
프로그램순매수상위50요청 응답 (ka90003).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ProgramTop50Item]
|
프로그램순매수상위50 리스트. |
required |
ProgramTop50Item
dataclass
¶
ProgramTop50Item(rank: str, stk_cd: str, stk_nm: str, cur_prc: str, flu_sig: str, pred_pre: str, flu_rt: str, acc_trde_qty: str, prm_sell_amt: str, prm_buy_amt: str, prm_netprps_amt: str)
프로그램순매수상위50 단일 항목.
ProgramTrend
dataclass
¶
프로그램매매추이요청 응답 (ka90005, ka90010).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ProgramTrendItem]
|
프로그램매매추이 리스트. |
required |
ProgramTrendItem
dataclass
¶
ProgramTrendItem(cntr_tm: str, dfrt_trde_sel: str, dfrt_trde_buy: str, dfrt_trde_netprps: str, ndiffpro_trde_sel: str, ndiffpro_trde_buy: str, ndiffpro_trde_netprps: str, dfrt_trde_sell_qty: str, dfrt_trde_buy_qty: str, dfrt_trde_netprps_qty: str, ndiffpro_trde_sell_qty: str, ndiffpro_trde_buy_qty: str, ndiffpro_trde_netprps_qty: str, all_sel: str, all_buy: str, all_netprps: str, kospi200: str, basis: str)
프로그램매매추이 단일 항목.
QtyRatioSurge
dataclass
¶
잔량율급증 응답 (ka10022).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[QtyRatioSurgeItem]
|
잔량율급증 종목 리스트. |
required |
QtyRatioSurgeItem
dataclass
¶
QtyRatioSurgeItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, base_rt: str, now_rt: str, sdnin_rt: str, tot_sel_req: str, tot_buy_req: str)
잔량율급증 단일 항목 (ka10022).
RealizedProfitByDateItem
dataclass
¶
RealizedProfitByDateItem(stk_nm: str, cntr_qty: str, buy_uv: str, cntr_pric: str, tdy_sel_pl: str, pl_rt: str, stk_cd: str, tdy_trde_cmsn: str, tdy_trde_tax: str, wthd_alowa: str, loan_dt: str, crd_tp: str)
일자별종목별실현손익 항목 (ka10072 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cntr_qty
|
str
|
체결량 (단위: 주). |
required |
buy_uv
|
str
|
매입단가 (단위: 원). |
required |
cntr_pric
|
str
|
체결가 (단위: 원). |
required |
tdy_sel_pl
|
str
|
당일매도손익 (단위: 원). |
required |
pl_rt
|
str
|
손익율 (단위: %). |
required |
RealizedProfitByPeriodItem
dataclass
¶
RealizedProfitByPeriodItem(dt: str, tdy_htssel_cmsn: str, stk_nm: str, cntr_qty: str, buy_uv: str, cntr_pric: str, tdy_sel_pl: str, pl_rt: str, stk_cd: str, tdy_trde_cmsn: str, tdy_trde_tax: str, wthd_alowa: str, loan_dt: str, crd_tp: str)
일자별종목별실현손익 항목 (ka10073 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자. |
required |
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
tdy_sel_pl
|
str
|
당일매도손익 (단위: 원). |
required |
pl_rt
|
str
|
손익율 (단위: %). |
required |
RealtimeEvent
dataclass
¶
실시간 WebSocket 수신 이벤트.
서버에서 trnm="REAL" 메시지가 수신될 때 data 배열의 각 항목을 이 dataclass로 파싱한다.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
type
|
str
|
실시간 항목 TR명. (예: |
required |
name
|
str
|
실시간 항목명. (예: |
required |
item
|
str
|
종목코드 또는 item 식별자. 계좌 기반 타입( |
required |
values
|
dict[str, str]
|
필드번호 → 값 딕셔너리. (예: |
required |
Example
event.values.get("10", "") # 현재가 '+60700' event.values.get("20", "") # 체결시간 '165208'
RevokeTokenRequest
dataclass
¶
접근토큰 폐기 요청 (au10002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
appkey
|
str
|
키움증권 앱 키. |
required |
secretkey
|
str
|
키움증권 시크릿 키. |
required |
token
|
str
|
폐기할 접근토큰. |
required |
SameNetTradeRank
dataclass
¶
동일순매매순위 응답 (ka10062).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[SameNetTradeRankItem]
|
동일순매매순위 종목 리스트. |
required |
SameNetTradeRankItem
dataclass
¶
SameNetTradeRankItem(stk_cd: str, rank: str, stk_nm: str, cur_prc: str, pre_sig: str, pred_pre: str, flu_rt: str, acc_trde_qty: str, orgn_nettrde_qty: str, orgn_nettrde_amt: str, orgn_nettrde_avg_pric: str, for_nettrde_qty: str, for_nettrde_amt: str, for_nettrde_avg_pric: str, nettrde_qty: str, nettrde_amt: str)
동일순매매순위 단일 항목 (ka10062).
SectorCandleItem
dataclass
¶
SectorCandleItem(cur_prc: str, trde_qty: str, cntr_tm: str, open_pric: str, high_pric: str, low_pric: str, pred_pre: str, pred_pre_sig: str)
업종 캔들 단일 항목 (틱·분봉 공통).
SectorDailyPrice
dataclass
¶
SectorDailyPrice(cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, trde_prica: str, trde_frmatn_stk_num: str, trde_frmatn_rt: str, open_pric: str, high_pric: str, low_pric: str, upl: str, rising: str, stdns: str, fall: str, lst: str, wk52_hgst_pric: str, wk52_hgst_pric_dt: str, wk52_hgst_pric_pre_rt: str, wk52_lwst_pric: str, wk52_lwst_pric_dt: str, wk52_lwst_pric_pre_rt: str, items: list[SectorDailyPriceItem])
업종현재가일별요청 응답 (ka20009).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
cur_prc
|
str
|
현재가. |
required |
items
|
list[SectorDailyPriceItem]
|
일별 현재가 리스트. |
required |
SectorDailyPriceItem
dataclass
¶
SectorDailyPriceItem(dt_n: str, cur_prc_n: str, pred_pre_sig_n: str, pred_pre_n: str, flu_rt_n: str, acc_trde_qty_n: str)
업종현재가 일별 단일 항목.
SectorDayChart
dataclass
¶
업종일봉조회 응답 (ka20006).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
inds_cd
|
str
|
업종코드. |
required |
items
|
list[SectorDayChartItem]
|
일봉 리스트. |
required |
SectorDayChartItem
dataclass
¶
SectorDayChartItem(cur_prc: str, trde_qty: str, dt: str, open_pric: str, high_pric: str, low_pric: str, trde_prica: str)
업종 일/주/월/년봉 단일 항목 (ka20006/07/08/19 공통).
SectorInvestorNetBuy
dataclass
¶
업종별투자자순매수요청 응답 (ka10051).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[SectorInvestorNetBuyItem]
|
업종별순매수 리스트. |
required |
SectorInvestorNetBuyItem
dataclass
¶
SectorInvestorNetBuyItem(inds_cd: str, inds_nm: str, cur_prc: str, pre_smbol: str, pred_pre: str, flu_rt: str, trde_qty: str, sc_netprps: str, insrnc_netprps: str, invtrt_netprps: str, bank_netprps: str, jnsinkm_netprps: str, endw_netprps: str, etc_corp_netprps: str, ind_netprps: str, frgnr_netprps: str, native_trmt_frgnr_netprps: str, natn_netprps: str, samo_fund_netprps: str, orgn_netprps: str)
업종별투자자순매수 단일 항목.
SectorItem
dataclass
¶
업종코드 단일 항목 (ka10101).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
market_code
|
str
|
시장구분코드. |
required |
code
|
str
|
업종코드. |
required |
name
|
str
|
업종명. |
required |
group
|
str
|
그룹. |
required |
SectorList
dataclass
¶
업종코드 리스트 응답 (ka10101).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[SectorItem]
|
업종코드 리스트. |
required |
SectorMinChart
dataclass
¶
업종분봉조회 응답 (ka20005).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
inds_cd
|
str
|
업종코드. |
required |
items
|
list[SectorMinChartItem]
|
분봉 캔들 리스트. |
required |
SectorMinChartItem
dataclass
¶
SectorMinChartItem(cur_prc: str, trde_qty: str, cntr_tm: str, open_pric: str, high_pric: str, low_pric: str, acc_trde_qty: str, pred_pre: str, pred_pre_sig: str)
업종분봉차트 단일 항목 (ka20005).
SectorMonthChart
dataclass
¶
업종월봉조회 응답 (ka20008).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
inds_cd
|
str
|
업종코드. |
required |
items
|
list[SectorDayChartItem]
|
월봉 리스트. |
required |
SectorPrice
dataclass
¶
SectorPrice(cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, trde_prica: str, trde_frmatn_stk_num: str, trde_frmatn_rt: str, open_pric: str, high_pric: str, low_pric: str, upl: str, rising: str, stdns: str, fall: str, lst: str, wk52_hgst_pric: str, wk52_hgst_pric_dt: str, wk52_hgst_pric_pre_rt: str, wk52_lwst_pric: str, wk52_lwst_pric_dt: str, wk52_lwst_pric_pre_rt: str, items: list[SectorPriceTmItem])
업종현재가요청 응답 (ka20001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
cur_prc
|
str
|
현재가. |
required |
items
|
list[SectorPriceTmItem]
|
시간별 현재가 리스트. |
required |
SectorPriceTmItem
dataclass
¶
SectorPriceTmItem(tm_n: str, cur_prc_n: str, pred_pre_sig_n: str, pred_pre_n: str, flu_rt_n: str, trde_qty_n: str, acc_trde_qty_n: str)
업종현재가 시간별 단일 항목.
SectorProgram
dataclass
¶
SectorProgram(dfrt_trst_sell_qty: str, dfrt_trst_sell_amt: str, dfrt_trst_buy_qty: str, dfrt_trst_buy_amt: str, dfrt_trst_netprps_qty: str, dfrt_trst_netprps_amt: str, ndiffpro_trst_sell_qty: str, ndiffpro_trst_sell_amt: str, ndiffpro_trst_buy_qty: str, ndiffpro_trst_buy_amt: str, ndiffpro_trst_netprps_qty: str, ndiffpro_trst_netprps_amt: str, all_dfrt_trst_sell_qty: str, all_dfrt_trst_sell_amt: str, all_dfrt_trst_buy_qty: str, all_dfrt_trst_buy_amt: str, all_dfrt_trst_netprps_qty: str, all_dfrt_trst_netprps_amt: str)
업종프로그램요청 응답 (ka10010).
SectorStockPriceItem
dataclass
¶
SectorStockPriceItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, now_trde_qty: str, sel_bid: str, buy_bid: str, open_pric: str, high_pric: str, low_pric: str)
업종별주가 단일 항목.
SectorStockPrices
dataclass
¶
업종별주가요청 응답 (ka20002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[SectorStockPriceItem]
|
업종별주가 리스트. |
required |
SectorTickChart
dataclass
¶
업종틱차트조회 응답 (ka20004).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
inds_cd
|
str
|
업종코드. |
required |
items
|
list[SectorCandleItem]
|
틱 캔들 리스트. |
required |
SectorWeekChart
dataclass
¶
업종주봉조회 응답 (ka20007).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
inds_cd
|
str
|
업종코드. |
required |
items
|
list[SectorDayChartItem]
|
주봉 리스트. |
required |
SectorYearChart
dataclass
¶
업종년봉조회 응답 (ka20019).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
inds_cd
|
str
|
업종코드. |
required |
items
|
list[SectorDayChartItem]
|
년봉 리스트. |
required |
ShortSellItem
dataclass
¶
ShortSellItem(dt: str, close_pric: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, shrts_qty: str, ovr_shrts_qty: str, trde_wght: str, shrts_trde_prica: str, shrts_avg_pric: str)
공매도추이 단일 항목.
ShortSellTrend
dataclass
¶
공매도추이요청 응답 (ka10014).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ShortSellItem]
|
공매도추이 리스트. |
required |
SplitOrderDetailItem
dataclass
¶
SplitOrderDetailItem(stk_cd: str, stk_nm: str, ord_no: str, ord_qty: str, ord_pric: str, osop_qty: str, io_tp_nm: str, trde_tp: str, sell_tp: str, cntr_qty: str, ord_stt: str, cur_prc: str, stex_tp: str, stex_tp_txt: str)
미체결 분할주문 상세 항목 (ka10088 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
ord_qty
|
str
|
주문수량 (단위: 주). |
required |
osop_qty
|
str
|
미체결수량 (단위: 주). |
required |
ord_stt
|
str
|
주문상태. |
required |
StockBrokerRank
dataclass
¶
StockBrokerRank(rank_1: str, rank_2: str, rank_3: str, prid_trde_qty: str, items: list[StockBrokerRankItem])
종목별증권사순위 응답 (ka10038).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
rank_1
|
str
|
순위1 (순매수/순매도 1위 수량). |
required |
rank_2
|
str
|
순위2. |
required |
rank_3
|
str
|
순위3. |
required |
prid_trde_qty
|
str
|
기간중거래량. |
required |
items
|
list[StockBrokerRankItem]
|
증권사순위 리스트. |
required |
StockBrokerRankItem
dataclass
¶
종목별증권사순위 단일 항목 (ka10038).
StockBrokers
dataclass
¶
StockBrokers(stk_cd: str, stk_nm: str, cur_prc: str, sell_brokers: list[BrokerEntry], buy_brokers: list[BrokerEntry])
주식거래원 응답 (ka10002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
sell_brokers
|
list[BrokerEntry]
|
매도거래원 1~5위 리스트. |
required |
buy_brokers
|
list[BrokerEntry]
|
매수거래원 1~5위 리스트. |
required |
StockCandleItem
dataclass
¶
StockCandleItem(cur_prc: str, trde_qty: str, cntr_tm: str, open_pric: str, high_pric: str, low_pric: str, pred_pre: str, pred_pre_sig: str)
주식 캔들 단일 항목 (틱·분봉 공통).
StockDailyProgram
dataclass
¶
종목일별프로그램매매추이요청 응답 (ka90013).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockDailyProgramItem]
|
종목일별프로그램매매추이 리스트. |
required |
StockDailyProgramItem
dataclass
¶
StockDailyProgramItem(dt: str, cur_prc: str, pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, prm_sell_amt: str, prm_buy_amt: str, prm_netprps_amt: str, prm_netprps_amt_irds: str, prm_sell_qty: str, prm_buy_qty: str, prm_netprps_qty: str, prm_netprps_qty_irds: str, base_pric_tm: str, dbrt_trde_rpy_sum: str, remn_rcvord_sum: str, stex_tp: str)
종목일별프로그램매매추이 단일 항목.
StockDayChart
dataclass
¶
주식일봉차트조회 응답 (ka10081).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
items
|
list[StockDayChartItem]
|
일봉 캔들 리스트. |
required |
StockDayChartItem
dataclass
¶
StockDayChartItem(cur_prc: str, trde_qty: str, trde_prica: str, dt: str, open_pric: str, high_pric: str, low_pric: str, pred_pre: str, pred_pre_sig: str, trde_tern_rt: str)
주식일봉차트 단일 항목 (ka10081).
StockDetail
dataclass
¶
StockDetail(code: str, name: str, list_count: str, reg_day: str, last_price: str, state: str, market_code: str, market_name: str, up_name: str, up_size_name: str, nxt_enable: str)
종목정보 조회 응답 (ka10100).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
code
|
str
|
종목코드 (단축코드). |
required |
name
|
str
|
종목명. |
required |
list_count
|
str
|
상장주식수. |
required |
reg_day
|
str
|
상장일 (YYYYMMDD). |
required |
last_price
|
str
|
전일종가 (원). |
required |
state
|
str
|
종목상태. |
required |
market_code
|
str
|
시장구분코드. |
required |
market_name
|
str
|
시장명. |
required |
up_name
|
str
|
업종명. |
required |
up_size_name
|
str
|
회사크기분류. |
required |
nxt_enable
|
str
|
NXT가능여부 (Y/N). |
required |
StockInfo
dataclass
¶
StockInfo(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, trde_qty: str, open_pric: str, high_pric: str, low_pric: str, upl_pric: str, lst_pric: str, mac: str, per: str, pbr: str, eps: str, roe: str, flo_stk: str, cap: str, oyr_hgst: str, oyr_lwst: str)
주식기본정보 응답 (ka10001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
open_pric
|
str
|
시가 (원). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
upl_pric
|
str
|
상한가 (원). |
required |
lst_pric
|
str
|
하한가 (원). |
required |
mac
|
str
|
시가총액 (억원). |
required |
per
|
str
|
PER. |
required |
pbr
|
str
|
PBR. |
required |
eps
|
str
|
EPS (원). |
required |
roe
|
str
|
ROE (%). |
required |
flo_stk
|
str
|
상장주식수 (천주). |
required |
cap
|
str
|
자본금 (억원). |
required |
oyr_hgst
|
str
|
연중최고 (원). |
required |
oyr_lwst
|
str
|
연중최저 (원). |
required |
StockInstitutionTrend
dataclass
¶
StockInstitutionTrend(orgn_prsm_avg_pric: str, for_prsm_avg_pric: str, items: list[StockInstitutionTrendItem])
종목별기관매매추이 응답 (ka10045).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
orgn_prsm_avg_pric
|
str
|
기관추정평균가 (원). |
required |
for_prsm_avg_pric
|
str
|
외인추정평균가 (원). |
required |
items
|
list[StockInstitutionTrendItem]
|
일별 추이 리스트. |
required |
StockInstitutionTrendItem
dataclass
¶
StockInstitutionTrendItem(dt: str, close_pric: str, flu_rt: str, trde_qty: str, orgn_dt_acc: str, orgn_daly_nettrde_qty: str, for_dt_acc: str, for_daly_nettrde_qty: str, limit_exh_rt: str)
종목별기관매매추이 단일 항목 (ka10045).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자 (YYYYMMDD). |
required |
close_pric
|
str
|
종가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
orgn_dt_acc
|
str
|
기관기간누적. |
required |
orgn_daly_nettrde_qty
|
str
|
기관일별순매매수량. |
required |
for_dt_acc
|
str
|
외인기간누적. |
required |
for_daly_nettrde_qty
|
str
|
외인일별순매매수량. |
required |
limit_exh_rt
|
str
|
한도소진율 (%). |
required |
StockInvestorByDay
dataclass
¶
종목별투자자기관별 응답 (ka10059).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockInvestorItem]
|
일별 투자자 리스트. |
required |
StockInvestorItem
dataclass
¶
StockInvestorItem(dt: str, cur_prc: str, flu_rt: str, acc_trde_qty: str, ind_invsr: str, frgnr_invsr: str, orgn: str, fnnc_invt: str, bank: str, penfnd_etc: str)
종목별투자자기관별 단일 항목 (ka10059).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dt
|
str
|
일자 (YYYYMMDD). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
ind_invsr
|
str
|
개인투자자. |
required |
frgnr_invsr
|
str
|
외국인투자자. |
required |
orgn
|
str
|
기관계. |
required |
fnnc_invt
|
str
|
금융투자. |
required |
bank
|
str
|
은행. |
required |
penfnd_etc
|
str
|
연기금등. |
required |
StockInvestorTotal
dataclass
¶
StockInvestorTotal(ind_invsr: str, frgnr_invsr: str, orgn: str, fnnc_invt: str, bank: str, penfnd_etc: str, samo_fund: str, natn: str, etc_corp: str)
종목별투자자기관별합계 응답 (ka10061).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ind_invsr
|
str
|
개인투자자. |
required |
frgnr_invsr
|
str
|
외국인투자자. |
required |
orgn
|
str
|
기관계. |
required |
fnnc_invt
|
str
|
금융투자. |
required |
bank
|
str
|
은행. |
required |
penfnd_etc
|
str
|
연기금등. |
required |
samo_fund
|
str
|
사모펀드. |
required |
natn
|
str
|
국가. |
required |
etc_corp
|
str
|
기타법인. |
required |
StockList
dataclass
¶
종목정보 리스트 응답 (ka10099).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockListItem]
|
종목 리스트. |
required |
StockListItem
dataclass
¶
StockListItem(code: str, name: str, list_count: str, reg_day: str, last_price: str, state: str, market_name: str, up_name: str, nxt_enable: str)
종목정보 리스트 단일 항목 (ka10099).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
code
|
str
|
종목코드 (단축코드). |
required |
name
|
str
|
종목명. |
required |
list_count
|
str
|
상장주식수. |
required |
reg_day
|
str
|
상장일 (YYYYMMDD). |
required |
last_price
|
str
|
전일종가 (원). |
required |
state
|
str
|
종목상태. |
required |
market_name
|
str
|
시장명. |
required |
up_name
|
str
|
업종명. |
required |
nxt_enable
|
str
|
NXT가능여부 (Y/N). |
required |
StockLoanByStock
dataclass
¶
대차거래추이요청(종목별) 응답 (ka20068).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockLoanByStockItem]
|
대차거래추이(종목별) 리스트. |
required |
StockLoanByStockItem
dataclass
¶
StockLoanByStockItem(dt: str, dbrt_trde_cntrcnt: str, dbrt_trde_rpy: str, dbrt_trde_irds: str, rmnd: str, remn_amt: str)
대차거래추이(종목별) 단일 항목.
StockLoanHistory
dataclass
¶
대차거래내역요청 응답 (ka90012).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockLoanHistoryItem]
|
대차거래내역 리스트. |
required |
StockLoanHistoryItem
dataclass
¶
StockLoanHistoryItem(stk_nm: str, stk_cd: str, dbrt_trde_cntrcnt: str, dbrt_trde_rpy: str, rmnd: str, remn_amt: str)
대차거래내역 단일 항목.
StockLoanItem
dataclass
¶
StockLoanItem(dt: str, dbrt_trde_cntrcnt: str, dbrt_trde_rpy: str, dbrt_trde_irds: str, rmnd: str, remn_amt: str)
대차거래추이 단일 항목.
StockLoanTop10
dataclass
¶
StockLoanTop10(dbrt_trde_cntrcnt_sum: str, dbrt_trde_rpy_sum: str, rmnd_sum: str, remn_amt_sum: str, dbrt_trde_cntrcnt_rt: str, dbrt_trde_rpy_rt: str, rmnd_rt: str, remn_amt_rt: str, items: list[StockLoanTop10Item])
대차거래상위10종목요청 응답 (ka10069).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
dbrt_trde_cntrcnt_sum
|
str
|
대차거래체결주수합. |
required |
items
|
list[StockLoanTop10Item]
|
대차거래상위10종목 리스트. |
required |
StockLoanTop10Item
dataclass
¶
StockLoanTop10Item(stk_nm: str, stk_cd: str, dbrt_trde_cntrcnt: str, dbrt_trde_rpy: str, rmnd: str, remn_amt: str)
대차거래상위10종목 단일 항목.
StockLoanTrend
dataclass
¶
대차거래추이요청 응답 (ka10068).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockLoanItem]
|
대차거래추이 리스트. |
required |
StockMinChart
dataclass
¶
주식분봉차트조회 응답 (ka10080).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
items
|
list[StockMinChartItem]
|
분봉 캔들 리스트. |
required |
StockMinChartItem
dataclass
¶
StockMinChartItem(cur_prc: str, trde_qty: str, cntr_tm: str, open_pric: str, high_pric: str, low_pric: str, pred_pre: str, pred_pre_sig: str, acc_trde_qty: str)
주식분봉차트 단일 항목 (ka10080).
StockMinutes
dataclass
¶
StockMinutes(date: str, open_pric: str, high_pric: str, low_pric: str, close_pric: str, pre: str, flu_rt: str, trde_qty: str, trde_prica: str, cntr_str: str)
주식시분 응답 (ka10006).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
date
|
str
|
날짜 (YYYYMMDD). |
required |
open_pric
|
str
|
시가 (원). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
close_pric
|
str
|
종가/현재가 (원). |
required |
pre
|
str
|
대비 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
trde_prica
|
str
|
거래대금 (백만원). |
required |
cntr_str
|
str
|
체결강도. |
required |
StockMonthChart
dataclass
¶
주식월봉차트조회 응답 (ka10083).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
items
|
list[StockMonthChartItem]
|
월봉 캔들 리스트. |
required |
StockMonthChartItem
dataclass
¶
StockMonthChartItem(cur_prc: str, trde_qty: str, trde_prica: str, dt: str, open_pric: str, high_pric: str, low_pric: str, pred_pre: str, pred_pre_sig: str, trde_tern_rt: str)
주식월봉차트 단일 항목 (ka10083).
StockPeriodItem
dataclass
¶
StockPeriodItem(date: str, open_pric: str, high_pric: str, low_pric: str, close_pric: str, pre: str, flu_rt: str, trde_qty: str, trde_prica: str, for_poss: str, for_wght: str, for_netprps: str, orgn_netprps: str, ind_netprps: str, crd_remn_rt: str, frgn: str, prm: str)
주식일주월시분 단일 항목 (ka10005).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
date
|
str
|
날짜 (YYYYMMDD). |
required |
open_pric
|
str
|
시가 (원). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
close_pric
|
str
|
종가 (원). |
required |
pre
|
str
|
대비 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
trde_prica
|
str
|
거래대금 (백만원). |
required |
for_poss
|
str
|
외인보유 (%). |
required |
for_wght
|
str
|
외인비중 (%). |
required |
for_netprps
|
str
|
외인순매수 (주). |
required |
orgn_netprps
|
str
|
기관순매수 (주). |
required |
ind_netprps
|
str
|
개인순매수 (주). |
required |
crd_remn_rt
|
str
|
신용잔고율 (%). |
required |
frgn
|
str
|
외국계. |
required |
prm
|
str
|
프로그램. |
required |
StockPeriods
dataclass
¶
주식일주월시분 응답 (ka10005).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockPeriodItem]
|
기간별 OHLCV 리스트. |
required |
StockProgramStatus
dataclass
¶
StockProgramStatus(tot_1: str, tot_2: str, tot_3: str, tot_4: str, tot_5: str, tot_6: str, items: list[StockProgramStatusItem])
종목별프로그램매매현황요청 응답 (ka90004).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tot_1
|
str
|
매수체결수량합계. |
required |
tot_2
|
str
|
매수체결금액합계. |
required |
tot_3
|
str
|
매도체결수량합계. |
required |
tot_4
|
str
|
매도체결금액합계. |
required |
tot_5
|
str
|
순매수대금합계. |
required |
tot_6
|
str
|
합계6. |
required |
items
|
list[StockProgramStatusItem]
|
종목별프로그램매매현황 리스트. |
required |
StockProgramStatusItem
dataclass
¶
StockProgramStatusItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_sig: str, pred_pre: str, buy_cntr_qty: str, buy_cntr_amt: str, sel_cntr_qty: str, sel_cntr_amt: str, netprps_prica: str, all_trde_rt: str)
종목별프로그램매매현황 단일 항목.
StockTickChart
dataclass
¶
주식틱차트조회 응답 (ka10079).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
last_tic_cnt
|
str
|
마지막틱갯수. |
required |
items
|
list[StockCandleItem]
|
틱 캔들 리스트. |
required |
StockTimeProgram
dataclass
¶
종목시간별프로그램매매추이요청 응답 (ka90008).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[StockTimeProgramItem]
|
종목시간별프로그램매매추이 리스트. |
required |
StockTimeProgramItem
dataclass
¶
StockTimeProgramItem(tm: str, cur_prc: str, pre_sig: str, pred_pre: str, flu_rt: str, trde_qty: str, prm_sell_amt: str, prm_buy_amt: str, prm_netprps_amt: str, prm_netprps_amt_irds: str, prm_sell_qty: str, prm_buy_qty: str, prm_netprps_qty: str, prm_netprps_qty_irds: str, base_pric_tm: str, dbrt_trde_rpy_sum: str, remn_rcvord_sum: str, stex_tp: str)
종목시간별프로그램매매추이 단일 항목.
StockWeekChart
dataclass
¶
주식주봉차트조회 응답 (ka10082).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
items
|
list[StockWeekChartItem]
|
주봉 캔들 리스트. |
required |
StockWeekChartItem
dataclass
¶
StockWeekChartItem(cur_prc: str, trde_qty: str, trde_prica: str, dt: str, open_pric: str, high_pric: str, low_pric: str, pred_pre: str, pred_pre_sig: str, trde_tern_rt: str)
주식주봉차트 단일 항목 (ka10082).
StockYearChart
dataclass
¶
주식년봉차트조회 응답 (ka10094).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
items
|
list[StockYearChartItem]
|
년봉 캔들 리스트. |
required |
StockYearChartItem
dataclass
¶
StockYearChartItem(cur_prc: str, trde_qty: str, trde_prica: str, dt: str, open_pric: str, high_pric: str, low_pric: str)
주식년봉차트 단일 항목 (ka10094).
SupplyConcentration
dataclass
¶
매물대집중 응답 (ka10025).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[SupplyConcentrationItem]
|
매물대집중 종목 리스트. |
required |
SupplyConcentrationItem
dataclass
¶
SupplyConcentrationItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, pric_strt: str, pric_end: str, prps_qty: str, prps_rt: str)
매물대집중 단일 항목 (ka10025).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
pric_strt
|
str
|
가격대시작 (원). |
required |
pric_end
|
str
|
가격대끝 (원). |
required |
prps_qty
|
str
|
매물량 (주). |
required |
prps_rt
|
str
|
매물비 (%). |
required |
ThemeGroup
dataclass
¶
테마그룹별요청 응답 (ka90001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[ThemeGroupItem]
|
테마그룹별 리스트. |
required |
ThemeGroupItem
dataclass
¶
ThemeGroupItem(thema_grp_cd: str, thema_nm: str, stk_num: str, flu_sig: str, flu_rt: str, rising_stk_num: str, fall_stk_num: str, dt_prft_rt: str, main_stk: str)
테마그룹별 단일 항목.
ThemeStockItem
dataclass
¶
ThemeStockItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_sig: str, pred_pre: str, flu_rt: str, acc_trde_qty: str, sel_bid: str, sel_req: str, buy_bid: str, buy_req: str, dt_prft_rt_n: str)
테마구성종목 단일 항목.
ThemeStocks
dataclass
¶
테마구성종목요청 응답 (ka90002).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
flu_rt
|
str
|
등락률. |
required |
dt_prft_rt
|
str
|
기간수익률. |
required |
items
|
list[ThemeStockItem]
|
테마구성종목 리스트. |
required |
TodayPrevExecution
dataclass
¶
당일전일체결 응답 (ka10084).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[TodayPrevExecutionItem]
|
체결 리스트. |
required |
TodayPrevExecutionItem
dataclass
¶
TodayPrevExecutionItem(tm: str, cur_prc: str, cntr_trde_qty: str, acc_trde_qty: str, cntr_str: str, stex_tp: str)
당일전일체결 단일 항목 (ka10084).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
tm
|
str
|
시간 (HHMMSS). |
required |
cur_prc
|
str
|
현재가 (원). |
required |
cntr_trde_qty
|
str
|
체결거래량 (주). |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
cntr_str
|
str
|
체결강도. |
required |
stex_tp
|
str
|
거래소구분. |
required |
TodayPrevExecutionQty
dataclass
¶
당일전일체결량 응답 (ka10055).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[TodayPrevExecutionQtyItem]
|
체결량 리스트. |
required |
TodayPrevExecutionQtyItem
dataclass
¶
TodayPrevExecutionQtyItem(cntr_tm: str, cntr_pric: str, flu_rt: str, cntr_qty: str, acc_trde_qty: str, acc_trde_prica: str)
당일전일체결량 단일 항목 (ka10055).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
cntr_tm
|
str
|
체결시간 (HHMMSS). |
required |
cntr_pric
|
str
|
체결가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
cntr_qty
|
str
|
체결량 (주). |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
acc_trde_prica
|
str
|
누적거래대금 (백만원). |
required |
TokenRequest
dataclass
¶
접근토큰 발급 요청 (au10001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
appkey
|
str
|
키움증권 앱 키. |
required |
secretkey
|
str
|
키움증권 시크릿 키. |
required |
grant_type
|
str
|
OAuth2 grant type. 항상 |
'client_credentials'
|
TokenResponse
dataclass
¶
접근토큰 발급 응답 (au10001).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
token
|
str
|
접근토큰. |
required |
token_type
|
str
|
토큰 타입 (예: |
required |
expires_dt
|
str
|
만료일시. |
required |
TradeAmtUpper
dataclass
¶
거래대금상위 응답 (ka10032).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[TradeAmtUpperItem]
|
거래대금상위 종목 리스트. |
required |
TradeAmtUpperItem
dataclass
¶
TradeAmtUpperItem(stk_cd: str, now_rank: str, pred_rank: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, sel_bid: str, buy_bid: str, now_trde_qty: str, pred_trde_qty: str, trde_prica: str)
거래대금상위 단일 항목 (ka10032).
TradeQtySurge
dataclass
¶
거래량급증 응답 (ka10023).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[TradeQtySurgeItem]
|
거래량급증 종목 리스트. |
required |
TradeQtySurgeItem
dataclass
¶
TradeQtySurgeItem(stk_cd: str, stk_nm: str, cur_prc: str, pred_pre_sig: str, pred_pre: str, flu_rt: str, prev_trde_qty: str, now_trde_qty: str, sdnin_qty: str, sdnin_rt: str)
거래량급증 단일 항목 (ka10023).
TransactionHistoryItem
dataclass
¶
TransactionHistoryItem(trde_dt: str, trde_no: str, rmrk_nm: str, crd_deal_tp_nm: str, exct_amt: str, entra_remn: str, crnc_cd: str, trde_kind_nm: str, stk_nm: str, trde_amt: str, io_tp_nm: str, stk_cd: str, trde_qty_jwa_cnt: str, cmsn: str, proc_tm: str)
위탁종합거래내역 항목 (kt00015 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
trde_dt
|
str
|
거래일자. |
required |
rmrk_nm
|
str
|
적요명. |
required |
trde_amt
|
str
|
거래금액 (단위: 원). |
required |
exct_amt
|
str
|
정산금액 (단위: 원). |
required |
entra_remn
|
str
|
예수금잔고 (단위: 원). |
required |
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
UnfilledOrderItem
dataclass
¶
UnfilledOrderItem(acnt_no: str, ord_no: str, stk_cd: str, ord_stt: str, stk_nm: str, ord_qty: str, ord_pric: str, oso_qty: str, orig_ord_no: str, io_tp_nm: str, trde_tp: str, tm: str, cntr_pric: str, cntr_qty: str, cur_prc: str, stex_tp: str, stex_tp_txt: str, sor_yn: str)
미체결 주문 항목 (ka10075 배열 원소).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
ord_no
|
str
|
주문번호. |
required |
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
ord_qty
|
str
|
주문수량 (단위: 주). |
required |
ord_pric
|
str
|
주문가격 (단위: 원). |
required |
oso_qty
|
str
|
미체결수량 (단위: 주). |
required |
io_tp_nm
|
str
|
주문구분. |
required |
trde_tp
|
str
|
매매구분. |
required |
ord_stt
|
str
|
주문상태. |
required |
VIStockItem
dataclass
¶
VIStockItem(stk_cd: str, stk_nm: str, acc_trde_qty: str, motn_pric: str, viaplc_tp: str, vimotn_cnt: str, stex_tp: str)
변동성완화장치 발동종목 단일 항목 (ka10054).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
acc_trde_qty
|
str
|
누적거래량 (주). |
required |
motn_pric
|
str
|
발동가격 (원). |
required |
viaplc_tp
|
str
|
VI적용구분 (동적/정적/동적+정적). |
required |
vimotn_cnt
|
str
|
VI발동횟수. |
required |
stex_tp
|
str
|
거래소구분. |
required |
VIStocks
dataclass
¶
변동성완화장치 발동종목 응답 (ka10054).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[VIStockItem]
|
VI 발동종목 리스트. |
required |
VolumeUpdatedItem
dataclass
¶
VolumeUpdatedItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, prev_trde_qty: str, now_trde_qty: str)
거래량갱신 단일 항목 (ka10024).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
prev_trde_qty
|
str
|
이전거래량 (주). |
required |
now_trde_qty
|
str
|
현재거래량 (주). |
required |
VolumeUpdatedStocks
dataclass
¶
거래량갱신 응답 (ka10024).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[VolumeUpdatedItem]
|
거래량갱신 종목 리스트. |
required |
WatchlistInfo
dataclass
¶
관심종목정보 응답 (ka10095).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
items
|
list[WatchlistStockItem]
|
관심종목 리스트. |
required |
WatchlistStockItem
dataclass
¶
WatchlistStockItem(stk_cd: str, stk_nm: str, cur_prc: str, flu_rt: str, trde_qty: str, trde_prica: str, open_pric: str, high_pric: str, low_pric: str, upl_pric: str, lst_pric: str)
관심종목정보 단일 항목 (ka10095).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
stk_cd
|
str
|
종목코드. |
required |
stk_nm
|
str
|
종목명. |
required |
cur_prc
|
str
|
현재가 (원). |
required |
flu_rt
|
str
|
등락률 (%). |
required |
trde_qty
|
str
|
거래량 (주). |
required |
trde_prica
|
str
|
거래대금 (백만원). |
required |
open_pric
|
str
|
시가 (원). |
required |
high_pric
|
str
|
고가 (원). |
required |
low_pric
|
str
|
저가 (원). |
required |
upl_pric
|
str
|
상한가 (원). |
required |
lst_pric
|
str
|
하한가 (원). |
required |