Batch Cancel Orders

Batch cancel up to 300 orders that satisfy the specified conditions.

Check the proper endpoint based on your region.
The examples in this page is written using Singapore fiat code(SGD). Set the quote currency to match your region. The base_url differs by country/region. Make sure to specify the correct region value for your environment.

- Singapore (sg): https://sg-api.upbit.com
- Indonesia (id): https://id-api.upbit.com
- Thailand (th): https://th-api.upbit.com

Batch Cancellation Eligibility by Order Status

The Batch cancellation API can only cancel orders in the WAIT (pending) status.

However, since trades may occur during the cancellation process, the order quantity at the time of the cancellation request and the canceled order quantity after completion may differ.

Orders in a reserved state (WATCH) cannot be canceled using the Bulk Cancel API. TTo cancel these orders, use either the Cancel Order or the Cancel Orders by IDs API.


Cancellation Target Specification

To specify the orders for bulk cancellation, you can use the following criteria:

  • Order Side: Optionally cancel only buy or sell orders.
  • Pairs: Specify up to 20 pairs to include for cancellation, or specify pairs to exclude from cancellation.
  • Market (Quote Asset): Cancel orders only within a specific market.
  • Cancellation Count and Sorting Option: Cancel a specified number of orders sorted by newest or oldest first.

If any pairs included in the target pairs or target market overlap with pairs listed in the exclusion list (excluded_pairs), the exclusion list takes higher priority, and such pairs are excluded from cancellation.

Order Cancellation Request Rejection Cases
Order cancellation requests may be rejected for the following reasons:
  • Orders that have already been fully executed and cannot be canceled
  • Orders that have already been canceled
  • Orders whose pairs have been temporarily suspended due to rebranding or other reasons
  • This API supports only query parameter format.
    All request parameters must be sent as query parameters. Form or JSON format parameters in the Request Body are not supported.

    Example /v1/orders/open?cancel_side=bid
    The pair(s) and market (quote_currencies) conditions cannot be used simultaneously.
    Only one of these parameters can be included at most. If neither parameter is specified, the bulk cancellation order applies to all markets.

    Version Date Changes
    v1.1.9 2024-12-11 Addition of Batch Order Cancel
    Rate Limit
    Up to 2 calls per second are allowed. This is measured on an account basis and request counts are shared within the exchange 'order-cancel-all' group.

    API Key Permission
    This API requires authentication and an API Key with [Make Orders] permission.
    If you encounter an out_of_scope error, please verify your permissions in the API Key Management page.
    Language
    URL