증권사 오픈API 비교 2026: 한투·키움·토스·KB·NH, 어디가 가장 좋을까?

최신수정일: 2026년 10월 21일

주식을 하다 보면 종목을 찾고, 뉴스와 재무 정보를 비교하고, 주문을 하기 위해 여러 앱을 오가게 됩니다. 이런 불편을 줄이고 투자 도구를 직접 만들거나 자동화하고 싶다면 증권사 오픈API를 활용할 수 있습니다. AI에게 원하는 기능을 설명하며 프로그램을 만드는 바이브 코딩으로 이런 도구를 쉽게 만들어볼 수 있고, 이때 내 프로그램과 증권사를 잇는 통로가 증권사 오픈API입니다.

종목 스크리닝을 위해 여러 데이터가 필요하다면 키움증권, 국내 기업의 재무 분석과 여러 해외시장까지 보려면 한국투자증권 KIS를 먼저 살펴볼 만합니다. 이외에도 토스, KB 증권, NH 증권이 OpenAPI를 출시하였습니다. KB 공식 발표 · NH 출시 보도 · 토스 출시 보도

캐리는 이 다섯 곳의 API를 모두 실제 계좌에 연동해 운영하고 있습니다. 공식 문서만으로는 알 수 없었던 차이는 아래 실전 노트에 증권사별로 정리했습니다.

AI가 코드를 작성해주더라도, 사용할 수 있는 정보와 주문 방식은 증권사에 따라 달라집니다. 코딩을 모르는 투자자라면 "어느 API가 가장 큰가"보다 **"내가 원하는 투자 도구를 만들기 좋은가"**를 기준으로 고르는 편이 이해하기 쉽습니다.

한눈에 보는 5개 증권사 오픈API 비교표

공식 자료 확인 기준: 2026년 10월 21일

한국투자증권 오픈API — 기업 분석과 해외 여러 시장까지 볼 때

좋은 점: 국내 기업의 재무 자료와 투자의견을 가격·계좌 정보와 함께 활용할 수 있습니다. 미국 외에도 홍콩·중국·일본·베트남 등 해외시장 주문을 다루며, 공식 예제의 범위도 넓습니다. 호출 한도도 기본 초당 20회로 넉넉한 편입니다.

아쉬운 점: 선택지가 많은 만큼 계좌·상품·연습용 설정을 구분할 일이 많습니다. 처음부터 모든 시장을 연결하기보다 하나의 계좌와 기능으로 시작하세요.

잘 맞는 목적: 국내 기업의 매출·이익·재무 상태를 비교하거나, 여러 해외시장에 걸친 투자 현황을 보는 도구.

AI에게 부탁할 예시 프롬프트
"KIS 공식 자료로 국내 관심 종목의 매출, 이익, 부채와 현재 주가를 비교하는 표를 만들어줘. 자료의 기준 시점을 표시하고, 제공되지 않는 값은 추측해서 채우지 마."

공식 자료: KIS 전체 기능 목록 · 공식 예제 · 해외주식 주문 안내

키움증권 오픈API(REST) — 종목 찾기와 스크리너가 필요할 때

좋은 점: 거래량·등락률뿐 아니라 투자자 동향, 미국주식 관심 종목 순위 등 살펴볼 정보가 다양합니다. 국내·미국 조건검색과 모의투자를 지원하고, 실시간 조건검색은 국내·미국 각 10개까지 등록할 수 있습니다. 공식 예제와 AI 코딩 어시스턴트가 있어 출발 자료를 찾기 좋습니다.

아쉬운 점: 국내주식은 주문·조회가 각각 초당 5회로 제한됩니다. 미국주식은 평소 주문 초당 10회·조회 5회지만, 오전 9~10시(KST)에는 각각 3회로 줄어듭니다. 종목을 많이 감시하는 도구라면 이 한도를 AI에게 함께 알려주세요.

잘 맞는 목적: 내가 정한 기준에 맞는 후보를 찾고, 주문 과정을 연습하는 도구.

AI에게 부탁할 예시 프롬프트
"키움의 현재 REST API를 기준으로 거래량과 외국인 매수 동향을 보여주는 후보 목록을 만들고 싶어. 공식 조건검색으로 가능한 부분과 직접 계산할 부분을 설명해줘."

공식 자료: 키움 서비스·이용 제한 안내 · 기능 목록 · 공식 예제

토스증권 오픈API — 국내·미국주식과 조건 주문

