키움 REST API 완전 가이드 — 인증부터 주문까지 순서대로 읽는 법

키움증권 REST API로 자동매매를 만들려고 검색하면 인증·잔고조회·주문·에러처리·레이트리밋 같은 글이 뿔뿔이 흩어져 나온다. 어디서부터 읽어야 할지, 무엇을 먼저 알아야 하는지 판단이 서지 않는다. 이 글은 지금까지 이 블로그에 쓴 키움 REST API 관련 글 8편을 순서대로 묶어, 전체 그림과 각 글의 위치를 안내하는 지도 역할을 한다.

이 글의 범위

이 글은 각 글의 세부 내용을 다시 설명하지 않는다. 무엇이 어디에 있는지, 어떤 순서로 읽으면 되는지만 안내한다. 정확한 API 사양과 코드는 각 글, 그리고 키움증권 공식 개발자 문서에서 확인해야 한다.

① 키움 REST API로 자동매매를 만드는 전체 그림

자동매매를 코드로 짜기 전에 거쳐야 하는 단계는 대체로 이렇다. 개발자 등록·앱키 발급 → 접근토큰 인증 → 잔고·계좌평가 조회 → 주문 실행 → 에러처리·레이트리밋 같은 운영 방어 로직. 국내주식과 미국주식은 API 카테고리 자체가 나뉘어 있어 별도로 다뤄야 한다. 아래 순서대로 읽으면 이 흐름을 그대로 따라갈 수 있다.

② 시작~인증 단계

키움증권 REST API 시작하기 — 개발자 등록·앱 키 발급·모의투자 신청: 개발자센터 가입부터 App Key/Secret 발급, 모의투자 계좌 신청까지의 순서와 처음 신청할 때 흔한 실수를 정리했다.
키움 REST API 접근토큰 발급과 만료·재발급 관리: App Key/Secret으로 접근토큰을 발급받고, 만료 전에 선제적으로 재발급하는 방어 로직을 다룬다.

③ 잔고·계좌평가 조회 — 국내 vs 미국주식

키움 REST API 잔고·계좌평가 조회하기: 국내주식 기준으로 잔고 조회 요청 구조와 응답 필드 개념, 조회 결과를 리스크 관리(포지션 한도 점검)에 연결하는 방법을 정리했다.
키움 미국주식 REST API 실전 — 잔고·예수금·주문 다루기: 미국주식은 국내주식과 별개 카테고리라 전용 엔드포인트를 써야 하며, 주문 유형(시장가·지정가)에 따라 주문 단가 필드가 필수·금지로 갈리는 함정을 다룬다.

④ 운영에서 걸리는 것 — 에러 처리와 레이트리밋

증권사 API 에러코드 처리 실전: 에러코드를 일시적·설정·치명적 세 그룹으로 나눠 대응하는 설계를 다룬다. 이 분류를 안 해두면 무인매매가 알림 없이 조용히 멈춘다.
증권 API 레이트리밋과 재시도 설계: 요청 한도(레이트리밋)에 걸렸을 때 지수 백오프와 요청 큐로 재시도를 설계하는 법을 다룬다.

⑤ AI 조사가 틀렸던 경험 — 공식 문서도 검증이 필요하다

키움 미국주식 REST API, AI는 '안 된다'고 했다 — 상식 한마디가 뒤집은 조사기: AI가 공식 저장소를 근거로 "미국주식 잔고 조회는 지원하지 않는다"고 단언했지만, 실제 포털에는 2주 전 이미 관련 기능이 열려 있었던 경험을 다룬다. 공식이라는 라벨이 최신을 보장하지 않으므로, 결정적인 사실은 1차 원본에서 다시 확인해야 한다는 교훈을 남겼다.

⑥ 다른 증권사와 비교하고 싶다면

증권사 자동매매 API, 뭘 골라야 하나 — 키움·한국투자·토스 실무 비교: 키움 REST API를 한국투자증권·토스증권과 개발·운영 관점(인증 방식·모의투자 지원·문서·생태계)에서 비교하고, 상황별 선택 기준을 정리했다.

오늘의 정리

키움 REST API를 처음 만진다면 개발자 등록·인증(017, 018) → 잔고 조회(019, 021) → 에러처리·레이트리밋(022, 026) 순서로 읽으면 된다.
국내주식과 미국주식은 API 카테고리가 다르므로, 잔고·주문을 다룰 때 각각 다른 글(019, 021)을 참고해야 한다.
AI 조사 결과도 "공식 문서"라는 이유만으로 최신이라고 믿지 말고, 결정적인 사실은 1차 원본에서 재확인해야 한다(020).
다른 증권사와 비교하고 싶다면 032에서 개발·운영 관점의 선택 기준을 확인할 수 있다.
각 글의 세부 코드와 정확한 API 사양은 이 허브 글이 아니라 해당 글, 그리고 키움증권 공식 개발자 문서를 기준으로 삼아야 한다.

이 글은 기존에 쓴 키움 REST API 관련 글들을 순서대로 안내하는 허브 글이며, 정확한 API 사양은 각 글에서 안내한 대로 공식 개발자 문서에서 확인해야 합니다. 실제 계좌번호·API 키·서버 상세는 담고 있지 않습니다. 투자 조언이 아니고 특정 종목이나 매매기법을 추천하지 않습니다. 수익 보장은 없으며, 투자 손실의 책임은 투자자 본인에게 있습니다.