Add Order - Old - KUCOIN API

It is recommended to use the POST /api/v1/hf/orders endpoint instead of this endpoint

Description

Place order to the Spot trading system, you can place two major 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.

Tips

Please note that once your order enters the order book, the system will freeze the handling fees for the order ahead of time.

Before placing orders, please be sure to fully understand the meaning of the parameters for each trading pair.

Tips

The maximum number of active orders per account is 2000, with a maximum of 200 active orders per trading pair.(including stop orders).

Public order placement request parameters

Param	Type	Mandatory	Description
clientOid	String	Yes	clientOid, the unique identifier created by the client, use of UUID, with a maximum length of 128 bits.
side	String	Yes	buy or sell
symbol	String	Yes	symbol, e.g. ETH-BTC
type	String	No	limit or market (default is limit)
remark	String	No	remark, length cannot exceed 50 characters (ASCII)
stp	String	No	self trade prevention, CN, CO, CB or DC
tradeType	String	No	The type of trading : TRADE（Spot Trade）, MARGIN_TRADE (Margin Trade). Default is TRADE. Note: To improve the system performance and to accelerate order placing and processing, KuCoin has added a new interface for order placing of margin. For traders still using the current interface, please move to the new one as soon as possible. The current one will no longer accept margin orders by May 1st, 2021 (UTC). At the time, KuCoin will notify users via the announcement, please pay attention to it.

Additional Request Parameters Required by `limit` Orders

Param	Type	Mandatory	Description
price	String	Yes	Specify price for currency
size	String	Yes	Specify quantity for currency
timeInForce	String	No	Order timing strategy `GTC`, `GTT`, `IOC`, `FOK` (The default is `GTC`)
cancelAfter	long	No	Cancel after `n` seconds，the order timing strategy is `GTT`
postOnly	boolean	No	passive order labels, this is disabled when the order timing strategy is `IOC` or `FOK`
hidden	boolean	No	Hidden or not (not shown in order book)
iceberg	boolean	No	Whether or not only visible portions of orders are shown in iceberg orders
visibleSize	String	No	Maximum visible quantity in iceberg orders

Additional request parameters required by `market` orders

Param	Type	Mandatory	Description
size	String	No	(Select one out of two: `size` or `funds`)
funds	String	No	(Select one out of two: `size` or `funds`)

Request

Body Params application/json

Example

//limit order
{
    "type": "limit",
    "symbol": "BTC-USDT",
    "side": "buy",
    "price": "50000",
    "size": "0.00001",
    "clientOid": "5c52e11203aa677f33e493fb",
    "remark": "order remarks"
}

//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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Add Order - Old

Additional Request Parameters Required by limit Orders#

Additional request parameters required by market orders#

Request

Request Code Samples

Responses

Additional Request Parameters Required by `limit` Orders

Additional request parameters required by `market` orders