콘텐츠로 이동

모델 (models)

요청·응답 데이터 구조 및 타입 별칭을 정의하는 모듈입니다.

kiwoompy.models

kiwoompy 공통 데이터 모델 — 타입 별칭 및 TR별 요청/응답 dataclass.

AccountNo

AccountNo = str

계좌번호. "12345678-01" 형식 (8자리 계좌번호 + 상품코드). 입력값 정규화는 :func:kiwoompy.utils.normalize_account_no 사용.

AfterAmtQtyType

AfterAmtQtyType = Literal['amount', 'qty']

금액수량구분 (장마감후투자자별).

  • "amount": 금액 — API "1"
  • "qty": 수량 — API "2"

AfterTradeType

AfterTradeType = Literal['net_buy', 'buy', 'sell']

장마감후 매매구분.

  • "net_buy": 순매수 — API "0"
  • "buy": 매수 — API "1"
  • "sell": 매도 — API "2"

AmtQtyType

AmtQtyType = Literal['amount', 'qty']

금액수량구분 (종목별투자자기관별).

  • "amount": 금액 — API "1"
  • "qty": 수량 — API "2"

ChartAdjustedPrice

ChartAdjustedPrice = Literal['adjusted', 'raw']

수정주가구분.

  • "adjusted": 수정주가 반영 — API "1"
  • "raw": 미반영 — API "0"

ChartAmtQtyType

ChartAmtQtyType = Literal['amount', 'qty']

금액수량구분 (투자자 차트).

  • "amount": 금액 — API "1"
  • "qty": 수량 — API "2"

ChartMinScope

ChartMinScope = Literal['1', '3', '5', '10', '15', '30', '45', '60']

주식 분봉 범위.

  • "1": 1분
  • "3": 3분
  • "5": 5분
  • "10": 10분
  • "15": 15분
  • "30": 30분
  • "45": 45분
  • "60": 60분

ChartSectorMarket

ChartSectorMarket = Literal['kospi', 'kosdaq', 'kospi200']

업종차트 시장구분.

  • "kospi": 코스피 — API "0"
  • "kosdaq": 코스닥 — API "1"
  • "kospi200": 코스피200 — API "2"

ChartTickScope

ChartTickScope = Literal['1', '3', '5', '10', '30']

주식/업종 틱 범위.

  • "1": 1틱
  • "3": 3틱
  • "5": 5틱
  • "10": 10틱
  • "30": 30틱

ChartTradeType

ChartTradeType = Literal['net_buy', 'buy', 'sell']

매매구분 (투자자 차트).

  • "net_buy": 순매수 — API "0"
  • "buy": 매수 — API "1"
  • "sell": 매도 — API "2"

ChartUnitType

ChartUnitType = Literal['thousand', 'single']

단위구분 (종목별투자자기관별차트).

  • "thousand": 천주 — API "1000"
  • "single": 단주 — API "1"

CreditMarketType

CreditMarketType = Literal['%', '1', '0']

신용융자 시장거래구분.

  • "%": 전체
  • "1": 코스피
  • "0": 코스닥

CreditQueryType

CreditQueryType = Literal['loan', 'short']

신용매매동향 조회구분.

  • "loan": 융자 — API "1"
  • "short": 대주 — API "2"

CreditStockGradeType

CreditStockGradeType = Literal['%', 'A', 'B', 'C', 'D', 'E']

신용종목등급구분.

  • "%": 전체
  • "A" ~ "E": 각 등급

DisplayType

DisplayType = Literal['qty', 'amount']

일별주가 표시구분.

  • "qty": 수량 — API "0"
  • "amount": 금액(백만원) — API "1"

ElwFlucType

ElwFlucType = Literal['surge', 'plunge']

ELW 등락구분.

  • "surge": 급등 (1)
  • "plunge": 급락 (2)

ElwRightType

ElwRightType = Literal['all', 'call', 'put', 'dc', 'dp', 'ex', 'early_call', 'early_put']

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)

Env

Env = Literal['real', 'demo']

운영(real) / 모의투자(demo) 환경 구분.

EstimatedPriceType

EstimatedPriceType = Literal['buy', 'sell']

추정단가구분.

  • "buy": 매수단가 — API "1"
  • "sell": 매도단가 — API "2"

EtfDuration

EtfDuration = Literal['1w', '1m', '6m', '1y']

ETF 기간구분.

  • "1w": 1주 (0)
  • "1m": 1달 (1)
  • "6m": 6개월 (2)
  • "1y": 1년 (3)

