Order(TRADE)
Send in a new order.
HTTP Request
POST/openapi/v1/order (HMAC SHA256)
Request Parameters
Parameter | Required | Type | Comments |
---|---|---|---|
symbol | true | string | |
assetType | false | string | |
side | true | enum | |
type | true | enum | |
timeInForce | false | enum | |
quantity | true | decimal | |
price | false | decimal | |
newClientOrderId | false | string | A unique id for the order. Automatically generated if not sent. |
stopPrice | false | decimal | Used with STOP_LOSS , STOP_LOSS_LIMIT , TAKE_PROFIT , and TAKE_PROFIT_LIMIT orders. Unavailable |
icebergQty | false | decimal | Used with LIMIT , STOP_LOSS_LIMIT , and TAKE_PROFIT_LIMIT to create an iceberg order. Unavailable |
Additional mandatory parameters based on type
:
Type | Additional mandatory parameters |
---|---|
LIMIT | timeInForce , quantity , price |
MARKET | quantity |
STOP_LOSS | quantity , stopPrice |
STOP_LOSS_LIMIT | timeInForce , quantity , price , stopPrice |
TAKE_PROFIT | quantity , stopPrice |
TAKE_PROFIT_LIMIT | timeInForce , quantity , price , stopPrice |
LIMIT_MAKER | quantity , price |
Other info:
LIMIT_MAKER
areLIMIT
orders that will be rejected if they would immediately match and trade as a taker.STOP_LOSS
andTAKE_PROFIT
will execute aMARKET
order when thestopPrice
is reached.- Any
LIMIT
orLIMIT_MAKER
type order can be made an iceberg order by sending anicebergQty
. - Any order with an
icebergQty
MUST havetimeInForce
set toGTC
.
Trigger order price rules against market price for both MARKET and LIMIT versions:
- Price above market price:
STOP_LOSS
BUY
,TAKE_PROFIT
SELL
- Price below market price:
STOP_LOSS
SELL
,TAKE_PROFIT
BUY
Response Example
{
"orderId": 28,
"clientOrderId": "6k9M212T12092"
}