바쁜 일상 속에서 실시간으로 변동하는 주식 시장을 계속 들여다보기란 쉽지 않습니다. 2026년 8월부터 전체 고객에게 개방된 토스증권 API를 활용하면, 파이썬이나 외부 AI 서비스를 연동하여 나만의 자동매매 프로그램을 구축할 수 있습니다. 이 글에서는 토스증권 오픈API의 핵심 기능부터 조건주문 설정, 계좌 개설 방법, 수수료, 그리고 연동 시 자주 겪는 오류 해결 방법까지 상세히 안내해 드립니다. 직접 프로그램을 만들어 효율적인 투자를 계획 중이라면 아래 내용을 꼼꼼히 확인해 보시기 바랍니다.
이 글은 공시-공개 자료를 정리한 정보 제공용이며 투자 권유가 아닙니다. 투자 판단과 책임은 본인에게 있습니다.
토스증권 API 핵심 기능: 국내·미국 주식 통합 관리
2026년 전면 개방된 오픈API의 특징
토스증권은 2026년 8월 13일을 기점으로 오픈API를 전체 고객에게 개방했습니다. 오픈API란 서로 다른 프로그램이 데이터를 원활하게 주고받을 수 있도록 연결해 주는 수단입니다. 이를 통해 투자자는 별도의 복잡한 HTS나 WTS를 켜지 않고도 시세 조회, 계좌 잔고 확인, 주식 주문 등의 기능을 자신의 프로그램이나 외부 서비스에 연동할 수 있습니다. 가장 큰 장점 중 하나는 국내 주식과 미국 주식을 하나의 API로 통합해서 관리할 수 있다는 점입니다. 개발 경험이 적은 초보자라도 챗GPT와 같은 AI의 도움을 받아 자연어로 명령을 내리고 주문을 실행하는 환경을 구축하는 사례가 늘고 있습니다.
조건주문의 꽃, OCO와 OTO 주문
주식 거래에서 가장 중요한 것은 매수와 매도 타이밍을 놓치지 않는 것입니다. 토스증권 API는 다양한 조건주문을 지원하여 투자자가 원하는 가격에 도달했을 때 자동으로 매매가 이루어지도록 돕습니다. 그중 대표적인 기능이 OCO(One Cancels the Other) 주문입니다. OCO는 익절가와 손절가를 동시에 설정해 두고, 한쪽 조건이 체결되면 다른 쪽 주문은 자동으로 취소되는 방식입니다. 또한 OTO(One Triggers the Other) 주문을 활용하면 첫 번째 주문이 체결된 직후 미리 설정해 둔 다음 주문이 연속해서 접수됩니다. 이런 기능들은 직접 화면을 보지 못하는 시간대나 변동성이 심한 장세에서 리스크를 관리하는 데 매우 유용합니다.
다양한 자동매매 전략 구현
오픈API가 제공하는 시세 데이터와 주문 접수 기능을 결합하면 유명한 매매 기법을 시스템으로 구현할 수 있습니다. 예를 들어, 투자금을 여러 회차로 나누어 일정 규칙에 따라 매수와 매도를 반복하는 라오어 무한매수법 같은 전략을 파이썬 코드로 자동화할 수 있습니다. 설정해 둔 하단가와 상단가 사이에 여러 개의 지정가 주문을 깔아두는 일명 ‘거미줄 매수’ 방식도 API를 통해 손쉽게 세팅할 수 있습니다. 물론 레버리지 ETF 등 변동성이 큰 종목에 분할 매수를 적용한다고 해서 손실 위험이 사라지는 것은 아니므로, 모의매매로 충분한 검증을 거친 후 실전에 도입해야 합니다.
👉 9월 코스피 급락주 하락 사유 및 외국인 순매도 규모 바로 보기
토스증권 오픈API 계좌 개설 및 키 발급 절차
365일 비대면 계좌 개설 방법
토스증권 API를 이용하려면 가장 먼저 토스증권 계좌가 필요합니다. 만 19세 이상의 내국인이라면 신분증(주민등록증 또는 운전면허증)과 본인 명의의 휴대폰을 준비해 토스 앱에서 비대면으로 간편하게 개설할 수 있습니다. 별도의 서류 제출 없이 약 5~7분 정도면 모든 절차가 끝납니다. 계좌 개설은 365일 24시간 가능하지만, 매일 밤 23시 30분부터 자정(00시 30분)까지는 시스템 점검 시간이므로 이 시간대는 피해야 합니다. 한편, 외국인, 재외국민, 법인은 비대면으로 계좌를 만들 수 없으며 임시 신분증도 사용할 수 없습니다. 만 19세 미만의 미성년자는 법정대리인이 먼저 계좌를 보유한 상태에서 별도의 절차를 통해 자녀 계좌를 개설해야 합니다.
인증 및 API 키 발급 시 주의사항
계좌 준비가 끝났다면 본격적으로 API Key를 발급받을 차례입니다. 토스증권 앱이나 웹을 통해 오픈API 사용을 신청하고 승인이 완료되면 인증 정보를 받게 됩니다. 이때 발급받는 클라이언트 ID와 인증 정보는 개인의 자산에 직접 접근할 수 있는 열쇠이므로 보안에 각별히 신경 써야 합니다. API 연동을 위해 코드를 작성할 때 가장 흔히 겪는 문제는 키 값을 복사하여 붙여넣는 과정에서 발생합니다. 눈에 보이지 않는 공백이나 줄바꿈 기호가 섞여 들어가면 인증 오류가 나면서 프로그램이 작동하지 않습니다. 반드시 복사 버튼을 활용해 정확한 값만 입력되도록 확인해야 합니다.
시세 및 잔고 조회를 위한 헤더 설정
API를 연결하면 두 겹의 인증 과정을 거칩니다. 단순히 특정 종목의 현재 시세를 조회하는 가벼운 작업은 발급받은 토큰만 있으면 충분히 호출이 가능합니다. 하지만 내 계좌의 예수금을 확인하거나 실제 주문을 넣는 등 개인 자산에 관련된 데이터를 요청할 때는 계좌 정보가 포함된 헤더(Header)를 추가로 붙여야 합니다. 이 헤더 설정이 누락되거나 형식이 틀리면 에러 코드를 반환하므로, 공식 문서의 가이드에 맞춰 파이썬이나 개발 환경에서 헤더 구조를 정확히 세팅하는 것이 중요합니다.
자동매매 프로그램 구축 단계 및 수수료 비교
직접 코딩을 통해 프로그램을 만들거나 외부 챗봇과 연결할 때, 각 단계별로 필요한 시간과 발생하는 수수료 구조를 미리 알아두면 계획을 세우는 데 큰 도움이 됩니다. 특히 투자금 규모가 커질수록 거래 수수료가 수익률에 미치는 영향이 커지므로 정확히 파악해야 합니다.
| 구축 단계 | 소요 시간 및 비용 (수수료) | 효과 및 주의사항 |
|---|---|---|
| 계좌 개설 및 입출금 | 5~7분 소요 / 입출금 수수료 무료 | 은행 및 타 증권사 연동이 자유로워 초기 자금 이동이 매우 편리함 |
| API 키 발급 및 설정 | 신청 후 즉시~반나절 / 발급 비용 없음 | 발급받은 키 유출 금지, 복사 시 공백 포함 여부 철저히 확인 |
| 국내 주식 주문 연동 | KRX 거래 시 0.015% / NXT 거래 시 0.014% | 프로그램 로직에 따른 반복 매매 시 누적되는 수수료 비용 계산 필수 |
| 미국 주식 및 조건주문 | 토스증권 해외주식 수수료율 적용 | 하나의 API로 OCO, OTO 등 고도화된 주문 전략 통합 실행 가능 |
| 모의매매 테스트 | 개발자 역량에 따라 수일 소요 | 실제 돈을 투입하기 전 시스템 오류와 수익성 검증으로 리스크 최소화 |
API 연동 시 자주 발생하는 오류와 문제 해결법
어뷰징 판정과 호출 제한(Rate Limit) 대응
프로그램이 너무 짧은 시간 안에 수백 건의 시세 조회를 요청하거나 매수/매도 주문을 반복하면, 시스템은 이를 비정상적인 접근(어뷰징)으로 판단합니다. 토스증권 API는 서버 과부하를 막기 위해 일정 시간 동안 호출 횟수를 제한하는 Rate Limit 정책을 적용하고 있습니다. 이 제한에 걸리면 조용히 호출이 차단되거나 매매 제한 조치가 내려질 수 있습니다. 이를 방지하려면 코드 내에 타이머(딜레이)를 설정하여 요청 간격을 적절히 벌려야 합니다. 불필요한 반복 호출을 줄이고 한 번에 필요한 데이터만 요청하도록 로직을 최적화하는 것이 중요합니다.
1억 원 이상 고액 주문 체결 시 필수 설정
투자금이 큰 규모로 운영될 때 예상치 못하게 마주치는 오류가 있습니다. 주문 금액이 한 번에 1억 원을 초과할 경우, 기본 설정 상태에서는 주문 접수가 거부됩니다. 고액 주문의 경우 보안과 실수 방지를 위해 추가 확인 장치를 둔 것입니다. API를 통해 1억 원 이상의 주문을 정상적으로 넣으려면 요청 파라미터 중 confirmHighValueOrder 값을 반드시 true로 설정해서 전송해야 합니다. 투자 예산이 많거나 레버리지 분할 매수 시 단위 금액이 큰 분들은 코드를 작성할 때 이 변수를 미리 확인해 두어야 매매 타이밍을 놓치지 않습니다.
체결 상태 값의 오해와 잔고 확인
API 응답으로 받는 상태 값의 의미를 정확히 이해해야 프로그램이 꼬이지 않습니다. 흔히 마주치는 함정 중 하나는 주문 상태가 CLOSED로 반환될 때 이를 ‘체결 완료’로 오해하는 것입니다. 상황에 따라 장 마감이나 조건 미충족으로 주문이 취소된 상태일 수도 있으므로, 상세 내역을 파싱하여 정확한 체결 수량을 대조해야 합니다. 또한, 예수금 조회 엔드포인트는 별도로 존재하며 통화별(원화, 달러 등)로 구분되어 반환됩니다. 국내와 미국 주식을 동시에 자동매매할 때는 통화별 잔고 데이터를 정확히 불러와서 환전 여부와 주문 한도를 실시간으로 점검하는 방어 코드를 추가해야 합니다.
자주 묻는 질문
Q. 토스증권 API 발급을 위한 기본 조건은 무엇인가요?
만 19세 이상의 내국인으로 토스증권 계좌를 정상적으로 보유하고 있어야 합니다. 신분증과 본인 명의 휴대폰으로 5~7분이면 비대면 계좌 개설이 가능하며, 이후 앱을 통해 API 발급을 신청할 수 있습니다.
Q. 미성년자 자녀의 계좌로도 API 자동매매를 할 수 있나요?
법정대리인이 먼저 계좌를 보유하고 있다면 자녀의 계좌를 개설할 수는 있습니다. 다만, API 발급 및 외부 연동의 상세 권한은 보안상 제약이 있을 수 있으니 토스증권 고객센터의 최신 가이드를 반드시 확인하시기 바랍니다.
Q. 자동매매 시 국내주식 거래 수수료는 어떻게 되나요?
토스증권 국내주식 수수료는 거래소에 따라 KRX는 0.015%, NXT는 0.014%가 적용됩니다. 프로그램이 빈번하게 거래를 일으킬 경우 수수료가 누적될 수 있으므로, 매매 로직을 설계할 때 비용을 충분히 감안해야 합니다.
Q. API를 통해 미국 주식 조건주문도 가능한가요?
네, 가능합니다. 토스증권 API의 큰 장점은 국내 주식과 미국 주식을 하나의 API로 통합하여 관리할 수 있다는 점입니다. 이를 통해 익절과 손절을 동시에 거는 OCO 주문이나 연속 주문인 OTO 기능을 양국 증시 모두에 적용할 수 있습니다.
Q. 프로그램으로 주문을 넣다가 차단될 수도 있나요?
네, 초당 수십~수백 건의 무리한 주문이나 조회를 시도하면 어뷰징으로 간주되어 Rate Limit 제한에 걸릴 수 있습니다. 또한 1억 원 이상의 주문을 넣을 때는 confirmHighValueOrder를 true로 설정하지 않으면 접수가 거부되니 유의해야 합니다.
👉 급등주 단타 실전 매매 원칙 3가지 (거래대금-분봉-손절 기준) 바로 보기
정리
토스증권 API는 국내와 미국 주식을 하나의 시스템으로 통합해 관리하고, OCO 및 OTO 같은 조건주문을 통해 정교한 자동매매 프로그램을 설계할 수 있도록 지원합니다. 계좌 개설부터 키 발급까지의 절차가 간편하지만, 코딩 과정에서 공백 포함 여부, 호출 제한(Rate Limit), 고액 주문 설정 등의 디테일을 놓치면 오류가 발생하기 쉽습니다. 직접 매매 전략을 자동화하고 싶다면 먼저 모의매매 환경에서 로직을 충분히 검증한 뒤 실전 투자에 적용해 보시기 바랍니다.
