get_price

TossSimpleOverseasStock.get_price(ticker: str) DataFrame[source]

특정 티커의 현재 가격 정보를 조회하여 데이터프레임으로 반환합니다.

Note

거래대금이 제공되지 않아 cum_valueNA, 매수 주문 가능 여부가 제공되지 않아 ordyNone 입니다. 당일 캔들이 아직 없으면 누적 거래량은 0 입니다.

Parameters:

ticker (str) – 티커(symbol)

Returns:

현재 가격 정보 (index: ticker)

  • current_price (float): 현재 가격

  • cum_volume (int): 누적 거래량

  • cum_value (NA): 누적 거래 금액 (제공되지 않음)

  • diff (float): 전일 종가 대비 가격 차이

  • diff_rate (float): 전일 종가 대비 등락률

  • sign (int): 등락 기호 (2: 상승, 3: 보합, 5: 하락. 미국 시장은 상/하한 없음)

  • pclose (float): 전일 종가

  • pvolume (int): 전일 거래량

  • ordy (None): 매수 주문 가능 여부 (제공되지 않음)

Return type:

pd.DataFrame

Raises:

ValueError – 티커를 찾을 수 없는 경우