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”)를 사용합니다.
소수점 수량 주문은 시장가 매도(MARKET+SELL)에만 허용됩니다. 조회 결과의 수량은 정수이면 int, 소수점이 있으면 Decimal.
주문 유형은 LIMIT/MARKET 만 지원됩니다. (MOO/LOO/MOC/LOC 미지원)
거래대금(value)은 제공되지 않아 None/NA 로 반환됩니다.
예약 주문/주간거래/실시간 주문 이벤트 미지원 - 해당 메서드는 NotImplementedError. (TradingTracker 사용 불가)
종목 상세 정보(PER/시가총액 등)가 제공되지 않아 get_price_detail 은 없습니다.
정정은 가격 변경만 지원되고(수량/유형 불가) 새 주문 ID가 발급되며, 취소는 전량 취소만 가능합니다.
주문 내역 조회는 취소된 주문에서 취소(CANCEL) 레코드를 분리해 반환합니다. (order_no=None, org_order_no 로 원주문 연결 - 상세는 문서 “주문 내역과 취소/정정 레코드” 참고)
“오늘”(get_today_minute_data, get_today_order_history)은 미국 동부 현지 날짜 기준입니다.

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`