API Reference

Create Multiple orders by Symbol

Create orders in batches up to 20 orders at a time. Currently only support for same symbol

- Weight 5

- Upper Limit: 20 orders/ batch


Request Parameters

📘

Note

api/v1/spot/order request parameters


PARAMETER

TYPE

Req'd

DESCRIPTION

symbol

STRING

Y

Name of instrument
e.g. "BTCUSD", "ETHUSD"

side

ENUM

Y

BUY or SELL

type

ENUM

Y

Currently offer 3 order types:

-LIMIT - Limit order
- MARKET - Market order
- LIMIT_MAKER - Maker Limit order

quantity

DECIMAL

Y

Order amount in units of the instrument.
Commonly known as "orderQty"

price

DECIMAL

C

Required for LIMIT and LIMIT_MAKER order

newClientOrderId

STRING

An ID defined by the client for the order, it will be automatically generated if it is not sent in the request.

timeInForce

ENUM

-"GTC" for Limit order & Limit maker order
-"IOC" for Limit order & Market order
-"FOK" for Limit order

recvWindow

LONG

Recv Window. Default 5000

timestamp

LONG

Y

Timestamp

stpMode

ENUM

C

Self Trade Prevention Mode.
Enum: EXPIRE_TAKER, EXPIRE_MAKER
Default EXPIRE_TAKER if not specified.

📘

Note

api/v1.1/spot/order request parameters

PARAMETER

TYPE

Req'd

DESCRIPTION

symbol

STRING

Y

Name of instrument
e.g. "BTCUSD", "ETHUSD"

side

ENUM

Y

BUY or SELL

type

ENUM

Y

Currently offer 3 order types:

-LIMIT - Limit order
- MARKET - Market order
- LIMIT_MAKER - Maker Limit order

quantity

DECIMAL

Y

Order amount in units of the instrument.
Commonly known as "orderQty"

*Required if the order type is "MARKET"

amount

DECIMAL

C

Cash amount in the units of quote currency. Market order only

*Required if the order type is "MARKET"

price

DECIMAL

C

Required for LIMIT and LIMIT_MAKER order

newClientOrderId

STRING

An ID defined by the client for the order, it will be automatically generated if it is not sent in the request.

timeInForce

ENUM

-"GTC" for Limit order & Limit maker order
-"IOC" for Limit order & Market order
-"FOK" for Limit order

recvWindow

LONG

Recv Window. Default 5000

timestamp

LONG

Y

Timestamp

stpMode

ENUM

C

Self Trade Prevention Mode.
Enum: EXPIRE_TAKER, EXPIRE_MAKER
Default EXPIRE_TAKER if not specified.


Response Content


PARAMETERTYPEExample valuesDESCRIPTION
codeINTEGER0Error code
resultObject ArrayBatch order result
-codeINTEGER0Error code of an order
-msgSTRING"Create order failed"Error code
-orderObject ArrayOrder response data
order.accountIdLONG1467298646903017216Account Number
order.symbolSTRINGBTCUSDTrading pair
order.symbolNameSTRINGBTCUSDTrading pair name
order.clientOrderIdSTRING123433An ID defined by the client for the order, it will be automatically generated if it is not sent in the request
order.orderIdLONG1470929631548869632System generated order ID. A maximum of 20 characters.
order.transactTimeLONG1690084476357Millisecond timestamp
order.priceDECIMAL28000Price
order.origQtyDECIMAL0.01Quantity
order.executedQtyDECIMAL0Traded Volume
order.statusENUMFILLEDOrder status. See Enumeration definition for more details
order.timeInForceENUMGTCDuration of the order before expiring
order.typeENUMLIMITOrder type. See Enumeration definition for more details
order.sideENUMSELLBUY or SELL
order.reqAmountSTRING0Requested Cash amount
concentrationSTRINGConcentration reminder message
Language
Credentials
Header
Click Try It! to start a request and see the response here!