KUCOIN API
HomeChange LogAPI DOC V1
Language
  • 繁體中文(即將上綫)
  • Русский (скоро)
HomeChange LogAPI DOC V1
Language
  • 繁體中文(即將上綫)
  • Русский (скоро)
SDK
Telegram
Kucoin
  1. REST
  2. Futures Trading
  3. Orders
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • Rate Limit
  • Change Log
  • User Service
    • Market Making Incentive Scheme
    • VIP Fast Track
    • Broker Program
  • REST
    • Account Info
      • Account & Funding
        • Get Account Summary Info
        • 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
        • Add sub-account
        • Add sub-account Margin Permission
        • Add sub-account Futures Permission
        • Get sub-account List - Summary Info
        • Get sub-account Detail - Balance
        • Get sub-account List - Spot Balance (V2)
        • Get sub-account List - Futures Balance (V2)
      • Sub Account API
        • Add sub-account API
        • Modify sub-account API
        • Get sub-account API List
        • Delete sub-account API
      • Deposit
        • Add Deposit Address (V3)
        • Get Deposit Address (V3)
        • Get Deposit History
      • Withdrawals
        • Get Withdrawal Quotas
        • Withdraw (V3)
        • Cancel Withdrawal
        • Get Withdrawal History
        • Get Withdrawal History By ID
      • Transfer
        • Get Transfer Quotas
        • Flex Transfer
      • Trade Fee
        • Get Basic Fee - Spot/Margin
        • Get Actual Fee - Spot/Margin
        • Get Actual Fee - Futures
    • 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
    • Margin Trading
      • Market Data
        • Get Symbols - Cross Margin
        • Get ETF Info
        • Get Mark Price Detail
        • Get Margin Config
        • Get Mark Price List
        • Get Symbols - Isolated Margin
      • Orders
        • Add Order
        • Add Order Test
        • Cancel Order By OrderId
        • Cancel Order By ClientOid
        • Cancel All Orders By Symbol
        • Get Symbols With Open Order
        • Get Open Orders
        • Get Closed Orders
        • Get Trade History
        • Get Order By OrderId
        • Get Order By ClientOid
      • Debit
        • Borrow
        • Get Borrow History
        • Repay
        • Get Repay History
        • Get Interest History.
        • Modify Leverage
      • Credit
        • Get Loan Market
        • Get Loan Market Interest Rate
        • Purchase
        • Modify Purchase
        • Get Purchase Orders
        • Redeem
        • Get Redeem Orders
      • Risk Limit
        • Get Margin Risk Limit
    • Futures Trading
      • Market Data
        • Get Symbol
        • Get All Symbols
        • Get Ticker
        • Get All Tickers
        • Get Full OrderBook
        • Get Part OrderBook
        • Get Trade History
        • Get Klines
        • Get Mark Price
        • Get Spot Index Price
        • Get Interest Rate Index
        • Get Premium Index
        • Get 24hr stats
        • Get Server Time
        • Get Service Status
      • Orders
        • Add Order
          POST
        • Add Order Test
          POST
        • Batch Add Orders
          POST
        • Add Take Profit And Stop Loss Order
          POST
        • Cancel Order By OrderId
          DELETE
        • Cancel Order By ClientOid
          DELETE
        • Batch Cancel Orders
          DELETE
        • Cancel All Orders
          DELETE
        • Cancel All Stop orders
          DELETE
        • Get Order By OrderId
          GET
        • Get Order By ClientOid
          GET
        • Get Order List
          GET
        • Get Recent Closed Orders
          GET
        • Get Stop Order List
          GET
        • Get Open Order Value
          GET
        • Get Recent Trade History
          GET
        • Get Trade History
          GET
      • Positions
        • Get Margin Mode
        • Switch Margin Mode
        • Batch Switch Margin 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 Isolated Margin Risk Limit
        • Modify Isolated Margin Risk Limit
      • Funding Fees
        • Get Current Funding Rate.
        • Get Public Funding History
        • Get Private Funding History
    • 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
    • Earn
      • Purchase
      • Get Redeem Preview
      • Redeem
      • Get Savings Products
      • Get Promotion Products
      • Get Staking Products
      • Get KCS Staking Products
      • Get ETH Staking Products
      • Get Account Holding
    • VIP Lending
      • Introduction
      • Get Discount Rate Configs
      • Get Loan Info
      • Get Accounts
    • Affiliate
      • Introduction
      • Get Account
    • Broker
      • Introduction
      • Broker Application
      • Instructions
      • API Broker
        • Introduction
        • Get Broker Rebate
      • Exchange Broker
        • Introduction
        • Submit KYC
        • Get KYC Status
        • Get KYC Status List
        • Get Broker Info
        • Add sub-account
        • Get sub-account
        • Add sub-account API
        • Get sub-account API
        • Modify sub-account API
        • Delete sub-account API
        • Transfer
        • Get Transfer History
        • Get Deposit List
        • Get Deposit Detail
        • Get Withdraw Detail
        • Get Broker Rebate
  • Websocket API
    • Base Info
      • Introduction
      • Get Public Token - Spot/Margin
      • Get Private Token - Spot/Margin
      • Get Public Token - Futures
      • Get Private Token - Futures
    • Spot Trading
      • Public Channels
        • Ticker
        • All Tickers
        • Orderbook - Level1
        • Orderbook - Level5
        • Orderbook - Level50
        • Orderbook - Increment
        • Call Auction Orderbook - Level50
        • Call Auction Data
        • Klines
        • Trade
        • Symbol Snapshot
        • Market Snapshot
      • Private Channels
        • Order V2
        • Order V1
        • Balance
        • Stop Order
    • Margin Trading
      • Public Channels
        • Index Price
        • Mark Price
      • Private Channels
        • Cross Margin Position
        • Isolated Margin Position
    • Futures Trading
      • Public Channels
        • Ticker V2
        • Ticker V1
        • Orderbook - Level5
        • Orderbook - Level50
        • Orderbook- Increment
        • Klines
        • Trade
        • Instrument
        • Funding Fee Settlement
        • Symbol Snapshot
      • Private Channels
        • Orders
        • Balance
        • Positions
        • Margin Mode
        • Cross Margin Leverage
        • Stop Orders
  • Error Code
    • HTTP
    • Spot
    • Margin
    • Futures
    • Earn
    • Broker
    • CopyTrading
  • 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
      • Orders
        • Add Order - Old
        • Add Order Test - Old
        • Batch Add Orders - Old
        • Cancel Order By OrderId - Old
        • Cancel Order By ClientOid - Old
        • Batch Cancel Order - Old
        • Get Orders List - Old
        • Get Recent Orders List - Old
        • Get Order By OrderId - Old
        • Get Order By ClientOid - Old
        • Get Trade History - Old
        • Get Recent Trade History - Old
    • Margin Trading
      • Get Account Detail - Margin
      • Add Order - V1
      • Add Order Test - V1
      • Get Account List - Isolated Margin - V1
      • Get Account Detail - Isolated Margin - V1
    • Futures Trading
      • Modify Isolated Margin Auto-Deposit Status
      • Cancel All Orders - V1
  • Developing
    • Introduction
    • Websocket API
      • Add Order
      • Cancel Order
    • Get Account
    • Get Transfer Quotas
    • Flex Transfer
    • Get Account Ledger
  1. REST
  2. Futures Trading
  3. Orders

