밤 11시, 미국 증시가 막 열렸는데 눈꺼풀은 천근만근인 경험 한 번쯤 있으신가요.
분할 매수 계획도 세워두고 사고 싶은 종목도 있는데 몸이 버텨주질 않는 그 상황 말입니다.
국내 주식 앱, 해외 주식 앱, 뉴스 앱 세 개를 오가며 투자 판단을 내려야 하는 번거로움도요.
오늘은 그 불편함을 정면으로 해결하려는 시도, 토스증권이 공개한 오픈 API 서비스에 대해
기술 구조부터 실전 활용 가능성, 반드시 알아야 할 주의사항까지 깊이 있게 살펴보겠습니다.
이 글은 2026년 6월 기준 공개된 토스증권 오픈 API 사전 신청 내용을 바탕으로 작성했습니다.
서비스는 아직 정식 출시 전 단계이며, 세부 사양은 변경될 수 있습니다.
신청 전 반드시 토스증권 공식 사이트에서 최신 공고를 확인하세요.
개인 투자자가 매일 겪는 현실 — 왜 자동화가 필요한가
스마트폰으로 주식을 하는 평범한 개인 투자자의 하루를 생각해봅시다.
아침 7시 반에 눈을 뜨자마자 미국 증시 마감 결과, 환율, 보유 종목 확인.
국내 장이 열리면 또 다른 앱으로 전환.
점심에 뉴스로 오후 전략 점검.
저녁에 국내 장 마감 이후 잠깐 쉬나 싶더니 밤이 되면 미국 장이 열립니다.
미국 주식을 하는 분들은 이 고충을 잘 알 것입니다.
특정 가격대에 분할 매수를 하고 싶은데 그 가격이 언제 올지 모르니 화면을 계속 들여다봐야 합니다.
결국 피곤함에 그냥 자버리거나 수면 부족으로 다음 날 일상이 무너지는 것, 둘 중 하나입니다.
정보는 넘쳐나는데 그것을 제때 활용할 도구가 없다. 전략은 있는데 실행할 자동화 수단이 없다.
이것이 대한민국 수많은 개인 투자자들이 매일 반복하는 현실입니다.
기관과 개인 사이의 기술 격차
이 문제를 해결하기 위한 자동화 투자 도구는 기관 투자자와 전문 트레이더 세계에서는
오래전부터 존재해 왔습니다. 알고리즘 트레이딩, 퀀트 투자, 시스템 트레이딩.
특정 조건이 충족되면 자동 매수, 목표 수익률 도달 시 자동 매도.
밤에 자는 동안에도 미리 설정한 전략대로 매매가 이루어지는 환경입니다.
하지만 개인 투자자에게는 진입 장벽이 높았습니다.
비용도 만만치 않고 기술적 이해도 상당히 필요했으니까요.
여기에 최근 몇 년 사이 새로운 변수가 생겼습니다. 챗GPT로 대표되는 대형 언어 모델, AI입니다.
많은 분들이 투자 결정 시 AI에게 물어보고 있지요.
“이 종목 지금 사도 될까?”, “내 포트폴리오 분석해줘” 같은 질문들.
하지만 AI는 내 실제 계좌 정보, 보유 종목, 현재 시세를 모릅니다.
그래서 AI의 답변은 항상 일반론에 머물 수밖에 없었습니다.
만약 AI가 내 실제 포트폴리오 데이터와 실시간 시세 정보에 접근할 수 있다면?
그 판단을 바탕으로 실제 매매까지 자동으로 실행해줄 수 있다면?
바로 이 지점에서 토스증권 오픈 API가 등장했습니다.
토스증권 오픈 API란?
토스증권이 사전 신청을 시작한 오픈 API 서비스는
국내외 주식 매매를 자동화할 수 있는 공식 프로그래밍 인터페이스입니다.
API라는 단어가 낯선 분들을 위해 식당으로 비유해 설명하면 이렇습니다.
토스증권 오픈 API의 가장 핵심적인 특징은 국내 주식과 해외 주식을 하나의 통합된 인터페이스로 다룰 수 있다는 점입니다.
기존 국내 증권사 API는 대부분 국내 주식에 초점이 맞춰져 있었습니다.
해외 주식 거래 자동화에는 별도 시스템이 필요했고 두 가지를 합치는 작업은 복잡했습니다.
토스증권은 이 두 영역을 처음부터 하나의 API 환경 안에 담아냈다는 점에서 주목받고 있습니다.
기술 구조 완전 분석
1. mTLS 인증 — 보안의 기반
토스증권 오픈 API는 mTLS(상호 TLS 인증) 방식을 기반으로 서버 간 통신합니다.
일반 TLS는 서버만 자신을 인증하지만, mTLS는 서버와 클라이언트 양쪽이 서로 인증서를 주고받아 신원을 확인합니다.
쉽게 말해 서버도 “당신이 진짜 우리 API 사용 허가를 받은 사람이 맞습니까?”라고 확인하는 방식입니다.
중요: mTLS 인증서의 유효 기간은 390일입니다.
API를 지속 사용하려면 만료 전에 인증서를 갱신해야 합니다.
갱신을 놓치면 자동매매 시스템이 갑자기 작동을 멈출 수 있습니다.
2. 호출 제한 — QPM이란?
QPM은 분당 최대 요청 수(Queries Per Minute)를 의미합니다.
토스증권 오픈 API는 미니앱 기준 분당 최대 3,000 QPM 제한이 있습니다.
1분 동안 API에 최대 3,000번까지 요청을 보낼 수 있다는 의미입니다.
일반적인 개인 투자자 수준의 자동화 시스템에서는 충분한 수치이지만,
요청 빈도를 관리하는 로직을 시스템 설계 단계부터 반드시 포함해야 합니다.
3. 웹소켓 — 실시간 시세 수신
실시간 주식 시세 수신에는 웹소켓 연결을 활용합니다.
웹소켓은 한 번 연결을 맺으면 서버가 데이터를 지속적으로 밀어 넣어주는 방식으로,
REST API처럼 매번 요청을 보내지 않아도 됩니다.
토스증권의 시세 데이터는 한국거래소와 연합인포맥스로부터 수신합니다.
이 데이터는 Kafka와 Redis를 활용해 처리합니다.
Kafka는 대용량 데이터를 빠르게 전달하는 메시지 큐 시스템이고,
Redis는 속도를 위해 데이터를 메모리에 저장하는 방식입니다.
이 조합을 통해 시세 데이터 지연을 최소화한 아키텍처를 구성하고 있습니다.
4. REST API — 매매 명령 실행
잔고 조회, 주문 접수, 체결 내역 확인 등 각종 거래 기능은 REST API 방식으로 이루어집니다.
특정 URL로 정해진 형식의 요청을 보내면 서버가 해당 작업을 처리하고 결과를 반환하는 구조입니다.
예를 들어 삼성전자 10주를 시장가로 매수하거나 계좌 잔고를 조회하는 명령이 모두 이 REST API를 통해 이루어집니다.
실전 활용 가능성 3가지
1. AI 연동 — 대화하듯 투자하기
가장 혁신적인 활용 가능성은 챗GPT·클로드 같은 AI와의 연동입니다.
토스증권 API 키를 AI에 연동하면 문자 그대로 대화하듯 투자 정보를 얻을 수 있습니다.
- “내 포트폴리오 지금 분석해줘” → AI가 실제 보유 종목, 평균 매수가, 현재 시세를 실시간 조회 후 개인화된 분석 제공
- “삼성전자 현재 시세 알려줘” → 실시간 시세 즉시 응답
- “내 미국 주식 오늘 수익률 어때?” → 실제 계좌 기반 수익률 계산
기존 AI가 제공하던 일반론적 답변이 아니라 내 실제 계좌 데이터에 기반한 개인화된 분석이 가능해지는 것입니다.
2. 미국 주식 야간 자동매매 — 잠자는 동안 실행되는 전략
시차로 인해 모니터링이 어려운 미국 주식 야간 시간대에
미리 설정한 분할 매매 전략을 자동으로 실행할 수 있습니다.
예시 전략:
- 특정 미국 주식이 일정 가격 이하로 내려가면 자동 매수
- 추가 하락 시 2차 분할 매수 자동 실행
- 목표 수익률 10% 도달 시 자동 매도
이 전략을 코드로 작성해 두면 잠자는 동안에도 시스템이 알아서 실행합니다.
개인 투자자와 전문 시스템 트레이더 사이의 기술적 격차를 줄여주는 핵심 가치입니다.
3. 국내외 통합 환경 — 하나의 시스템으로 관리
국내 주식과 해외 주식을 하나의 API로 처리할 수 있다는 것은
시스템을 만드는 사람 입장에서 매우 큰 장점입니다.
아침 국내 시장과 밤 미국 시장을 모두 관리하는 통합 대시보드를 직접 만들 수 있으며,
모든 데이터가 단일 API를 통해 들어오므로 관리가 훨씬 간편해집니다.
반드시 알아야 할 주의사항 6가지
주의 1 — 수수료 계산 필수
국내 주식은 2026년 6월까지 수수료 면제이나 이후 0.015% 등이 적용될 예정입니다.
미국 주식은 0.1%입니다.
자동매매 시스템은 거래 횟수가 많아질 수 있으므로
수수료가 실제 수익에 미치는 영향을 전략 설계 단계에서 반드시 계산해야 합니다.
주의 2 — 보안 관리 책임
mTLS 인증서와 API 키는 여러분의 증권 계좌에 직접 접근할 수 있는 열쇠입니다.
외부에 노출되면 심각한 금전적 피해로 이어질 수 있습니다.
- GitHub 같은 공개 저장소에 API 키를 절대 포함하지 않을 것
- 환경 변수(.env 파일)로 분리해 관리할 것
- 인증서 파일은 별도 보안 폴더에 저장하고 접근을 제한할 것
주의 3 — 이용 약관: 반드시 지켜야 할 선
토스증권 오픈 API에는 명확한 이용 약관이 있습니다.
- 만 19세 미만 미성년자 신청 불가
- 시세 정보의 상업적 활용 및 제3자 제공 엄격 금지 — API로 받은 시세 데이터를 판매하거나 자신의 서비스에 활용해 수익을 내는 행위는 약관 위반
- 사용 목적을 개인 투자 자동화에 한정해야 함
주의 4 — 비공식 도구 tossinvest-cli 사용 위험
온라인 검색 중 tossinvest-cli라는 비공식 도구를 발견할 수 있습니다.
이 도구는 수급 데이터, AI 시그널, 스크리너, 실시간 푸시 알림, 소수점 주문 등
공식 API에서 지원하지 않는 기능들을 포함합니다.
그러나 이 도구는 토스증권 앱 내부의 비공식 웹 API를 활용하는 방식입니다.
공식적으로 제공된 인터페이스가 아닌, 앱 내부 통로를 이용하는 것입니다.
이는 이용 약관 위반에 해당할 수 있으며, 최악의 경우 계좌 이용 제한이라는 결과로 이어질 수 있습니다.
기능이 매력적으로 보여도 이런 비공식 도구의 사용은 상당한 위험을 감수하는 일입니다.
주의 5 — QPM 제한과 시스템 안정성
분당 3,000 QPM 제한을 초과하면 API 호출이 차단됩니다.
시스템 설계 시 요청 빈도를 제한하는 로직(Rate Limiter)을 반드시 포함해야 하며,
너무 짧은 간격으로 반복 요청을 보내지 않도록 주의해야 합니다.
주의 6 — mTLS 인증서 갱신 일정 관리
mTLS 인증서 유효 기간은 390일입니다.
인증서 만료를 놓치면 자동매매 시스템이 갑자기 작동을 멈춥니다.
캘린더나 알림 시스템에 갱신 일정을 등록해 두는 것을 강력히 권장합니다.
오픈 API를 활용한 투자 일상 — 어떻게 달라질까
토스증권 오픈 API를 활용한 시스템을 구축한 투자자의 하루는 이렇게 달라질 수 있습니다.
- 아침: 간밤에 자동으로 실행된 미국 주식 매매 내역이 정리되어 있음. 편하게 잠자면서도 계획한 전략이 실행됨
- 오전: AI에게 “오늘 내 포트폴리오 상황 알려줘”라고 물으면 실시간 데이터 기반으로 수익률·보유 종목 현황을 한눈에 확인
- 낮: 특정 종목이 특정 가격에 도달하면 자동 알림. 화면을 들여다보는 시간이 크게 줄어듦
- 밤: 미국 장 개장 시 분할 매수 조건을 미리 설정해두고 수면 취함. 시스템이 대신 실행
처음부터 이런 시스템을 구축하는 데는 시간과 노력이 필요합니다.
프로그래밍을 전혀 모르는 분이라면 학습 곡선이 있겠죠.
하지만 최근 AI 코딩 도구들이 크게 도와주기 때문에 예전보다 진입 장벽이 많이 낮아졌습니다.
핵심 주의사항: 아무리 좋은 자동화 도구가 있어도 잘못된 전략을 자동화하면 손실도 자동화됩니다.
올바른 전략의 품질이 시스템의 성패를 결정합니다.
감정 없이 데이터에 기반해 일관되게 실행하는 것이 오픈 API 자동매매의 본질입니다.