新增獲利止損單

POST

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

api-channel:Private

api-permission:LeadtradeFutures

api-rate-limit-pool:CopyTrading

api-rate-limit-weight:2

sdk-service:CopyTrading

sdk-method-name:addTPSLOrder

sdk-sub-service:Futures

說明

下獲利及止損單支援獲利及止損功能，其他功能與下單界面完全相同。

您可以下兩種訂單：限價和市價。只有在您的帳戶有足夠資金的情況下才能下單。一旦下單，您的資金將在訂單期間暫停使用。保留的資金金額取決於指定的訂單類型和參數。

請注意，系統會預先保留輸入買賣盤的訂單費用。

Request

Body Params application/json

Example

{
    "clientOid": "2dad6ef608264c33bed3620be7e43fbe",
    "symbol": "XBTUSDTM",
    "marginMode": "CROSS",
    "leverage": 12,
    "positionSide": "LONG",
    "side": "buy",
    "type": "market",
    "size": 1,
    "stopPriceType": "TP",
    "triggerStopUpPrice": "111000",
    "triggerStopDownPrice": "100000",
    "timeInForce": "GTC",
    "reduceOnly": false,
    "remark": "order_remarks"
}

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/copy-trade/futures/st-orders' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientOid": "2dad6ef608264c33bed3620be7e43fbe",
    "symbol": "XBTUSDTM",
    "marginMode": "CROSS",
    "leverage": 12,
    "positionSide": "LONG",
    "side": "buy",
    "type": "market",
    "size": 1,
    "stopPriceType": "TP",
    "triggerStopUpPrice": "111000",
    "triggerStopDownPrice": "100000",
    "timeInForce": "GTC",
    "reduceOnly": false,
    "remark": "order_remarks"
}'

Responses

🟢200確認

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "orderId": "368519604659625985",
        "clientOid": "2dad6ef608264c33bed3620be7e43fbe"
    }
}

Modified at 2025-11-07 07:35:04

新增訂單測試

按 OrderId 取消訂單