| toss_get_orderbookA | 특정 종목의 현재 호가(매수/매도 잔량) 정보를 조회합니다. Args: Returns: timestamp: 호가 기준 시간 (ISO 8601) currency: 통화 코드 (KRW/USD) asks[]: 매도 호가 목록 (price, volume) bids[]: 매수 호가 목록 (price, volume)
예시: 삼성전자(005930) 호가 조회, 애플(AAPL) 호가 조회 |
| toss_get_pricesA | 여러 종목의 현재가를 한번에 조회합니다. 최대 200개 심볼 지원. Args: symbols (string, 필수): 콤마로 구분된 종목 심볼 목록 (최대 200개). 예: "005930,000660" 또는 "AAPL,TSLA,NVDA"
Returns:
각 종목별 배열: symbol: 종목 심볼 timestamp: 기준 시간 (ISO 8601) lastPrice: 현재가 (decimal string) currency: 통화 코드 (KRW/USD)
|
| toss_get_tradesA | 특정 종목의 최근 체결 내역을 조회합니다. Args: symbol (string, 필수): 종목 심볼. KRX: 6자리 숫자, US: 영문 티커 count (number, 선택): 조회 건수. 기본값 50, 최대 50
Returns:
각 체결 내역: price: 체결 가격 (decimal string) volume: 체결 수량 (decimal string) timestamp: 체결 시간 (ISO 8601) currency: 통화 코드 (KRW/USD)
|
| toss_get_price_limitsA | 특정 종목의 상한가/하한가를 조회합니다. (국내 KRX 종목에 적용) Args: Returns: timestamp: 기준 시간 (ISO 8601) upperLimitPrice: 상한가 (decimal string) lowerLimitPrice: 하한가 (decimal string) currency: 통화 코드
|
| toss_get_candlesA | 특정 종목의 캔들 차트 데이터를 조회합니다. Args: symbol (string, 필수): 종목 심볼. KRX: 6자리 숫자, US: 영문 티커 interval (string, 필수): 캔들 간격. "1m" (1분봉) 또는 "1d" (일봉) count (number, 선택): 조회 건수. 기본값 100, 최대 200 before (string, 선택): 페이지네이션 상한 (ISO 8601). 이 시간 이전 캔들을 반환 adjusted (boolean, 선택): 수정주가 적용 여부. 기본값 true
Returns: candles[]: 캔들 목록 (timestamp, openPrice, highPrice, lowPrice, closePrice, volume, currency) nextBefore: 다음 페이지 조회용 cursor (더 이전 데이터가 없으면 null)
|
| toss_get_stocksA | 여러 종목의 기본 정보를 조회합니다. 최대 200개 심볼 지원. Args: Returns:
각 종목별: symbol: 종목 심볼 name: 종목명 (한글) englishName: 종목명 (영문) isinCode: ISIN 코드 market: 시장 (KOSPI, KOSDAQ, NASDAQ 등) securityType: 증권 유형 isCommonShare: 보통주 여부 status: 거래 상태 currency: 통화 코드 (KRW/USD) listDate: 상장일 delistDate: 상장폐지일 (null이면 상장 중) sharesOutstanding: 발행주식수 leverageFactor: 레버리지 배수 (null이면 일반주) koreanMarketDetail: 국내 주식 추가 정보 (null이면 해외주)
|
| toss_get_stock_warningsA | 특정 종목의 투자 유의사항 및 경고 정보를 조회합니다. Args: Returns:
경고 목록 (없으면 빈 배열): |
| toss_get_exchange_rateA | KRW ↔ USD 환율 정보를 조회합니다. Args: baseCurrency (string, 필수): 기준 통화. "KRW" 또는 "USD" quoteCurrency (string, 필수): 상대 통화. "KRW" 또는 "USD" (baseCurrency와 달라야 함) dateTime (string, 선택): 조회 기준 시간 (ISO 8601). 생략 시 현재 시간 기준
Returns: baseCurrency: 기준 통화 quoteCurrency: 상대 통화 rate: 환율 midRate: 중간 환율 basisPoint: 환율 변동 basis point rateChangeType: 변동 유형 validFrom: 유효 시작 시간 (ISO 8601) validUntil: 유효 종료 시간 (ISO 8601)
|
| toss_get_kr_market_calendarA | 국내(KRX) 주식 시장의 장 운영 시간 정보를 조회합니다.
특정 날짜의 프리마켓/정규장/애프터마켓 시간과 전/다음 영업일 정보를 반환합니다. Args: Returns: today.date: 기준 날짜 today.integrated: 통합장 시간 (preMarket, regularMarket, afterMarket) previousBusinessDay: 전 영업일 정보 nextBusinessDay: 다음 영업일 정보
|
| toss_get_us_market_calendarA | 미국 주식 시장의 장 운영 시간 정보를 조회합니다.
특정 날짜의 프리마켓/정규장/애프터마켓 시간과 전/다음 영업일 정보를 반환합니다. Args: Returns: today.date: 기준 날짜 (미국 현지) today.dayMarket: 데이마켓 시간 today.preMarket: 프리마켓 시간 (null이면 미운영) today.regularMarket: 정규장 시간 (null이면 휴장) today.afterMarket: 애프터마켓 시간 (null이면 미운영) previousBusinessDay: 전 영업일 정보 nextBusinessDay: 다음 영업일 정보
|
| toss_get_accountsA | 토스증권 계좌 목록을 조회합니다.
반환된 accountSeq 값은 계좌/자산/주문 관련 API 호출 시 필요합니다. Returns:
배열: |
| toss_get_holdingsA | 특정 계좌의 보유 주식 현황을 조회합니다.
계좌 시퀀스(accountSeq)는 toss_get_accounts로 조회할 수 있습니다. Args: accountSeq (number, 필수): 계좌 시퀀스. toss_get_accounts 응답의 accountSeq 값 symbol (string, 선택): 종목 심볼 필터. 특정 종목만 조회 시 사용
Returns: totalPurchaseAmount: 총 매수 금액 (krw, usd) marketValue: 평가 금액 (amount, amountAfterCost - 수수료 차감) profitLoss: 평가 손익 (amount, amountAfterCost, rate, rateAfterCost) dailyProfitLoss: 일간 손익 (amount, rate) items[]: 보유 종목 목록 symbol, name, marketCountry, currency quantity: 보유 수량 lastPrice: 현재가 averagePurchasePrice: 평균 매수가 marketValue: 평가 금액 profitLoss: 손익 dailyProfitLoss: 일간 손익 cost: 수수료/세금 정보
|
| toss_get_buying_powerA | 특정 계좌의 매수 가능 금액(현금 기준)을 조회합니다. Args: accountSeq (number, 필수): 계좌 시퀀스. toss_get_accounts 응답의 accountSeq 값 currency (string, 필수): 통화 코드. "KRW" (국내 주식 매수 가능 금액) 또는 "USD" (해외 주식 매수 가능 금액)
Returns: |
| toss_get_sellable_quantityA | 특정 계좌에서 특정 종목의 판매 가능 수량을 조회합니다. Args: accountSeq (number, 필수): 계좌 시퀀스. toss_get_accounts 응답의 accountSeq 값 symbol (string, 필수): 종목 심볼. KRX: 6자리 숫자 (예: 005930), US: 영문 티커 (예: AAPL)
Returns: |
| toss_get_commissionsA | 특정 계좌의 매매 수수료 정보를 조회합니다. Args: Returns:
수수료 정보 (API 응답 그대로 반환) |
| toss_get_ordersA | 특정 계좌의 주문 목록을 조회합니다. Args: accountSeq (number, 필수): 계좌 시퀀스. toss_get_accounts 응답의 accountSeq 값 status (string, 필수): 주문 상태 필터. "OPEN": 미체결 주문 (PENDING, PARTIAL_FILLED, PENDING_CANCEL, PENDING_REPLACE) "CLOSED": 체결/취소/거부된 주문 (FILLED, CANCELED, REJECTED, REPLACED 등)
symbol (string, 선택): 종목 심볼 필터 from (string, 선택): 조회 시작일 (YYYY-MM-DD). 주문 생성 시간 기준 to (string, 선택): 조회 종료일 (YYYY-MM-DD) cursor (string, 선택): 페이지네이션 cursor. 이전 응답의 nextCursor 값 (CLOSED만) limit (number, 선택): 조회 건수. 기본값 20, 최대 100 (CLOSED만)
Returns: |
| toss_get_orderA | 특정 주문의 상세 정보를 조회합니다. Args: accountSeq (number, 필수): 계좌 시퀀스. toss_get_accounts 응답의 accountSeq 값 orderId (string, 필수): 주문 식별자. toss_create_order 또는 toss_get_orders 응답의 orderId 값
Returns: orderId, symbol, side (BUY/SELL), orderType (LIMIT/MARKET) timeInForce, status, price, quantity, orderAmount, currency orderedAt, canceledAt execution: 체결 정보 (filledQuantity, averageFilledPrice, filledAmount, commission, tax, filledAt, settlementDate)
|
| toss_create_orderA | ⚠️ 경고: 이 도구는 실제 주식 주문을 생성합니다. 실제 자금이 사용됩니다. 주문을 생성합니다. 수량 기반 또는 금액 기반(US 시장가 매수만) 주문을 지원합니다. Args: accountSeq (number, 필수): 계좌 시퀀스. toss_get_accounts 응답의 accountSeq 값 symbol (string, 필수): 종목 심볼. KRX: 6자리 숫자 (예: 005930), US: 영문 티커 (예: AAPL) side (string, 필수): 주문 방향. "BUY" (매수) 또는 "SELL" (매도) orderType (string, 필수): 호가 유형. "LIMIT" (지정가) 또는 "MARKET" (시장가) quantity (string, 선택): 주문 수량. quantity 또는 orderAmount 중 하나 필수 orderAmount (string, 선택): 주문 금액 (USD). US 시장가 매수(MARKET BUY)만 사용 가능 (예: "100.5") price (string, 선택): 주문 가격. orderType=LIMIT일 때 필수 KR: 정수 원화 (예: "70000") US: 소수점 달러 (예: "185.50")
timeInForce (string, 선택): 주문 유효 조건. "DAY" (기본, 당일 유효) 또는 "CLS" (장마감, US LIMIT만) clientOrderId (string, 선택): 클라이언트 주문 ID. 최대 36자, 영숫자/-/_. 멱등성 키로 사용 (10분간 유효) confirmHighValueOrder (boolean, 선택): 고액 주문 확인 플래그. 1억원 이상 주문 시 true 필수
Returns: |
| toss_modify_orderA | ⚠️ 경고: 이 도구는 실제 주식 주문을 정정합니다. 미체결(PENDING/PARTIAL_FILLED) 상태의 주문을 정정합니다.
KR 주식: 수량과 가격 변경 가능. US 주식: 가격만 변경 가능 (수량 변경 불가). Args: accountSeq (number, 필수): 계좌 시퀀스 orderId (string, 필수): 정정할 주문의 orderId orderType (string, 필수): 변경할 호가 유형. "LIMIT" 또는 "MARKET" quantity (string, 선택): 변경할 수량. KR 주식 필수, US 주식 불가 (양의 정수만) price (string, 선택): 변경할 가격. orderType=LIMIT일 때 필수 confirmHighValueOrder (boolean, 선택): 고액 주문 확인 플래그. 1억원 이상 시 true 필수
Returns: |
| toss_cancel_orderA | ⚠️ 경고: 이 도구는 실제 주식 주문을 취소합니다. 미체결(PENDING/PARTIAL_FILLED) 상태의 주문을 취소합니다. Args: accountSeq (number, 필수): 계좌 시퀀스 orderId (string, 필수): 취소할 주문의 orderId
Returns: |
