Place Order

This endpoint supports to create the order USDT futures.

INFO

Open orders up limit: Futures:

Each account can hold a maximum of 500 active orders simultaneously per symbol.
Conditional orders: each account can hold a maximum of 10 active orders simultaneously per symbol.

HTTP Request

POST `/v1/trade/place-order`

NOTE

Don't include trailing slash / at the end of the endpoint. Doing so can result in a “not found” error.

Request Parameters

Parameter	Required	Type	Comments
coin	true	string	Values: `BTCUSDT`, `ETHUSDT`, `SOLUSDT`, `XRPUSDT` `1000PEPEUSDT`, `WLDUSDT`, `DOGEUSDT`, `STPTUSDT`, `SUIUSDT`, `ADAUSDT`, `ARBUSDT`, `XLMUSDT`, `HIVEUSDT`, `ONDOUSDT`
side	true	string	Values: `long`, `short`
entryPrice	true	number
leverage	true	number	Minimum: `1`
size	true	number
marginMode	true	string	Values: `Cross`, `Isolated`
type	true	string	Values: `market`, `limit`

Response Parameters

Parameter	Type	Comments
statusCode	number	`200`
result	string	Success
message	string	Placed successfully!

Parameter	Type	Comments
statusCode	number	`10001`
result	string	Bad Request
message	string	Insufficient Balance!

INFO

The ack of create order request indicates that the request is successfully accepted. Please use websocket order stream to confirm the order status.

Request Example

POST /v1/trade/place-order HTTP/1.1
Host: api.okxai.net
X-OKXAI-SIGN: XXXXX
X-OKXAI-API-KEY: XXXXX
Content-Type: application/json
 
// USDT Perp open long position (one-way mode)
{
  "coin": "BTCUSDT", 
  "side": "long", 
  "entryPrice": 50000.00, 
  "leverage": 10, 
  "size": 0.5, 
  "marginMode": "Cross", 
  "type": "market"
}

Response Example

{
  "statusCode": 200,
  "result": "Success",
  "message": "Placed successfully!",
}