pyqqq.brokerage.toss.overseas_stock¶

토스증권 해외(미국)주식 API 모듈입니다. 시세 조회, 주문 실행, 계좌 조회 기능을 제공합니다. 국내와 동일한 엔드포인트를 사용하며, 보유 주식/주문 조회 결과에서 미국(US/USD) 종목만 반환합니다. 심볼은 거래소 접미사 없는 티커(“AAPL”)를 사용하며, 소수점(0.5주 등) 수량은 시장가 매도 주문에만 허용됩니다.

사용 예시

from pyqqq.brokerage.toss.oauth import TossAuth
from pyqqq.brokerage.toss.overseas_stock import TossOverseasStock
import os

auth = TossAuth(
    client_id=os.getenv("TOSS_CLIENT_ID"),
    client_secret=os.getenv("TOSS_CLIENT_SECRET"),
)
api = TossOverseasStock(auth=auth)

# 애플 현재가 조회
prices = api.get_prices("AAPL")

# 계좌 조회 후 시장가 1주 매수 주문
cano = api.get_accounts()[0]["accountNo"]
order = api.create_order(cano, "AAPL", "BUY", "MARKET", 1)

Note

간편하게 사용하려면 TossSimpleOverseasStock 모듈의 TossSimpleOverseasStock 을 사용하세요. 계좌 연결, 인증 갱신 등 반복적인 처리를 자동으로 처리합니다.

생성자¶

TossOverseasStock(auth)

토스증권 해외(미국)주식 API

시세 조회¶

`get_prices`(symbols)	현재가 조회
`get_candles`(symbol[, interval, count, ...])	캔들(차트) 데이터 조회
`get_orderbook`(symbol)	호가 조회
`get_trades`(symbol)	최근 체결 내역 조회
`get_price_limits`(symbol)	상/하한가 조회
`get_exchange_rate`()	환율 조회

종목 정보 조회¶

`get_stocks`(symbols)	종목 기본 정보 조회
`get_stock_warnings`(symbol)	종목 투자유의(매수 주의) 정보 조회
`get_market_calendar`([country])	시장 운영 일정(개장 시간) 조회

계좌 조회¶

`get_accounts`()	계좌 목록 조회
`get_holdings`(cano)	보유 주식 조회
`get_buying_power`(cano[, currency])	매수 가능 금액 조회
`get_sellable_quantity`(cano, symbol)	매도 가능 수량 조회

주문¶

`create_order`(cano, symbol, side, order_type, ...)	주문 생성
`modify_order`(cano, order_id, order_type[, ...])	주문 정정
`cancel_order`(cano, order_id)	주문 취소
`get_orders`(cano[, params])	주문 내역 조회
`get_order`(cano, order_id)	주문 상세 조회
`get_commissions`(cano[, params])	거래 수수료 조회