[계좌 리팩토링] 2편. 첫 단추가 절반! Node.js 환경 세팅 및 KIS API 발급

Node.js 환경 세팅 및 KIS API 발급

1. 봇 개발을 위한 기본 무기 장착 (Node.js & VS Code)

감정이 배제된 나만의 자동매매 봇을 만들기 위한 첫걸음입니다. 먼저 코드를 작성하고 실행할 환경을 만들어야 합니다. 이미 개발 환경이 갖춰져 있으신 분들은 이 단계를 건너뛰셔도 좋습니다.

• Node.js 설치: Node.js 공식 홈페이지(nodejs.org)에 접속하여 LTS(안정적인 버전)를 다운로드하고 설치합니다. 봇은 안정성이 생명이므로 최신 버전보다는 LTS 버전 사용을 강력히 권장합니다.
• 코드 에디터 (VS Code): Microsoft에서 무료로 제공하는 Visual Studio Code를 설치합니다. 수많은 확장 프로그램과 터미널을 내장하고 있어 Node.js 개발에 가장 최적화된 에디터입니다.

node 24.15.0 버전이 설치되어있는걸 볼 수 있다.

2. 한국투자증권(KIS) Open API 발급받기 (핵심)

우리의 봇이 증권소와 통신하며 시세를 확인하고 주문을 넣으려면 '출입증' 역할을 하는 API 키가 필요합니다. 한국투자증권은 개인 개발자도 쉽게 사용할 수 있는 강력한 REST API를 제공합니다.

1. 한국투자증권 개발자 센터(API KIS Developers) 홈페이지에 접속하여 로그인합니다. (계좌가 없다면 스마트폰 앱을 통해 비대면으로 개설해야 합니다.)
2. 상단 메뉴에서 [API 서비스 신청]을 클릭합니다.
3. 우리는 봇을 처음 만들고 테스트하는 단계이므로, 반드시 실전 투자가 아닌 '모의투자(Virtual Trading)'로 먼저 신청을 진행합니다. (계좌 리팩토링의 핵심은 철저한 검증과 리스크 관리입니다!)
4. 신청이 완료되면 App Key와 App Secret이라는 두 개의 긴 문자열을 발급받게 됩니다. 이 두 가지가 봇의 핵심 비밀번호입니다. 절대 외부에 노출되지 않도록 메모장 등에 잠시 복사해 둡니다.

 

https://apiportal.koreainvestment.com/intro 에 들어가서 API 신청을 한다.

3. 프로젝트 초기화 및 필수 라이브러리 설치

이제 VS Code를 열고 나만의 봇이 살아 숨 쉴 프로젝트 폴더를 만들어 보겠습니다.

원하는 위치에 kis-bot이라는 폴더를 만들고 VS Code로 엽니다. 상단 메뉴의 [터미널] -> [새 터미널]을 열고 아래 명령어를 순서대로 입력합니다.

# 1. Node.js 프로젝트 초기화 (package.json 생성)
npm init -y

# 2. 통신과 환경변수 관리를 위한 필수 라이브러리 설치
npm install axios dotenv

• axios: 증권사 서버로 API 요청(현재가 조회, 주문 등)을 빠르고 쉽게 보내기 위한 통신 라이브러리입니다.
• dotenv: 방금 발급받은 소중한 API 키를 안전하게 숨겨서 관리하기 위한 보안 라이브러리입니다.

4. 내 소중한 API 키 안전하게 보관하기 (.env 설정)

초보 개발자들이 가장 많이 하는 치명적인 실수 중 하나가 소스 코드 안에 API 키를 그대로 적어두었다가 깃허브(GitHub) 등에 유출되는 것입니다. 우리는 .env 파일을 통해 이를 원천 차단하겠습니다.

프로젝트 최상단 폴더에 .env라는 이름의 파일을 새로 만들고, 아까 복사해둔 KIS API 키를 아래 양식에 맞게 붙여넣습니다. (따옴표 없이 작성하세요!)

# .env 파일 내부
KIS_APP_KEY=여기에_발급받은_AppKey_입력
KIS_APP_SECRET=여기에_발급받은_AppSecret_입력
KIS_ACCOUNT_NUMBER=여기에_모의투자_계좌번호_8자리_입력

주의: 만약 나중에 코드를 깃허브에 올릴 계획이라면, .gitignore 파일에 반드시 .env를 추가하여 키가 유출되지 않도록 각별히 주의하시기 바랍니다.

마무리 및 다음 편 예고

축하합니다! 이제 여러분의 PC는 주식 시장의 데이터를 받아들일 완벽한 준비를 마쳤습니다. API 출입증도 얻었고, 이를 안전하게 보관할 금고(.env)도 마련했습니다.

하지만 아직 증권사 서버에 들어갈 수는 없습니다. 출입증(App Key)을 보여주고 임시 방문증(Access Token)을 발급받는 과정이 필요하기 때문입니다. 다음 3편에서는 Node.js 코드를 직접 작성하여 '한국투자증권 API 인증 토큰(Access Token)을 발급받는 방법'을 아주 상세히 다루어 보겠습니다.