KUCOIN API - EU
SDK
Telegram
Kucoin
  1. Orders
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • Rate Limit
  • Classic REST
    • Account Info
      • Account & Funding
        • Get Account Summary Info
        • Get KYC Regions
        • Get Apikey Info
        • Get Account Type - Spot
        • Get Account List - Spot
        • Get Account Detail - Spot
        • Get Account - Cross Margin
        • Get Account - Isolated Margin
        • Get Account Ledgers - Spot/Margin
        • Get Account Ledgers - Trade_hf
        • Get Account Ledgers - Margin_hf
      • Sub Account
        • Add sub-account
        • Add sub-account Margin Permission
        • Get sub-account List - Summary Info
        • Get sub-account Detail - Balance
        • Get sub-account List - Spot Balance (V2)
      • Sub Account API
        • Get sub-account API List
        • Add sub-account API
        • Modify sub-account API
        • Delete sub-account API
      • Deposit
        • Add Deposit Address (V3)
        • Get Deposit Address (V3)
        • Get Deposit History
      • Withdrawals
        • Get Withdrawal Quotas
        • Withdraw (V4)
        • Cancel Withdrawal
        • Get Withdrawal History
        • Get Withdrawal History By ID
      • Transfer
        • Get Transfer Quotas
        • Flex Transfer
      • Trade Fee
        • Get Basic Fee - Spot/Margin
        • Get Actual Fee - Spot/Margin
    • Spot Trading
      • Market Data
        • Get Announcements
        • Get Currency
        • Get All Currencies
        • Get Symbol
        • Get All Symbols
        • Get Ticker
        • Get All Tickers
        • Get Trade History
        • Get Klines
        • Get Part OrderBook
        • Get Full OrderBook
        • Get Call Auction Part OrderBook
        • Get Call Auction Info
        • Get Fiat Price
        • Get 24hr Stats
        • Get Market List
        • Get Client IP Address
        • Get Server Time
        • Get Service Status
      • Orders
        • Add Order
          POST
        • Add Order Sync
          POST
        • Add Order Test
          POST
        • Batch Add Orders
          POST
        • Batch Add Orders Sync
          POST
        • Cancel Order By OrderId
          DELETE
        • Cancel Order By OrderId Sync
          DELETE
        • Cancel Order By ClientOid
          DELETE
        • Cancel Order By ClientOid Sync
          DELETE
        • Cancel Partial Order
          DELETE
        • Cancel All Orders By Symbol
          DELETE
        • Cancel All Orders
          DELETE
        • Modify Order
          POST
        • Get Order By OrderId
          GET
        • Get Order By ClientOid
          GET
        • Get Symbols With Open Order
          GET
        • Get Open Orders
          GET
        • Get Open Orders By Page
          GET
        • Get Closed Orders
          GET
        • Get Trade History
          GET
        • Get DCP
          GET
        • Set DCP
          POST
        • Add Stop Order
          POST
        • Cancel Stop Order By ClientOid
          DELETE
        • Cancel Stop Order By OrderId
          DELETE
        • Batch Cancel Stop Orders
          DELETE
        • Get Stop Orders List
          GET
        • Get Stop Order By OrderId
          GET
        • Get Stop Order By ClientOid
          GET
        • Add OCO Order
          POST
        • Cancel OCO Order By OrderId
          DELETE
        • Cancel OCO Order By ClientOid
          DELETE
        • Batch Cancel OCO Order
          DELETE
        • Get OCO Order By OrderId
          GET
        • Get OCO Order By ClientOid
          GET
        • Get OCO Order Detail By OrderId
          GET
        • Get OCO Order List
          GET
    • Margin Trading
      • Market Data
        • Get Symbols - Cross Margin
        • Get Symbols - Isolated Margin
        • Get Mark Price Detail
        • Get Margin Config
        • Get Mark Price List
        • Get Margin Collateral Ratio
        • Get Market Available Inventory
      • Orders
        • Add Order
        • Add Order Test
        • Cancel Order By OrderId
        • Cancel Order By ClientOid
        • Cancel All Orders By Symbol
        • Get Symbols With Open Order
        • Get Open Orders
        • Get Closed Orders
        • Get Trade History
        • Get Order By OrderId
        • Get Order By ClientOid
      • Debit
        • Borrow
        • Get Borrow History
        • Repay
        • Get Repay History
        • Get Interest History
        • Modify Leverage
      • Risk Limit
        • Get Margin Risk Limit
    • Earn
      • Simple Earn
        • Purchase
        • Get Redeem Preview
        • Redeem
        • Get Savings Products
        • Get Promotion Products
        • Get Account Holding
    • Broker
      • Introduction
      • Broker Application
      • Instructions
      • Broker Pro
        • Introduction
        • Broker Fast API Service
        • Get Broker Rebate
        • Get Commission
        • Get User List
        • Get User Transactions
  • Classic Websocket
    • Base Info
      • Introduction
      • Get Public Token - Classic Spot/Margin
      • Get Private Token - Classic Spot/Margin
    • Spot Trading
      • Public Channels
        • Ticker
        • All Tickers
        • Orderbook - Level 1
        • Orderbook - Level 5
        • Orderbook - Level 50
        • Orderbook - Increment
        • Call Auction Orderbook - Level 50
        • Call Auction Data
        • Klines
        • Trade
        • Symbol Snapshot
        • Market Snapshot
      • Private Channels
        • Order V2
        • Order V1
        • Balance
        • Stop Order
    • Margin Trading
      • Public Channels
        • Index Price
        • Mark Price
      • Private Channels
        • Cross Margin Position
        • Isolated Margin Position
  • Error Code
    • HTTP
    • Spot
    • Margin
    • Earn
    • Websocket
  • Abandoned Endpoints
    • Introduction
    • Account & Funding
      • Get sub-account List - Summary Info (V1)
      • Get sub-account List - Spot Balance (V1)
      • Get Deposit Addresses (V2)
      • Get Deposit Addresses - V1
      • Get Deposit History - Old
      • Get Withdrawal History - Old
      • Add Deposit Address - V1
      • Withdraw - V1
    • Spot Trading
      • Orders
        • Add Order - Old
        • Add Order Test - Old
        • Batch Add Orders - Old
        • Cancel Order By OrderId - Old
        • Cancel Order By ClientOid - Old
        • Batch Cancel Order - Old
        • Get Orders List - Old
        • Get Recent Orders List - Old
        • Get Order By OrderId - Old
        • Get Order By ClientOid - Old
        • Get Trade History - Old
        • Get Recent Trade History - Old
    • Margin Trading
      • Get Account Detail - Margin
      • Add Order - V1
      • Add Order Test - V1
      • Get Account List - Isolated Margin - V1
      • Get Account Detail - Isolated Margin - V1
  • Developing
    • Introduction
  1. Orders

Modify Order

POST
https://api.kucoin.eu/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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kucoin.eu/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
Previous
Cancel All Orders
Next
Get Order By OrderId