증권사 자동매매 API, 뭘 골라야 하나 — 키움·한국투자·토스 실무 비교

자동매매를 처음 만들 때 다들 "무슨 전략을 짤까"부터 고민한다. 그런데 실제로 먼저 부딪히는 벽은 전략이 아니라 "이걸 어느 증권사 API 위에 올릴까"다. 나는 키움으로 시작했는데, 솔직히 비교하고 고른 게 아니라 먼저 손에 잡혔기 때문이었다. 이후 한국투자증권(KIS) 오픈API와 2026년 새로 열린 토스증권 오픈API까지 구조를 들여다보면서, 그때 미리 알았으면 좋았을 기준들이 보였다.

이 글의 범위

이 글은 어느 API가 "최고"라고 결론 내리지 않는다. 종목 추천이나 수익 비교가 아니라, 세 증권사의 공식 문서·구조를 개발·운영 관점에서 비교하고 상황별 선택 기준을 정리하는 글이다. 키움은 자체 연동 경험을 바탕으로 쓰고, 한국투자증권·토스증권은 직접 운영해본 계좌가 없어 공식 문서와 공개된 자료로 팩트를 확인한 뒤 서술했다 — 확인이 안 되는 부분은 추정하지 않고 "확인되지 않는다"고 명시한다. 실계좌·실키·실 엔드포인트는 다루지 않는다.

왜 API 선택이 첫 갈림길인가

전략 코드는 결국 증권사 API 위에서 돌아간다. 전략을 아무리 잘 짜도 그 밑의 API가 인증 단계에서 막히거나, 서버에 못 올라가거나, 모의투자 없이 바로 실전으로 가야 한다면 진도가 안 나간다. API 선택이 나중에 되돌리기 비싼 이유는, 인증 흐름·에러 처리·재시도 로직이 전부 그 API의 스펙에 맞춰 짜여지기 때문이다. 증권사 REST API 인증 흐름에서 다뤘듯, 이 부분은 웹 로그인과 감이 달라서 처음부터 헷갈리기 쉽다.

세 증권사 모두 큰 그림은 "키·시크릿으로 토큰을 받아 이후 요청 헤더에 싣는" 이 흐름을 따른다. 다만 그 안의 세부 방식과, 그 위에 뭘 지었을 때 어디서 걸리는지는 증권사마다 다르다.

OCX(설치형) vs REST(설치 불필요)의 실무 차이

키움은 원래 OpenAPI+라는 OCX 컨트롤 방식으로 시작했다. Windows 32비트 프로세스에서만 동작하고, 화면이 떠 있는 세션을 계속 유지해야 하는 구조라 서버에 무인으로 올려두기가 까다로웠다. 이후 REST API가 열리면서 운영체제에 매이지 않고 백그라운드 프로세스로 돌릴 수 있게 됐다 — 키움증권 REST API 시작하기에서 이 절차를 그대로 다뤘다. 미국주식까지 REST로 지원되는지는 처음엔 나도 확신이 없었는데, 그 조사 과정 자체가 하나의 이야기가 됐다 — 키움 미국주식 REST API 조사기와 실제 주문까지 다룬 키움 미국주식 REST API 실전에 정리했다.

한국투자증권 KIS Developers와 토스증권 오픈API는 둘 다 문서상 REST API로 제공된다. OCX 같은 설치형 유산을 거치지 않고 시작한 구조라, 서버 배포 자체는 셋 다 지금은 "설치 불필요"로 수렴한다고 보면 된다. 다만 REST라는 이름이 같다고 세부 인증·요청 방식까지 같은 건 아니다 — 그 차이는 다음 절에서 다룬다.

서버·자동화 관점 비교 포인트 5가지

무인 자동매매를 서버에 올릴 때 실제로 걸리는 지점은 다섯 가지로 좁혀진다.

