get_tickers#

pyqqq.data.domestic.get_tickers(date: date | None = None, market: str | None = None)[source]#

주어진 날짜와 시장에 따른 주식 종목 코드와 관련 정보를 조회합니다.

이 함수는 지정된 날짜(기본값은 오늘)와 선택적 시장(‘KOSPI’, ‘KOSDAQ’)에 대한 주식 종목 코드와 추가 정보를 API를 통해 요청합니다. 반환된 정보는 pandas DataFrame 형태로 제공되며, 데이터가 없는 경우 빈 DataFrame을 반환합니다. DataFrame은 ‘code’를 인덱스로 사용합니다.

2018년 1월 1일 데이터 부터 조회 가능합니다.

Parameters:

  • date (Optional[dtm.date]) – 조회할 날짜. 기본값은 현재 날짜입니다.

  • market (Optional[str]) – 조회할 시장. ‘KOSPI’ 또는 ‘KOSDAQ’ 중 선택할 수 있습니다.

Returns:

주식 종목 코드와 관련 정보를 포함하는 DataFrame. ‘code’ 컬럼은 인덱스로 설정됩니다.

  • market (str): 시장 이름 (KOSPI 또는 KOSDAQ)

  • name (str): 종목 이름

  • type (str): 종목 유형 (EQUITY, ETF, ETN)

  • reference_price (int): 기준가

  • upper_limit (int or None): 상한가

  • lower_limit (int or None): 하한가

  • previous_close (int): 전일 종가

  • listing_date (str or None): 상장일

Return type:

pd.DataFrame

Raises:

  • AssertionError – 잘못된 시장 이름이 입력된 경우 오류를 발생시킵니다.

  • HTTPError – API 요청이 실패했을 때 발생.

Examples

>>> tickers = get_tickers()
>>> print(tickers)
        market     name    type  reference_price  upper_limit  lower_limit  previous_close listing_date delisting_date
code
000020   KOSPI     동화약품  EQUITY             7820        10160         5480            7820     19760324
000040   KOSPI    KR모터스  EQUITY              571          742          400             571     19760525
000050   KOSPI       경방  EQUITY             6050         7860         4240            6050     19560303
000070   KOSPI    삼양홀딩스  EQUITY            71100        92400        49800           71100     19681227
000075   KOSPI   삼양홀딩스우  EQUITY            54200        70400        38000           54200     19920221
On this page
Show Source