ksxt 0.0.8__py3-none-any.whl → 0.0.9__py3-none-any.whl

ksxt/market/krx/kospi.py

@@ -10,15 +10,15 @@ from ksxt.market.krx.stock import KrxStockItem, KrxStockMarket
 
 
 APNT_CLS_CODES = {
-    '0': '미분류',
-    '1': '건설기계',
-    '2': '조선운송',
-    '3': '철강소재',
-    '4': '에너지화학',
-    '5': '정보통신',
-    '6': '금융',
-    '7': '필수소비재',
-    '8': '자유소비재',
+    "0": "미분류",
+    "1": "건설기계",
+    "2": "조선운송",
+    "3": "철강소재",
+    "4": "에너지화학",
+    "5": "정보통신",
+    "6": "금융",
+    "7": "필수소비재",
+    "8": "자유소비재",
 }
 
 # region typedef struct
@@ -119,235 +119,236 @@ APNT_CLS_CODES = {
 # }   ST_KSP_CODE;
 # endregion typedef struct
 
+
 @dataclass
 class KospiItem(KrxStockItem):
     CONTROL = [
-         ('mksc_shrn_iscd', 9),
-        ('stnd_iscd', 12),
-        ('hts_kor_isnm', (9+12, -227)),
-        ('_index', -1),
-        ('_reverse', True),
-        ('scrt_grp_cls_code', 2),
-        ('avls_scal_cls_code', 1),
-        ('bstp_larg_div_code', 4),
-        ('bstp_medm_div_code', 4),
-        ('bstp_smal_div_code', 4),
-        ('mnin_cls_code_yn', 1),
-        ('low_current_yn', 1),
-        ('sprn_strr_nmix_issu_yn', 1),
-        ('kospi200_apnt_cls_code', 1),
-        ('kospi100_issu_yn', 1),
-        ('kospi50_issu_yn', 1),
-        ('krx_issu_yn', 1),
-        ('etp_prod_cls_code', 1),
-        ('elw_pblc_yn', 1),
-        ('krx100_issu_yn', 1),
-        ('krx_car_yn', 1),
-        ('krx_smcn_yn', 1),
-        ('krx_bio_yn', 1),
-        ('krx_bank_yn', 1),
-        ('etpr_undt_objt_co_yn', 1),
-        ('krx_enrg_chms_yn', 1),
-        ('krx_stel_yn', 1),
-        ('short_over_cls_code', 1),
-        ('krx_medi_cmnc_yn', 1),
-        ('krx_cnst_yn', 1),
-        ('_dummy', 1),
-        ('krx_scrt_yn', 1),
-        ('krx_ship_yn', 1),
-        ('krx_insu_yn', 1),
-        ('krx_trnp_yn', 1),
-        ('sri_nmix_yn', 1),
-        ('stck_sdpr', 9),
-        ('frml_mrkt_deal_qty_unit', 5),
-        ('ovtm_mrkt_deal_qty_unit', 5),
-        ('trht_yn', 1),
-        ('sltr_yn', 1),
-        ('mang_issu_yn', 1),
-        ('mrkt_alrm_cls_code', 2),
-        ('mrkt_alrm_risk_adnt_yn', 1),
-        ('insn_pbnt_yn', 1),
-        ('byps_lstn_yn', 1),
-        ('flng_cls_code', 2),
-        ('fcam_mod_cls_code', 2),
-        ('icic_cls_code', 2),
-        ('marg_rate', 3),
-        ('crdt_able', 1),
-        ('crdt_days', 3),
-        ('prdy_vol', 12),
-        ('stck_fcam', 12),
-        ('stck_lstn_date', 8),
-        ('lstn_stcn', 15),
-        ('cpfn', 21),
-        ('stac_month', 2),
-        ('po_prc', 7),
-        ('prst_cls_code', 1),
-        ('ssts_hot_yn', 1),
-        ('stange_runup_yn', 1),
-        ('krx300_issu_yn', 1),
-        ('kospi_issu_yn', 1),
-        ('sale_account', 9),
-        ('bsop_prfi', 9),
-        ('op_prfi', 9),
-        ('thtr_ntin', 5),
-        ('roe', 9),
-        ('base_date', 8),
-        ('prdy_avls_scal', 9),
-        ('grp_code', 3),
-        ('co_crdt_limt_over_yn', 1),
-        ('secu_lend_able_yn', 1),
-        ('stln_able_yn', 1),
+        ("mksc_shrn_iscd", 9),
+        ("stnd_iscd", 12),
+        ("hts_kor_isnm", (9 + 12, -227)),
+        ("_index", -1),
+        ("_reverse", True),
+        ("scrt_grp_cls_code", 2),
+        ("avls_scal_cls_code", 1),
+        ("bstp_larg_div_code", 4),
+        ("bstp_medm_div_code", 4),
+        ("bstp_smal_div_code", 4),
+        ("mnin_cls_code_yn", 1),
+        ("low_current_yn", 1),
+        ("sprn_strr_nmix_issu_yn", 1),
+        ("kospi200_apnt_cls_code", 1),
+        ("kospi100_issu_yn", 1),
+        ("kospi50_issu_yn", 1),
+        ("krx_issu_yn", 1),
+        ("etp_prod_cls_code", 1),
+        ("elw_pblc_yn", 1),
+        ("krx100_issu_yn", 1),
+        ("krx_car_yn", 1),
+        ("krx_smcn_yn", 1),
+        ("krx_bio_yn", 1),
+        ("krx_bank_yn", 1),
+        ("etpr_undt_objt_co_yn", 1),
+        ("krx_enrg_chms_yn", 1),
+        ("krx_stel_yn", 1),
+        ("short_over_cls_code", 1),
+        ("krx_medi_cmnc_yn", 1),
+        ("krx_cnst_yn", 1),
+        ("_dummy", 1),
+        ("krx_scrt_yn", 1),
+        ("krx_ship_yn", 1),
+        ("krx_insu_yn", 1),
+        ("krx_trnp_yn", 1),
+        ("sri_nmix_yn", 1),
+        ("stck_sdpr", 9),
+        ("frml_mrkt_deal_qty_unit", 5),
+        ("ovtm_mrkt_deal_qty_unit", 5),
+        ("trht_yn", 1),
+        ("sltr_yn", 1),
+        ("mang_issu_yn", 1),
+        ("mrkt_alrm_cls_code", 2),
+        ("mrkt_alrm_risk_adnt_yn", 1),
+        ("insn_pbnt_yn", 1),
+        ("byps_lstn_yn", 1),
+        ("flng_cls_code", 2),
+        ("fcam_mod_cls_code", 2),
+        ("icic_cls_code", 2),
+        ("marg_rate", 3),
+        ("crdt_able", 1),
+        ("crdt_days", 3),
+        ("prdy_vol", 12),
+        ("stck_fcam", 12),
+        ("stck_lstn_date", 8),
+        ("lstn_stcn", 15),
+        ("cpfn", 21),
+        ("stac_month", 2),
+        ("po_prc", 7),
+        ("prst_cls_code", 1),
+        ("ssts_hot_yn", 1),
+        ("stange_runup_yn", 1),
+        ("krx300_issu_yn", 1),
+        ("kospi_issu_yn", 1),
+        ("sale_account", 9),
+        ("bsop_prfi", 9),
+        ("op_prfi", 9),
+        ("thtr_ntin", 5),
+        ("roe", 9),
+        ("base_date", 8),
+        ("prdy_avls_scal", 9),
+        ("grp_code", 3),
+        ("co_crdt_limt_over_yn", 1),
+        ("secu_lend_able_yn", 1),
+        ("stln_able_yn", 1),
     ]
 
     excd: str
-    '''거래소정보'''
+    """거래소정보"""
     curr: str
-    '''화폐 정보'''
-    
+    """화폐 정보"""
+
     mksc_shrn_iscd: str
-    '''단축코드'''
+    """단축코드"""
     stnd_iscd: str
-    '''표준코드'''
+    """표준코드"""
     hts_kor_isnm: str
-    '''한글종목명'''
-    scrt_grp_cls_code: Literal['ST', 'MF', 'RT', 'SC', 'IF', 'DR', 'EW', 'EF', 'SW', 'SR', 'BC', 'FE', 'FS']
-    '''증권그룹구분코드'''
-    avls_scal_cls_code: Literal['0', '1', '2', '3']
-    '''시가총액 규모 구분 코드 유가'''
+    """한글종목명"""
+    scrt_grp_cls_code: Literal["ST", "MF", "RT", "SC", "IF", "DR", "EW", "EF", "SW", "SR", "BC", "FE", "FS"]
+    """증권그룹구분코드"""
+    avls_scal_cls_code: Literal["0", "1", "2", "3"]
+    """시가총액 규모 구분 코드 유가"""
     bstp_larg_div_code: str
-    '''지수 업종 대분류 코드'''
+    """지수 업종 대분류 코드"""
     bstp_medm_div_code: str
-    '''지수 업종 중분류 코드'''
+    """지수 업종 중분류 코드"""
     bstp_smal_div_code: str
-    '''지수 업종 소분류 코드'''
+    """지수 업종 소분류 코드"""
     mnin_cls_code_yn: bool
-    '''제조업 구분 코드'''
+    """제조업 구분 코드"""
     low_current_yn: bool
-    '''저유동성종목 여부'''
+    """저유동성종목 여부"""
     sprn_strr_nmix_issu_yn: bool
-    '''지배 구조 지수 종목 여부'''
-    kospi200_apnt_cls_code: Literal['0', '1', '2', '3', '4', '5', '6', '7', '8']
-    '''KOSPI200 섹터업종'''
+    """지배 구조 지수 종목 여부"""
+    kospi200_apnt_cls_code: Literal["0", "1", "2", "3", "4", "5", "6", "7", "8"]
+    """KOSPI200 섹터업종"""
     kospi100_issu_yn: bool
-    '''KOSPI100여부'''
+    """KOSPI100여부"""
     kospi50_issu_yn: bool
-    '''KOSPI50 종목 여부'''
+    """KOSPI50 종목 여부"""
     krx_issu_yn: bool
-    '''KRX 종목 여부'''
-    etp_prod_cls_code: Literal['0', '1', '2', '3']
-    '''ETP 상품구분코드'''
+    """KRX 종목 여부"""
+    etp_prod_cls_code: Literal["0", "1", "2", "3"]
+    """ETP 상품구분코드"""
     elw_pblc_yn: bool
-    '''ELW 발행여부'''
+    """ELW 발행여부"""
     krx100_issu_yn: bool
-    '''KRX100 종목 여부'''
+    """KRX100 종목 여부"""
     krx_car_yn: bool
-    '''KRX 자동차 여부'''
+    """KRX 자동차 여부"""
     krx_smcn_yn: bool
-    '''KRX 반도체 여부'''
+    """KRX 반도체 여부"""
     krx_bio_yn: bool
-    '''KRX 바이오 여부'''
+    """KRX 바이오 여부"""
     krx_bank_yn: bool
-    '''KRX 은행 여부'''
+    """KRX 은행 여부"""
     etpr_undt_objt_co_yn: bool
-    '''기업인수목적회사여부'''
+    """기업인수목적회사여부"""
     krx_enrg_chms_yn: bool
-    '''KRX 에너지 화학 여부'''
+    """KRX 에너지 화학 여부"""
     krx_stel_yn: bool
-    '''KRX 철강 여부'''
-    short_over_cls_code: Literal['0', '1', '2', '3']
-    '''단기과열종목구분코드'''
+    """KRX 철강 여부"""
+    short_over_cls_code: Literal["0", "1", "2", "3"]
+    """단기과열종목구분코드"""
     krx_medi_cmnc_yn: bool
-    '''KRX 미디어 통신 여부'''
+    """KRX 미디어 통신 여부"""
     krx_cnst_yn: bool
-    '''KRX 건설 여부'''
+    """KRX 건설 여부"""
     krx_scrt_yn: bool
-    '''KRX 증권 구분'''
+    """KRX 증권 구분"""
     krx_ship_yn: bool
-    '''KRX 선박 구분'''
+    """KRX 선박 구분"""
     krx_insu_yn: bool
-    '''KRX섹터지수 보험여부'''
+    """KRX섹터지수 보험여부"""
     krx_trnp_yn: bool
-    '''KRX섹터지수 운송여부'''
+    """KRX섹터지수 운송여부"""
     sri_nmix_yn: bool
-    '''SRI 지수여부'''
+    """SRI 지수여부"""
     stck_sdpr: int
-    '''주식 기준가'''
+    """주식 기준가"""
     frml_mrkt_deal_qty_unit: int
-    '''정규 시장 매매 수량 단위'''
+    """정규 시장 매매 수량 단위"""
     ovtm_mrkt_deal_qty_unit: int
-    '''시간외 시장 매매 수량'''
+    """시간외 시장 매매 수량"""
     trht_yn: bool
-    '''거래정지 여부'''
+    """거래정지 여부"""
     sltr_yn: bool
-    '''정리매매 여부'''
+    """정리매매 여부"""
     mang_issu_yn: bool
-    '''관리 종목 여부'''
-    mrkt_alrm_cls_code: Literal['00', '01', '02', '03']
-    '''시장 경고 구분 코드'''
+    """관리 종목 여부"""
+    mrkt_alrm_cls_code: Literal["00", "01", "02", "03"]
+    """시장 경고 구분 코드"""
     mrkt_alrm_risk_adnt_yn: bool
-    '''시장 경고위험 예고 여부'''
+    """시장 경고위험 예고 여부"""
     insn_pbnt_yn: bool
-    '''불성실 공시 여부'''
+    """불성실 공시 여부"""
     byps_lstn_yn: bool
-    '''우회 상장 여부'''
-    flng_cls_code: Literal['00', '01', '02', '03', '04', '05', '06', '99']
-    '''락구분 코드'''
-    fcam_mod_cls_code: Literal['00', '01', '02', '99']
-    '''액면가 변경 구분 코드'''
-    icic_cls_code: Literal['00', '01', '02', '03', '99']
-    '''증자 구분 코드'''
+    """우회 상장 여부"""
+    flng_cls_code: Literal["00", "01", "02", "03", "04", "05", "06", "99"]
+    """락구분 코드"""
+    fcam_mod_cls_code: Literal["00", "01", "02", "99"]
+    """액면가 변경 구분 코드"""
+    icic_cls_code: Literal["00", "01", "02", "03", "99"]
+    """증자 구분 코드"""
     marg_rate: int
-    '''증거금 비율'''
+    """증거금 비율"""
     crdt_able: bool
-    '''신용주문 가능 여부'''
+    """신용주문 가능 여부"""
     crdt_days: int
-    '''신용기간'''
+    """신용기간"""
     prdy_vol: int
-    '''전일 거래량'''
+    """전일 거래량"""
     stck_fcam: int
-    '''주식 액면가'''
+    """주식 액면가"""
     stck_lstn_date: datetime
-    '''주식 상장 일자'''
+    """주식 상장 일자"""
     lstn_stcn: int
-    '''상장 주수(천)'''
+    """상장 주수(천)"""
     cpfn: int
-    '''자본금'''
+    """자본금"""
     stac_month: int
-    '''결산 월'''
+    """결산 월"""
     po_prc: int
-    '''공모 가격'''
-    prst_cls_code: Literal['0', '1', '2']
-    '''우선주 구분 코드'''
+    """공모 가격"""
+    prst_cls_code: Literal["0", "1", "2"]
+    """우선주 구분 코드"""
     ssts_hot_yn: bool
-    '''공매도과열종목여부'''
+    """공매도과열종목여부"""
     stange_runup_yn: bool
-    '''이상급등종목여부'''
+    """이상급등종목여부"""
     krx300_issu_yn: bool
-    '''KRX300 종목 여부'''
+    """KRX300 종목 여부"""
     kospi_issu_yn: bool
-    '''KOSPI여부'''
+    """KOSPI여부"""
     sale_account: int
-    '''매출액'''
+    """매출액"""
     bsop_prfi: int
-    '''영업이익'''
+    """영업이익"""
     op_prfi: int
-    '''경상이익'''
+    """경상이익"""
     thtr_ntin: int
-    '''당기순이익'''
+    """당기순이익"""
     roe: float
-    '''ROE(자기자본이익률)'''
+    """ROE(자기자본이익률)"""
     base_date: datetime
-    '''기준년월'''
+    """기준년월"""
     prdy_avls_scal: int
-    '''전일기준 시가총액 (억)'''
+    """전일기준 시가총액 (억)"""
     grp_code: str
-    '''그룹사 코드'''
+    """그룹사 코드"""
     co_crdt_limt_over_yn: bool
-    '''회사신용한도초과여부'''
+    """회사신용한도초과여부"""
     secu_lend_able_yn: bool
-    '''담보대출가능여부'''
+    """담보대출가능여부"""
     stln_able_yn: bool
-    '''대주가능여부'''
+    """대주가능여부"""
 
     @property
     def kospi200_apnt_cls_name(self) -> str:
@@ -359,11 +360,12 @@ class KospiItem(KrxStockItem):
 
 
 class _KospiItem(Base):
-    '''KOSPI 종목 정보'''
-    __tablename__ = 'kospi'
-    excd = Column(String, default='kospi')
-    curr = Column(String, default='KRW')
-    
+    """KOSPI 종목 정보"""
+
+    __tablename__ = "kospi"
+    excd = Column(String, default="kospi")
+    curr = Column(String, default="KRW")
+
     mksc_shrn_iscd = Column(String, primary_key=True)
     stnd_iscd = Column(String)
     hts_kor_isnm = Column(String)
@@ -442,4 +444,6 @@ class Kospi(KrxStockMarket[KospiItem, _KospiItem]):
     logger: logging.Logger
 
     def __init__(self, client):
-        super().__init__(client, 'kospi', '코스피', 'https://new.real.download.dws.co.kr/common/master/kospi_code.mst.zip')
+        super().__init__(
+            client, "kospi", "코스피", "https://new.real.download.dws.co.kr/common/master/kospi_code.mst.zip"
+        )