좋은 점: 주식과 업종 순위를 살펴보고, 국내·미국주식의 계좌·주문 기능으로 이어갈 수 있습니다. 미국주식은 금액을 지정해 시장가로 매수하거나, 소수점 수량을 지정해 시장가로 매도할 수 있습니다. 국내·미국주식의 조건 주문도 지원해 가격에 따른 매수·매도, 익절·손절 연결(OCO), 매수 후 매도 연결(OTO)을 구성할 수 있습니다. 연결부터 조회까지의 시작 안내도 간결합니다.

아쉬운 점: 프로그램이 접속할 인터넷 주소를 미리 등록해야 합니다. 이를 '허용 IP 등록'이라고 하며, 등록하지 않은 곳에서는 로그인부터 막힙니다. 프로그램을 실행하는 장소나 서비스를 바꾸면 이 설정부터 다시 보세요. 미국주식 시세는 일부 거래소 기준이므로, 아주 작은 가격 차이를 활용하는 도구에는 맞지 않을 수 있습니다.

종목 순위·업종 정보는 제공하지만, 키움처럼 조건을 걸어 종목을 걸러주는 조건검색 기능은 공개 문서에서 확인되지 않습니다. 스크리너를 만들려면 조건 계산을 직접 구현해야 합니다.

잘 맞는 목적: 관심 종목과 내 계좌를 함께 보고, 소액 투자나 정해둔 매수·매도 조건을 관리하는 도구.

AI에게 부탁할 예시 프롬프트
"토스 공식 자료로 국내·미국주식 거래량 상위와 내 보유 종목을 보여줘. 두 목록을 구분하고, 거래량의 집계 기준도 표시해줘. 먼저 조회 화면만 만들자."

공식 자료: 토스 API 안내 · 시작 가이드 · 시세 관련 FAQ

KB증권 오픈API — 베타 서비스의 현재 범위를 확인할 때

KB의 공식 안내는 2026년 7월 20일 베타 시작과 연내 정식 오픈 예정을 발표했습니다. 그렇기 때문에 API 형식이 지속적으로 수정되거나 추가될 수 있음을 유의바랍니다. KB 공식 이용 안내 · 확대 계획

좋은 점: 국내·해외주식의 거래량·시가총액 등 순위 정보를 제공하며, 국내주식과 미국주식의 소수점 주문 기능도 확인됩니다. 기존 KB 계좌를 활용해 관심 종목을 찾고 소액 투자 흐름을 구성하려는 경우 살펴볼 만합니다. 전체 기능 명세를 엑셀로 내려받아 AI의 참고 자료로 쓸 수도 있습니다.

아쉬운 점: 공식 자료에 증권사 고유 약어가 많아 처음 읽기는 쉽지 않습니다. 공개 오류 목록에 없는 오류도 있습니다. 예를 들어 미국주식 시장가 매수를 보내면 G474 시장가주문은 매도만 가능합니다로 거절되는데, 이 코드는 공개된 오류 코드 목록에 없습니다(아래 실전 노트 참고).

잘 맞는 목적: 기존 KB 계좌를 유지하면서 필요한 조회와 소수점 거래 기능을 하나씩 추가하는 도구. 매수와 매도, 국내와 미국에서 같은 주문 방식이 모두 가능하다고 가정하지 마세요.

AI에게 부탁할 예시 프롬프트
"KB 개인용 API에서 내 보유 종목과 관심 종목 순위를 보여줘. 소수점 투자를 추가하려면 국내와 미국에서 각각 어떤 주문 방식과 시간 조건이 있는지 먼저 정리해줘."

공식 자료: KB 시작 가이드 · 개인용 기능·주문 목록

NH투자증권 오픈API(PLUG) — 주식·채권·금까지 함께 볼 때

좋은 점: 국내·해외주식 외에 채권, 금현물, 국내·해외 선물옵션 등 여러 상품을 다룹니다. 출시 발표 기준 수수료는 국내주식 0.01%, 해외주식 0.09%입니다. 연결에 필요한 공통 작업을 도와주는 공식 도구와 예제도 있어, 투자상품이 다양하거나 여러 계좌를 함께 보고 싶다면 검토할 이유가 있습니다.

아쉬운 점: 넓은 상품 범위와 풍부한 종목 발굴 자료는 별개입니다. 검토한 국내·해외주식 목록에서는 전용 순위·조건검색 기능이 제한적입니다. "시장에서 새로운 종목 찾기"까지 원한다면 최적의 선택은 아닙니다.

잘 맞는 목적: 주식·채권·금 등 내가 보유한 여러 종류의 자산을 정리하는 도구.

