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 Either`prev_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 to`best` or `limit`. The post_only option is supported only when ord_type is set to`limit`.	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 the`smp_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.

Responses

Language

Loading…

Response

Choose an example:

application/json