post https://{region}-api.upbit.com/v1/orders/cancel_and_new
Cancel existing order and create new order in a single request.
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
- Singapore (sg): https://sg-api.upbit.com
- Indonesia (id): https://id-api.upbit.com
- Thailand (th): https://th-api.upbit.com
Modifiable Fields and Restrictions When Reordering
- New orders can only be created for the same market and the same order side as the original order; these cannot be changed
- You may optionally set a new identifier (
new_identifier), but the identifier used for the original order to be canceled cannot be reused. - order type(
new_ord_type), volume(new_volume), price(new_price), self-matching prevention mode(new_smp_type), time in force(new_time_in_force) can be changed. - If the original order was partially filled, you can specify "remain_only" in the "new_volume" parameter to automatically set the new order volume to the remaining amount of the original order.
Required Parameters by New Order Type
The mandatory parameters based on the new order type ("new_ord_type") are as follows..
| Order Type | Required Fields |
|---|---|
| Limit | new_volume, new_price |
| Price | new_price |
| Market | new_volume |
| Best Limit Buy | new_price, new_time_in_force |
| Best Limit Sell | new_volume, new_time_in_force |
For detailed parameter examples by order type, please refer to the Create Order documentation.
New Order Creation Conditions
When making a request to this API, the new order is created only after the cancellation of the previous order has been completed. Even if the API request is successful, if the previous order is fully filled before the cancellation is finalized and thus cannot be canceled, the new order will not be created.
When making a cancel request, either "prev_order_uuid" or "prev_order_identifier" must be included.
Both parameters are optional; however, at least one must be included to specify the order to be canceled.
Form-based POST requests are no longer supported from March 1, 2022.
Due to the end of Form support, POST requests sent using URL-encoded Form data are no longer guaranteed to work properly. Please ensure that the request body is sent strictly in JSON format.
| Version | Date | Changes |
|---|---|---|
| v1.2.1 | 2025-07-02 |
Addition of Self-Match Prevention (SMP) feature
|
| v1.2.1 | 2025-07-02 |
Addition of Post Only order condition
|
| v1.1.9 | 2025-02-05 |
Addition of Cancel and New Order
|
Rate Limit
Up to 8 calls per second are allowed. This is measured on an account basis and request counts are shared within the exchange 'order' group.
API Key Permission
This API requires authentication and an API Key with the [Make Orders] permission.
If you encounter an out_of_scope error, please verify the permission settings in the API Key Management page.
If you encounter an out_of_scope error, please verify the permission settings in the API Key Management page.