Modify Order

POST

https://api.kucoin.com/api/v1/hf/orders/alter

api-channel:Private

api-permission:Spot

api-rate-limit-pool:Spot

sdk-service:Spot

sdk-sub-service:Order

sdk-method-name:modifyOrder

api-rate-limit-weight:1

Description

This interface can modify the price and quantity of the order according to orderId or clientOid.

The implementation of this interface is: Cancel the order and place a new order on the same trading pair, and return the modification result to the client synchronously.

When the quantity of the new order updated by the user is less than the filled quantity of this order, the order will be considered as completed, and the order will be canceled, and no new order will be placed.

Request

Body Params application/json

Example

{
    "symbol": "BTC-USDT",
    "orderId": "670fd33bf9406e0007ab3945",
    "newPrice": "30000",
    "newSize": "0.0001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kucoin.com/api/v1/hf/orders/alter' \
--header 'Content-Type: application/json' \
--data-raw '{
    "symbol": "BTC-USDT",
    "orderId": "670fd33bf9406e0007ab3945",
    "newPrice": "30000",
    "newSize": "0.0001"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "newOrderId": "67112258f9406e0007408827",
        "clientOid": "client order id 12"
    }
}

Modified at 2025-11-12 07:54:53

Cancel All Orders

Get Order By OrderId