Place Order

Place a new futures order with support for limit and market orders, including take-profit and stop-loss settings.

HTTP Request

POST /api/v1/future/order/place-order

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
marginMode	string	Yes	Margin mode: "CROSSED" or "ISOLATED"
size	string	Yes	Order size
side	string	Yes	Position side: "LONG" or "SHORT"
tradeSide	string	Yes	Trade side: "OPEN" or "CLOSE"
orderType	string	Yes	Order type: "LIMIT" or "MARKET"
price	string	No	Order price (required for LIMIT orders)
force	string	No	Time in force: "POST_ONLY" (optional)
clientOid	string	No	Client order ID
presetTakeProfitPrice	string	No	Take profit trigger price
presetStopLossPrice	string	No	Stop loss trigger price
presetTakeProfitExecutePrice	string	No	Take profit execution price
presetStopLossExecutePrice	string	No	Stop loss execution price

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/future/order/place-order" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTCUSDT",
    "marginMode": "CROSSED",
    "size": "0.5",
    "side": "LONG",
    "tradeSide": "OPEN",
    "orderType": "LIMIT",
    "price": "40000.00",
    "clientOid": "my-order-001",
    "presetTakeProfitPrice": "42000.00",
    "presetStopLossPrice": "38000.00"
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Order response data
> orderId	string	Created order ID
> clientOid	string	Client order ID

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1763459280000,
  "data": {
    "orderId": "fu-123456789",
    "clientOid": "my-order-001"
  }
}

Error Codes

Code	Message
40001	symbol does not exist
40010	No position to close
40011	Custom ID already exists
40012	Already ordering
40013	A different margin mode is not available than the position currently opened.
40014	Open Size is too large
40015	Open Size is too small
40016	Open Size decimal precision is too high
40017	Order price is required
40018	Order price decimal precision is too high
40019	Insufficient balance
40020	Take Profit price decimal precision is too high
40021	Take Profit execute price decimal precision is too high
40022	Stop Loss price decimal precision is too high
40023	Stop Loss execute price decimal precision is too high
40024	Price is not the last price
40025	Quantity is greater than the position quantity