get_all_day_data#

pyqqq.data.minutes.get_all_day_data(date: date, codes: list[str] | str, period: timedelta = datetime.timedelta(seconds=60), source: str = 'kis', adjusted: bool = True, ascending: bool = True, exchange: str | DataExchange = 'KRX') dict[str, DataFrame] | DataFrame[source]#

지정된 날짜에 대해 하나 이상의 주식 코드에 대한 전체 분별 OHLCV(시가, 고가, 저가, 종가, 거래량) 데이터를 검색하여 반환합니다.

데이터 소스에 따라 데이터 조회 가능 시작일이 다릅니다. LS증권은 추후 제거될 예정입니다.

데이터 소스별 조회 가능 기간:
한국투자증권:
  • KRX: 2023년 7월 3일 데이터 부터 조회 가능합니다.

  • NXT: 2025년 3월 4일 데이터 부터 조회 가능합니다.

LS증권(구 이베스트증권):
  • KRX: 2024년 4월 26일 ~ 2025년 7월 17일까지 데이터 조회 가능합니다.

  • NXT: 조회 불가합니다.

Parameters:
  • date (datetime.date) – 데이터를 검색할 날짜.

  • codes (list[str]) – 조회할 주식 코드들의 리스트. 최대 20개까지 지정할 수 있습니다.

  • period (datetime.timedelta, optional) – 반환된 데이터의 시간 간격. 기본값은 1분입니다. 30초 이상의 값을 30초간격으로 지정할 수 있습니다.

  • source (str, optional) – 데이터를 검색할 API. ‘ebest’ 또는 ‘kis’를 지정할 수 있습니다. 기본값은 ‘kis’입니다.

  • adjusted (bool) – 수정주가 여부. 기본값은 True.

  • ascending (bool) – 오름차순 여부. 기본값은 True.

  • exchange (Union[str, DataExchange]) – 거래소. 기본값은 KRX. (cf. NXT의 경우 해당되지 않는 종목은 Empty DataFrame이 반환됩니다.)

Returns:

주식 코드를 키로 하고, 해당 주식의 일일 OHLCV 데이터가 포함된 pandas DataFrame을 값으로 하는 딕셔너리. 각 DataFrame에는 변환된 ‘time’ 열이 포함되어 있으며, 이는 조회된 데이터의 시간을 나타냅니다. ‘time’ 열은 DataFrame의 인덱스로 설정되고 오름차순으로 정렬됩니다.

DataFrame의 열은 다음과 같습니다:

  • time (datetime.datetime): 시간

  • open (int): 시가

  • high (int): 고가

  • low (int): 저가

  • close (int): 종가

  • volume (int): 거래량

  • value (int): 거래대금

  • cum_volume (int): 누적거래량

  • cum_value (int): 누적거래대금

Return type:

dict[str, pd.DataFrame]

Raises:

requests.exceptions.RequestException – PYQQQ API로부터 데이터를 검색하는 과정에서 오류가 발생한 경우.

Examples

>>> result = get_all_day_data(datetime.date(2025, 8, 12), codes=["005930", "319640"], source="kis", exchange="UN")
>>> print(result["005930"])
        open   high    low  close  volume       value  cum_volume      cum_value
time
2025-08-12 08:00:00  71100  71300  71000  71200   39907  2840499700       39907     2840499700
2025-08-12 08:01:00  71200  71200  71100  71200   17688  1258243300       57595     4098743000
2025-08-12 08:02:00  71200  71300  71100  71300   37311  2656578100       94906     6755321100
2025-08-12 08:03:00  71200  71300  71200  71300   12086   861096800      106992     7616417900
2025-08-12 08:04:00  71300  71300  71200  71300   14868  1059991500      121860     8676409400
...                    ...    ...    ...    ...     ...         ...         ...            ...
2025-08-12 19:56:00  71200  71300  71200  71300    3507   250012700    22367898  1603227575600
2025-08-12 19:57:00  71200  71300  71200  71200    6834   487156900    22374732  1603714732500
2025-08-12 19:58:00  71200  71300  71200  71300    9708   692159000    22384440  1604406891500
2025-08-12 19:59:00  71300  71400  71200  71400   10540   751223500    22394980  1605158115000
2025-08-12 20:00:00  71400  71400  71400  71400       0           0    22394980  1605158115000