Batch Add Orders

POST
https://api-futures.kucoin.com/api/v1/orders/multi
domain:Futures
api-channel:Private
api-permission:Futures
api-rate-limit-pool:Futures
sdk-service:Futures
sdk-sub-service:Order
sdk-method-name:batchAddOrders
api-rate-limit-weight:20
Description
Place multiple order to the futures 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.
You can place up to 20 orders at one time, including limit orders, market orders, and stop orders
Please be noted that the system would hold the fees from the orders entered the orderbook in advance.
Do NOT include extra spaces in JSON strings.
Place Order Limit
The maximum limit orders for a single contract is 100 per account, and the maximum stop orders for a single contract is 50 per account.
Tips
The maximum limit orders for a single contract is 100 per account, and the maximum stop orders for a single contract is 50 per account.

Request

Authorization
Body Params application/json
array of:
clientOid
string 
required
Unique order id created by users to identify their orders, the maximum length cannot exceed 40, e.g. UUID, Only allows numbers, characters, underline(_), and separator(-)
Example:
5c52e11203aa677f33e493fb
side
enum<string> 
required
specify if the order is to 'buy' or 'sell'
Allowed values:
buysell
Example:
buy
symbol
string 
required
Symbol of the contract, Please refer to Get Symbol endpoint: symbol
Example:
XBTUSDTM
leverage
integer 
required
Used to calculate the margin to be frozen for the order. If you are to close the position, this parameter is not required.
Example:
3
type
enum<string> 
optional
specify if the order is an 'limit' order or 'market' order
Allowed values:
limitmarket
Default:
limit
Example:
limit
remark
string 
optional
remark for the order, length cannot exceed 100 utf8 characters
stop
enum<string> 
optional
Either 'down' or 'up'. If stop is used,parameter stopPrice and stopPriceType also need to be provieded.
Allowed values:
downup
stopPriceType
enum<string> 
optional
Either 'TP', 'IP' or 'MP', Need to be defined if stop is specified.
Allowed values:
TPMPIP
stopPrice
string 
optional
Need to be defined if stop is specified.
reduceOnly
boolean 
optional
A mark to reduce the position size only. Set to false by default. Need to set the position size when reduceOnly is true. If set to true, only the orders reducing the position size will be executed. If the reduce-only order size exceeds the position size, the extra size will be canceled.
Default:
false
closeOrder
boolean 
optional
A mark to close the position. Set to false by default. If closeOrder is set to true, the system will close the position and the position size will become 0. Side, Size and Leverage fields can be left empty and the system will determine the side and size automatically.
Default:
false
forceHold
boolean 
optional
A mark to forcely hold the funds for an order, even though it's an order to reduce the position size. This helps the order stay on the order book and not get canceled when the position size changes. Set to false by default. The system will forcely freeze certain amount of funds for this order, including orders whose direction is opposite to the current positions. This feature is to ensure that the order won’t be canceled by the matching engine in such a circumstance that not enough funds are frozen for the order.
Default:
false
stp
enum<string> 
optional
Self Trade Prevention is divided into these strategies: CN, CO, CB. Not supported DC at the moment.
Allowed values:
CNCOCB
marginMode
enum<string> 
optional
Margin mode: ISOLATED, CROSS, default: ISOLATED
Allowed values:
ISOLATEDCROSS
Default:
ISOLATED
price
string 
optional
Required for type is 'limit' order, indicating the operating price
Example:
0.1
size
integer 
optional
Choose one of size, qty, valueQty, Order size (Lot), must be a positive integer. The quantity unit of coin-swap contracts is size(lot), and other units are not supported.
qty
string 
optional
Choose one of size, qty, valueQty, Order size (Base currency) must be an integer multiple of the multiplier. The unit of the quantity of coin-swap is size(lot), which is not supported
valueQty
string 
optional
Choose one of size, qty, valueQty, Order size (Value), USDS-Swap correspond to USDT or USDC. The unit of the quantity of coin-swap is size(lot), which is not supported
timeInForce
enum<string> 
optional
Optional for type is 'limit' order, Time in force is a special strategy used during trading, default is GTC
Allowed values:
GTCIOC
Default:
GTC
postOnly
boolean 
optional
Optional for type is 'limit' order, post only flag, invalid when timeInForce is IOC. When postOnly is true, not allowed choose hidden or iceberg. The post-only flag ensures that the trader always pays the maker fee and provides liquidity to the order book. If any part of the order is going to pay taker fee, the order will be fully rejected.
Default:
false
hidden
boolean 
optional
Optional for type is 'limit' order, orders not displaying in order book. When hidden chose, not allowed choose postOnly.
Default:
false
iceberg
boolean 
optional
Optional for type is 'limit' order, Only visible portion of the order is displayed in the order book. When iceberg chose, not allowed choose postOnly.
Default:
false
visibleSize
string 
optional
Optional for type is 'limit' order, The maximum visible size of an iceberg order. please place order in size (lots), The units of qty (base currency) and valueQty (value) are not supported.
Example
[
  {
    "clientOid": "5c52e11203aa677f33e493fb",
    "side": "buy",
    "symbol": "XBTUSDTM",
    "leverage": 3,
    "type": "limit",
    "remark": "order remarks",
    "reduceOnly": false,
    "marginMode": "ISOLATED",
    "price": "0.1",
    "size": 1,
    "timeInForce": "GTC"
  },
  {
    "clientOid": "5c52e11203aa677f33e493fc",
    "side": "buy",
    "symbol": "XBTUSDTM",
    "leverage": 3,
    "type": "limit",
    "remark": "order remarks",
    "reduceOnly": false,
    "marginMode": "ISOLATED",
    "price": "0.1",
    "size": 1,
    "timeInForce": "GTC"
  }
]

