TossSimpleOverseasStock¶

class pyqqq.brokerage.toss.simple_overseas.TossSimpleOverseasStock(auth: TossAuth, account_no: str | None = None)[source]¶

Bases: object

토스증권 해외(미국)주식 API를 사용하여 주식 거래를 하기 위한 클래스입니다.

기존 TossOverseasStock 클래스를 감싸고, 간단한 주문/조회 기능을 제공합니다. 메서드 시그니처는 KISSimpleOverseasStock 을 따릅니다.

토스증권 Open API 제약으로 인한 차이점:

종목의 거래소(NYSE/NASDAQ/AMEX)가 노출되지 않아 포지션/주문의 exchange 는 항상 None 이며, 심볼은 거래소 접미사 없는 티커(“AAPL”)를 사용합니다.
소수점(0.5주 등) 수량 주문은 시장가 매도(MARKET+SELL)에만 허용되며, 그 외 주문은 정수 수량만 가능합니다. (소수점 매수는 금액(orderAmount) 주문 전용이라 지원되지 않음) 조회 결과의 수량은 정수이면 int, 소수점이 있으면 Decimal 로 반환됩니다.
주문 유형은 LIMIT/MARKET 만 지원됩니다. (MOO/LOO/MOC/LOC 미지원)
거래대금(value) 데이터가 제공되지 않아 관련 값은 None/NA 로 반환됩니다.
예약 주문(schedule_order 계열)과 주간거래(daytime_order 계열)는 지원되지 않아 NotImplementedError 를 발생시킵니다. 실시간 주문 이벤트(listen_order_event)도 아직 지원되지 않습니다. (TradingTracker 사용 불가)
종목 상세 정보(PER/시가총액 등)가 제공되지 않아 get_price_detail 은 없습니다.
미국 주식 정정은 가격 변경만 지원됩니다. (수량/유형 변경 불가) 정정 시 새로운 주문 ID가 발급되고 원주문은 REPLACED 상태가 됩니다.
취소는 전량 취소만 가능합니다.
취소/정정 요청이 별도의 주문 레코드로 조회되지 않아(KIS 와 다름) 주문 내역의 req_type 은 항상 NEW, org_order_no 는 항상 None 입니다.
“오늘”(get_today_minute_data, get_today_order_history)은 미국 동부 현지 날짜 기준입니다. (KST 새벽 장중에는 KST 기준 전일이 “오늘”)

Parameters:

auth (TossAuth) – 인증 정보
account_no (str) – 계좌번호. 미지정 시 첫 번째 계좌를 사용한다. (하나의 App Key로 여러 계좌 지원)

__init__(auth: TossAuth, account_no: str | None = None)[source]¶

메서드

`__init__`
`cancel_order`	주문을 취소합니다.
`cancel_scheduled_order`	예약 주문 취소 - 토스증권 Open API 에서 지원되지 않습니다.
`create_order`	주문을 생성합니다.
`daytime_cancel_order`	주간거래 주문 취소 - 토스증권 Open API 에서 지원되지 않습니다.
`daytime_order`	주간거래 주문 - 토스증권 Open API 에서 지원되지 않습니다.
`daytime_update_order`	주간거래 주문 정정 - 토스증권 Open API 에서 지원되지 않습니다.
`get_account`	계좌 요약 정보를 조회하여 총 잔고, 투자 가능 현금, 매입 금액 및 손익 정보를 반환합니다.
`get_historical_daily_data`	일봉 데이터 검색
`get_order`	주문 번호로 주문 정보를 조회합니다.
`get_order_history`	주문 내역을 조회합니다.
`get_orderbook`	특정 종목의 호가/잔량 정보를 조회하여 반환합니다.
`get_pending_orders`	미체결 주문을 조회합니다.
`get_positions`	보유 종목을 조회합니다.
`get_possible_quantity`	특정 티커에 대해 지정된 가격으로 주문 가능한 최대 수량과 금액을 조회합니다.
`get_price`	특정 티커의 현재 가격 정보를 조회하여 데이터프레임으로 반환합니다.
`get_scheduled_orders`	예약 주문 조회 - 토스증권 Open API 에서 지원되지 않습니다.
`get_supported_exchange_codes`	지원하는 미국 거래소 코드 목록 (참고용 - 토스증권은 거래소를 구분하지 않음)
`get_today_minute_data`	분봉 데이터 검색 (미국 현지 기준 오늘)
`get_today_order_history`	미국 현지 기준 오늘(또는 지정 일자)의 주문 내역을 조회합니다.
`listen_order_event`	계좌 주문 이벤트를 수신하는 메서드
`schedule_order`	예약 주문 - 토스증권 Open API 에서 지원되지 않습니다.
`update_order`	주문 가격을 정정합니다.

속성

`account_no`
`kst`
`nyt`