종목명이나 티커로 종목 심볼을 찾는다.

시세 조회 도구는 모두 심볼을 요구하므로, 사용자가 종목명으로 물으면 먼저 이 도구를 쓴다. 예: "삼성전자" -> 005930, "apple" -> AAPL.

결과가 여러 개면 어느 종목인지 사용자에게 되묻는다.

Args: query: 종목명, 영문명, 또는 심볼. 부분 일치도 동작한다. market: 특정 시장으로 제한 (KOSPI, KOSDAQ, NASDAQ, NYSE, AMEX). limit: 최대 결과 수 (기본 10).

종목 목록 캐시를 즉시 갱신한다.

신규 상장 종목이 검색되지 않을 때 사용한다. 평소에는 자동으로 갱신되므로 부를 필요가 없다.

종목의 현재가를 조회한다. 최대 200종목을 한 번에 조회할 수 있다.

응답에는 종목명이 함께 담긴다. 사용자가 종목명으로 물었다면 반환된 이름이 의도한 종목과 맞는지 확인한다.

Args: symbols: 종목 심볼. 콤마로 구분 (예: "005930,000660" 또는 "AAPL"). include_change: True면 전일 종가 대비 등락액·등락률을 함께 계산한다. 종목마다 일봉을 추가 조회하므로 종목이 많으면 느려진다. 사용자가 등락/변동을 물었을 때만 켠다.

종목의 매수/매도 호가와 잔량을 조회한다.

Args: symbol: 종목 심볼 (KRX는 6자리 숫자, 미국은 티커).

종목의 당일 최근 체결 내역을 조회한다.

Args: symbol: 종목 심볼. count: 조회 건수 (1~50, 기본 20).

종목의 당일 상한가·하한가를 조회한다.

미국 주식처럼 가격제한이 없는 시장은 null이 반환된다.

Args: symbol: 종목 심볼.

종목의 캔들(OHLCV) 차트 데이터를 조회한다.

Args: symbol: 종목 심볼. interval: 봉 단위. "1m"(1분봉) 또는 "1d"(일봉). count: 조회 봉 수 (1~200, 기본 30). before: 페이지네이션 상한 (ISO 8601). 이전 응답의 nextBefore를 그대로 전달한다. adjusted: 수정주가 적용 여부 (기본 True).

종목의 기본 정보를 조회한다 — 종목명, 상장 시장, 통화, 상장 상태, 발행주식수.

Args: symbols: 종목 심볼. 콤마로 구분, 최대 200개.

종목의 매수 유의사항을 조회한다.

정리매매, 단기과열, 투자경고/위험 지정, VI 발동, 신주인수권 여부를 확인한다. 매수를 검토하는 종목이라면 확인할 가치가 있다.

Args: symbol: 종목 심볼.

KRW-USD 환율을 조회한다.

1분마다 갱신되는 참고용 표시 환율이다. 실제 거래 환율과는 다를 수 있다.

Args: base: 기준 통화 (KRW 또는 USD, 기본 USD). quote: 표시 통화 (KRW 또는 USD, 기본 KRW). 1 base = ? quote. date_time: 특정 시점의 환율 (ISO 8601). 생략하면 현재 유효 환율.

국내 또는 미국 시장의 장 운영 시간을 조회한다.

지금 장이 열려 있는지 확인할 때 쓴다. 전일·당일·익일 3영업일 정보를 반환하며, 모든 시각은 KST(+09:00) 기준이다. 휴장일은 세션이 비어 있다.

Args: country: "KR"(국내) 또는 "US"(미국). date: 조회 기준일 (YYYY-MM-DD). 생략하면 오늘.

주식 랭킹을 조회한다 — 급상승·급하락·거래대금/거래량 상위.

"오늘 많이 오른 종목", "거래량 터진 종목" 같은 질문에 쓴다.

Args: type: 랭킹 기준. TOP_GAINERS(급상승), TOP_LOSERS(급하락), MARKET_TRADING_AMOUNT(시장 거래대금 상위), MARKET_TRADING_VOLUME(시장 거래량 상위), TOSS_SECURITIES_TRADING_AMOUNT, TOSS_SECURITIES_TRADING_VOLUME. market_country: "KR"(국내) 또는 "US"(미국). duration: 산정 기간. realtime, 1d, 1w, 1mo, 3mo, 6mo, 1y. TOP_GAINERS/TOP_LOSERS는 realtime을 지원하지 않는다. count: 조회 수 (1~100, 기본 20). 크게 잡을수록 응답이 길어진다. exclude_investment_caution: 투자 유의 종목 제외 여부.

국내 지수와 국채 금리의 현재가를 조회한다.

"코스피 지금 얼마야", "국고채 10년 금리" 같은 질문에 쓴다. 개별 종목 시세는 이 도구가 아니라 get_price를 사용한다.

Args: symbols: 콤마로 구분. 지원 심볼은 다음 8종뿐이다 — KOSPI, KOSDAQ, KR_BOND_2Y, KR_BOND_3Y, KR_BOND_5Y, KR_BOND_10Y, KR_BOND_20Y, KR_BOND_30Y.