pyqqq.brokerage.toss.overseas_stock
===================================

.. currentmodule:: pyqqq.brokerage.toss.overseas_stock

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

.. admonition:: 사용 예시
   :class: tip

   .. code-block:: python

      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::

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

생성자
~~~~~~

.. autosummary::
   :toctree: _gen/overseas_stock/

   TossOverseasStock

시세 조회
~~~~~~~~~

.. autosummary::
   :toctree: _gen/overseas_stock/

   ~TossOverseasStock.get_prices
   ~TossOverseasStock.get_candles
   ~TossOverseasStock.get_orderbook
   ~TossOverseasStock.get_trades
   ~TossOverseasStock.get_price_limits
   ~TossOverseasStock.get_exchange_rate

종목 정보 조회
~~~~~~~~~~~~~~

.. autosummary::
   :toctree: _gen/overseas_stock/

   ~TossOverseasStock.get_stocks
   ~TossOverseasStock.get_stock_warnings
   ~TossOverseasStock.get_market_calendar

계좌 조회
~~~~~~~~~

.. autosummary::
   :toctree: _gen/overseas_stock/

   ~TossOverseasStock.get_accounts
   ~TossOverseasStock.get_holdings
   ~TossOverseasStock.get_buying_power
   ~TossOverseasStock.get_sellable_quantity

주문
~~~~

.. autosummary::
   :toctree: _gen/overseas_stock/

   ~TossOverseasStock.create_order
   ~TossOverseasStock.modify_order
   ~TossOverseasStock.cancel_order
   ~TossOverseasStock.get_orders
   ~TossOverseasStock.get_order
   ~TossOverseasStock.get_commissions