FrgnDuration

FrgnDuration = Literal['1', '3', '5', '10', '20', '120', 'custom']

기관/외국인 연속매매 기간.

  • "1": 최근 1일
  • "3": 3일
  • "5": 5일
  • "10": 10일
  • "20": 20일
  • "120": 120일
  • "custom": 시작일자/종료일자로 직접 지정 ("0" 전달)

FrgnStockSectType

FrgnStockSectType = Literal['stock', 'sector']

기관/외국인 종목업종구분.

  • "stock": 종목(주식) (0)
  • "sector": 업종 (1)

GoldOrderTradeType

GoldOrderTradeType = Literal['normal', 'normal_ioc', 'normal_fok']

금현물 매매구분.

  • "normal": 보통 (00)
  • "normal_ioc": 보통(IOC) (10)
  • "normal_fok": 보통(FOK) (20)

GoldStockCode

GoldStockCode = Literal['M04020000', 'M04020100']

금현물 종목코드.

  • "M04020000": 금 99.99_1kg
  • "M04020100": 미니금 99.99_100g

HighLowSelectType

HighLowSelectType = Literal['high', 'low']

신고저구분.

  • "high": 신고가 — API "1"
  • "low": 신저가 — API "2"

InstitutionTradeType

InstitutionTradeType = Literal['sell', 'buy']

기관 매매구분 (순매도/순매수).

  • "sell": 순매도 — API "1"
  • "buy": 순매수 — API "2"

IntraAmtQtyType

IntraAmtQtyType = Literal['amount_qty', 'amount', 'qty']

금액수량구분 (장중투자자별).

  • "amount_qty": 금액&수량 — API "1"

InvestorTradeType

InvestorTradeType = Literal['net_buy', 'buy', 'sell']

종목별투자자 매매구분.

  • "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

MrkcondExchangeType = Literal['krx', 'nxt', 'all']

시세·종목정보 거래소구분.

  • "krx": KRX — API "1"
  • "nxt": NXT — API "2"
  • "all": 통합 — API "3"

MrktType3

MrktType3 = Literal['all', 'kospi', 'kosdaq']

시장구분 3자리 코드 (전체/코스피/코스닥).

  • "all": 전체 — API "000"
  • "kospi": 코스피 — API "001"
  • "kosdaq": 코스닥 — API "101"

MrktType3Ext

MrktType3Ext = Literal['all', 'kospi', 'kosdaq', 'kospi200']

시장구분 3자리 (가격급등락용, KOSPI200 포함).

  • "all": 전체 — API "000"
  • "kospi": 코스피 — API "001"
  • "kosdaq": 코스닥 — API "101"
  • "kospi200": 코스피200 — API "201"

NewStockRightsType

NewStockRightsType = Literal['all', 'rights_cert', 'rights_deed']

신주인수권구분.

  • "all": 전체 — API "00"
  • "rights_cert": 신주인수권증권 — API "05"
  • "rights_deed": 신주인수권증서 — API "07"

OrderExchange

OrderExchange = Literal['KRX', 'NXT', 'SOR']

주문 국내거래소구분.

  • "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

PERType = Literal['low_pbr', 'high_pbr', 'low_per', 'high_per', 'low_roe', 'high_roe']

고저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

RkinfoBaseDateType = Literal['today', 'prev']

기준일구분.

  • "today": 당일기준 — API "0"
  • "prev": 전일기준 — API "1"

RkinfoBidSortType

RkinfoBidSortType = Literal['net_buy_qty', 'net_sell_qty', 'buy_ratio', 'sell_ratio']

호가잔량상위 정렬구분 (ka10020).

  • "net_buy_qty": 순매수잔량순 — API "1"
  • "net_sell_qty": 순매도잔량순 — API "2"
  • "buy_ratio": 매수비율순 — API "3"
  • "sell_ratio": 매도비율순 — API "4"

RkinfoBidTradeType

RkinfoBidTradeType = Literal['buy', 'sell']

호가잔량급증 매매구분 (ka10021).

  • "buy": 매수잔량 — API "1"
  • "sell": 매도잔량 — API "2"

RkinfoMarketType

RkinfoMarketType = Literal['all', 'kospi', 'kosdaq']

순위정보 시장구분.

  • "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

RkinfoPriceChangeSortType = Literal['rise_ratio', 'rise_gap', 'fall_ratio', 'fall_gap', 'flat']