• 인증 방식: 키움·한국투자증권은 앱 키/시크릿으로 접근 토큰을 발급받아 헤더에 싣는 방식이다. 토스증권 오픈API는 표준 OAuth2 client credentials 방식(사용자 로그인 단계 없이 서버 간 자격증명만으로 토큰을 받는 방식)을 쓴다. 개념은 비슷해 보여도 실제 토큰 요청 파라미터 구성은 다르므로, 토큰 발급·만료 재발급 로직을 만들 때 각 공식 문서를 그대로 따라야 한다. 키움 REST API 접근토큰 발급과 관리에서 이 부분을 실제로 구현한 기록을 남겼다.
• 언어·라이브러리 생태계: 키움·한국투자증권은 공식 문서 외에 커뮤니티 래퍼 라이브러리(파이썬 등)가 여럿 존재해서, 막히는 지점을 남이 이미 겪었을 가능성이 높다. 토스증권 오픈API는 2026년 새로 열린 만큼 공식 SDK는 없고, 공개된 OpenAPI(JSON) 스펙으로 자동 생성 도구를 쓸 수 있다는 정도까지만 확인된다 — 커뮤니티 자료는 아직 얇다.
• 진입 난이도: 키움은 REST 전환 이후 앱 등록·모의투자 신청 절차가 비교적 정형화돼 있다. 한국투자증권은 신청·인증 단계 자체는 무난하지만 지원 기능이 많아 문서량이 두껍다. 토스증권은 API 스펙 자체는 단순한 편이지만, 자료가 적어 막혔을 때 참고할 사례가 적다.
• 레이트리밋·재시도 여지: 요청 한도에 걸렸을 때 무작정 재시도하면 상황이 악화될 수 있다는 건 증권사를 가리지 않는 공통 문제다. 증권 API 레이트리밋과 재시도 설계에서 다룬 지수 백오프·요청 큐 패턴은 세 곳 모두에 그대로 적용된다.
• 에러 처리 설계: 인증 실패·토큰 만료·요청 한도 초과 같은 실패 케이스를 "성공"만 가정하고 넘어가면 무인 매매가 조용히 멈춘다. 증권사 API 에러코드 처리 실전에서 다룬 분류·대응 로직은 특정 증권사 코드가 아니라 어느 API를 붙이든 먼저 설계해둬야 하는 부분이다.

모의투자·문서·생태계 비교

• 키움: 개발자센터에서 모의투자 계좌를 신청할 수 있다. 실전과 모의 접속 주소가 분리돼 있어 혼동하기 쉬운 지점이라, 키움증권 REST API 시작하기와 키움 REST API 잔고·계좌평가 조회에서 그 흐름을 실제로 밟았다.
• 한국투자증권(KIS): 신청 시 실전 계좌와 모의투자 계좌를 함께 선택할 수 있고, 모의투자용 접속 주소가 실전과 별도로 분리돼 있다. 다만 모의투자 계좌는 REST 요청 호출 한도가 실전보다 낮게 제한된다고 공식 자료에 안내돼 있다 — 자동화 로직을 모의투자에서 검증할 때는 이 한도 차이를 감안해야 한다. 공식 GitHub 저장소와 커뮤니티 파이썬 래퍼가 다수 존재해, 세 곳 중 문서·예제 생태계가 가장 두껍다.
• 토스증권 오픈API: 2026년 상반기에 새로 연 서비스다. 확인되는 범위에서는 오픈API 자체에 별도 모의투자(샌드박스) 환경이 제공되지 않는다 — 앱 안의 모의투자 기능은 오픈API와는 별개다. 즉 오픈API로 실제 요청을 검증하려면 실계좌를 써야 한다는 뜻이라, 처음 붙일 때는 소액·소량으로 신중하게 접근할 필요가 있다. 국내·미국 주식을 API 하나에서 함께 다루도록 설계됐고, 인증·시세·계좌·주문 등 기능을 카테고리별로 나눠 제공한다. 신규 서비스라 공식 문서 외의 커뮤니티 가이드는 아직 소수다. 신청부터 앱키 발급, 파이썬 첫 연동까지 실제로 밟아본 순서는 토스증권 오픈API 시작하기에 정리했다.

내 상황이면 어떻게 고를까

