get_orderbook

KISSimpleOverseasStock.get_orderbook(ticker: str) → Dict

특정 티커의 호가/잔량 정보를 조회하여 반환합니다.

Parameters:

ticker (str) – 조회할 자산의 티커(symbol).

Returns:

호가 정보가 포함된 사전.

• total_bid_volume (int): 총 매수 잔량.

• total_ask_volume (int): 총 매도 잔량.

• ask_price (Decimal): 1차 매도 호가 가격.

• ask_volume (int): 1차 매도 호가 잔량.

• bid_price (Decimal): 1차 매수 호가 가격.

• bid_volume (int): 1차 매수 호가 잔량.

• time (dtm.datetime): 현지 기준 호가 정보 조회 시간.

• bids (list): 매수 호가 목록 (각 항목은 price와 volume을 포함하는 dict).

• asks (list): 매도 호가 목록 (각 항목은 price과 volume을 포함하는 dict).

Return type:

dict

Raises:

ValueError – 주어진 티커가 유효하지 않거나 찾을 수 없는 경우 발생.