KISOpenAPI 6

[계좌 리팩토링] 7편. 수익의 완성! Node.js 주식 매도 주문 및 수익률 자동 계산

사는 것보다 파는 것이 더 중요하다안녕하세요. 감정을 배제하고 완벽한 로직으로 계좌를 재설계하는 [계좌 리팩토링] 시리즈 7편입니다. 지난 6편에서 우리는 봇에게 주식을 매수하는 '손'을 달아주었습니다. 주문이 체결되는 것을 보며 짜릿함을 느끼셨을 텐데요.하지만 주식 시장에서 오랜 격언이 있죠. "매수는 기술이고, 매도는 예술이다." 아무리 좋은 타점에 주식을 샀더라도, 적절한 시점에 팔지 못하면 그 수익은 결코 내 계좌의 것이 되지 않습니다. 오히려 '조금만 더 오르겠지' 하는 탐욕이나 '다시 오를 거야'라는 미련 때문에 익절과 손절 타이밍을 놓치고 계좌가 망가지는 경우가 허다합니다.이번 7편에서는 봇이 냉철하게 수익률을 계산하고, 목표한 조건(익절/손절 라인)에 도달했을 때 미련 없이 주식을 던지는 ..

[계좌 리팩토링] 6편. 드디어 실전! Node.js로 주식 매수 주문 자동화하기

머리로 생각한 타점, 코드로 실행하다안녕하세요. 내 계좌를 튼튼하게 다지는 [계좌 리팩토링] 자동매매 봇 만들기 시리즈 6편입니다. 지난 시간까지 우리는 봇에게 '눈'과 '귀'를 달아주었습니다. 4편에서는 내 계좌의 예수금 상태(REST API)를 파악했고, 5편에서는 시장의 실시간 시세(WebSocket)를 읽어내는 데 성공했습니다.이제 드디어 봇에게 '손'을 달아줄 차례입니다. 우리가 설정한 로직(타점)이 왔을 때, 망설임이나 감정의 동요 없이 기계적으로 주식을 사들이는 '매수 주문(Buy Order)'을 구현해 보겠습니다.시장가 vs 지정가: 봇에게 어떻게 명령할 것인가?주문을 코드로 구현하기 전에, 증권사 API가 요구하는 주문의 형태를 이해해야 합니다. 자동매매에서 가장 많이 쓰이는 두 가지 주..

[계좌 리팩토링] 5편. 뚝딱뚝딱 호가창 연동! Node.js 실시간 시세 조회 (WebSocket)

자동매매 봇의 심장, '실시간 시세'안녕하세요. 우리의 계좌를 튼튼하게 리팩토링하는 자동매매 봇 개발 시리즈, 벌써 5편입니다. 지난 4편에서는 REST API를 통해 우리의 계좌 예수금과 보유 잔고를 실시간으로 가져오는 구현을 마쳤습니다. "내가 무엇을 얼마나 가졌는지"는 이제 봇이 정확히 압니다.하지만 무엇을 살 것인가요? 그리고 언제 살 것인가요? 이 질문에 답하기 위해서는 시장의 움직임, 즉 실시간 종목 시세(호가) 데이터가 필요합니다. 4편에서 사용한 REST API 방식(Polling)으로 시세를 1초에 한 번씩 물어볼 수도 있겠지만, 이는 효율적이지 않고 증권사 서버에 부하를 줍니다.그래서 우리는 더 빠르고, 효율적이며, 즉각적인 WebSocket 기술을 사용하여 증권사 호가창을 내 봇의 터..

[계좌 리팩토링] 4편. 내 계좌 정보, 실시간으로 완벽하게 파싱하기 (REST API)

감정에 휘둘리지 않으려면 데이터가 필요하다안녕하세요, 주식 자동매매 봇을 만드는 여러분. 지난 시간까지 우리는 환경 세팅과 API 토큰 발급까지 마쳤습니다. 이제 드디어 증권사 서버에서 우리의 실제 돈, 즉 계좌 정보를 실시간으로 가져오는 구현을 해볼 차례입니다.썸네일에서 보신 것처럼, 이것은 'API 아키텍처 완벽 마스터'의 핵심입니다. 뇌동매매를 줄이고 안정적인 수익을 내기 위해서는, 내 봇이 현재 정확히 얼마를 가지고 있고(D+2 활용금 포함), 어떤 종목을 얼마나 보유하고 있는지(TR 코드 매핑)를 한 치의 오차 없이 알아야 합니다.TR 코드를 통한 계좌 정보 매핑 (with KIS Developers)한국투자증권(KIS) API에서는 TR(Transaction) 코드라는 개념을 사용합니다. 특정..

[계좌 리팩토링] 3편. 매매 봇의 심장을 켜다! KIS API 토큰(Access Token) 발급 및 캐싱 전략

1. 출입증(App Key)이 있어도 임시 방문증(Token)이 필요한 이유지난 2편에서 우리는 한국투자증권(KIS) 개발자 센터를 통해 나만의 고유한 출입증인 'App Key'와 'App Secret'을 발급받고, 이를 안전하게 .env 파일에 보관하는 작업까지 마쳤습니다. 그렇다면 이 두 가지 키만 있으면 바로 증권사 서버에서 주식 가격을 가져오고 매수 주문을 넣을 수 있을까요? 정답은 '아니오'입니다.보안이 가장 중요한 금융 시스템에서는 만약 누군가 여러분의 App Key와 App Secret을 탈취하더라도, 영구적으로 계좌에 접근하는 것을 막기 위해 'OAuth 2.0' 기반의 토큰(Token) 인증 방식을 사용합니다. 쉽게 비유하자면, App Key와 App Secret은 내 고유한 신분을 증명..

[계좌 리팩토링] 2편. 첫 단추가 절반! 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 개발에 가장 최적화된 에디터입니다.2. 한국투자증권(KIS) Op..