KB증권 오픈API 활용법 — AI로 주식 매매 앱 만들기

투자 조언이 아니라 구현 가이드입니다

KB증권이 오픈API를 공개하면서, 코딩을 몰라도 AI와 함께 계좌와 연동되는 개인용 서비스를 만들 수 있게 됐습니다. 이 글은 유튜브 채널 "API 알려주는 누나" 영상을 바탕으로, KB증권 오픈API 활용법을 신청부터 앱키 발급, AI 프롬프트 작성, 웹앱 실행과 테스트까지 순서대로 정리한 것입니다.

종목 매수·매도에 대한 조언은 아닙니다. 아래 나오는 매수 테스트도 API 연동을 확인하는 절차일 뿐, 특정 종목을 추천하는 내용이 아닙니다.

증권사 오픈API란 무엇인가

오픈API는 증권사(KB증권) 내부의 계좌 정보와 시세 조회, 주문 기능을 개인이 만든 서비스와 연결해주는 통로입니다. 사람이 증권사 앱에서 버튼을 누르는 대신, 내가 만든 프로그램이 이 통로로 "현재가 알려줘", "이 주식 사줘" 같은 요청을 보내는 방식입니다.

발급받는 앱키와 두 번째 키(화면에 표시되는 이름을 그대로 쓰면 됩니다)는 본인 인증 수단입니다. 영상은 이걸 "나만의 주민등록번호" 같은 것이라고 설명합니다. 이 API를 물려두면 개인 투자 대시보드(내 자산과 시세를 한 화면에 모아 보는 화면), 자동 매매 도구, 퀀트 전략(정해진 숫자 규칙에 따라 사고파는 방식), AI 투자비서 같은 것을 만들 수 있습니다.

KB증권 오픈API 준비물

• KB증권 계좌 (없으면 개설)
• 본인 명의 휴대폰 (SNS 인증용)
• AI 데스크톱 앱 (ChatGPT 데스크톱 앱 또는 Claude 데스크톱 앱)

브라우저 버전 ChatGPT는 로컬(내 컴퓨터)에 파일을 설치하거나 실행하는 기능이 없습니다. 그래서 코드를 일일이 복사해 붙여넣어야 합니다. 반드시 데스크톱 앱을 받아야 합니다.

1. KB증권 오픈API 신청하기

1. 검색창에 "KB증권"을 검색해 공식 웹사이트에 들어갑니다.
2. 강조돼 있는 "오픈API" 메뉴를 클릭합니다.
3. KB증권 계정으로 로그인합니다.
4. 신청 페이지 하단의 노란색 "신청하기" 버튼을 누르면 휴대폰 SNS 인증 화면이 나옵니다. 인증을 마칩니다.
5. 계좌 비밀번호를 입력해 "조회"를 누르면 신청 내용이 화면에 뜹니다.
6. "확인 완료" → 증권 문서 확인 → "개인정보 동의" → 유의 사항 체크 → "신청하기" 순서로 넘어갑니다.
7. 비밀번호를 한 번 더 입력하면 "오픈API 신청이 완료됐습니다" 메시지가 뜹니다.

2. 앱키·두 번째 키 발급받기

신청 사이트로 돌아가면 앱키와 두 번째 키 두 개의 값이 화면에 보입니다. 복사해서 메모장에 붙여넣어 형태를 확인해둡니다. 이 키는 본인을 나타내는 값이라 노출되면 안 됩니다. 매번 로그인하기 번거로우면 개인 메모장에 저장해도 됩니다. 다만 평문(암호화하지 않은 그대로의 글자)으로 남겨두는 셈이라 관리는 신경 써야 합니다.

3. API 문서와 샘플 코드 확인하기

API 문서는 어떤 요청을 어떤 형식으로 보내면 무엇이 돌아오는지 적어둔 사용 설명서입니다. "API 문서" 메뉴에 들어가면 국내 주식 관련 API 목록(기본 시세 조회, 호가, 체결, 현재가, 매수/매도 주문 등)이 나옵니다. 호가는 사고팔려고 내놓은 가격, 체결은 거래가 실제로 성사된 것을 말합니다.

문서 찾기가 번거로우면 챗봇에 "현재가 조회하는 API 있어?"처럼 물어보면 됩니다. 문서 안 샘플 소스 코드(따라 쓰라고 제공하는 예제 코드)의 위치도 미리 확인해둡니다. 다음 단계 프롬프트에 씁니다.

4. AI 데스크톱 앱 설치, 프로젝트 폴더 연결

