get_possible_quantity¶
- TossSimpleOverseasStock.get_possible_quantity(ticker: str, price: Decimal | None = None) Dict[source]¶
특정 티커에 대해 지정된 가격으로 주문 가능한 최대 수량과 금액을 조회합니다.
수량은 매매 수수료(센트 단위 올림)를 포함한 총비용이 매수 가능 현금을 넘지 않는 최대치로 계산합니다. 소수점 수량 매수는 지원되지 않아(금액 주문 전용) 정수 수량만 반환합니다.
- Parameters:
ticker (str) – 조회할 자산의 티커(symbol)
price (Decimal) – 조회할 가격. 지정하지 않으면 현재 가격을 사용.
- Returns:
주문 가능한 수량 및 금액 정보
currency (str): 거래 통화 코드 (“USD”)
possible_amount (Decimal): 주문 가능한 금액
quantity (int): 주문 가능한 최대 정수 수량 (수수료 반영)
price (Decimal): 계산 기준 단가
- Return type:
dict
- Raises:
ValueError – 현재가 조회 실패 또는 가격이 유효하지 않은 경우