- Introduction
- Authentication
- Enums Definitions
- Terms Definitions
- SDK
- Rate Limit
- Change Log
- User Service
- 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 - Futures
- Get Account Ledgers - Spot/Margin
- Get Account Ledgers - Trade_hf
- Get Account Ledgers - Margin_hf
- Get Account Ledgers - Futures
- Sub Account
- Sub Account API
- Deposit
- Withdrawals
- Transfer
- Trade Fee
- Account & Funding
- 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
- Add Order Sync
- Add Order Test
- Batch Add Orders
- Batch Add Orders Sync
- Cancel Order By OrderId
- Cancel Order By OrderId Sync
- Cancel Order By ClientOid
- Cancel Order By ClientOid Sync
- Cancel Partial Order
- Cancel All Orders By Symbol
- Cancel All Orders
- Modify Order
- Get Order By OrderId
- Get Order By ClientOid
- Get Symbols With Open Order
- Get Open Orders
- Get Open Orders By Page
- Get Closed Orders
- Get Trade History
- Get DCP
- Set DCP
- Add Stop Order
- Cancel Stop Order By ClientOid
- Cancel Stop Order By OrderId
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Market Data
- Margin Trading
- Market Data
- Orders
- Add OrderPOST
- Add Order TestPOST
- Cancel Order By OrderIdDELETE
- Cancel Order By ClientOidDELETE
- Cancel All Orders By SymbolDELETE
- Get Symbols With Open OrderGET
- Get Open OrdersGET
- Get Closed OrdersGET
- Get Trade HistoryGET
- Get Order By OrderIdGET
- Get Order By ClientOidGET
- Add Stop OrderPOST
- Cancel Stop Order By OrderIdDELETE
- Cancel Stop Order By ClientOidDELETE
- Batch Cancel Stop OrdersDELETE
- Get Stop Orders ListGET
- Get Stop Order By OrderIdGET
- Get Stop Order By ClientOidGET
- Add OCO OrderPOST
- Cancel OCO Order By OrderIdDELETE
- Cancel OCO Order By ClientOidDELETE
- Batch Cancel OCO OrderDELETE
- Get OCO Order By OrderIdGET
- Get OCO Order By ClientOidGET
- Get OCO Order Detail By OrderIdGET
- Get OCO Order ListGET
- Debit
- Credit
- Risk Limit
- Futures Trading
- Introduction
- Market Data
- Orders
- Add Order
- Add Order Test
- Batch Add Orders
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Batch Cancel Orders
- Cancel All Orders
- Cancel All Stop orders
- Get Order By OrderId
- Get Order By ClientOid
- Get Order List
- Get Recent Closed Orders
- Get Stop Order List
- Get Open Order Value
- Get Recent Trade History
- Get Trade History
- Positions
- Get Margin Mode
- Switch Margin Mode
- Batch Switch Margin Mode
- Get Position Mode
- Switch Position Mode
- Get Max Open Size
- Get Position Details
- Get Position List
- Get Positions History
- Get Max Withdraw Margin
- Get Cross Margin Leverage
- Modify Cross Margin Leverage
- Add Isolated Margin
- Remove Isolated Margin
- Get Cross Margin Risk Limit
- Get Cross Margin Requirement
- Get Isolated Margin Risk Limit
- Modify Isolated Margin Risk Limit
- Funding Fees
- Copy Trading
- Introduction
- Add Order
- Add Order Test
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Get Max Open Size
- Get Max Withdraw Margin
- Add Isolated Margin
- Remove Isolated Margin
- Modify Isolated Margin Risk Limit
- Modify Isolated Margin Auto-Deposit Status
- Switch Margin Mode
- Modify Cross Margin Leverage
- Get Cross Margin Requirement
- Switch Position Mode
- Convert
- Earn
- VIP Lending
- Affiliate
- Broker
- Unified API
- Websocket API
- Error Code
- 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
- Sub-account Transfer
- Get Deposit History - Old
- Internal Transfer
- Get Futures Account Transfer Out Ledger
- Get Withdrawal History - Old
- Futures Account Transfer Out
- Futures Account Transfer In
- Add Deposit Address - V1
- Withdraw - V1
- Spot Trading
- Margin Trading
- Futures Trading
- Affiliate
- Broker
- Developing
Add Stop Order
POST
https://api.kucoin.com/api/v3/hf/margin/stop-order
domain:Spot
api-channel:Private
api-permission:Margin
api-rate-limit-pool:Spot
sdk-service:Margin
sdk-sub-service:Order
sdk-method-name:addMarginStopOrder
api-rate-limit-weight:3
Description
Request
Body Params application/json
Example
//limit order
{
"clientOid": "9e64g33505cc899h55g615hd",
"side": "buy",
"symbol": "KCS-USDT",
"type": "limit",
"remark": "Test order",
"stop": "entry",
"stopPrice": "136.42",
"stp": "CB",
"isIsolated": false,
"autoRepay": false,
"autoBorrow": false,
"price": "975.07",
"size": "10.5",
"timeInForce": "GTC"
}
//market order 1
// {
// "type": "market",
// "symbol": "BTC-USDT",
// "side": "buy",
// "size": "0.00001",
// "clientOid": "5c52e11203aa677f33e493fc",
// "remark": "order remarks"
// }
//market order 2
// {
// "type": "market",
// "symbol": "BTC-USDT",
// "side": "buy",
// "funds": "1",
// "clientOid": "5c52e11203aa677f33e493fc",
// "remark": "order remarks"
// }
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.com/api/v3/hf/margin/stop-order' \
--header 'Content-Type: application/json' \
--data-raw '//limit order
{
"clientOid": "9e64g33505cc899h55g615hd",
"side": "buy",
"symbol": "KCS-USDT",
"type": "limit",
"remark": "Test order",
"stop": "entry",
"stopPrice": "136.42",
"stp": "CB",
"isIsolated": false,
"autoRepay": false,
"autoBorrow": false,
"price": "975.07",
"size": "10.5",
"timeInForce": "GTC"
}
//market order 1
// {
// "type": "market",
// "symbol": "BTC-USDT",
// "side": "buy",
// "size": "0.00001",
// "clientOid": "5c52e11203aa677f33e493fc",
// "remark": "order remarks"
// }
//market order 2
// {
// "type": "market",
// "symbol": "BTC-USDT",
// "side": "buy",
// "funds": "1",
// "clientOid": "5c52e11203aa677f33e493fc",
// "remark": "order remarks"
// }'Responses
🟢200OK
application/json
Body
Example
{
"code": "200000",
"data": {
"orderId": "vs8hoq2h6t43dlku003vff2r",
"clientOid": "9e64g33505cc899h55g615hd"
}
}Modified at 2025-11-10 09:13:58