KB증권 Open API는 2026년 7월 20일 베타로 오픈했고, 정식 오픈은 2026년 연내 예정입니다. KB증권 고객 안내 콘텐츠(작성 기준일 2026년 8월 28일)는 현재 이용할 수 있는 기능을 계좌·잔고 조회, 국내주식 시세·주문, 투자정보 조회로 적고 있습니다. 그런데 해외주식과 모의투자에 대해서는 같은 콘텐츠 안에서도 안내 위치에 따라 표현이 다릅니다. 이 글은 국내주식 자동매매를 넘어 해외주식 주문까지 연결하려 하거나, 실제 돈을 넣기 전에 모의 환경에서 전략을 먼저 검증하려는 개인 투자자를 위해 썼습니다. 베타 기간에 어떤 내용이 공식 안내로 확인되고 어떤 내용이 아직 확정되지 않았는지 문구별로 나누어 정리합니다.
현황: 안내 문구가 위치마다 다르게 적혀 있습니다
KB증권이 공개한 KB증권 Open API란? 시세·계좌 조회부터 자동매매 연동까지 콘텐츠는 이용 전 확인 사항을 표로 정리하고 있습니다. 이 표의 제공 기능 항목에는 계좌·잔고 조회, 국내주식 시세·주문, 투자정보 조회 등 현재 제공 중인 기능을 이용할 수 있고, 해외주식·기타 금융상품 등은 향후 확대 예정이라고 적혀 있습니다. 반면 같은 콘텐츠의 자주 묻는 질문에서는 제공 기능이 계좌·잔고 조회, 국내주식 시세·주문, 해외주식 등으로 시작해 단계적으로 확대될 예정이라고 설명합니다. 해외주식이 출발 시점부터 포함되는지, 이후 확대 대상인지가 문구마다 다르게 읽힐 수 있는 상황입니다.
모의 환경에 대한 표현도 비슷합니다. 개발자용 기술 소개 부분은 Java·Python·JavaScript·PHP·Ruby 샘플 코드 생성과 모의거래 체험 기능을 제공한다고 적고 있습니다. 그러나 자주 묻는 질문에서는 같은 기능을 설명하면서 괄호 안에 모의투자 서비스는 추후 제공 예정이라고 덧붙이고 있습니다. 두 문구를 함께 놓고 보면, 체험 수준의 모의거래 기능과 별도의 모의투자 서비스를 구분해서 이해해야 합니다. 두 안내 모두 정확한 현재 제공 범위는 기준일 현재 Open API 포털(openapi.kbsec.com)의 API 목록과 문서에서 확인하라고 공통으로 밝히고 있습니다.
변동 요인: 베타 운영과 정책에 따라 범위가 달라집니다
문구가 엇갈리는 가장 큰 배경은 서비스가 베타 단계에 있다는 점입니다. 공식 안내에 따르면 오픈 일정은 준비 상황에 따라 변경될 수 있습니다. 또한 오픈 일정, 제공 기능, API 호출 한도, 이용 가능 시간은 서비스 운영 정책에 따라 변경되거나 제한될 수 있습니다. 블로그 콘텐츠는 작성 기준일에 맞춰 쓰였고, 포털의 API 목록은 실제 배포 상황에 따라 갱신됩니다. 따라서 해외주식 주문이나 모의투자처럼 확대 예정으로 언급된 기능일수록 콘텐츠 문구보다 포털의 현재 목록을 우선해서 판단해야 합니다.
이용 제한 요인도 함께 봐야 합니다. 안내는 시스템 점검, 장애, 정책 변경이 있을 때 일부 서비스 이용이 제한될 수 있다고 밝힙니다. 초당·일일 호출 한도와 이용 가능 시간은 API별로 다를 수 있다고도 설명합니다. 같은 전략이라도 국내주식 API와 이후 추가될 수 있는 해외주식 API의 호출 한도나 이용 가능 시간이 다르면, 하나의 프로그램으로 두 시장을 처리하려는 설계는 수정이 필요할 수 있습니다. 주문 가능 상품과 시간, 오류 처리 조건은 최신 API 문서로 확인해야 한다는 것이 공식 안내의 기준입니다.
투자자·소비자 점검 사항: 문구별 판단 기준표
아래 표는 해외주식 자동매매와 모의 검증을 계획하는 투자자가 공식 안내 문구를 어떻게 읽어야 하는지 정리한 것입니다. 판단 기준은 KB증권 안내에 적힌 범위 안에서만 썼습니다.
- 국내주식 시세·주문 — 안내 문구: 현재 제공 중인 기능으로 명시되어 있습니다. — 판단: 베타 기간 이용 대상으로 볼 수 있으며, 세부 API는 포털 목록으로 확인합니다.
- 해외주식 — 안내 문구: 이용 전 확인 표에는 향후 확대 예정으로, 자주 묻는 질문에는 제공을 시작하는 기능 가운데 하나로 적혀 있습니다. — 판단: 확정 여부를 문구만으로 판단하기 어려우므로 포털 API 목록에 해외주식 시세·주문 API가 실제로 올라와 있는지 확인합니다.
- 모의거래 체험 — 안내 문구: 개발 편의를 위해 제공한다고 명시되어 있습니다. — 판단: 샘플 코드와 함께 호출 흐름을 익히는 용도로 이해하고, 체험 범위는 포털에서 확인합니다.
- 모의투자 서비스 — 안내 문구: 추후 제공 예정입니다. — 판단: 실제 자금을 넣기 전에 장기간 전략을 돌려 보는 용도로 지금 바로 쓸 수 있다고 전제하지 않습니다.
- 이용료와 거래 비용 — 안내 문구: API 이용료와 거래 수수료에는 별도 기준이 적용될 수 있습니다. — 판단: 이용료는 포털에서, 주문 수수료와 세금은 KB증권 수수료 안내에서 각각 확인합니다.
거래 비용은 따로 점검해야 합니다. 안내에 따르면 API를 통한 주문에도 거래 수수료, 유관기관 비용, 세금이 적용될 수 있습니다. KB증권이 함께 표기한 국내주식 비대면 계좌 수수료는 HTS 0.014%~0.015%, 모바일 0.119%~0.12%이며, KRX와 NXT 거래를 포함한 기준입니다. 다만 API 주문에 어느 수수료 구간이 적용되는지는 해당 콘텐츠에 명시되어 있지 않습니다. 그러므로 위 수치를 API 주문 수수료로 바로 적용하지 말고 거래 전에 KB증권 수수료 안내로 확인해야 합니다. 증권사별 수수료 수준을 비교하려는 투자자는 금융투자협회 홈페이지의 금융투자회사 공시 자료에서 수수료 관련 항목을 참고할 수 있습니다.
주문 가능 시간도 시장 운영 기준과 함께 봐야 합니다. 국내주식의 정규 매매 시간, 호가 단위 같은 시장 운영 기준은 한국거래소가 공개하는 시장 운영 자료로 확인할 수 있습니다. 여기에 더해 Open API 자체의 이용 가능 시간이 API와 운영 정책에 따라 별도로 정해질 수 있습니다. 시장이 열려 있어도 API 호출이 제한되는 시간이 있을 수 있으므로 두 기준을 함께 확인하는 편이 안전합니다.
투자자·소비자 점검 사항: 착수 전 준비 순서
해외주식 연동이나 모의 검증을 계획한다면 다음 순서로 확인하면 문구 차이에서 생기는 혼선을 줄일 수 있습니다. 각 단계는 KB증권 안내가 확인 경로로 제시한 포털 문서와 수수료 안내를 기준으로 합니다.
- 포털 API 목록에서 해외주식 시세 API와 주문 API가 각각 올라와 있는지 따로 확인합니다. 시세 조회만 제공되고 주문은 아직 없을 수도 있으므로 두 가지를 구분해서 봅니다.
- 모의거래 체험으로 토큰 발급, 요청 헤더 구성, 응답 처리 같은 호출 흐름을 먼저 점검합니다. 이 결과를 장기 전략의 성과 검증 결과로 간주하지 않습니다.
- 사용하려는 API마다 초당·일일 호출 한도와 이용 가능 시간, 오류 코드를 기록해 두고, 재시도 간격과 호출량을 그 범위 안에서 설계합니다.
- API 이용료와 주문 수수료, 유관기관 비용, 세금을 각각의 안내 경로에서 확인한 뒤 전략의 예상 비용에 반영합니다.
- 이용 가능한 고객과 계좌 종류, 상품별 거래 신청 조건을 포털에서 확인합니다. 해외주식 거래에 별도 신청 조건이 있는지도 함께 점검합니다.
이 순서를 따르면 확대 예정 기능을 전제로 프로그램을 먼저 만들었다가 실제 제공 범위와 맞지 않아 다시 고쳐야 하는 일을 줄일 수 있습니다. 특히 안내는 API마다 토큰 외에 추가 헤더나 요청값이 필요할 수 있다고 밝히고 있습니다. 해외주식 API가 추가되면 국내주식 API와 요청 형식이 같다고 전제하지 말고 해당 명세를 따로 확인해야 합니다.
전망과 유의점
공식 안내 기준으로 KB증권 Open API는 정식 오픈을 2026년 연내로 예정하고 있으며, 해외주식과 기타 금융상품은 단계적으로 확대한다는 방향을 밝히고 있습니다. 다만 일정과 제공 기능은 준비 상황과 운영 정책에 따라 달라질 수 있다고 함께 밝히고 있어, 특정 시점에 특정 기능이 열린다고 단정할 근거는 현재 자료에 없습니다. 해외주식 자동매매나 모의투자 기반 검증을 계획하는 투자자는 정식 오픈 공지와 포털 API 목록의 갱신 여부를 주기적으로 확인하는 것이 현실적인 대응입니다.
자동으로 실행되는 주문도 투자라는 점은 변하지 않습니다. KB증권은 Open API를 활용한 자동매매·알고리즘 매매에서도 자산가격 변동과 환율 변동 등에 따라 투자원금의 일부 또는 전액 손실이 발생할 수 있고, 그 손실은 투자자 본인에게 귀속된다고 안내합니다. 프로그램이 자동으로 실행되더라도 모든 투자 판단과 실행의 책임은 이용자에게 있다고도 밝히고 있습니다. 해외주식으로 범위를 넓힐 때는 환율 변동이 추가 위험 요인이 됩니다. 이 글은 공식 안내 문구를 구분해 정리한 정보 제공용 자료이며, 특정 서비스 이용이나 종목 매매를 권유하지 않습니다.