AnnouncementsGuidesAPI ReferenceSupport
API Reference
Start typing to search…

Cancel And New Order

post https://EXCHANGE-REGION-ENDPOINT-URL.com/v1/orders/cancel_and_new

Cancel an order and create a new order of the same market, same order side (Bid/Ask)

Request Parameters

Name

설명

타입

prev_order_uuid *

UUID of order to cancel

String

prev_order_identifier *

User custom value for order to cancel

Eitherprev_order_uuid or prev_order_identifier must be included.

String

new_ord_type *

New order method

  • limit : Limit Order
  • price : Market Price Order(Bid)
  • market : Market Price Order(Ask)
  • best : Best Order type(time_in_force field is required)

String

new_volume *

Order Volume (Required when selling at the limit price or market price)

Please set this field to remain_only to use the remaining volume of the existing order for the volume of the new order.
**remain_only**is supported only for limit, limit IOC/FOK, market sell, and best sell orders.

NumberString or remain_only

new_price *

Order Price.

Required when selling at the limit price or market price

NumberString

new_identifier

User custom value for new order (Optional)

String (Uniq Value)

new_time_in_force

IOC, FOK, and Post Only Settings for new order (Optional)

  • ioc: Immediately executes the portion of the order that can be filled; cancels the rest. (Immediate or Cancel)
  • fok: Executes the order only if the entire quantity can be filled immediately; otherwise, the order is canceled. (Fill or Kill)
  • post_only: Places the order only if it would not immediately match with an existing order; otherwise, the order is canceled.
  • The ioc and fok options are supported only when ord_type is set tobest or limit.
  • The post_only option is supported only when ord_type is set tolimit.

String

new_smp_type

SMP (Self-Match Prevention) Type (Optional)

  • reduce : Prevent matching by reducing the volume of both orders by the matched amount when orders from the same user are matched.
  • cancel_maker : Cancel the maker order when orders from the same user are matched.
  • cancel_taker : Cancel the taker order when orders from the same user are matched.
    • **The SMP is determined by thesmp_type of the taker order. **The smp_type of the maker order does not affect the prevention logic. Please refer to the [SMP Guide] for more details.

<span style={{color:'red'}}></span>Required\ <span style={{color:'orange'}}></span> Required under specific conditions

❗️

This API only supports the application/json Content-Type format. Please note that requesting with other formats such as query parameters or form-data are not supported.

❗️

new_identifier and prev_order_identifier must be different.

The identifier is a key value that is issued directly by the user, not the UUID that is issued by the service. It is used to uniquely identify orders and must be unique for each order. Therefore, when canceling an order and placing a new one, a new identifier is required.

Additionally, if an error occurs during the request, please do not resend the request with the same identifier and generate a new identifier for each request.


Response

Field Name

Description

Type

uuid

Unique Order ID for the order to be canceled

String

side

Order Type for the order to be canceled

String

ord_type

Order Method for the order to be canceled

String

price

Currency Price at the Time of Order for the order to be canceled

NumberString

state

Order Status for the order to be canceled

String

market

Market Unique Key for the order to be canceled

String

created_at

Order Generation Time for the order to be canceled

String

volume

User Input Order Volume for the order to be canceled

NumberString

remaining_volume

Remaining Order Volume after Trade for the order to be canceled

NumberString

reserved_fee

Ratio Reserved as Fees for the order to be canceled

NumberString

remaining_fee

Remaining Fees for the order to be canceled

NumberString

paid_fee

Used Fees for the order to be canceled

NumberString

locked

Ratio being used in Transactions for the order to be canceled

NumberString

executed_volume

Traded Volume for the order to be canceled

NumberString

trades_count

The number of Transactions in the order for the order to be canceled

Integer

time_in_force

IOC, FOK, Post Only settings for the order to be canceled

String

identifier

User customized order ID for the order to be canceled

*Provided only for orders created after October 18, 2024

String

smp_type

SMP (Self-Match Prevention) Type to be canceled

String

prevented_volume

Total cancelled volume by SMP to be canceled

NumberString

prevented_locked

(Buy) The amount canceled due to the Self-Match Prevention (SMP) setting.
(Sell) The volume canceled due to the Self-Match Prevention (SMP) setting.

NumberString

new_order_uuid

Expected UUID of the new order (if succeed)

String

new_order_identifier

User customized order ID of the the new order (if succeed)

String


❗️

New Order

The new order will be placed in the same market as the existing order after the existing order (corresponding to prev_order_uuid or prev_order_identifier) has been completely canceled.

If the new order has been successfully placed, you can query it by new_order_uuid provided in the response or new_identifier specified by the user upon request.

Even if the cancel and new request is successfully submitted, a new order won’t be created if the previous existing order has been fully filled before the cancellation.

Language