AI에게 부탁할 예시 프롬프트
"NH 계좌에서 조회할 수 있는 보유자산을 한 표로 정리하고 싶어. 내가 나무와 N2 중 무엇을 쓰는지 먼저 확인하고, 내 계좌에서 실제로 조회 가능한 상품부터 알려줘."

공식 자료: 나무 PLUG 소개 · 지원 기능 · 공식 연결 도구와 예제

직접 연동하며 확인한 차이 — 공식 문서에 없는 것들

캐리는 다섯 증권사의 API를 실제 계좌로 연동해 운영하고 있습니다. 직접 개발을 진행했던 과정을 기반으로 미리 알면 좋을 내용을 공유드립니다. AI에게 코드를 부탁할 때 해당 증권사 항목을 함께 붙여 넣으세요.

다섯 곳 모두에서 반복된 세 가지

1. "내역 없음"이 오류로 옵니다. 주문이 하나도 없는 날 미체결 조회를 하면 빈 목록 대신 오류 코드를 주는 증권사가 많습니다. 이를 진짜 오류로 처리하면 조용한 날마다 프로그램이 멈춥니다.
2. 문서의 예시 응답과 실제 응답이 다릅니다. 필드 이름, 데이터가 담기는 위치, 구분값의 의미가 예시와 달랐던 경우가 증권사마다 있었습니다. 처음 연결할 때는 실제 응답을 한 번 저장해 두고 그것을 기준으로 만드세요.

한국투자증권: 미국주식 주문가능금액이 두 개

미국주식 매수가능 조회는 금액 필드를 두 개 돌려줍니다. ord_psbl_frcr_amt(주문가능외화금액)는 결제가 끝난 달러만 계산하고, ovrs_ord_psbl_amt(해외주문가능금액)는 아직 결제되지 않은 매도 대금까지 포함합니다. 주식을 판 다음 날 앞의 필드를 쓰면 실제로는 200달러를 쓸 수 있는데 1달러만 있는 것처럼 보입니다. 매수 가능 금액에는 뒤의 필드를 쓰세요.

오류가 오는 방식도 세 갈래입니다. 계좌번호가 틀리면 HTTP 상태는 정상(200)인데 응답 안의 결과 코드만 실패(OPSQ2000, APTR0058)로 옵니다. 앱 시크릿이 틀리면 토큰 발급은 통과하고 그다음 조회에서 HTTP 500(EGW00304)이 납니다. 초당 호출 한도를 넘기면 EGW00201·EGW00215가 옵니다. HTTP 상태만 보지 말고 응답 본문의 결과 코드와 메시지를 함께 확인하도록 만드세요.

키움증권: 체결 조회는 거래소별로

국내 주문체결 조회는 거래소 구분(dmst_stex_tp)별로 따로 조회됩니다. KRX만 조회하면 SOR(자동으로 KRX·넥스트레이드 중 유리한 곳에 주문을 보내는 방식)로 처리된 체결이 보이지 않습니다. 일반 지정가 주문은 SOR로 나가는 경우가 많아, 체결된 주문이 계속 미체결로 남아 보일 수 있습니다. KRX와 SOR(필요하면 NXT)를 모두 조회해 주문번호로 합치세요.

• 미국주식 미체결이 없을 때도 오류(571758, "해당 계좌의미체결내역이 없습니다")로 옵니다. 빈 목록으로 처리하세요.
• 체결 시각은 문서 예시와 달리 09:30:15처럼 콜론이 들어간 형태로 옵니다.
• 주문가능금액 조회를 통과한 주문이 바로 다음 순간 "매수증거금이 부족합니다"로 거절된 사례가 있습니다. 조회 결과는 추정치로 보고, 거절됐을 때 알림을 띄우세요.
• 국내 계좌는 등록한 단말(IP)에서만 접속됩니다. 다른 곳에서는 저장해 둔 토큰도 거부됩니다. 프로그램을 서버로 옮기면 IP 등록부터 다시 하세요.
• 미국주식은 앱이나 HTS에서 '해외증권 위험고지'를 한 번 확인하기 전까지 모든 주문이 거절(571771)됩니다. 장이 닫힌 시간의 주문은 거절되지 않고 접수돼 다음 장을 기다립니다.

토스증권: 토큰은 하나, 체결 목록은 없음

