핀트 같은 AI 자산관리 앱 제작: 한국투자증권 API와 PyPortfolioOpt

핵심 요약

1. 성향 분석부터 자산배분·리밸런싱·내역 확인까지 연결해 투자 관리 부담을 줄이는 앱을 만듭니다. 2. 한국투자증권 Open API는 데이터·거래 연결, PyPortfolioOpt는 비중 계산, Claude API는 입력 해석과 설명을 맡습니다. 3. 성향 분류, 투자 제약, 주문·체결 관리와 일임·자문별 실행 절차는 자체 로직으로 설계합니다.

대한민국 금융 서비스인 핀트의 핵심 가치는 투자 성향·스타일에 맞춘 자산배분과 운용 내역 확인으로 투자 관리 부담을 줄이는 데 있습니다. 이 글은 자산관리 사업자의 AI 자산관리 앱 제작을 위한 설계안입니다. 아래 기술은 핀트의 비공개 내부 스택이 아니라 유사 기능을 구현할 대안입니다.

투자성향 분석 시스템 개발: 설문과 설명을 연결합니다

사용자가 투자 기간, 손실 감내 수준, 투자 스타일을 입력하면 Claude API가 서술형 답변을 정리합니다. 자체 분류 규칙은 설문 점수를 계산해 성향 유형을 정하며, 고객 적합성 판단 절차를 별도로 둡니다.

출력은 성향 유형, 분류 근거, 해당 조건에서 선택할 수 있는 전략입니다. AI에는 결과 설명을 맡기고, 점수 계산과 적합성 판단은 별도의 규칙으로 처리합니다.

종목·시장 분석: 시세 API와 자체 신호모델을 연결합니다

분석할 시장과 종목 목록을 입력하면 한국투자증권 Open API에서 시세와 종목·상품 정보를 조회합니다. 자체 로직은 자료의 기준시각과 누락 값을 확인하고, 가격 변화와 변동성 등을 계산해 시장 신호를 만듭니다.

신호모델은 서비스가 정한 조건에 따라 투자 후보를 걸러내도록 설계합니다. 출력 화면에는 후보 종목과 선정 근거, 데이터 기준시각을 표시해 이후 비중 계산에 사용할 자료를 확인할 수 있게 합니다.

PyPortfolioOpt 포트폴리오 최적화로 ETF 비중을 계산합니다

ETF 자산배분 자동화의 입력은 투자 후보, 가격 이력, 성향별 비중 한도입니다. Python 오픈소스 라이브러리인 PyPortfolioOpt는 기대수익과 공분산을 추정하고 제약조건에 맞는 목표 비중을 계산합니다. 공분산은 자산 수익률이 함께 움직이는 정도를 나타냅니다.

자체 로직은 투자 가능 상품과 위험 한도를 정하고, 계산 결과를 계좌 금액에 맞는 목표 보유량으로 변환합니다. 출력은 종목별 목표 비중과 현재 비중의 차이입니다. 가격 자료 공급과 주문 전송은 각각 연결한 데이터·거래 API가 담당합니다.

한국투자증권 API 리밸런싱: 주문 이후까지 관리합니다

리밸런싱은 목표 비중에서 벗어난 자산 구성을 다시 맞추는 작업입니다. 한국투자증권 Open API로 조회한 잔고·시세와 목표 비중을 입력받아 자체 로직이 조정 여부와 매매 수량을 결정합니다. 이때 비중 차이, 조정 주기, 거래 비용, 최소 주문 단위 등을 반영하도록 설계합니다.

계약 유형에 따른 실행 조건을 충족한 주문은 증권사 API로 전송합니다. 자체 로직은 주문 접수와 체결 결과를 구분하고 부분 체결·취소·중복 전송을 관리합니다. 사용자에게는 주문 진행 상태와 체결 결과를 반영한 보유 내역을 제공합니다.

AI 투자 리포트 개발: 계산 결과에 근거를 붙입니다

보유 종목 매매내역 분석은 한국투자증권 Open API로 조회·저장한 잔고와 체결 기록에서 시작합니다. 자체 계산 로직이 평가금액, 비중 변화, 매매 내역을 정리한 뒤 Claude API에 전달합니다. Claude API는 이 결과를 바탕으로 사용자가 이해할 수 있는 설명 초안을 생성합니다.

근거 문서를 제공하면 문서의 구절과 위치를 응답에 연결하는 Citations 기능을 활용할 수 있습니다. 문서 인용 응답과 엄격한 JSON 형식의 출력은 별도 요청으로 생성합니다. 자체 로직은 설명에 포함된 수치를 계산 결과와 대조하고, 기준시각·근거·운용 내역이 함께 보이는 리포트로 출력합니다.

일임·자문과 계좌별 공급 범위를 나눠 설계합니다

핀트 공개 안내에서 일임은 포트폴리오 구성과 주문을 자동으로 진행하고, 자문은 추천 후 고객 요청에 따라 매매합니다. 제작할 앱도 계약 유형에 맞춰 자동 실행과 고객 확인 단계를 다르게 설계합니다.

핀트 Android 앱 2.10.24의 공개 설명에는 IRP·ISA 자문 안내가 있으며, 표시된 업데이트일은 2026년 10월 8일입니다. 2026년 6월 출시된 BNK부산·경남은행의 IRP 일임은 해당 은행 MTS를 통한 제휴 공급 사례입니다. 따라서 같은 IRP라도 계약 유형과 가입 채널을 구분해야 합니다.

증권사 API는 국내·해외 시장, 실전·모의 환경, 계좌·상품별 지원 기능과 이용 권한을 확인해 연결 범위를 정합니다. IRP·ISA의 연결 범위와 일임 운용 권한은 일반 거래 API 지원 여부와 별도로 확인해야 합니다.

로보어드바이저 서비스 개발을 준비한다면 필요한 기능, 입력 자료, 연결할 계좌·상품과 업무를 정리해 주세요. 트램스 AI 제작 문의 https://trams.co.kr/ai-si/contact/#inquiry 에서 유사 서비스의 설계·제작 범위를 상담할 수 있습니다.