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