전일대비등락률상위 정렬구분 (ka10027).

  • "rise_ratio": 상승률 — API "1"
  • "rise_gap": 상승폭 — API "2"
  • "fall_ratio": 하락률 — API "3"
  • "fall_gap": 하락폭 — API "4"
  • "flat": 보합 — API "5"

RkinfoSortCndType

RkinfoSortCndType = Literal['qty', 'amount']

동일순매매 정렬조건 (ka10062).

  • "qty": 수량 — API "1"
  • "amount": 금액 — API "2"

RkinfoStexType

RkinfoStexType = Literal['krx', 'nxt', 'all']

순위정보 거래소구분.

  • "krx": KRX — API "1"
  • "nxt": NXT — API "2"
  • "all": 통합 — API "3"

RkinfoSurgeSort2Type

RkinfoSurgeSort2Type = Literal['surge_qty', 'surge_ratio']

급증 정렬구분 (ka10021/ka10022).

  • "surge_qty": 급증량 — API "1"
  • "surge_ratio": 급증률 — API "2"

SectAmtQtyType

SectAmtQtyType = Literal['amount', 'qty']

업종별 금액수량구분.

  • "amount": 금액 (0)
  • "qty": 수량 (1)

SectExchangeType

SectExchangeType = Literal['krx', 'nxt', 'all']

업종 거래소구분.

  • "krx": KRX (1)
  • "nxt": NXT (2)
  • "all": 통합 (3)

SectMrktType

SectMrktType = Literal['kospi', 'kosdaq', 'kospi200']

업종 시장구분.

  • "kospi": 코스피 (0)
  • "kosdaq": 코스닥 (1)
  • "kospi200": 코스피200 (2)

SectorMarketType

SectorMarketType = Literal['kospi', 'kosdaq', 'kospi200', 'kospi100', 'krx100']

업종코드 리스트 시장구분.

  • "kospi": 코스피(거래소) — API "0"
  • "kosdaq": 코스닥 — API "1"
  • "kospi200": KOSPI200 — API "2"
  • "kospi100": KOSPI100 — API "4"
  • "krx100": KRX100(통합지수) — API "7"

SlbMrktType

SlbMrktType = Literal['kospi', 'kosdaq']

대차거래 시장구분.

  • "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

ThemeSearchType = Literal['all', 'theme', 'stock']

테마 검색구분.

  • "all": 전체검색 (0)
  • "theme": 테마검색 (1)
  • "stock": 종목검색 (2)

TickMinType

TickMinType = Literal['tick', 'minute']

틱/분 구분.

  • "tick": 틱 — API "0"
  • "minute": 분 — API "1"

TodayPrevType

TodayPrevType = Literal['today', 'prev']

당일전일구분.

  • "today": 당일 — API "1"
  • "prev": 전일 — API "2"

UnitType

UnitType = Literal['thousand', 'single']

단위구분.

  • "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

AccountNumbers(account_numbers: list[str])

