1
① 사전 신청하기
상단 ‘발급 페이지 열기’로 이동하면 이 화면이 떠요. 가운데 파란 ‘사전 신청하기’ 버튼만 누르면 신청 끝이에요.
- · 토스증권 계좌가 있어야 신청할 수 있어요. 계좌 없으면 토스 앱에서 먼저 개설하세요.
- · 신청은 지금도 계속 받고 있어요. 아직 정식 전체 오픈이 아니라 순차 개방 중이에요.
Loading...
토스증권토스증권 API 발급 가이드
사전신청 → 승인되면 카카오톡 알림 → PC(WTS) 우측 하단 톱니바퀴 설정의 Open API에서 Client ID·Secret을 발급하고 허용 IP를 등록하면 돼요.
권장 권한
- ✓ 계좌 조회
- ✓ 보유 자산 조회
- ✓ 주문·체결 조회
끄세요
- ✕ 주문 생성
- ✕ 주문 정정·취소
- ✕ 조건주문
단계별 안내
2
② 신청 완료 확인
사전 신청하기를 누르면 이 화면(체크 표시 + ‘사전 신청을 완료했어요’)이 떠요. 이게 보이면 접수가 끝난 거예요.
- · 대기 기간은 토스증권이 정확히 공개한 적이 없어요. 신청자 수와 시기에 따라 달라질 수 있어요.
- · 승인 순서가 되면 신청 시 등록한 카카오톡으로 알림이 와요.
3
③ 카카오톡 알림 확인
승인되면 ‘토스증권 API 출시 안내’ 알림톡이 와요. ‘토스증권 PC 바로가기’를 누르면 WTS(PC 웹)로 이동해요.
- · 알림톡을 차단해뒀다면 못 받을 수 있어요. 카카오톡 채널 차단 여부를 확인하세요.
- · PC 바로가기를 누르면 로그인 화면으로 갈 수 있어요. 로그인부터 하세요.
4
④ 톱니바퀴 설정 → Open API 발급
WTS 화면 우측 하단 톱니바퀴(설정) 아이콘을 누르고, 왼쪽 메뉴에서 Open API를 고르면 이 패널이 열려요. 여기서 Client ID·Secret 발급과 허용 IP 등록을 모두 해요.
- · Client Secret은 발급·재발급 직후에만 보여요. 바로 복사해 두세요.
- · ‘허용 IP 관리’에 손익 저널 팝업의 서버 공인 IP를 등록하세요. 등록 안 된 IP는 호출이 막혀요.
- · Client Secret은 비밀번호예요. 깃허브·카톡·디스코드에 올리지 마세요.
공식 문서: https://developers.tossinvest.com/docs
자주 묻는 질문
어떤 권한이 필요한가요?
자산 조회·주문/체결 조회만이면 충분해요. 주문·출금·이체 권한은 켜지 마세요.
IP는 어디에 넣나요?
손익 저널 → 거래소 추가 팝업에 나오는 ‘이 기기 공인 IP’를 거래소 API 화이트리스트에 등록하세요. 서버가 거래소에 접속할 때 이 주소로 보여요.
Invalid ApiKey / 인증 실패가 떠요
Access/Secret을 바꿔 넣었거나, 공백이 들어갔거나, 빗썸 API 1.0/2.0을 혼동했을 때가 많아요. 키를 재발급해 바로 붙여넣어 보세요.
출금 권한이 없어도 손익이 보이나요?
네. 실현손익·체결 내역은 조회 권한만으로 가져올 수 있어요.