Creates a single order for Spot Trading on the Exchange. When an order is placed, the required funds from your account will be ringfenced for the duration of the order
Note
New endpoint
- Supports specifying both the cash amount and the quantity for market orders, regardless of whether it's a buy or sell order
Weight: 1
Certain parameters are mandatory depending on the order type
:
Type | Mandatory parameters |
---|---|
LIMIT | quantity, price |
MARKET | quantity |
LIMIT_MAKER | quantity, price |
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: |
quantity | DECIMAL | C | Order quantity in units of the instrument |
amount | DECIMAL | C | Cash amount in the units of quote asset. Market order only |
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 | |
recvWindow | LONG | Recv Window. Default 5000 | |
timestamp | LONG | Y | Timestamp |
stpMode | ENUM | C | Self Trade Prevention Mode.
|
Response Content
PARAMETER | TYPE | Example values | DESCRIPTION |
---|---|---|---|
accountId | LONG | 1467298646903017216 | Account number |
symbol | STRING | BTCUSD | Trading pair |
symbolName | STRING | BTCUSD | Trading pair name |
clientOrderId | STRING | 1690084460710352 | An ID defined by the client for the order, it will be automatically generated if it is not sent in the request |
orderId | LONG | 1470929500342690304 | System-generated order ID (up to 20 characters) |
transactTime | LONG | 1690084460716 | Timestamp in milliseconds |
price | DECIMAL | 28000 | Price |
origQty | DECIMAL | 0.01 | Quantity |
executedQty | DECIMAL | 0 | Traded Volume |
status | ENUM | NEW | Order status. See Enumeration definition for more details |
timeInForce | ENUM | GTC | Duration of the order before expiring |
type | ENUM | LIMIT | Order type. See enumeration definition for more details |
side | ENUM | BUY | BUY or SELL |
reqAmount | STRING | 0 | Requested Cash amount |
concentration | STRING | Concentration reminder message |