Request 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-futures.kucoin.com/api/v1/orders/multi' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "clientOid": "5c52e11203aa677f33e493fb",
        "side": "buy",
        "symbol": "XBTUSDTM",
        "leverage": 3,
        "type": "limit",
        "remark": "order remarks",
        "reduceOnly": false,
        "marginMode": "ISOLATED",
        "price": "0.1",
        "size": 1,
        "timeInForce": "GTC"
    },
    {
        "clientOid": "5c52e11203aa677f33e493fc",
        "side": "buy",
        "symbol": "XBTUSDTM",
        "leverage": 3,
        "type": "limit",
        "remark": "order remarks",
        "reduceOnly": false,
        "marginMode": "ISOLATED",
        "price": "0.1",
        "size": 1,
        "timeInForce": "GTC"
    }
]'

Responses

🟢200OK
application/json
Body
code
string 
required
data
array [object {5}] 
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.
clientOid
string 
required
Unique order id created by users to identify their orders, the maximum length cannot exceed 40, e.g. UUID, Only allows numbers, characters, underline(_), and separator(-)
symbol
string 
required
Symbol of the contract, Please refer to Get Symbol endpoint: symbol
code
string 
required
msg
string 
required
Example
{
  "code": "200000",
  "data": [
    {
      "orderId": "235919387779985408",
      "clientOid": "5c52e11203aa677f33e493fb",
      "symbol": "XBTUSDTM",
      "code": "200000",
      "msg": "success"
    },
    {
      "orderId": "235919387855482880",
      "clientOid": "5c52e11203aa677f33e493fc",
      "symbol": "XBTUSDTM",
      "code": "200000",
      "msg": "success"
    }
  ]
}
Modified at 2025-03-19 02:11:53
Previous
Add Order Test
Next
Add Take Profit And Stop Loss Order