· 톺아보기

잡담

한투 API와 AI를 활용해서 주식 분석 대시보드를 만들어봤습니다.

blackice · · 수정

조회 2,633 · 공감 2 · 댓글 23

안녕하세요. 퀀트 분석에 관심이 많은 프리랜서 개발자입니다.


최근 한국투자증권에서 웹 기반 API 서비스를 오픈했길래, 평소 관심 있던 AI(Gemini)와 접목해서 개인적으로 사용하려고 퀀트 분석 및 투자 대시보드 툴을 개발해 보았습니다.


본업이 따로 있다 보니, 프로젝트 사이사이 쉬는 텀이나 주말을 이용해서 틈틈이 작업한 결과물인데요. 


저 혼자만 쓰기에는 조금 아까워서 혹시나 필요하신 분들이 있을까 싶어 공개하게 되었습니다.


[프로그램 사용을 위해 필요한 것]

  1. 한국투자증권 계좌 및 API 신청 (무료)
  2. 구글 Gemini API 키 (무료 티어로도 충분)


이 툴은 외부 서버에 접속하는 일반적인 웹사이트 형태가 아니라, 개인 PC(윈도우, 맥, 리눅스)에 직접 설치해서 구동하는 방식입니다. 개발자에겐 익숙한 도커(Docker) 기반 가상환경에서 작동합니다.


HTS를 켜지 않아도 웹에서 부드럽게 차트를 보고, AI가 복잡한 수급이나 뉴스를 분석해 종목의 핵심 호재와 악재를 브리핑해 주는 기능 등을 담았습니다.


