매매 실행 후 근거·지표 스냅샷을 로컬 파일에 기록합니다. create_order 호출 후 반드시 호출해 AI 매매 이력을 남깁니다.

로컬에 저장된 AI 매매 이력을 조회합니다. 과거 매매 근거·지표 상태를 파악해 현재 전략 판단에 활용합니다.

환경변수 TOSSINVEST_API_KEY(client_id)와 TOSSINVEST_SECRET_KEY(client_secret)를 사용해 액세스 토큰을 재발급합니다. 별도 파라미터 없이 호출하면 됩니다.

종목의 매수/매도 호가 및 잔량을 조회합니다.

종목의 현재가를 조회합니다. 최대 200개 종목을 콤마로 구분하여 한 번에 조회 가능합니다.

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

종목의 당일 상한가 및 하한가를 조회합니다. 미국 주식은 가격제한이 없어 null로 반환됩니다.

종목의 캔들(OHLCV) 차트 데이터를 조회합니다. 1분봉(1m) 또는 일봉(1d)을 지원하며 최대 200개를 반환합니다.

종목의 RSI(상대강도지수)를 계산합니다. Wilder 평활법을 사용하며 과매수/과매도 구간, 시그널 라인(RSI의 EMA), 크로스오버 신호를 함께 반환합니다.

종목의 MACD(이동평균 수렴확산)를 계산합니다. MACD 라인, 시그널 라인, 히스토그램, 크로스오버 신호를 반환합니다.

종목의 볼린저 밴드를 계산합니다. 중간선(SMA), 상단·하단 밴드, %B(현재가 위치), 밴드폭을 반환합니다.

종목의 일목균형표를 계산합니다. 전환선·기준선·선행스팬1·2·후행스팬과 구름(kumo) 방향, 향후 displacement 기간의 구름 예측을 반환합니다.

종목의 ATR(평균 실제 범위)을 계산합니다. Wilder 평활법 사용. 변동성 측정으로 포지션 사이징과 스탑로스 거리 자동 설정에 활용됩니다.

종목의 ADX(평균 방향성 지수)를 계산합니다. ADX≥25이면 강한 추세, +DI>-DI이면 상승 추세. 추세/횡보 판별로 전략 전환에 활용됩니다.

종목의 Slow Stochastic을 계산합니다. %K, %D, 과매수(≥80)/과매도(≤20) 구간, 크로스오버 신호를 반환합니다.

종목의 OBV(누적 거래량)를 계산합니다. 시그널 라인(EMA of OBV)과 비교해 거래량 기반 추세 방향을 반환합니다.

종목의 거래량 이동평균을 계산합니다. 현재/평균 거래량 비율로 급등 거래량을 감지합니다.

종목의 Parabolic SAR를 계산합니다. 추세 방향·반전 신호·트레일링 스탑 기준선을 반환합니다.

종목의 주요 기술 지표를 한 번에 조회합니다. 현재가·RSI·MACD·볼린저밴드·ADX·ATR·스토캐스틱·EMA20/60·거래량MA와 종합 신호(signal score)를 반환합니다. AI 자동매매에서 분석 호출 횟수를 최소화하는 데 적합합니다.

ATR 기반 스탑로스 가격과 계좌 잔고 대비 적정 포지션 규모를 계산합니다. AI 자동매매에서 주문 전 리스크 관리용으로 호출합니다.

종목의 지수이동평균(EMA)을 계산합니다. 캔들 데이터를 기반으로 지정한 봉 단위·기간·계산 기준으로 EMA 시계열을 반환합니다.

종목의 기본 정보(종목명, 시장, 통화, 상장상태 등)를 조회합니다. 최대 200개를 콤마로 구분하여 한 번에 조회 가능합니다.

종목의 매수 유의사항(정리매매, 단기과열, 투자경고/위험, VI 발동, 신주인수권 등)을 조회합니다.

KRW↔USD 환율 정보를 조회합니다. 1분 주기로 갱신되는 참고용 표시 환율입니다.

국내 시장(KRX+NXT 통합 모드)의 장 운영 시간을 조회합니다. 전일/당일/익일 3영업일 정보를 반환합니다.

미국 시장의 장 운영 시간을 조회합니다. 데이마켓/프리마켓/정규장/애프터마켓 세션별로 반환하며 전일/당일/익일 3영업일 정보를 제공합니다.

사용자의 계좌 목록을 조회합니다. 응답의 accountSeq를 다른 계좌 관련 API의 account_seq 파라미터에 사용합니다.

계좌의 보유 주식 현황(수량, 매입가, 평가금액, 손익)을 조회합니다. 국내/미국 주식 모두 포함됩니다.

주문 목록을 조회합니다. OPEN(진행 중) 또는 CLOSED(종료됨)으로 필터링합니다.

특정 주문의 상세 정보를 조회합니다. 모든 상태의 주문을 조회할 수 있습니다.

매수 또는 매도 주문을 생성합니다. quantity(수량) 또는 order_amount(금액) 중 하나를 지정합니다. order_amount는 미국 주식 시장가 주문 전용입니다.

기존 주문의 가격 또는 수량을 정정합니다. 국내 주식은 가격+수량 정정 가능, 미국 주식은 가격만 정정 가능합니다.

기존 주문을 취소합니다. 이미 체결된 주문은 취소할 수 없습니다.

매수 주문 시 사용 가능한 현금 기반 매수 가능 금액을 조회합니다 (미수 미발생 기준).

특정 종목의 매도 가능 수량을 조회합니다.

현재 계좌의 시장별(국내/미국) 매매 수수료율을 조회합니다.