Open API | 업비트 개발자 센터

개요

업비트 API의 주요 기능과 연동 순서를 한눈에 확인하세요.

업비트 API는 제공하는 정보의 성격에 따라 시세 조회(Quotation)와 거래 및 자산 관리(Exchange)의 두 가지 카테고리로 분류됩니다.

각 API 카테고리별 주요 지원 기능 및 범위는 아래와 같습니다.

	시세 조회(Quotation)	거래 및 자산 관리(Exchange)
세부 기능	페어, 캔들(OHLCV), 체결 이력, 현재가, 호가 조회	계정 자산 조회, 주문 관리, 입출금 관리 등
Open API 권한	Public API로, 인증 없이 조회 가능	Private API로, API Key를 사용한 인증 필수
API 동작 범위	조회만 지원 (과거 이력 및 실시간 조회 포함)	요청 생성(실행), 취소, 조회 지원

업비트 API는 REST API 방식과 WebSocket 방식의 연동을 모두 지원합니다. 아래 두 프로토콜을 비교한 표를 참고하여 프로그램 구현 환경 및 용도에 따라 연동하시기 바랍니다.

	REST API	WebSocket
통신 방식	요청(Request)-응답(Response)으로 동작하며 필요 시점에 요청하는 방식	최초 연결 이후 서버와의 지속적인 통신을 통해 실시간 데이터를 수신하는 스트림 방식
장점	구현 및 테스트가 직관적이고 쉬움 HTTP 기반으로 서버 환경 연동 지원 요청 시점에 명확한 데이터 확보 가능	빠른 데이터 반영과 낮은 지연 시간으로 시세 등 실시간 데이터 수신에 최적화 압축 데이터 형식 지원 등을 활용하여 트래픽 최소화 가능
단점	요청에 의해 응답하므로 실시간성 낮음 정보가 필요한 시점마다 매번 새로 요청 필요	비교적 높은 구현 난이도: ping/pong, 연결 유지 및 재연결 등 관리 필요 서버와의 연결 유지에 지속적인 리소스 할당 필요
추천 용도	주문 생성 및 취소, 입출금 요청 등 조회를 제외한 실행 작업, 비교적 긴 주기의 정보 갱신을 위한 조회 시	실시간 시세/체결 데이터 구독을 통한 자동 매매 전략 반영 및 모니터링

현재 업비트가 지원하는 전체 REST API 및 WebSocket 기능 목록은 아래와 같습니다.