pyqqq.brokerage.toss.domestic_stock
===================================

.. currentmodule:: pyqqq.brokerage.toss.domestic_stock

토스증권 국내주식 API 모듈입니다. 시세 조회, 주문 실행, 계좌 조회 기능을 제공합니다.
토스증권 Open API는 국내주식만 지원하며, 해외주식 주문/보유 내역은 조회 결과에서 제외됩니다.

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

   .. code-block:: python

      from pyqqq.brokerage.toss.oauth import TossAuth
      from pyqqq.brokerage.toss.domestic_stock import TossDomesticStock
      import os

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

      # 삼성전자 현재가 조회
      prices = api.get_prices("005930")

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

.. note::

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

생성자
~~~~~~

.. autosummary::
   :toctree: _gen/domestic_stock/

   TossDomesticStock

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

.. autosummary::
   :toctree: _gen/domestic_stock/

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

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

.. autosummary::
   :toctree: _gen/domestic_stock/

   ~TossDomesticStock.get_stocks
   ~TossDomesticStock.get_stock_warnings
   ~TossDomesticStock.get_market_calendar

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

.. autosummary::
   :toctree: _gen/domestic_stock/

   ~TossDomesticStock.get_accounts
   ~TossDomesticStock.get_holdings
   ~TossDomesticStock.get_buying_power
   ~TossDomesticStock.get_sellable_quantity

주문
~~~~

.. autosummary::
   :toctree: _gen/domestic_stock/

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