업비트 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) |
시간 단위별 시가/고가/저가/종가/거래금액/거래량 통계 조회 |
지정한 페어에 대한 캔들 데이터 조회
|
페어별 캔들 정보 수신(초/분) |
| Quotation 체결(Trade) |
체결 일시/체결 가격/체결량/체결 방향 등 체결 정보 조회 |
지정한 페어에 대한 최근 체결 내역 조회
|
페어별 실시간 체결 정보 구독 |
| Quotation 현재가(Ticker) |
최근 거래 일시/시가/고가/저가/현재가/가격 변동 정보/거래량/52주 신고가 및 신저가 등 현재가 정보 조회 |
|
페어별 실시간 현재가 정보 구독 |
| Quotation 호가(Orderbook) |
호가 매수 및 매도 호가/잔량/총 잔량 등 호가 정보 조회 |
|
페어별 실시간 호가 정보 구독 |
| Exchange 자산(Asset) |
계정이 보유한 디지털 자산 및 원화 잔고 조회 |
|
실시간 계정 잔고 변동 정보 구독 |
| Exchange 주문(Order) |
주문 생성 및 취소 |
|
- |
| 주문 조회 |
|
실시간 내 주문 생성/체결/취소 정보 구독 | |
| Exchange 출금(Withdrawal) |
출금 요청 및 취소 |
|
- |
| 출금 조회 |
|
- | |
| Exchange 입금(Deposit) |
디지털 자산 입금 주소 관리 |
|
- |
| 디지털 자산 입금 관리 |
|
- | |
| 트래블룰(계정주 확인 서비스) 관리 |
|
- | |
| 원화 입금 요청 |
|
- | |
| Exchange 서비스 정보(Service) |
입출금 서비스 지원 상태 조회 및 API Key 목록 조회 |
|
- |