알파스퀘어 같은 주식 대시보드 만들기: 한국투자증권 API와 Lightweight Charts

핵심 요약

1. 관심종목·차트·재무·뉴스·모의투자를 연결해 투자정보를 여러 화면에서 찾는 수고를 줄입니다. 2. 한국투자증권 Open API와 OpenDART로 자료를 연결하고, Lightweight Charts·TA-Lib·Claude API로 표시·계산·요약을 구현합니다. 3. 종목 연결, 조건식 평가, 근거 관리, 가상계좌와 모의체결은 서비스 목적에 맞게 자체 개발합니다.

주식 관심종목 관리와 차트를 연결합니다

알파스퀘어의 핵심 가치는 차트·조건검색·기업정보·뉴스와 테마·모의투자를 한 화면에서 확인하는 데 있습니다. 이런 주식 분석 서비스 개발을 위해 국내주식 중심의 구현안을 살펴봅니다. 아래 기술은 유사 기능을 만드는 대안이며 알파스퀘어의 내부 스택을 뜻하지 않습니다. 주식 대시보드는 시세·차트·관심종목을 같은 종목 기준으로 연결해 구성합니다.

사용자가 관심종목과 조회 기간을 입력하면 한국투자증권 Open API에서 시세를 받아옵니다. 자체 로직은 종목 코드와 시간을 맞추고 조회값과 실시간 갱신값을 연결합니다. 브라우저 차트 라이브러리인 Lightweight Charts에 캔들 데이터를 전달하면 관심목록과 차트를 함께 보여줄 수 있습니다.

한국투자증권 API 차트 연동에서는 데이터를 공급하는 API와 그리는 도구를 분리합니다. TradingView 위젯은 외부 시세를 주입할 수 없어 이 연결 방식의 대체재가 아닙니다. Lightweight Charts 5.2 문서의 출처 표시 요구를 반영하고, AI 코딩 보조 스킬은 개발 지원에만 활용합니다. 시장별 데이터 표시·재배포 권한과 모의·실전 계정의 이용 범위도 확인해야 합니다.

TA-Lib 기술지표 계산으로 신호를 만듭니다

입력은 종목별 시가·고가·저가·종가·거래량과 지표의 계산 기간입니다. 오픈소스 라이브러리 TA-Lib은 가격 흐름을 수치화하는 RSI·MACD 등의 기술지표를 계산합니다. 자체 규칙이 지표의 기준값 통과나 교차를 판별하면 차트 위 신호와 발생 시점을 출력할 수 있습니다.

계산 전에 조정주가 적용 여부와 거래 세션을 통일해야 합니다. 진행 중인 봉과 거래가 끝나 값이 확정된 봉을 구별하고, 신호 계산에 어떤 봉을 쓰는지 정합니다. 기술지표는 정해진 계산식의 결과이므로 미래 가격을 예측하는 AI로 설명하지 않습니다.

OpenDART로 기업 재무제표 비교를 구현합니다

사용자가 기업과 보고 기간을 선택하면 OpenDART 재무정보 API로 공시 재무 계정과 지표를 받습니다. 한국투자증권 Open API는 상장종목 가격을 연결하는 역할을 맡습니다. 자체 로직에서 공시 기업 고유번호와 종목 코드를 연결하고 계정·단위·기간을 맞추면 기업별 비교표를 만들 수 있습니다.

연결재무제표와 별도재무제표를 섞지 않고 정정공시에 따른 수치 변경을 반영합니다. 결과에는 보고 기간과 공시 기준을 함께 표시해 비교의 근거를 남깁니다. OpenDART의 제공 범위는 국내 공시 대상 기업의 자료이며, 모든 비상장·해외기업이나 현재 시장 컨센서스를 포괄하지 않습니다.

주식 조건검색 설정을 자체 편집기로 만듭니다

사용자가 시장·업종·재무·기술 조건과 모두 충족(AND)·하나 이상 충족(OR) 조합을 입력하도록 설계합니다. 시세 API와 OpenDART가 자료를 공급하고 TA-Lib이 지표를 계산하면, 자체 필터가 조건을 평가합니다. 출력에는 일치 종목과 충족한 조건, 계산 기준 시점을 표시하고 조건 저장 기능을 붙입니다.

한국투자증권의 조건검색 API를 연결하는 방법도 있습니다. 다만 HTS에 등록하고 서버에 저장한 조건을 사용자 HTS ID와 조건 키값으로 조회하며, 공식 예제상 조건당 결과는 100건으로 제한됩니다. 자유로운 조건 편집기를 만들려면 조건 저장·계산·결과 관리 로직이 별도로 필요합니다. 알파스퀘어의 종목필터는 공식 가이드상 PC 전용이므로 모바일 필터는 제작 범위로 따로 정합니다.

주식 뉴스 AI 요약 개발은 근거를 연결합니다

입력은 관심종목·검색어·조회 기간입니다. 네이버 뉴스 검색 API는 기사 제목·요약문·링크·게시시각을, OpenDART는 관련 공시를 찾는 자료를 제공합니다. 자체 로직에서 기업명·종목 코드 대응표로 기사를 연결하고 중복 결과를 제거합니다.

Claude API는 이용 가능한 문서를 입력받아 요약과 테마 분류를 돕는 AI API로 배치합니다. 주식 뉴스 테마 분석 결과에는 관련 종목, 분류 이유, 문서 근거와 날짜를 표시합니다. 네이버 검색 결과는 기사 전문 제공과 구별하며, 전문이 필요하면 이용 권한을 확보한 자료를 별도로 연결합니다.

근거 인용 응답과 데이터 교환 형식인 JSON의 엄격한 구조화 출력은 별도 요청으로 설계합니다. 자체 로직에서 인용 문서와 출력 항목의 연결을 관리하고 수치와 날짜를 원자료와 대조합니다. 인용이 있다는 이유만으로 사실 검증까지 완료되는 것은 아닙니다.

모의투자 앱 만들기: 체결과 매매 기록을 설계합니다

사용자가 가상 주문의 종목·가격·수량을 입력하면 시세와 거래량을 받아 자체 모의체결 로직에 전달합니다. 가상 잔고, 주문 상태, 부분 체결, 수수료를 관리하고 보유현황·체결내역·주식 매매일지를 출력합니다. 여러 사용자의 계좌와 기록을 구분해 저장하는 기능도 서비스에서 개발합니다.

Backtrader는 과거 데이터와 전략을 넣어 주문·포지션을 시뮬레이션하는 백테스트 도구로 활용합니다. 실시간 가상계좌 운영과 역할을 나누고, 수수료와 예상 가격·체결 가격의 차이인 슬리피지를 반영합니다. 당시 알 수 있었던 정보만 사용하고 상장폐지·주식분할도 고려합니다. 과거 결과가 미래 수익을 보장하지는 않습니다.

국내주식부터 대상 시장과 데이터 이용 범위를 정하면 필요한 연동을 구체화할 수 있습니다. 해외주식·가상화폐로 확장할 때는 별도 데이터 공급과 권한을 설계합니다.

필요한 화면과 기능, 보유한 입력 자료, 연결할 업무를 정리해 트램스 AI에 제작을 문의해 주세요. https://trams.co.kr/ai-si/contact/#inquiry