업비트 API의 주요 기능과 연동 순서를 한눈에 확인하세요.
업비트 API 기능 개요
업비트 API는 제공하는 정보의 성격에 따라 시세 조회(Quotation)와 거래 및 자산 관리(Exchange)의 두 가지 카테고리로 분류됩니다.
- 시세 조회 기능: 업비트 거래소에서 지원하는 모든 페어별 시세 정보(실시간 정보와 이력)를 조회할 수 있습니다.
- 거래 및 자산 관리 기능: 개인 업비트 계정과 연동하여 주문, 입출금, 자산 관리를 실행할 수 있습니다.
각 API 카테고리별 주요 지원 기능 및 범위는 아래와 같습니다.
| 시세 조회(Quotation) | 거래 및 자산 관리(Exchange) | |
|---|---|---|
| 세부 기능 | 페어, 캔들(OHLCV), 체결 이력, 현재가, 호가 조회 | 계정 자산 조회, 주문 관리, 입출금 관리 등 |
| Open API 권한 | Public API로, 인증 없이 조회 가능 | Private API로, API Key를 사용한 인증 필수 |
| API 동작 범위 | 조회만 지원 (과거 이력 및 실시간 조회 포함) | 요청 생성(실행), 취소, 조회 지원 |
업비트 API 연동 방식
업비트 API는 REST API 방식과 WebSocket 방식의 연동을 모두 지원합니다. 아래 두 프로토콜을 비교한 표를 참고하여 프로그램 구현 환경 및 용도에 따라 연동하시기 바랍니다.
| REST API | WebSocket | |
|---|---|---|
| 통신 방식 | 요청(Request)-응답(Response)으로 동작하며 필요 시점에 요청하는 방식 | 최초 연결 이후 서버와의 지속적인 통신을 통해 실시간 데이터를 수신하는 스트림 방식 |
| 장점 |
|
|
| 단점 |
|
|
| 추천 용도 | 주문 생성 및 취소, 입출금 요청 등 조회를 제외한 실행 작업, 비교적 긴 주기의 정보 갱신을 위한 조회 시 | 실시간 시세/체결 데이터 구독을 통한 자동 매매 전략 반영 및 모니터링 |
업비트 REST API 및 WebSocket 기능 목록
현재 업비트가 지원하는 전체 REST API 및 WebSocket 기능 목록은 아래와 같습니다.
| 분류 | 주요 기능 | REST API | WebSocket |
|---|---|---|---|
| Quotation 페어 (Trading Pairs) | 지원 페어 목록 조회 | 페어 목록 조회 | - |
| Quotation 캔들 (OHLCV) | 기간별 OHLCV 조회 | 초 캔들 분 캔들 일 캔들 주 캔들 월 캔들 연 캔들 | 실시간 캔들 수신 |
| Quotation 체결 (Trade) | 체결 정보 조회 | 최근 체결 내역 | 실시간 체결 수신 |
| Quotation 현재가 (Ticker) | 현재가 및 변동 정보 조회 | 페어별 현재가 마켓별 현재가 | 실시간 현재가 수신 |
| Quotation 호가 (Orderbook) | 호가 및 잔량 조회 | 호가 정보 호가 정책 | 실시간 호가 수신 |
| Exchange 포켓 (Pocket) | 포켓 및 자산 이전 관리 | 포켓 정보 포켓별 API Key 서브포켓 잔고 메인포켓 자산 이전 메인포켓 이전 목록 서브포켓 자산 이전 서브포켓 이전 목록 | - |
| Exchange 자산 (Asset) | 포켓 잔고 조회 | 포켓 잔고 | 실시간 잔고 변동 |
| Exchange 주문 (Order) | 주문 생성 및 취소 | 주문 생성 주문 생성 테스트 개별 주문 취소 지정 주문 목록 취소 주문 일괄 취소 취소 후 재주문 | - |
| Exchange 주문 (Order) | 주문 조회 | 주문 가능 정보 개별 주문 주문 목록 체결 대기 주문 종료 주문 | 실시간 주문·체결 정보 |
| Exchange 출금 (Withdrawal) | 출금 요청 및 취소 | 디지털 자산 출금 원화 출금 출금 취소 | - |
| Exchange 출금 (Withdrawal) | 출금 조회 | 출금 가능 정보 출금 허용 주소 개별 출금 출금 목록 | - |
| Exchange 입금 (Deposit) | 입금 주소 관리 | 입금 주소 생성 개별 입금 주소 입금 주소 목록 | - |
| Exchange 입금 (Deposit) | 디지털 자산 입금 조회 | 입금 가능 통화 개별 입금 입금 목록 | - |
| Exchange 입금 (Deposit) | 트래블룰 관리 | 지원 거래소 목록 UUID 검증 TXID 검증 | - |
| Exchange 입금 (Deposit) | 원화 입금 | 원화 입금 | - |
| Exchange 서비스 정보 (Service) | 서비스 상태 및 API Key 조회 | 입출금 서비스 상태 API Key 목록 | - |
| Service 공지사항 (Announcement) | 공지 게시·변경 정보 수신 | - | 실시간 공지사항 수신 |