TossSimpleOverseasStock

메서드 시그니처는 KISSimpleOverseasStock 을 따릅니다.

Note

토스증권 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 은 없습니다.

  • 미국 주식 정정(update_order)은 가격 변경만 지원됩니다. (수량/유형 변경 불가) 정정 시 새로운 주문 ID가 발급되고 원주문은 REPLACED 상태가 됩니다. 취소는 전량 취소만 가능합니다.

  • 취소/정정 요청이 별도의 주문 레코드로 조회되지 않아 주문 내역의 req_type 은 항상 NEW, org_order_no 는 항상 None 입니다. (주문 내역과 취소/정정 레코드 참고)

  • “오늘”(get_today_minute_data, get_today_order_history)은 미국 동부 현지 날짜 기준입니다.

Constructor

TossSimpleOverseasStock(auth[, account_no])

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

Methods

get_account()

계좌 요약 정보를 조회하여 총 잔고, 투자 가능 현금, 매입 금액 및 손익 정보를 반환합니다.

get_possible_quantity(ticker[, price])

특정 티커에 대해 지정된 가격으로 주문 가능한 최대 수량과 금액을 조회합니다.

get_positions([to_frame])

보유 종목을 조회합니다.

get_historical_daily_data(ticker, ...[, ...])

일봉 데이터 검색

get_today_minute_data(ticker)

분봉 데이터 검색 (미국 현지 기준 오늘)

get_price(ticker)

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

get_orderbook(ticker)

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

create_order(ticker, side, quantity, order_type)

주문을 생성합니다.

update_order(ticker, org_order_no, price[, ...])

주문 가격을 정정합니다.

cancel_order(ticker, order_no[, quantity])

주문을 취소합니다.

get_pending_orders([to_frame])

미체결 주문을 조회합니다.

get_today_order_history([target_date, to_frame])

미국 현지 기준 오늘(또는 지정 일자)의 주문 내역을 조회합니다.

get_order_history(from_date, to_date[, to_frame])

주문 내역을 조회합니다.

get_order(order_no)

주문 번호로 주문 정보를 조회합니다.

get_supported_exchange_codes()

지원하는 미국 거래소 코드 목록 (참고용 - 토스증권은 거래소를 구분하지 않음)

Data Classes

TossOverseasStockPosition(asset_code, ...[, ...])

TossOverseasStockOrder(order_no, asset_code, ...)