get_rising_stocks#

pyqqq.data.domestic.get_rising_stocks(market: str, time: datetime | date) → DataFrame[source]#

지정된 시장과 시간에 따른 상승 주식 목록을 조회합니다.

이 함수는 주어진 시장(‘KOSPI’ 또는 ‘KOSDAQ’)과 날짜 및/또는 시간에 대해 상승하는 주식들의 데이터를 API를 통해 요청합니다. 휴장일인 경우 빈 DataFrame을 반환합니다. 요청한 날짜 및 시간에 대한 데이터가 없는 경우에도 빈 DataFrame을 반환하며, 요청이 실패하면 예외를 발생시킵니다. 반환된 데이터는 ‘code’를 인덱스로 사용하는 DataFrame 형태로 제공됩니다.

시간은 30분 단위로만 제공됩니다. 예를 들어 9시 30분, 10시 00분, 10시 30분 등으로만 조회할 수 있습니다. 그 외의 시간은 30분 단위로 내림하여 조회합니다. 예를 들어 9시 15분은 9시 00분으로 조회합니다.

2024년 5월 3일 데이터 부터 조회 가능합니다.

Parameters:

  • market (str) – 조회할 주식 시장의 명칭. ‘KOSPI’ 또는 ‘KOSDAQ’ 중 하나여야 합니다.

  • time (dtm.datetime | dtm.date) – 조회할 날짜와 시간. 시간이 제공되지 않은 경우 시장 종료 시간을 사용합니다.

Returns:

주식 데이터를 포함하는 DataFrame. ‘code’를 인덱스로 사용합니다.

Return type:

pd.DataFrame

Raises:

  • AssertionError – 잘못된 시장 명칭이 입력된 경우.

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

Examples

>>> stocks = get_rising_stocks("KOSPI", dtm.datetime.now())
>>> print(stocks)
        rank     name  current_price  change  change_rate    volume  bid_price  ask_price  bid_volume  ask_volume    per    roe
code
090460     1     비에이치          20700    3060        17.35  14705798      20700      20750      107635      194628   7.87  15.11
004090     2     한국석유          17150    2050        13.58  12984410      17150      17160       21096        4507  14.66   8.67
002380     3      KCC         280500   33000        13.33    140193     280000     280500        1259        5112  11.72   4.13
018880     4    한온시스템           6490     620        10.56   4428320       6480       6490       24297      146398  67.60   2.21
025620     5  제이준코스메틱           7710     710        10.14   1231670       7700       7710         677        6139  -4.96 -16.66
On this page
Show Source