계좌번호조회 응답 (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

AfterCloseInvestorTrading(items: list[AfterCloseInvestorItem])

장마감후투자자별매매 응답 (ka10066).

Parameters:

Name Type Description Default
items list[AfterCloseInvestorItem]

종목별 투자자 매매 리스트.

required

AfterHoursRank dataclass

AfterHoursRank(items: list[AfterHoursRankItem])

시간외단일가등락율순위 응답 (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

AllSectorIndex(items: list[AllSectorIndexItem])

전업종지수요청 응답 (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

BidQtySurge(items: list[BidQtySurgeItem])

호가잔량급증 응답 (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

BidQtyUpper(items: list[BidQtyUpperItem])

호가잔량상위 응답 (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

BrokerEntry(name: str, code: str, qty: str)

거래원 단일 항목 (ka10002).

Parameters:

Name Type Description Default
name str

거래원명.

required
code str

거래원 코드.

required
qty str

거래량 (주).

required

BrokerInstantVolume dataclass

BrokerInstantVolume(items: list[BrokerInstantVolumeItem])

거래원순간거래량 응답 (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

BrokerItem(code: str, name: str, gb: str)

회원사 단일 항목 (ka10102).

Parameters:

Name Type Description Default
code str

회원사 코드.

required
name str

회원사명.

required
gb str

구분.

required

BrokerList dataclass

BrokerList(items: list[BrokerItem])

회원사 리스트 응답 (ka10102).

Parameters:

Name Type Description Default
items list[BrokerItem]

회원사 리스트.

required

BrokerStockTrend dataclass

BrokerStockTrend(items: list[BrokerStockTrendItem])

증권사별종목매매동향 응답 (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

BrokerSupplyAnalysis(items: list[BrokerSupplyItem])

거래원매물대분석 응답 (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

BrokerTradeUpper(items: list[BrokerTradeUpperItem])

증권사별매매상위 응답 (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

CancelOrderResponse(ord_no: str, base_orig_ord_no: str, cncl_qty: str)

주식 취소주문 응답 (kt10003, kt10009).

Parameters:

Name Type Description Default
ord_no str

주문번호 (새로 발급된 취소 주문번호).

required
base_orig_ord_no str

모주문번호 (최초 원주문번호).

required
cncl_qty str

취소수량 (단위: 주).

required

ConditionItem dataclass

ConditionItem(seq: str, name: str)

조건검색식 단일 항목.

Parameters:

Name Type Description Default
seq str

조건검색식 일련번호.

required
name str

조건검색식 이름.

required

ConditionList dataclass

ConditionList(items: list[ConditionItem])

조건검색 목록조회 응답 (ka10171).

Parameters:

Name Type Description Default
items list[ConditionItem]

조건검색식 목록.

required

ConditionRealtimeItem dataclass

ConditionRealtimeItem(type: str, name: str, item: str, values: ConditionRealtimeValues)

조건검색 실시간 단일 이벤트.

Parameters:

Name Type Description Default
type str

실시간 항목 TR명 (예: "0B").

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

삽입삭제 구분 — "I" (삽입) / "D" (삭제) (843).

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

종목코드 (예: "A005930").

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

ConditionSearchResult(seq: str, cont_yn: str, next_key: str, items: list[ConditionSearchItem])

조건검색 요청 일반 응답 (ka10172).

Parameters:

Name Type Description Default
seq str

조건검색식 일련번호.

required
cont_yn str

연속조회 여부 ("Y" / "N").

required
next_key str

연속조회키.

required
items list[ConditionSearchItem]

검색 결과 종목 리스트.

required

ConditionStopResult dataclass

ConditionStopResult(seq: str)

조건검색 실시간 해제 응답 (ka10174).

Parameters:

Name Type Description Default
seq str

해제된 조건검색식 일련번호.

required

CreditLoanAvailability dataclass

CreditLoanAvailability(crd_alow_yn: str)

신용융자 가능문의 응답 (kt20017).

Parameters:

Name Type Description Default
crd_alow_yn str

신용가능여부 안내 문자열 (예: "< A군 신용융자 가능 >").

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

신용한도초과 텍스트 ("N": 공란, "Y": 회사한도 초과).

required

CreditLoanStocks dataclass

CreditLoanStocks(crd_loan_able: str, items: list[CreditLoanStockItem])

신용융자 가능종목요청 응답 (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

CreditRatioUpper(items: list[CreditRatioUpperItem])

신용비율상위 응답 (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

CreditTradingTrend(items: list[CreditTradingItem])

신용매매동향 응답 (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

일자 (YYYYMMDD 형식).

required
entr str

예수금 (단위: 원).

required
prsm_dpst_aset_amt str

추정예탁자산 (단위: 원).

required

DailyInstitutionStockItem dataclass

DailyInstitutionStockItem(stk_cd: str, stk_nm: str, netprps_qty: str, netprps_amt: str)

일별기관매매종목 단일 항목 (ka10044).

Parameters:

Name Type Description Default
stk_cd str

종목코드.

required
stk_nm str

종목명.

required
netprps_qty str

순매수수량 (주).

required
netprps_amt str

순매수금액 (백만원).

required

DailyInstitutionStocks dataclass

DailyInstitutionStocks(items: list[DailyInstitutionStockItem])

일별기관매매종목 응답 (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

DailyPrices(items: list[DailyPriceItem])

일별주가 응답 (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

DailyRealizedProfitDetail(tdy_rlzt_pl: str, items: list[DailyRealizedProfitDetailItem] = list())

당일실현손익상세 응답 (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

DailyTopExit(items: list[DailyTopExitItem])

당일상위이탈원 응답 (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

DailyTradeQtyUpper(items: list[DailyTradeQtyUpperItem])

당일거래량상위 응답 (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

DailyTradingDetail(items: list[DailyTradingDetailItem])

일별거래상세 응답 (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

ElwAccessRate(items: list[ElwAccessRateItem])

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

ElwBalRank(items: list[ElwBalRankItem])

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

ElwBrokerNetTrade(items: list[ElwBrokerNetTradeItem])

거래원별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

ElwDailySens(items: list[ElwDailySensItem])

ELW일별민감도지표요청 응답 (ka10048).

Parameters:

Name Type Description Default
items list[ElwDailySensItem]

ELW일별민감도지표 리스트.

required

ElwDailySensItem dataclass

ElwDailySensItem(dt: str, iv: str, delta: str, gam: str, theta: str, vega: str, law: str, lp: str)

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

ElwFlucRank(items: list[ElwFlucRankItem])

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

ElwGap(items: list[ElwGapItem])

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

ElwLpDaily(items: list[ElwLpDailyItem])

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

ElwPriceSurge(base_pric_tm: str, items: list[ElwPriceSurgeItem])

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

ElwSearch(items: list[ElwSearchItem])

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

ElwSens(items: list[ElwSensItem])

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

EstimatedAsset(prsm_dpst_aset_amt: str)

추정자산조회 응답 (kt00003).

Parameters:

Name Type Description Default
prsm_dpst_aset_amt str

추정예탁자산 (단위: 원).

required

EtfAllQuote dataclass

EtfAllQuote(items: list[EtfAllQuoteItem])

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

EtfDailyTrend(items: list[EtfDailyTrendItem])

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

EtfInfo(stk_nm: str, etfobjt_idex_nm: str, wonju_pric: str, etftxon_type: str, etntxon_type: str)

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

EtfNav(items: list[EtfNavItem])

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

EtfReturn(items: list[EtfReturnItem])

ETF수익율요청 응답 (ka40001).

Parameters:

Name Type Description Default
items list[EtfReturnItem]

ETF수익율 리스트.

required

EtfReturnItem dataclass

EtfReturnItem(etfprft_rt: str, cntr_prft_rt: str, for_netprps_qty: str, orgn_netprps_qty: str)

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

EtfTimeTrend2(items: list[EtfTimeTrend2Item])

ETF시간대별추이요청 응답 (ka40010).

Parameters:

Name Type Description Default
items list[EtfTimeTrend2Item]

ETF시간대별추이 리스트.

required

EtfTimeTrend2Item dataclass

EtfTimeTrend2Item(cur_prc: str, pre_sig: str, pred_pre: str, trde_qty: str, for_netprps: str)

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

ExecutionInfo(items: list[ExecutionInfoItem])

체결정보 응답 (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

ExecutionStrength(items: list[ExecutionStrengthItem])

체결강도추이 응답 (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

ExpectedTradeUpper(items: list[ExpectedTradeUpperItem])

예상체결등락률상위 응답 (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

ForeignBrokerTradeUpper(items: list[ForeignBrokerTradeUpperItem])

외국계창구매매상위 응답 (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

ForeignConsecTradeUpper(items: list[ForeignConsecTradeUpperItem])

외인연속순매매상위 응답 (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

ForeignInstitutionTradeUpper(items: list[ForeignInstitutionTradeUpperItem])

외국인기관매매상위 응답 (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

ForeignLimitExhaustUpper(items: list[ForeignLimitExhaustUpperItem])

외인한도소진율증가상위 응답 (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

ForeignPeriodTradeUpper(items: list[ForeignPeriodTradeUpperItem])

외인기간별매매상위 응답 (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

ForeignTrade(items: list[ForeignTradeItem])

주식외국인종목별매매동향 응답 (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

통화코드 (예: "USD").

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

GoldBid(items: list[GoldBidItem])

금현물 호가 응답 (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

GoldCancelOrderResponse(ord_no: str, base_orig_ord_no: str, cncl_qty: str)

금현물 취소주문 응답 (kt50003).

Parameters:

Name Type Description Default
ord_no str

주문번호.

required
base_orig_ord_no str

모주문번호.

required
cncl_qty str

취소수량.

required

GoldContractTrend dataclass

GoldContractTrend(items: list[GoldContractTrendItem])

금현물체결추이요청 응답 (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

GoldDailyChart(items: list[GoldDailyChartItem])

금현물일봉차트조회요청 응답 (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

GoldDailyMinuteChart(items: list[GoldDailyMinuteChartItem])

금현물당일분봉차트조회요청 응답 (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

GoldDailyTickChart(items: list[GoldDailyTickChartItem])

금현물당일틱차트조회요청 응답 (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

GoldDailyTrend(items: list[GoldDailyTrendItem])

금현물일별추이요청 응답 (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

GoldExpectedContract(items: list[GoldExpectedContractItem])

금현물예상체결요청 응답 (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

GoldInvestorStatus(items: list[GoldInvestorStatusItem])

금현물투자자현황 응답 (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

GoldMinuteChart(items: list[GoldMinuteChartItem])

금현물분봉차트조회요청 응답 (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

GoldModifyOrderResponse(ord_no: str, base_orig_ord_no: str, mdfy_qty: str)

금현물 정정주문 응답 (kt50002).

Parameters:

Name Type Description Default
ord_no str

주문번호.

required
base_orig_ord_no str

모주문번호.

required
mdfy_qty str

정정수량.

required

GoldMonthlyChart dataclass

GoldMonthlyChart(items: list[GoldMonthlyChartItem])

금현물월봉차트조회요청 응답 (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

GoldOrderDetail(items: list[GoldOrderDetailItem])

금현물 주문체결조회 응답 (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

GoldOrderResponse(ord_no: str)

금현물 매수/매도주문 응답 (kt50000, kt50001).

Parameters:

Name Type Description Default
ord_no str

주문번호.

required

GoldOrderStatus dataclass

GoldOrderStatus(items: list[GoldOrderStatusItem])

금현물 주문체결전체조회 응답 (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

GoldTickChart(items: list[GoldTickChartItem])

금현물틱차트조회요청 응답 (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

GoldTradeHistory(acnt_print: str, items: list[GoldTradeHistoryItem])

금현물 거래내역조회 응답 (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

GoldUnfilled(items: list[GoldUnfilledItem])

금현물 미체결조회 응답 (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

GoldWeeklyChart(items: list[GoldWeeklyChartItem])

금현물주봉차트조회요청 응답 (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

HighLowPER(items: list[HighLowPERItem])

고저PER 응답 (ka10026).

Parameters:

Name Type Description Default
items list[HighLowPERItem]

고저PER 종목 리스트.

required

HighLowPERItem dataclass

HighLowPERItem(stk_cd: str, stk_nm: str, per: str, cur_prc: str, flu_rt: str, now_trde_qty: str)

고저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

HighLowStocks(items: list[HighLowStockItem])

신고저가 응답 (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

InstFrgnConsecutiveTrade(items: list[InstFrgnConsecutiveItem])

기관외국인연속매매현황요청 응답 (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

IntraInvestorChart(items: list[IntraInvestorChartItem])

장중투자자별매매차트 응답 (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

IntradayInvestorTrading(items: list[IntradayInvestorItem])

장중투자자별매매 응답 (ka10063).

Parameters:

Name Type Description Default
items list[IntradayInvestorItem]

종목별 투자자 매매 리스트.

required

InvestorChart dataclass

InvestorChart(items: list[InvestorChartItem])

종목별투자자기관별차트 응답 (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

InvestorDailyStocks(items: list[InvestorDailyStockItem])

투자자별일별매매종목 응답 (ka10058).

Parameters:

Name Type Description Default
items list[InvestorDailyStockItem]

종목별 리스트.

required

InvestorTradeUpper dataclass

InvestorTradeUpper(items: list[InvestorTradeUpperItem])

장중투자자별매매상위 응답 (ka10065).

Parameters:

Name Type Description Default
items list[InvestorTradeUpperItem]

장중투자자별매매상위 종목 리스트.

required

InvestorTradeUpperItem dataclass

InvestorTradeUpperItem(stk_cd: str, stk_nm: str, sel_qty: str, buy_qty: str, netslmt: str)

장중투자자별매매상위 단일 항목 (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

LimitStocks(items: list[LimitStockItem])

상하한가 응답 (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

ModifyOrderResponse(ord_no: str, base_orig_ord_no: str, mdfy_qty: str, dmst_stex_tp: str)

주식 정정주문 응답 (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

NearHighLow(items: list[NearHighLowItem])

고저가근접 응답 (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

NetBuyBrokerRank(items: list[NetBuyBrokerRankItem])

순매수거래원순위 응답 (ka10042).

Parameters:

Name Type Description Default
items list[NetBuyBrokerRankItem]

순매수거래원순위 리스트.

required

NetBuyBrokerRankItem dataclass

NetBuyBrokerRankItem(rank: str, mmcm_cd: str, mmcm_nm: str)

순매수거래원순위 단일 항목 (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

NewStockRightsPrices(items: list[NewStockRightsItem])

신주인수권전체시세 응답 (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

OpenPriceChange(items: list[OpenPriceChangeItem])

시가대비등락률 응답 (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

OrderResponse(ord_no: str, dmst_stex_tp: str)

주식 매수/매도 주문 응답 (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

OrderbookLevel(price: str, qty: str, qty_change: str)

호가 단일 레벨 (매도/매수 각 호가·잔량·직전대비).

Parameters:

Name Type Description Default
price str

호가 (단위: 원).

required
qty str

잔량 (단위: 주).

required
qty_change str

잔량직전대비.

required

PrevTradeQtyUpper dataclass

PrevTradeQtyUpper(items: list[PrevTradeQtyUpperItem])

전일거래량상위 응답 (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

PriceChangeUpper(items: list[PriceChangeUpperItem])

전일대비등락률상위 응답 (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

PriceSurgeStocks(items: list[PriceSurgeItem])

가격급등락 응답 (ka10019).

Parameters:

Name Type Description Default
items list[PriceSurgeItem]

급등락 종목 리스트.

required

ProgramAccTrend dataclass

ProgramAccTrend(items: list[ProgramAccTrendItem])

프로그램매매누적추이요청 응답 (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

ProgramArbitrageBal(items: list[ProgramArbitrageBalItem])

프로그램매매차익잔고추이요청 응답 (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

ProgramTop50(items: list[ProgramTop50Item])

프로그램순매수상위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

ProgramTrend(items: list[ProgramTrendItem])

프로그램매매추이요청 응답 (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

QtyRatioSurge(items: list[QtyRatioSurgeItem])

잔량율급증 응답 (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

RealtimeEvent(type: str, name: str, item: str, values: dict[str, str])

실시간 WebSocket 수신 이벤트.

서버에서 trnm="REAL" 메시지가 수신될 때 data 배열의 각 항목을 이 dataclass로 파싱한다.

Parameters:

Name Type Description Default
type str

실시간 항목 TR명. (예: "0B", "00")

required
name str

실시간 항목명. (예: "주식체결", "주문체결")

required
item str

종목코드 또는 item 식별자. 계좌 기반 타입("00", "04")은 빈 문자열.

required
values dict[str, str]

필드번호 → 값 딕셔너리. (예: {"10": "+60700", "20": "165208"})

required
Example

event.values.get("10", "") # 현재가 '+60700' event.values.get("20", "") # 체결시간 '165208'

RevokeTokenRequest dataclass

RevokeTokenRequest(appkey: str, secretkey: str, token: str)

접근토큰 폐기 요청 (au10002).

Parameters:

Name Type Description Default
appkey str

키움증권 앱 키.

required
secretkey str

키움증권 시크릿 키.

required
token str

폐기할 접근토큰.

required

SameNetTradeRank dataclass

SameNetTradeRank(items: list[SameNetTradeRankItem])

동일순매매순위 응답 (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

SectorDayChart(inds_cd: str, items: list[SectorDayChartItem])

업종일봉조회 응답 (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

SectorInvestorNetBuy(items: list[SectorInvestorNetBuyItem])

업종별투자자순매수요청 응답 (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

SectorItem(market_code: str, code: str, name: str, group: str)

업종코드 단일 항목 (ka10101).

Parameters:

Name Type Description Default
market_code str

시장구분코드.

required
code str

업종코드.

required
name str

업종명.

required
group str

그룹.

required

SectorList dataclass

SectorList(items: list[SectorItem])

업종코드 리스트 응답 (ka10101).

Parameters:

Name Type Description Default
items list[SectorItem]

업종코드 리스트.

required

SectorMinChart dataclass

SectorMinChart(inds_cd: str, items: list[SectorMinChartItem])

업종분봉조회 응답 (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

SectorMonthChart(inds_cd: str, items: list[SectorDayChartItem])

업종월봉조회 응답 (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

SectorStockPrices(items: list[SectorStockPriceItem])

업종별주가요청 응답 (ka20002).

Parameters:

Name Type Description Default
items list[SectorStockPriceItem]

업종별주가 리스트.

required

SectorTickChart dataclass

SectorTickChart(inds_cd: str, items: list[SectorCandleItem])

업종틱차트조회 응답 (ka20004).

Parameters:

Name Type Description Default
inds_cd str

업종코드.

required
items list[SectorCandleItem]

틱 캔들 리스트.

required

SectorWeekChart dataclass

SectorWeekChart(inds_cd: str, items: list[SectorDayChartItem])

업종주봉조회 응답 (ka20007).

Parameters:

Name Type Description Default
inds_cd str

업종코드.

required
items list[SectorDayChartItem]

주봉 리스트.

required

SectorYearChart dataclass

SectorYearChart(inds_cd: str, items: list[SectorDayChartItem])

업종년봉조회 응답 (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

ShortSellTrend(items: list[ShortSellItem])

공매도추이요청 응답 (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

StockBrokerRankItem(rank: str, mmcm_nm: str, buy_qty: str, sell_qty: str, acc_netprps_qty: str)

종목별증권사순위 단일 항목 (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

StockDailyProgram(items: list[StockDailyProgramItem])

종목일별프로그램매매추이요청 응답 (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

StockDayChart(stk_cd: str, items: list[StockDayChartItem])

주식일봉차트조회 응답 (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

StockInvestorByDay(items: list[StockInvestorItem])

종목별투자자기관별 응답 (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

StockList(items: list[StockListItem])

종목정보 리스트 응답 (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

StockLoanByStock(items: list[StockLoanByStockItem])

대차거래추이요청(종목별) 응답 (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

StockLoanHistory(items: list[StockLoanHistoryItem])

대차거래내역요청 응답 (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

StockLoanTrend(items: list[StockLoanItem])

대차거래추이요청 응답 (ka10068).

Parameters:

Name Type Description Default
items list[StockLoanItem]

대차거래추이 리스트.

required

StockMinChart dataclass

StockMinChart(stk_cd: str, items: list[StockMinChartItem])

주식분봉차트조회 응답 (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

StockMonthChart(stk_cd: str, items: list[StockMonthChartItem])

주식월봉차트조회 응답 (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

StockPeriods(items: list[StockPeriodItem])

주식일주월시분 응답 (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

StockTickChart(stk_cd: str, last_tic_cnt: str, items: list[StockCandleItem])

주식틱차트조회 응답 (ka10079).

Parameters:

Name Type Description Default
stk_cd str

종목코드.

required
last_tic_cnt str

마지막틱갯수.

required
items list[StockCandleItem]

틱 캔들 리스트.

required

StockTimeProgram dataclass

StockTimeProgram(items: list[StockTimeProgramItem])

종목시간별프로그램매매추이요청 응답 (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

StockWeekChart(stk_cd: str, items: list[StockWeekChartItem])

주식주봉차트조회 응답 (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

StockYearChart(stk_cd: str, items: list[StockYearChartItem])

주식년봉차트조회 응답 (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

SupplyConcentration(items: list[SupplyConcentrationItem])

매물대집중 응답 (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

ThemeGroup(items: list[ThemeGroupItem])

테마그룹별요청 응답 (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

ThemeStocks(flu_rt: str, dt_prft_rt: str, items: list[ThemeStockItem])

테마구성종목요청 응답 (ka90002).

Parameters:

Name Type Description Default
flu_rt str

등락률.

required
dt_prft_rt str

기간수익률.

required
items list[ThemeStockItem]

테마구성종목 리스트.

required

TodayPrevExecution dataclass

TodayPrevExecution(items: list[TodayPrevExecutionItem])

당일전일체결 응답 (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

TodayPrevExecutionQty(items: list[TodayPrevExecutionQtyItem])

당일전일체결량 응답 (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

TokenRequest(appkey: str, secretkey: str, grant_type: str = 'client_credentials')

접근토큰 발급 요청 (au10001).

Parameters:

Name Type Description Default
appkey str

키움증권 앱 키.

required
secretkey str

키움증권 시크릿 키.

required
grant_type str

OAuth2 grant type. 항상 "client_credentials" 고정.

'client_credentials'

TokenResponse dataclass

TokenResponse(token: str, token_type: str, expires_dt: str)

접근토큰 발급 응답 (au10001).

Parameters:

Name Type Description Default
token str

접근토큰. Authorization: Bearer <token> 헤더에 사용.

required
token_type str

토큰 타입 (예: "Bearer").

required
expires_dt str

만료일시. "YYYYMMDDHHMMSS" 형식.

required

TradeAmtUpper dataclass

TradeAmtUpper(items: list[TradeAmtUpperItem])

거래대금상위 응답 (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

TradeQtySurge(items: list[TradeQtySurgeItem])

거래량급증 응답 (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

VIStocks(items: list[VIStockItem])

변동성완화장치 발동종목 응답 (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

VolumeUpdatedStocks(items: list[VolumeUpdatedItem])

거래량갱신 응답 (ka10024).

Parameters:

Name Type Description Default
items list[VolumeUpdatedItem]

거래량갱신 종목 리스트.

required

WatchlistInfo dataclass

WatchlistInfo(items: list[WatchlistStockItem])

관심종목정보 응답 (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