• 같은 API 키로 토큰을 새로 받으면 이전 토큰이 즉시 끊깁니다. 노트북과 서버에서 같은 키로 프로그램을 돌리면 서로의 접속을 계속 끊습니다. 실행은 한 곳에서만 하세요.
• 체결 내역만 모아 보는 조회가 없습니다. 체결 여부를 확인하려면 주문마다 상세 조회를 해야 하는데, 주문 정보 조회 한도는 초당 6회(장 시작 직후 09:00~09:10에는 3회)입니다. 미체결 주문이 몇 개만 쌓여도 한도에 걸려 429가 납니다. 체결 확인은 반복 조회 대신 실시간 주문 이벤트(웹소켓)로 받으세요. 주문 이벤트는 연결이 유지되는 동안 누락 없이 전달됩니다.
• 레버리지 ETF처럼 토스가 해외 파생상품으로 분류하는 종목은 앱에서 요건을 갖추기 전까지 422 prerequisite-required("해외 파생상품 거래를 위한 요건이 부족합니다")로 거절됩니다. 코드 문제가 아니라 계좌 설정 문제입니다.

KB증권: 미국 시장가는 매도만

• 미국주식 시장가 매수는 G474("시장가주문은 매도만 가능합니다")로 거절됩니다. 공개된 오류 코드 목록에 없는 코드입니다. 바로 체결되길 원하면 현재가보다 약간 높은 지정가로 매수하세요.
• 투자성향이 '공격투자형'이 아니면 해외주식 주문이 "해외 주문은 공격투자형만 가능합니다"로 막힙니다. 앱에서는 안내 창을 거쳐 주문할 수 있지만 API에는 이를 넘기는 방법이 없습니다. KB 앱에서 투자성향을 다시 진단해야 합니다.
• 주문 후 1초도 안 돼 보낸 취소는 "미접수주문은 정정/취소주문이 불가능합니다"로 거절되는데, 이 취소가 수십 초 뒤 실제로 반영된 경우가 있었습니다. 취소된 원주문은 상태가 '주문접수'로 남고 취소는 별도 행으로 기록됩니다. 남은 수량은 상태명이 아니라 미체결 수량 필드로 판단하세요.
• 한국 시간 자정 이후 낸 미국주식 주문은 주문일자가 미국 거래일 기준(한국 날짜로는 전날)으로 기록됩니다.
• 해외 잔고 조회의 실제 필드 이름이 문서 예시와 달랐습니다. 잔고가 비어 있는 계좌의 예시만 보고 만들면 실제 보유 종목이 있는 계좌에서 잔고를 하나도 읽지 못합니다.

NH투자증권: 토큰 재발급은 보안 알림

• 토큰을 새로 받을 때마다 사용자에게 NH의 보안 알림이 갑니다. 프로그램이 재시작할 때마다 토큰을 받으면 알림이 쏟아집니다. 토큰은 반드시 저장해 두고 재사용하세요.
• 여러 페이지에 걸친 조회는 응답 코드 00218과 함께 헤더로 다음 페이지 키(cts)를 줍니다. 다음 요청에는 cts와 cts_flag: Y를 둘 다 보내야 하며, cts만 보내면 같은 페이지가 반복됩니다. 잔고 합계는 마지막 페이지에만 들어 있습니다.
• 주문체결 조회 결과는 문서상 객체로 표기된 Output_0에 배열로 들어옵니다. 시장 구분(orr_mkt_cd)을 비우면 거래소(코스피) 주문만 조회되므로, 코스닥까지 보려면 00을 보내세요.
• 주문이 없는 날의 체결 조회(11512), 보유하지 않은 종목의 매도가능수량 조회(16935)는 0이 아니라 오류 코드로 옵니다.
• 미국주식은 티커로 주문하지만 잔고·체결은 ISIN 코드로 돌려주고, 취소할 때 ISIN을 넣으면 거절됩니다. 주문 시점의 티커를 따로 저장해 두세요.
• 짧은 시간에 8회 정도 연속 호출하면 429가 나며, 언제 다시 시도하라는 안내(Retry-After)는 오지 않습니다.

이 차이들은 2026년 5~10월 캐리의 실제 연동에서 확인한 동작이며, 증권사가 API를 업데이트하면 달라질 수 있습니다.

AI 에이전트와 연결하기 좋은 오픈API는

AI 활용은 두 가지로 나눠보면 이해하기 쉽습니다. AI가 공식 문서를 읽고 코드를 작성하는 것, 그리고 AI가 연결된 도구로 시세·계좌 조회나 주문을 실행하는 것입니다. 전자에 도움이 되는 자료가 있다고 후자의 연결과 승인 과정까지 자동으로 완성되는 것은 아닙니다.

