KUCOIN API

Add OCO Order

POST

https://api.kucoin.com/api/v3/oco/order

domain:Spot

api-channel:Private

api-permission:Spot

api-rate-limit-pool:Spot

sdk-service:Spot

sdk-sub-service:Order

sdk-method-name:addOcoOrder

api-rate-limit-weight:2

Description

Place OCO order to the Spot trading system

Tips

The maximum untriggered stop orders for a single trading pair in one account is 20.

Request

Body Params application/json

symbol

string

required

symbol

Examples:

BTC-USDTETH-USDTKCS-USDT

side

enum<string>

required

specify if the order is to 'buy' or 'sell'

Allowed values:

buysell

Example:

buy

price

string

required

Specify price for order

size

string

required

Specify quantity for order

clientOid

string

required

Client Order Id，The ClientOid field is a unique ID created by the user（we recommend using a UUID）, and can only contain numbers, letters, underscores （_）, and hyphens （-）. This field is returned when order information is obtained. You can use clientOid to tag your orders. ClientOid is different from the order ID created by the service provider. Please do not initiate requests using the same clientOid. The maximum length for the ClientOid is 40 characters.

Please remember the orderId created by the service provider, it used to check for updates in order status.

Example:

5c52e11203aa677f33e493fb

stopPrice

string

required

trigger price.

limitPrice

string

required

The limit order price after take-profit and stop-loss are triggered.

remark

string

optional

Order placement remarks, length cannot exceed 20 characters (ASCII)

tradeType

enum<string>

optional

Transaction Type, currently only supports TRADE (spot transactions), the default is TRADE

Allowed value:

TRADE

Example

{
  "symbol": "BTC-USDT",
  "side": "buy",
  "price": "94000",
  "size": "0.1",
  "clientOid": "5c52e11203aa67f1e493fb",
  "stopPrice": "98000",
  "limitPrice": "96000",
  "remark": "this is remark",
  "tradeType": "TRADE"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kucoin.com/api/v3/oco/order' \
--header 'Content-Type: application/json' \
--data-raw '{
    "symbol": "BTC-USDT",
    "side": "buy",
    "price": "94000",
    "size": "0.1",
    "clientOid": "5c52e11203aa67f1e493fb",
    "stopPrice": "98000",
    "limitPrice": "96000",
    "remark": "this is remark",
    "tradeType": "TRADE"
}'

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

orderId

string

required

The unique order id generated by the trading system,which can be used later for further actions such as canceling the order.

Example

{
  "code": "200000",
  "data": {
    "orderId": "674c316e688dea0007c7b986"
  }
}

Modified at 2025-03-20 08:01:47

Get Stop Order By ClientOid

Cancel OCO Order By OrderId