1. "챗GPT 다운로드"를 검색해 OS에 맞는 버전을 설치합니다(Claude도 무방).
2. 바탕화면에 새 폴더를 하나 만듭니다(예: "KB테스트").
3. ChatGPT 앱에서 "프로젝트 선택" → "새 프로젝트"를 누릅니다.
4. 방금 만든 폴더를 선택하고 "프로젝트 만들기"를 누릅니다.

이후 생성되는 소스 코드는 전부 이 폴더에 저장됩니다.

5. 프롬프트로 웹앱 제작 요청하기

프롬프트는 AI에게 시킬 일을 적은 지시문입니다. 대화창에 API 문서(파일 또는 URL)를 첨부하고, 아래 내용을 Shift+Enter로 줄을 바꿔가며 순서대로 입력합니다. 그냥 Enter를 누르면 다 쓰기 전에 전송돼버리니 주의합니다.

1. 첫 줄에 아래 문장을 적습니다.

(첨부한) API 문서와 아래 넣은 샘플 코드를 참고해서 주식 매매 웹사이트를 만들어

1. 줄을 바꿔 샘플 코드 주소를 붙여넣습니다.
2. 다시 줄을 바꿔 원하는 기능을 문장으로 적습니다(예: "주식 현재가를 확인할 수 있다", "주식을 매수/매도할 수 있다").
3. 마지막으로 아래 기술 스택 지정 문장을 넣습니다.

파이썬과 FastAPI 그리고 HTML, CSS, 자바스크립트를 이용해서 만들어줘

기술 스택은 프로그램을 만드는 데 쓰는 언어와 도구의 조합입니다. 파이썬과 FastAPI는 뒤에서 증권사와 통신하는 서버 쪽을, HTML·CSS·자바스크립트는 브라우저에 보이는 화면 쪽을 맡습니다. 이 문장을 빼도 동작은 합니다. 다만 넣지 않으면 결과물이 사람마다 달라질 수 있습니다.

1. Enter로 전송합니다. 5~6분(안내는 최대 10분) 정도 뒤 "국내 주식 거래 웹 프로그램을 완성했습니다"라는 메시지가 뜹니다.

6. 웹앱 실행하고 키 연결하기

서버는 웹앱을 내 컴퓨터에서 돌려 브라우저로 열 수 있게 해주는 프로그램입니다. 원래는 터미널(명령어를 글자로 입력하는 창. 맥은 응용 프로그램 > 유틸리티 > 터미널, 윈도우는 시작 메뉴에서 PowerShell)에 실행 명령어를 쳐야 합니다. 이 방법에서는 그럴 필요가 없습니다.

1. 채팅창에 "서버 실행시켜줘"라고 요청합니다. AI가 서버를 실행하고 접속 주소를 안내합니다.
2. 그 주소로 들어가면 웹앱 화면이 뜹니다. 처음에는 "연결 안 됨" 상태입니다. 아직 키를 앱에 알려주지 않았기 때문입니다.
3. "API 연결" 버튼을 클릭합니다.
4. 팝업에 앱키와 두 번째 키를 붙여넣습니다.
5. "토큰 발급"을 누르면 "API 연결됨"으로 바뀝니다. 토큰은 키로 인증을 마친 뒤 받는 임시 출입증입니다.

만약 "API 연결" 버튼이 화면에 없다면 현재 화면을 캡처해서 AI에게 "앱키/두 번째 키 입력 팝업 만들어줘"라고 요청하면 됩니다.

7. 기능 테스트

1. 종목 코드(예: 삼성전자 005930)를 입력해 현재가를 조회합니다. 종목 코드는 상장 종목마다 붙는 여섯 자리 번호입니다.
2. "매수 주문 검토" → 확인 → "실제 주문 전송"까지 눌러봅니다.
3. "내 계좌 현황"으로 보유 종목을 확인합니다.

"실제 주문 전송"은 이름 그대로 실제 계좌에서 주문이 나가는 버튼입니다. 테스트할 때는 수량과 금액을 확인하고 누르는 편이 안전합니다. 다만 영상 속 시연에서도 주문 전송 직후 바로 체결까지 보여주지는 않았습니다. "검토 중일 것"이라는 말과 함께 영상이 끝납니다. 실제 체결 여부는 각자 계좌에서 확인해야 합니다.

KB증권 오픈API로 주식 매매 앱 만드는 순서 한눈에 보기

신청 → 키 발급 → 문서 확인 → AI 앱 설치·프로젝트 연결 → 프롬프트 작성 → 서버 실행 → 키 연결·테스트. 이 순서를 그대로 따라가면 재현됩니다. 이건 계좌 연동 기술을 만들어보는 구현 가이드이고, 실제 매매 판단이나 자동매매 확장은 별개로 본인이 리스크를 따져봐야 하는 영역입니다.

원본 영상: youtu.be/…