MCP는 AI가 외부 도구를 사용할 수 있도록 연결하는 방식입니다. 이름을 외울 필요는 없지만, 내가 쓰는 AI 앱에서 증권사가 제공한 연결 도구를 사용할 수 있는지 볼 때 등장합니다.

근거: KIS AI 도구 · 키움 공식 도구 · 토스 AI용 문서 · KB 공식 안내 · NH 공식 MCP

상황별 추천 — 어떤 증권사 오픈API를 골라야 할까

처음에는 지금 이용하는 계좌로 원하는 작업이 가능한지부터 보세요. 필요한 데이터나 주문 방식이 없을 때 다른 증권사를 비교하면 선택 기준이 분명해집니다.

종목·계좌 연결을 갖춘 AI 서비스를 함께 비교하려면 AI 에이전틱 트레이딩 서비스를, 기존 자산관리 서비스와의 차이는 로보어드바이저와 AI 에이전트 비교에서 살펴볼 수 있습니다.

캐리AI에서는 기존 계좌를 코딩이나 서버 설정 없이 연결할 수 있습니다

직접 만드는 즐거움도 있지만, 계좌를 연결해 투자에 활용하는 것이 목적이라면 준비된 서비스를 선택할 수도 있습니다.

캐리AI(Carry)는 토스·키움·NH·KB·한국투자증권의 기존 계좌 연결을 지원합니다. 번거로운 API 관리 및 서버 설정 등은 캐리가 대신 처리하므로, 직접 코드를 작성할 필요 없이 이용 중인 계좌를 연결해 시작할 수 있습니다.

캐리AI는 계좌 현황과 함께 기업 실적, 주가가 기업 가치에 비해 어느 수준인지, 외국인·기관 매매 동향, 뉴스·공시와 가격 흐름 등을 살펴보고 매매를 제안합니다. 주문은 사용자가 승인한 뒤 실행하는 방식입니다. 캐리AI 공식 안내

캐리AI에서 지원 증권사와 계좌 연결 방법 확인하기

자주 묻는 질문

Q. 코딩을 전혀 몰라도 증권사 오픈API를 쓸 수 있나요?
A. AI의 도움을 받아 시작할 수 있습니다. 다만 원하는 결과를 설명하고, 계좌 연결 절차를 진행하고, 결과가 맞는지 확인하는 일은 직접 해야 합니다. 첫 목표를 조회 화면 하나로 정하면 확인할 범위가 줄어듭니다.

Q. 증권사 오픈API는 무료인가요?
A. 검토한 공식 안내에서 별도의 API 이용료는 확인되지 않았고, 주문할 때 매매 수수료가 붙습니다. 수수료는 대부분 기존 계좌 요율을 따르며, NH는 출시 발표 기준 국내 0.01%·해외 0.09%입니다(위 '주문·연습·수수료' 표 참고). 환전 비용, 세금, AI 서비스·프로그램 운영 비용은 별도입니다.

Q. 실제 돈 없이 주문을 연습할 수 있나요?
A. 키움·KIS·NH는 모의투자를 제공하지만, 시장과 기능에 따라 지원 범위가 다릅니다. KB는 모의투자 서비스를 추후 제공할 예정이고, 토스는 모의투자 환경이 없습니다. 어떤 경우든 시세와 잔고를 읽는 화면부터 시작할 수 있습니다.

Q. 맥이나 리눅스에서도 사용할 수 있나요?
A. 현재 REST 방식의 API는 웹 통신으로 요청을 보내므로 운영체제와 무관합니다. 예전 Windows 전용 프로그램(키움 OpenAPI+ 등)과 구분하세요. 키움의 현재 REST API와 NH PLUG는 맥·리눅스 지원을 공식 안내합니다.

Q. 미국주식도 거래하고 익절·손절을 걸 수 있나요?
A. 다섯 곳 모두 개인용 API에서 미국주식을 거래할 수 있습니다. 다만 주문 방식은 다릅니다. KB는 미국 시장가 매수가 안 되고, 토스는 금액 지정 매수와 익절·손절을 묶는 조건 주문(OCO)을 지원하지만 OCO·OTO는 지정가만 허용합니다. 위 '주문·연습·수수료' 표와 실전 노트를 참고하세요.

유의사항

이 글은 API 기능을 비교한 정보이며 특정 금융상품의 매매를 권유하지 않습니다. 투자에는 원금 손실 위험이 있고, 조건 주문도 원하는 가격의 체결이나 손실 한도를 보장하지 않습니다. 서비스 범위·수수료·이용 제한은 바뀔 수 있으므로 사용 전 최신 공식 안내를 확인하세요.