• 모의투자에서 안전하게 검증하고 싶다: 키움 또는 한국투자증권. 둘 다 API 레벨에서 모의투자 환경이 분리돼 있어, 실계좌 없이도 인증·조회·주문 흐름을 먼저 익힐 수 있다.
• 막혔을 때 참고할 사례가 많은 곳에서 시작하고 싶다: 한국투자증권. 공식 저장소와 커뮤니티 래퍼가 가장 풍부해서, 에러 메시지 하나로 검색해도 먼저 겪은 사례가 나올 가능성이 높다.
• 이미 운영 노하우가 쌓인 곳에 바로 이어 짓고 싶다: 키움. 24시간 무인 운영·에러코드 처리·레이트리밋 설계까지 이미 다뤄둔 만큼, 새로 검증할 변수가 적다.
• 국내·미국 주식을 API 하나로 통합해서 다루고 싶다: 토스증권. 다만 모의투자 없이 실계좌로 검증해야 한다는 점, 그리고 아직 커뮤니티 자료가 얇다는 점은 감수해야 한다.
• 신규 API를 가장 먼저 써보고 관련 글을 쓰고 싶다: 토스증권. 저경쟁 영역이라 시행착오를 남기는 것 자체가 정보가 되지만, 그만큼 스스로 공식 문서를 더 꼼꼼히 읽어야 한다.

자주 하는 실수

• "모의투자"라는 단어가 증권사마다 다른 걸 가리킨다는 걸 모르고 넘어가는 것: 키움·한국투자증권은 API 레벨에서 모의투자 접속 주소가 따로 있지만, 토스증권 오픈API는 확인되는 범위에서 그렇지 않다. 이 차이를 모르고 토스 오픈API로 "모의 테스트부터 하면 되겠지"라고 넘겨짚으면 나중에 계획을 다시 짜야 한다.
• 커뮤니티 래퍼와 공식 문서를 구분하지 않는 것: 래퍼 라이브러리는 편하지만 공식 스펙이 바뀌면 래퍼가 먼저 깨진다. 문제가 생겼을 때 래퍼의 이슈 트래커만 뒤지지 말고, 항상 해당 증권사의 공식 문서를 기준점으로 삼아야 한다.
• 자료가 적은 걸 "어렵다"로 착각하는 것: 토스증권처럼 신규 API는 스펙 자체는 단순해도 검증된 실패 사례가 아직 쌓이지 않았을 뿐이다. 어렵다고 피하기보다, 공식 문서를 더 천천히 읽는 쪽으로 접근하는 게 맞다.

오늘의 정리

1. 자동매매에서 API 선택은 전략보다 먼저 결정되는 갈림길이고, 인증·에러 처리·재시도 로직이 전부 그 선택에 맞춰 짜여지므로 되돌리기 비싸다.
2. 키움·한국투자증권·토스증권 모두 지금은 REST API로 수렴했지만, 인증 세부 방식과 모의투자 지원 여부는 증권사마다 다르다.
3. 모의투자를 API 레벨에서 검증하고 싶다면 키움이나 한국투자증권이, 문서·커뮤니티 자료가 가장 두꺼운 곳을 원한다면 한국투자증권이, 국내·미국 통합과 신규 트렌드를 원한다면 토스증권이 각각 유리하다.
4. "어디가 최고냐"가 아니라 "내 상황(검증 방식·서버 환경·자료 의존도)에 뭐가 맞느냐"로 질문을 바꾸는 게 이 선택의 핵심이다.

이 글에 등장하는 계좌·인증 정보는 전부 일반적인 구조 설명이며, 실제 계좌번호·API 키·서버 상세는 담고 있지 않습니다. 한국투자증권·토스증권 관련 내용은 공식 문서와 공개 자료를 근거로 확인한 범위에서만 서술했고, 확인되지 않는 부분은 추정하지 않았습니다. 이 글은 투자 조언이 아니며 특정 증권사·종목·매매기법을 추천하지 않습니다. 수익을 보장하지 않으며, 투자 손실은 투자자 본인의 책임입니다.