안녕하세요, 업비트 개발자 센터입니다.

업비트 Open API 이용하는 회원님의 소중한 의견을 바탕으로 새로 추가된 기능을 안내해 드립니다.

이럴 때 쓰면 좋아요

• 특정 상황(변동성 증가, 점검 등)에서 미체결 상태의 주문을 일괄적으로 취소 요청할 수 있습니다.
• 불필요한 주문 혹은 오래 방치된 미체결 주문건들을 일괄적으로 취소 요청할 수 있습니다.

함께 쓰면 좋아요

> id로 주문리스트 조회

> 체결 대기 주문 (Open Order) 조회

주문 일괄 취소 접수

👍

다양한 조건으로 일괄 주문 취소를 요청할 수 있습니다.

• cancel_side: 미체결 상태인 주문을 주문 종류에 따라 주문취소 요청할 수 있어요.
  • all: 매수, 매도 전체 (default) / ask : 매도 / bid : 매수
• 목적에 따라 특정 조건으로 필터링하여 여러 주문을 취소 요청할 수 있습니다.
  • pairs: 취소할 '종목' (예: 'KRW-BTC,KRW-ETH'면 두 종목의 미체결 주문만 취소)
  • quote_currencies: 취소할 '거래 화폐 마켓' (예: 'KRW'이면 원화마켓의 모든 미체결 주문 취소)
  • excluded_pairs: 일괄 취소에서 '제외'할 종목 설정 (예: 'KRW-BTC'면 해당 종목 이외의 모든 미체결 주문 취소)
• order_by필드를 통해 취소 접수할 주문을 최신 혹은 오래된 순으로 필터링할 수 있습니다.
• ⚠️ 어떤 파라미터도 포함하지 않고 요청 시, default 값에 따라 전체 매수/매도 대상 최근 20개 주문에 대해 취소 요청됩니다.
• ⚠️ 별도의 rate limit이 적용됩니다.(2초당 1회)
• 자세한 사항은 해당 문서에서 확인해주시길 바랍니다.
  • [API Reference] > [EXCHANGE API] > [주문] > [주문 일괄 취소 접수]

id로 주문리스트 취소 접수

👍

최대 20건까지 미체결 상태의 주문을 취소 요청 할 수 있어요.

• uuids[]혹은 identifiers[]로 최대 20개까지 주문 취소를 요청할 수 있습니다.
  • 두 필드 중 하나만 필수로 입력해야 합니다.
• ⚠️'identifiers[]필드는 2024-10-18 이후에 생성된 주문에 대해서만 제공합니다.
• 자세한 사항은 해당 문서에서 확인해주시길 바랍니다.
  • [API Reference] > [EXCHANGE API] > [주문] > [id로 주문리스트 취소 접수]

❗️

<필독> 공통 유의사항

• 주문 일괄 취소 접수, id로 주문리스트 취소 접수 모두 미체결(WAIT) 상태의 주문에 대해서만 취소 접수 요청이 가능합니다.
• 두 기능 모두 Query Parameter 형식의 요청만 지원합니다. Request Body를 통한 요청을 지원하지 않습니다.
• '취소 불가능한 상태(이미 체결이 완료된 경우, 이미 취소된 주문인 경우, 리브랜딩 등의 이유로 인한 마켓 일시 중단 등)'일시 취소 접수가 실패할 수 있습니다.

[변경 사항 적용 일정]

• 2024-12-11 (수) 적용 완료

관련하여 문의 사항이 있으시면 언제든 [email protected]으로 문의하시면 이른 시일 내에 답변드리도록 하겠습니다.

언제나 최선을 다하는 업비트가 되겠습니다.

감사합니다.