Weight: 1

This endpoint allows you to create a new Futures order. There are two main types of orders you can place: Limit orders and Market orders. Here's how to use them:

1. Limit Order

A Limit order allows you to set a specific price at which you want to buy or sell.

To place a Limit order:

• Set "type" to "LIMIT"
• Set "priceType" to "INPUT" (this is the default, so you can omit it if you prefer)
• Specify the "price" at which you want to execute the order
• Set other required parameters like "symbol", "side", "quantity", etc.

Example:
For a Limit order to buy 10,000 contracts of ETHUSDT-PERPETUAL at a price of 3000

{
  "symbol": "ETHUSDT-PERPETUAL",
  "side": "BUY_OPEN",
  "type": "LIMIT",
  "quantity": 10000,
  "price": 3000,
  "priceType": "INPUT",
  "timeInForce": "GTC",
  "clientOrderId": "limit_order_001",
  "timestamp": 1714311403031
}

2. Market Order

A Market order is executed immediately at the best available current market price.

To place a Market order:

• Set "type" to "LIMIT"
• Set "priceType" to "MARKET"
• Do not specify a "price" (it will be ignored if included)
• Set other required parameters like "symbol", "side", "quantity", etc.

{
  "symbol": "ETHUSDT-PERPETUAL",
  "side": "SELL_OPEN",
  "type": "LIMIT",
  "quantity": 5000,
  "priceType": "MARKET",
  "timeInForce": "GTC",
  "clientOrderId": "market_order_001",
  "timestamp": 1714311503031
}

📘

Quick tip how to input your position type

BUY_OPEN: Initiating a long position by buying. This results in a long position

SELL_CLOSE: Closing a long position by selling. This reduces the long position

SELL_OPEN: Initiating a short position by selling. This results in a short position

BUY_CLOSE: Closing a short position by buying. This reduces the short position

You can get contracts' price, quantity precision configuration data in the brokerInfo endpoint.

Note: if your balance does not meet the margin requirement (which is the minimum margin requirement + open position fee + close position fee), "insufficient balance" error message will be returned.

For detailed information regarding various price types and _order types. Please refer to the explanation section in the end.

Request Parameters

Response Content

type = LIMIT

type = STOP