Skip to main content

New Order

Type: TRADE

External endpoint: POST /fapi/v1/order
Rocky impl: POST /fapi/v1/order

Place a new order. Currently only LIMIT is supported; MARKET returns -1100 until the matching engine grows a MARKET type.

Request

POST /fapi/v1/order

Query / body params

NameTypeRequiredNotes
symbolstringyesstandard pair, e.g. BTCUSDT.
sidestringyesBUY or SELL.
typestringyesOnly LIMIT accepted today.
quantitystringyesBase-asset quantity.
pricestringyes for LIMITLimit price.
newClientOrderIdstringnoFree-form idempotency key. Auto-generated UUID if omitted.

Response — 200

{
"orderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
"clientOrderId": "my-bot-1748275200-001",
"symbol": "BTCUSDT",
"status": "NEW",
"side": "BUY",
"type": "LIMIT",
"price": "76500.00",
"origQty": "0.001",
"updateTime": 1748275200500
}

Errors

HTTPcodemsg
400-1100Unknown symbol, invalid side, or unsupported type (e.g. MARKET).
400-1102price missing on a LIMIT order.
422-2010Insufficient balance to lock the required margin.
401-2015Invalid or revoked API key.

Other standard params not yet supported: timeInForce, reduceOnly, closePosition, stopPrice, activationPrice, callbackRate, workingType, priceProtect, newOrderRespType, positionSide. Leverage is system-wide LEVERAGE_V1=10 and cannot be set per-order.