KIWOOM REST API

AI Stocker

대시보드

자산/원금/수익

수익률 흐름

계좌별 현황

계좌 평가일 총자산 예수금 주식매입금 주식투자금 입금 원금 주식수익(평가손익) 실현 수익 기타 수익 수익률

계좌별/전체 수익률 비교

계좌 목적 자산비중 총자산 주식매입금 주식투자금 원금 주식수익(평가손익) 실현 수익 수익률 수익 기여도

보유종목 통합 분석

종목 코드 계좌수 보유 계좌 합산수량 평가금액 평가손익 수익률

AI 현황판

국내 누적 수급/시총 추정
실시간 요약

장중 1시간 간격으로 국내/미국 지수와 주요 이벤트 요약이 표시됩니다.

AI 현황판

국내 누적 수급/시총 추정
실시간 요약

장 시작부터 마감까지 1시간 간격으로 국내/미국 지수와 주요 이벤트를 AI가 정리합니다.

매매일지 실현손익

AI 주간 매매 요약

이번 주 매매 패턴과 개선점을 AI가 자동 정리합니다.

매매일지 등록

메신저 텍스트 등록

최근 매매일지

일자 계좌 종목 매수/매도 실현손익 수익률 전략/태그 복기 소스

계좌 별칭/목적

계좌 API 계좌명 별칭 목적 총자산 표시상태

원금 입출금 검증

계좌 목적 스냅샷 원금 입출금 합계 차이 자동/수동/미확인 상태 진단/권고

원금 입출금

최근 입출금

일자 계좌 분류 구분 금액 메모 소스

수동 스냅샷

키움 REST API

텔레그램/디스코드 알림

참조용 사이트

실전투자 계좌별 API Key

계좌 계좌명 API Key Secret

관리자 계정명

관리자 비밀번호

동기화 이력

시작 상태 구분 메시지

운영 상태

사용 매뉴얼

AI Stocker 현재 기능

상단 아이콘

  • ? : 이 매뉴얼을 엽니다.
  • ☾/☀ : 다크/라이트 테마를 전환합니다.
  • ↻ : 키움 REST API 동기화를 즉시 실행합니다. 수동 동기화는 장외에도 가능하며 백그라운드 자동 동기화만 장중에 실행됩니다.
  • 상단 상태 배지는 장중 동기화 가능 여부와 최근 완료 시각을 표시합니다.
  • ⚙ : 설정 화면으로 이동합니다.
  • ↩ : 로그아웃합니다.

대시보드

  • All, Day, Week, Month, Year 기간별 자산, 입금/뱅킹 원금, 평가손익, 실현 수익, 기타 수익, 기간 수익을 확인합니다.
  • Day, Week, Month는 숫자 입력으로 조회 기간을 조절합니다.
  • 자산/원금/수익 그래프의 범례를 누르면 해당 선이 강조됩니다.
  • AI 현황판에서 장중 실시간 국내/미국 지수 및 주요 이벤트 요약을 확인합니다.
  • 계좌 필터는 별칭 기준으로 표시되며 계좌번호는 노출하지 않습니다.
  • 그래프는 화면 크기 변경과 모바일 회전에 맞춰 다시 그려집니다.

매매일지

  • 수동 등록, 키움 실현손익 가져오기, 텔레그램/디스코드 메시지 등록을 지원합니다.
  • 매매일지 실현손익 요약과 그래프는 대시보드와 같은 키움 일자별 실현손익 기준으로 표시합니다.
  • 거래 건수, 승률, 매수/매도 금액은 매매일지에 등록된 항목 기준으로 표시합니다.
  • 메신저에서는 /trade 삼성전자 매수 이유... 형식으로 기록합니다.
  • 일일/주간 리포트와 수익률 그래프 이미지를 자동 발송할 수 있습니다.
  • AI 주간 매매 요약은 주간 패턴, 잘한 점, 개선점, 다음 주 체크리스트를 자동 정리합니다.

AI 현황판

  • 장 시작부터 마감까지 1시간 간격으로 KOSPI/KOSDAQ, NASDAQ, S&P 500, 미국 VIX, 미국 공포탐욕지수, 미국 10년물, USD/KRW와 보유종목 기준 AI 브리핑을 갱신합니다.
  • 실시간 요약은 국내/미국 지수, 매크로 지표, 최신 국내외 이벤트, 보유종목 뉴스 데이터를 가져와 생성합니다.
  • AI 답변에는 사용한 핵심 데이터와 근거 부족 항목을 함께 표시하며, 오래된 지수/뉴스는 판단 근거에서 제외합니다.
  • 브리핑은 핵심 데이터, 리스크, 대응 조건, 포트폴리오, StockScanner 참조 후보 5블록으로 압축해 표시합니다.
  • 최신 동기화 기준 현재 계좌의 현금, 주식, 펀드, 채권 비중을 원형 그래프와 범례로 표시합니다. ETF는 주식에 포함됩니다.
  • 국내 개인, 외국인, 기관의 누적 순매수 시총 대비 추정 추이와 외국인 실제 보유율을 AI 브리핑 근거에 포함합니다.
  • OpenAI, Google Gemini, Anthropic Claude 제공자와 모델을 선택할 수 있습니다.
  • 실시간 요약 생성 버튼으로 수동 갱신할 수 있습니다.
  • 설정 화면의 AI 연결 테스트로 저장 전 API Key와 모델 연결을 확인합니다.
  • AI API Key가 없으면 지수 데이터 기반 로컬 요약을 표시합니다.

계좌/원금

  • 계좌 관리에서 별칭과 목적을 저장하면 화면에는 별칭만 표시됩니다.
  • 원금/입출금 화면에서 키움 거래내역과 스냅샷 원금을 검증합니다.
  • 원금 검증 기준은 스냅샷 원금 = 자동 입출금 + 수동 입출금이며 미확인 거래는 합계에서 제외됩니다.
  • 입금/뱅킹 원금은 자동/수동 입출금과 원금 보정만 포함하며 실현손익과 배당/분배금은 원금과 분리합니다.
  • 평가손익은 현재 보유종목 평가 기준, 실현손익은 키움 일자별 실현손익 기준, 기타수익은 배당/분배금 기준으로 표시됩니다.
  • 최근 입출금은 최신순으로 표시되며 전체/입금/출금 필터를 사용할 수 있습니다.
  • 기간수익은 원금 변동을 제외한 기간 성과로 표시됩니다.

설정

  • 모의투자 API와 실전 계좌별 API Key/Secret을 암호화 저장합니다.
  • API Key, Secret, AI API Key, 봇 토큰, Webhook URL은 화면/API 응답/로그에 일부도 노출하지 않고 설정됨 상태만 표시합니다.
  • 계좌 입력값은 1234-5678 [중개형ISA]처럼 입력하면 계좌번호와 별칭으로 분리됩니다.
  • 텔레그램/디스코드 Webhook, 봇 토큰, 리포트 시간을 설정합니다.
  • AI API Key와 모델을 설정하면 매매일지 화면과 주간 리포트에서 AI 요약을 사용할 수 있습니다.

운영

  • 운영 메뉴에서 DB 상태, 현재 동기화 실행 여부, 최근 완료 동기화, 스케줄러, AI 설정 상태를 확인합니다.
  • 완료되지 않고 오래 남은 동기화 이력은 중단됨으로 표시됩니다.
  • DB 백업 버튼은 현재 SQLite DB의 일관된 백업 파일을 생성합니다. 백업 파일에도 암호화된 설정이 포함되므로 안전하게 보관하세요.
  • /api/health는 Docker healthcheck와 운영 모니터링에 사용할 수 있습니다.