pyqqq.brokerage.toss.domestic_stock¶

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

사용 예시

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

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

생성자¶

TossDomesticStock(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])	거래 수수료 조회