STOCK API HUB · DEVELOPER GUIDE

토스증권 OpenAPI 가이드

토스증권 OpenAPI의 인증·시세·종목 정보·계좌·자산·주문 명세를 살펴보세요. 현재 포털에서 제공하는 API와 요청 방식, 인증 및 공식 출처를 안내합니다.

토스증권 OpenAPI 카탈로그는 인증, 시세·종목 정보, 계좌·자산, 주문, 조건주문으로 구성됩니다. 비교적 작은 기능 묶음에서 투자 화면에 필요한 조회와 주문 흐름을 살펴볼 수 있습니다.

토스증권 API 한눈에 보기

WTS에서 발급한 클라이언트 ID·시크릿과 서버의 허용 IP 등록이 필요합니다. 계좌 API의 X-Tossinvest-Account는 요청 헤더에 입력하세요.

아래는 현재 허브 카탈로그의 분류입니다. 증권사의 전체 상품 지원이나 모든 API의 테스트 가능 여부를 뜻하지 않습니다.

계좌 식별 헤더를 요구하는 명세와 일반 시세 조회를 구분하세요. 조건주문은 일반 주문과 별도 기능이므로 조건의 유효기간과 실행 결과 확인 방법을 함께 검토하세요.

인증 명세를 먼저 열고 운영 환경과 키 발급 환경을 맞추세요. 필요한 기능을 고른 뒤 요청·응답 필드와 필수값을 확인하고, 포털에서 테스트를 지원하는 명세에 한해 요청을 실행할 수 있습니다.

인증과 주요 조회·주문 기능에서 선별한 14개 명세입니다. 기능명은 카탈로그 원본을 사용하며, 아래 API 이름을 누르면 해당 포털 명세가 열립니다.

API	방식	TR / 업무코드	엔드포인트
OAuth2 액세스 토큰 발급인증 · 인증	POST	`issueOAuth2Token`	`/oauth2/token`
현재가 조회시세·종목 정보 · 시세	GET	`getPrices`	`/api/v1/prices`
주문 생성주문 · 주문	POST	`createOrder`	`/api/v1/orders`
주문 정정주문 · 주문	POST	`modifyOrder`	`/api/v1/orders/{orderId}/modify`
주문 취소주문 · 주문	POST	`cancelOrder`	`/api/v1/orders/{orderId}/cancel`
보유 주식 조회계좌·자산 · 자산	GET	`getHoldings`	`/api/v1/holdings`
주문 목록 조회주문 · 주문 내역	GET	`getOrders`	`/api/v1/orders`
주문 상세 조회주문 · 주문 내역	GET	`getOrder`	`/api/v1/orders/{orderId}`
호가 조회시세·종목 정보 · 시세	GET	`getOrderbook`	`/api/v1/orderbook`
최근 체결 내역 조회시세·종목 정보 · 시세	GET	`getTrades`	`/api/v1/trades`
상/하한가 조회시세·종목 정보 · 시세	GET	`getPriceLimit`	`/api/v1/price-limits`
캔들 차트 조회시세·종목 정보 · 시세	GET	`getCandles`	`/api/v1/candles`
종목 기본 정보 조회시세·종목 정보 · 종목 정보	GET	`getStocks`	`/api/v1/stocks`
마켓별 전체 종목 조회시세·종목 정보 · 종목 정보	GET	`listStocks`	`/api/v1/stocks/all`

현재가 조회를 계좌 잔고와 분리해 표시하고, 가격 기준 시각과 통화를 함께 보여주는 화면을 구성합니다.

주문번호를 저장한 뒤 체결·미체결과 잔고를 대조하는 흐름을 설계합니다. 필요한 명세의 지원 여부를 먼저 확인하세요.

API 개수와 분류는 현재 Stock API Hub에 등록된 명세 기준입니다. 변경된 조건과 호출 제한은 공식 문서를 확인하세요.

연결에 성공한 작은 예제도 다른 개발자의 출발점이 됩니다. 사용한 증권사와 API 이름, 구현 목적, 해결 과정을 API 활용 레시피에 남겨 주세요. 오류를 질문할 때는 재현 조건과 오류 코드를 적고 계좌번호·토큰·앱키는 지워 주세요.