Add Take Profit And Stop Loss Order

POST

https://api-futures.kucoin.com/api/v1/st-orders

api-channel:Private

api-permission:Futures

api-rate-limit-pool:Futures

sdk-service:Futures

sdk-sub-service:Order

sdk-method-name:addTPSLOrder

api-rate-limit-weight:2

Description

Place take profit and stop loss order supports both take-profit and stop-loss functions, and other functions are exactly the same as the place order interface.

You can place two types of orders: limit and market. Orders can only be placed if your account has sufficient funds. Once an order is placed, your funds will be put on hold for the duration of the order. The amount of funds on hold depends on the order type and parameters specified.

Please be noted that the system would hold the fees from the orders entered the orderbook in advance.

Request

Body Params application/json

Example

{
    "clientOid": "5c52e11203aa677f33e493fb",
    "side": "buy",
    "symbol": "XBTUSDTM",
    "leverage": 3,
    "type": "limit",
    "remark": "order remarks",
    "reduceOnly": false,
    "marginMode": "ISOLATED",
    "positionSide": "BOTH",
    "price": "0.2",
    "size": 1,
    "timeInForce": "GTC",
    "triggerStopUpPrice": "0.3",
    "triggerStopDownPrice": "0.1",
    "stopPriceType": "TP"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-futures.kucoin.com/api/v1/st-orders' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientOid": "5c52e11203aa677f33e493fb",
    "side": "buy",
    "symbol": "XBTUSDTM",
    "leverage": 3,
    "type": "limit",
    "remark": "order remarks",
    "reduceOnly": false,
    "marginMode": "ISOLATED",
    "positionSide": "BOTH",
    "price": "0.2",
    "size": 1,
    "timeInForce": "GTC",
    "triggerStopUpPrice": "0.3",
    "triggerStopDownPrice": "0.1",
    "stopPriceType": "TP"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "orderId": "234125150956625920",
        "clientOid": "5c52e11203aa677f33e493fb"
    }
}

Modified at 2025-11-10 09:13:58

Batch Add Orders

Cancel Order By OrderId