자주 묻는 질문

공통 사항

REST API 요청 시 오류가 발생합니다.

API 요청 처리 중 오류가 발생한 경우 HTTP 응답 body에 에러 코드가 함께 반환됩니다. 주요 에러 코드는 업비트 개발자 센터 레퍼런스에서 확인하실 수 있습니다.
만약 위 문서에서 확인되지 않는 오류가 발생하는 경우 해당 에러 코드를 포함하여 문의주시기 바랍니다.

IP 주소를 허용했으나 오류가 발생합니다.

로컬 네트워크에서 확인되는 IP 주소와 실제 통신에 사용하는 IP 주소가 다른 경우가 있습니다.

로컬 PC를 이용하시는 경우: 구글 등의 검색엔진에서 "what is my ip" 혹은 "내 IP 주소" 등을 검색하시어 나오는 외부 IP 주소
서버를 이용하시는 경우 : 서버의 외부망 통신에 사용하는 IP 주소

위 주소를 허용 목록에 등록하신 후 다시 시도 부탁드립니다.

유동 IP 환경에서 이용하고 싶습니다.

주문하기 및 출금하기 API를 이용하시기 위해서는 허용 IP를 필수적으로 입력해주셔야합니다. 이는 회원님의 자산을 안전하게 보호하기 위한 조치이므로, 번거로우시겠으나 클라우드 서버 혹은 IP 고정 서비스 등을 이용 부탁드리겠습니다.

시세 관련 질문

차트 보조지표를 계산하고 싶습니다.

업비트 차트의 보조지표들은 Chartiq, Tradingview 에서 제공하고 있으니 해당 사이트들을 참고하시길 바랍니다.

UBCI 지표를 API를 통해 수신하고 싶습니다.

UBCI API는 Open API로 제공해드리고 있지 않습니다. 추후 변경사항이 있을 경우 공지사항을 통해 안내드리도록 하겠습니다.

매수, 매도 (bid/ask) 결정 기준이 궁금합니다.

결정 기준은 아래와 같습니다.

매도 호가에 누군가 매수를 하면 체결은 매수(BID) 타입
매수 호가에 누군가 매도를 하면 체결은 매도(ASK) 타입

making/taking 관점에서 보면 taking의 주문 타입으로 결정이 됩니다.

체결강도를 API를 통해 수신하고 싶습니다.

현재 API를 통해 체결강도를 따로 제공해드리고 있지는 않습니다.
다만 websocket의 체결 데이터 수신을 통해 체결강도를 계산하실 수 있습니다.

[체결강도 계산식]

체결강도 = 매수체결량/매도체결량 × 100%
체결강도가 100보다 클 경우 매도보다 매수가 많은 것이며, 100보다 작을 경우는 매수보다 매도가 많다는 것을 의미

체결강도는 UTC 0시(KST 9시)부터의 매수누적체결량 / 매도누적체결량 * 100 으로 계산됩니다.
해당 계산식은 향후 서비스 운영 중 다른 형태로 별도의 고지 없이 변경될 수 있음을 참고 부탁드리겠습니다.

USDT 마켓의 원화 환산가격를 알고 싶습니다.

USDT 마켓의 원화 환산가격은 업비트 자체 마켓 시세를 통하여 계산됩니다.

KRW-USDT = KRW-BTC / USDT-BTC

거래 관련 질문

업비트 앱/웹에서 표시되는 거래내역과 API의 응답이 다릅니다.

업비트 웹/앱에서 표시되는 거래내역은 체결 목록이며, Open API에서 확인하실 수 있는 내용은 주문 목록입니다. 하나의 주문에 여러 개의 체결이 발생할 수 있으므로 두 내용은 다를 수 있습니다.

체결 목록을 확인하기 위해서는 주문 조회 API 응답의 trades 필드를 통해 확인하실 수 있습니다.

주문 리스트 조회 API에서 시장가 주문이 조회되지 않습니다.

시장가 매수 주문은 체결 후 주문 상태가 cancel, done 두 경우 모두 발생할 수 있습니다.

시장가로 체결이 일어난 후 주문 잔량이 발생하는 경우, 남은 잔량이 반환되며 cancel 처리됩니다. 대부분의 경우 소수점 아래 8자리까지 나누어 떨어지지 않는 미미한 금액이 주문 잔량으로 발생하게 됩니다.
만일 주문 잔량 없이 딱 맞아떨어지게 체결이 발생한 경우에는 주문 상태가 done이 됩니다.

[예시] 현재 가격이 30000 KRW인 디지털 자산을 시장가로 10000 KRW 값어치만큼 매수하려는 경우

매수 수량 : 10000 / 30000 = 0.33333333... => 수량은 소수점 아래 9자리 이하는 버림처리되어 0.33333333
실제 매수되는 금액 : 0.33333333 * 30000 = 9999.9999 KRW
주문 잔량 : 10000 - 9999.9999 = 0.0001 KRW

이처럼 소수점 아래 자릿수가 나누어 떨어지지 않는 시장가 매수 경우에는 소액의 잔량이 발생하여, 해당 잔량은 계좌로 반환되고 주문은 취소 처리됩니다. 시장가 매도 주문의 경우 수량을 통해 요청이 이루어지므로 나눗셈 연산이 없어 잔량이 발생하지 않습니다.

또한 주문 리스트 조회 API에는 states 필드가 있어, 여러 상태를 동시에 조회할 수 있는 점 참고 부탁드립니다.

시장가 주문 요청에 실패합니다.

시장가 주문의 경우 매수/매도할 가격을 명시하지 않으므로, price 혹은 volume 중 하나의 값만 존재해야합니다. 자세한 내용은 주문하기 API 레퍼런스 문서를 참고 부탁드립니다.

주문하기 요청 횟수 제한이 남아있는데 오류가 발생합니다.

해당 현상은 주문 요청이 일시적으로 폭증하는 상황에 주문 안정화 시스템이 동작할 때 발생합니다.

주문 안정화 시스템은 Open API 및 업비트 앱/웹 여부와 무관하게 시스템 전체에 적용됩니다. 때문에 API 요청 수 제한이 남아있더라도 안정화 시스템 동작 중에는 주문 요청에 실패할 수 있습니다.

해당 오류가 발생하는 경우 수 초 후 다시 주문 요청 부탁드립니다.