kquant API document (0.3.6)

info_stock

단일 주식 종목의 모든 현재 상태 정보를 출력하는 함수

  • API URL
    • /stock/m001/basic_info_all
    • /stock/m003/basic_info_all
info_stock(
    symbol: 'str',
    as_frame: 'bool'=False,
) -> Union[pd.Series, pd.DataFrame]
  • symbol (str): 주식 종목의 단축 종목코드

  • as_frame (bool): True면 Pandas Series가 아닌 Pandas DataFrame으로 출력. 디폴트 False

  • 반환값 (Union[pd.Series, pd.DataFrame]): 주식 종목 또는 ETP 상품(ETF/ETN등)의 모든 현재 상태 정보를 담은 Pandas Series 또는 Pandas DataFrame. 주식 종목 또는 ETP 상품(ETF/ETN등)의 필드가 다른 점에 주의!

    • 공통 필드 설명

      필드명 필드설명 타입
      SYMBOL 종목 단축코드 6자리 str
      ISIN ISIN 종목코드 str
      TIMESTAMP 최근 체결시간 int64
      OPEN 호출당일 시가 int64
      HIGH 호출당일 고가 int64
      LOW 호출당일 저가 int64
      LAST 현재가 int64
      VOLUME_ACC 호출당일 누적거래량 int64
      AMOUNT_ACC 호출당일 누적거래대금 int64
      CHG 전일대비 등락 int64
      CHG_PCT 전일대비 등락률 float64
      CHG_TYPE 전일대비 등락구분 int64
      NAME 국문주권명 str
      NAME_EN 영문주권명 str
      NAME_SHORT 국문단축주권명 str
      NAME_SHORT_EN 영문단축주권명 str
      SEC_TYPE 증권그룹 str
      SPAC 기업인수목적회사 여부 str
      UPPER_LIMIT 호출당일 상한가 int64
      LOWER_LIMIT 호출당일 하한가 int64
      PREV_CLOSE 전일 종가 int64
      BASE_PRICE 기준가 int64
      EX_EVENT 락구분 str
      ADMIN_ISSUE 주식통합시장조치 int64
      SETTLE_PRICE 예상 체결가 int64
      SETTLE_CHG 예상 등락 int64
      SETTLE_CHG_PCT 예상 등락률 float64
      SETTLE_CHG_TYPE 예상 등락구분 int64
      POSTHOUR_PRICE 시간외단일가 현재가 int64
      POSTHOUR_PREV 시간외단일가 전일종가 int64
      POSTHOUR_CHG 시간외단일가 등락 int64
      POSTHOUR_CHG_PCT 시간외단일가 등락률 float64
      POSTHOUR_CHG_TYPE 시간외단일가 등락구분 int64
      LIST_DATE 상장일 int64
      DAY20_HIGH 20일 최고가 int64
      DAY20_HIGH_DATE 20일 최고가 일자 int64
      DAY20_LOW 20일 최저가 int64
      DAY20_LOW_DATE 20일 최저가 일자 int64
      DAY60_HIGH 60일 최고가 int64
      DAY60_HIGH_DATE 60일 최고가 일자 int64
      DAY60_LOW 60일 최저가 int64
      DAY60_LOW_DATE 60일 최저가 일자 int64
      DAY120_HIGH 120일 최고가 int64
      DAY120_HIGH_DATE 120일 최고가 일자 int64
      DAY120_LOW 120일 최저가 int64
      DAY120_LOW_DATE 120일 최저가 일자 int64
      YTD_HIGH 연중 최고가 int64
      YTD_HIGH_DATE 연중 최고가 일자 int64
      YTD_LOW 연중 최저가 int64
      YTD_LOW_DATE 연중 최저가 일자 int64
      HIST_HIGH 역사적 최고가 int64
      HIST_HIGH_DATE 역사적 최고가 일자 int64
      HIST_LOW 역사적 최저가 int64
      HIST_LOW_DATE 역사적 최저가 일자 int64
      LOAN_VOLUME 신용융자잔고수량 int64
      LOAN_RATIO 신용융자잔고비율 float64
      FOREIGN_RATIO 외국인보유율 float64
      FOREIGN_SHARES 외국인보유주식수 int64
      FOREIGN_SHARES_PREV 전일 외국인보유주식수 int64
      FOREIGN_SHARES_CHG 외국인보유주식수 등락 int64
      FOREIGN_ORDER_CAP 외국인주문가능수량 int64
      FOREIGN_CAP 외국인한도수량 int64
      MARKETCAP 시가총액 int64
      SHARES 상장주식수 int64
      ISSUED_COMMON 보통주 발행주식수 int64
      ISSUED_PREFER 우선주 발행주식수 int64
    • SEC_TYPE 증권그룹 값의 의미

      유형문자열 유형설명
      ST 주권(주식)
      EF 상장지수펀드 (ETF: Exchange Traded Fund)
      EN 상장지수증권 (ETN: Exchange Traded Note)
      FS 외국주권
      DR 주식예탁증서 (DR: Depository Receipt)
      RT 부동산투자회사
      IF 사회간접자본투융자회사
      MF 증권투자회사
      SC 선박투자회사
    • ADMIN_ISSUE 주식통합시장조치 값의 의미

      의미
      0 정상
      10 시초가산출
      20 투자주의
      21 투자경고
      22 투자위험
      30 불성실공시
      40 투자유의
      50 관리지정
      60 거래정지
      61 거래중단
      70 정리매매
      80 단기과열
      89 공매도 X
      91 기타
    • CHG_TYPE 등락구분 값의 의미

      의미
      1 상한
      2 상승
      3 보합
      4 하한
      5 하락
      6 기세상한
      7 기세상승
      8 기세하한
      9 기세하락
    • 주식 종목에만 존재하는 필드 설명

      필드명 필드설명 타입
      FLOAT_SHARES 유동주식수 int64
      FLOAT_RATIO 유동비율 int64
      PAR 액면가 int64
      CAPITAL 자본금 int64
      NET_INCOME 당기순이익 int64
      EPS 주당순이익(Earning Per Share) float64
      BPS 주당주당순자산(Book-value Per Share) float64
      CPS 주당현금흐름(Cashflow Per Share) float64
      SPS 주당매출액(Sales Per Share) float64
      PER 주가수익비율(Price Earnings Ratio) float64
      PBR 주가순자산비율(Price Book-value Ratio) float64
      PCR 주가현금흐름비율(Price Cachflow Ratio) float64
      PSR 주가매출액비율(Price Sales Ratio) float64
      DPS 배당금(Dividend Per Share) float64
      DIV_YIELD 시가배당수익률 float64
      SHORT_VOLUME 전일 공매도 거래수량 int64
      SHORT_AMOUNT 전일 공매도 거래대금 int64
      SHORT_VOLUME_RATIO 전일 공매도 거래수량비중 float64
      SHORT_AMOUNT_RATIO 전일 공매도 거래대금비중 float64
      SHORT_OVERHEAT 공매도과열지정여부(Y:지정, N:미지정) str
      INDEX_SYMBOL_MAJOR 지수업종코드(중) int64
      INDEX_SYMBOL_MINOR 지수업종코드(소) int64
    • ETF/ETN 등 ETP 상품에만 존재하는 필드 설명

      필드명 필드설명 타입
      ETP_TYPE ETF상품 유형코드 int64
      ETP_ISSUER_NAME 운용사명 str
      ETP_LEVERAGE_TYPE 레버리지 유형 str
      ETP_LEVERAGE 레버리지 배율 float64
      ETP_CU ETF 구성단위 (CU) int64
      ETP_COST 연간총보수율(%) float64
      ETP_TRACKING_ERROR 추적오차율 float64
      ETP_DISPARATE_RATIO 괴리율 float64
      ETP_NAV 지표가치(NAV/IV) float64
      ETP_NAV_PREV 전일지표가치(NAV/IV) float64
      ETP_INAV 장중지표가치(iNAV/iIV) float64
      ETP_INAV_CHG 장중지표가치(iNAV/iIV)등락 float64
      ETP_BM_NAME 기초자산명 str
      ETP_BM_NAME_EN 기초자산영문명 str
      ETP_BM_MARKET 기초지수소속시장구분코드 str
      ETP_BM_SYMBOL 기초지수코드 str
      ETP_BM_LAST 기초지수현재가 float64
      ETP_BM_CHG 기초지수등락 float64
      ETP_BM_CHG_PCT 기초지수등락률 float64
      ETP_BM_CAT_MAJOR 지수시장대분류 str
      ETP_BM_CAT_MINOR 지수시장중분류 str
      ETP_BM_CAT_MICRO 지수시장소분류 str
      ETP_BM_CAT_MAJOR_1 지수자산대분류1 str
      ETP_BM_CAT_MINOR_1 지수자산중분류1 str
      ETP_BM_CAT_MICRO_1 지수자산소분류1 str
      ETP_BM_CAT_MAJOR_2 지수자산대분류2 str
      ETP_BM_CAT_MINOR_2 지수자산중분류2 str
      ETP_BM_CAT_MICRO_2 지수자산소분류2 str
      ETP_EXPIRY ETN 만기날짜 int64
      ETP_LP_RATIO ETN LP보유수량비중 float64
      ETP_DISTRIB_DATE 최근분배일 int64
      ETP_DISTRIB_AMOUNT 1년분배금 int64
      ETP_DISTRIB_RATIO 분배율 float64
    • ETP_TYPE ETF상품 유형코드 값의 의미

      의미
      1 투자회사형 ETF
      2 수익증권형 ETF
      3 ETN
      4 손실제한형 ETN
    • ETP_LEVERAGE_TYPE 레버리지 유형 값의 의미

      의미
      P1 1배(x1)
      P2 2배(x2)
      P3 3배(x3)
      N1 인버스 1배(x-1)
      N2 인버스 2배(x-2)
      N3 인버스 3배(x-3)
      NA 기타
예제 코드
import kquant as kq
kq.info_stock("005930")
SYMBOL                      005930
ISIN                  KR7005930003
TIMESTAMP                 17001800
OPEN                         73400
HIGH                         73700
                          ...     
SHORT_VOLUME_RATIO          0.0200
SHORT_AMOUNT_RATIO          0.0200
SHORT_OVERHEAT                   N
INDEX_SYMBOL_MAJOR              13
INDEX_SYMBOL_MINOR              13
Name: 0, Length: 88, dtype: object
kq.info_stock("069500")
SYMBOL                      069500
ISIN                  KR7069500007
TIMESTAMP                 17003000
OPEN                         35855
HIGH                         36110
                          ...     
ETP_EXPIRY                       0
ETP_LP_RATIO                0.0000
ETP_DISTRIB_DATE          20240129
ETP_DISTRIB_AMOUNT             715
ETP_DISTRIB_RATIO           1.9900
Name: 0, Length: 99, dtype: object