자세한 스크린샷과 기능 설명, 그리고 설치 방법은 첨부된 소개페이지(https://www.kstock.live)를 통해 확인하실 수 있습니다.


모두 성투하시길 기원합니다! 




출처 : https://www.kstock.live/

댓글 23

  1. 반지하제왕 ·
    제미나이 무료티어는 3개월 있다가 유료로전환되지않나요 첫 3개월동안 300달러 무료 충전해주고
  2. blackice ·
    댓글 이미지
    @반지하제왕님 무료등급이 있는데, 요걸로 충분합니다.
  3. gift ·
    감사합니다. 사용해 볼께요 ^^
  4. MDEASY ·
    P.S 게시물 관련 쪽지 확인 바랍니다.
  5. schaft ·
    한번 해봤는데 도커 설치하고 localhost 불러오는 것까지는 성공했습니다만 계좌입력하고 APP KEY, APP Secret 입력을 해도 확인버튼이 안먹네요. 윈도11 사용중입니다.
  6. blackice ·
    댓글 이미지
    @schaft님 제미나이 키를 발급받고 입력해야 확인버튼이 활성화 됩니다. 혹시, 안되시면 다시 글 남겨주시면 틈틈히 확인해서 답변 드릴께요 ^^
  7. schaft ·
    @blackice님
    제미나이 키도 입력을 했었습니다. 확인버튼도 활성화됩니다만 눌러보면 '계좌번호가 올바르지 않거나 실전/모의투자를 잘못 선택하셨습니다' 라고 나옵니다.
    API서비스 신청을 할 때 계좌번호는 뒤에 01이 붙지 않는데 여기서는 -01을 붙이지 않으면 입력이 안되도록 되어 있는데 이 차이가 아닐지 모르겠네요.
  8. blackice ·
    댓글 이미지
    @schaft님 아마 신규 계좌 잔고가 0원인 경우, 버그가 있었던 것 같습니다. 우측 상단의 '설정' 아이콘 버튼 누르시고 '시스템 정보' 탭으로 가셔서 업데이트 한번 부탁드립니다.

    참고로, 한투 앱에서 상단 MY 메뉴에서 전체 계좌번호 확인 가능합니다. (-01, -22 등)

    혹시, 계속 안되시면 uninstall.bat 실행 후, 다시 install.bat 실행 부탁드립니다.
  9. schaft ·
    @blackice님
    아.. 잔고 0원인게 문제였나 봅니다. 업데이트하고 나서 해결되었습니다.
    잘 써보겠습니다!
  10. blackice ·
    @schaft님 설치가 잘되어 다행이네요. 피드백 해주신 덕분에 심각한 버그를 수정할 수 있었네요. 감사드립니다.

    참고로, 한투에서는 api 신규 발급 시, 3일간 유량 조절으로 웹소켓을 계좌당 3개로 제한해서 일반 종목 1, etf 1개만 실시간 가격 정보 수신이 가능합니다. (3일 이후에는 계좌당 41개로 제한이 해제됩니다.)

    사용하시면서 버그나 개선 사항 있으시면 댓글이나
    https://github.com/kndoll/kstock.live.release/issues 에 이슈 등록해주시면 반영해보도록 하겠습니다.
  11. 바다 ·
    설치했는데, 잘 작동되네요. 감사합니다. 잘 사용하겠습니다.
  12. BSTBTSBTSBST ·
    운분투 서버에 설치했습니다.
    24시간 아주 잘 돌아가네요. 첫번째 업데이트까지 수행 했습니다.
    감사 드립니다.
  13. blackice ·
    @BSTBTSBTSBST님 개인 서버에 설치하면 외부 환경 특히, 방화벽이 있는 회사에서 틈틈히 시세 확인하기 좋습니다. ^^

    사용하시다가 버그나 개선 사항 있으시면 댓글 부탁드립니다.
  14. BSTBTSBTSBST ·
    AI 분석 대기 중...
    기술적 인디케이터 산출을 완료하고 리포트를 생성하고 있습니다.

    계속 이 상태네요! 처음엔 잘 됐었는데...
    아! 그리고 메뉴 통한 업데이트가 안돼서, 터미널에서 업데이트 했습니다. v1.1.4
  15. blackice ·
    @BSTBTSBTSBST님 혹시, 수동으로 업데이트 하셨다면 3개의 이미지를 모두 업데이트 하셨나요?

    kndoll/kstock-frontend
    kndoll/kstock-worker
    kndoll/kstock-server

    위 이미지 모두 받으셨다면, 설치 디렉토리에서 컨테이너 재기동 하셔야 합니다.

    1. docker-compose -f docker-compose.release.yml down
    2. docker-compose -f docker-compose.release.yml up -d

    만약 위 조치로 안되시면 uninstall -> install 한번 부탁드립니다.

    그리고 혹시, 지금 위 오류가 신규 상장된 특정 종목에서 나오는지요?
  16. BSTBTSBTSBST ·
    @blackice님
    테스트를 위해 '삼성전자(005930)'나 '현대차(005380)'처럼 데이터가 아주 빵빵한 대형 우량주로 AI 분석을 시도해 봤습니다.

    제가 포트를 8899로 바꿨는데, 영향도 있나요?

    ====> 클린 재설치했습니다. (단, 제 사정상 포트는 8899)
    계좌검증 서버 연결에 실패했습니다. 가 뜨네요.
    한투 서버의 야간배치작업이나, 서버점검시간이길 기대하며 나중에 재시도해 봅니다.
  17. blackice ·
    @BSTBTSBTSBST님 위 오류는 한투 서버의 문제가 아니라 포트 변경으로 프론트엔드와 통신이 실패하여 발생하는 증상입니다. (계좌 정보를 주기적으로 확인하기 때문에 계속 오류 알람이 뜹니다.)

    혹시, 포트는 어떻게 수정하셨나요?
  18. BSTBTSBTSBST ·
    @blackice님
    방금 수정해서 성공했습니다.
    제가 이미 포트를 쓰고 있어서...
    Nginx Proxy Manager 에서 NPM 우회해서 겨우 해결했네요. ㅡ,.ㅡ
    (시스템 업데이트 뜨면, 저같은 경우는 수동으로 해야 하지요?)
  19. blackice ·
    @BSTBTSBTSBST님 시스템에서 업데이트 하셔도 무방할 것 같습니다. (기존 컨테이너의 설정은 그대로 사용합니다.)

    혹시, 다른 문제 있으시면 댓글 부탁드립니다.
  20. BSTBTSBTSBST ·
    @blackice님
    시스템에서 하면 업데이트가 끝나질 않아서요
  21. blackice ·
    @BSTBTSBTSBST님 네, 도커 컨테이너가 교체되면서 내부의 ip가 변경되는데 NPM이 기존 ip를 캐싱하고 있으면 위와 같은 문제가 발생할 것 같습니다.

    아마 수동으로 업데이트 하셔야 할 것 같네요.. 또는 어느정도 시간이 지난 후에 브라우저를 리로딩해도 업데이트는 적용될것 같네요..
  22. BSTBTSBTSBST · · 공감 1
    댓글 이미지
    며칠 사용해 보고 있는데, 굉장히 짜임새 있고 완성도 있습니다.
    개발자님의 공개 결정에 경의를 표합니다.
    물론, AI의 추천점수 기준 등은 소스없이 알 수 없지만, 제 자동매매 로직에 붙여서 테스트 사용해 보고자 합니다.
    - AI추천점수가 장중 stable 한 것 같아서 , 제 나름 실시간 가점해서 동적점수로 변환해서 매매에 붙입니다.
    단, 종목 추천은 한투의 브로킹 때문인지, 전종목 스캔시에는 결과가 없고 섹터별 업종별로는 잘 되네요.
    : 전직 30년전 한투 업무개발팀장 올림. (코딩은 모르고 주식만 아는 문과 무지랭이입니다)
  23. blackice ·
    @BSTBTSBTSBST님

    종목 추천의 경우 어제 업데이트를 통해, 아래와 같이 작동합니다.

    1. 모의 계좌는 재무 정보를 지원하지 않기 때문에, 종목 추천을 사용할 수 없습니다.
    2. 다만, 실전 계좌로 추천 받은 테마나 섹터는 캐싱하여 모의 계좌에서도 이를 활용하여 추천을 받을 수 있습니다.(30일 유효)

    * 모의 계좌는 api 호출 유량 제한이 심해 가능한 실전 계좌로 사용하시길 권장 드립니다.

    피드백이 매우 전문적이라고 생각했는데, 한투 업무개발팀장님 경력을 가지고 계셨군요... 소중한 의견 정말 감사드립니다.

    앞으로도 기능 개선과 관련한 쪽지 주시면 적극 반영하도록 하겠습니다.

    감사합니다.

    ps. 후원(응원) 잘 받았습니다. 앱 개선에 소중하게 사용하겠습니다.

주식한당 최근 글

주식한당 목록 더 보기