Placing Orders | Binance

These operations submit real orders. Both operations below are signed, mutating calls against your live Binance account — there is no dry-run/simulate mode. Test with small quantities first.

placeMarketOrder (ORD01)

Submits a market order — executes immediately at the best available price.

Field	Required	Description
`symbol`	✓ Yes	Trading pair, e.g. `BTCUSDT`. Automatically uppercased — Binance's wire protocol is case-sensitive and rejects a lowercase symbol.
`side`	✓ Yes	`BUY` or `SELL`.
`quantity`	Exactly one of these two	Base-asset quantity to trade.
`quoteOrderQty`	Exactly one of these two	Quote-asset amount to spend/receive instead of a base quantity. Specifying both `quantity` and `quoteOrderQty` is a validation error — exactly one is required.
`newClientOrderId`	No	Your own idempotency-style order identifier.

Output: single order record.

{
  "symbol": "BTCUSDT",
  "orderId": 28457123,
  "clientOrderId": "myOrder001",
  "side": "BUY",
  "type": "MARKET",
  "orderStatus": "FILLED",
  "executedQty": "0.00250000",
  "transactTime": 1690000000000
}

placeLimitOrder (ORD02)

Submits a limit order — rests on the book until it fills at your price or better, or is cancelled.

Field	Required	Description
`symbol`	✓ Yes	Trading pair, e.g. `BTCUSDT`. Automatically uppercased.
`side`	✓ Yes	`BUY` or `SELL`.
`timeInForce`	✓ Yes	Binance time-in-force code, e.g. `GTC`.
`quantity`	✓ Yes	Base-asset quantity to trade.
`price`	✓ Yes	Limit price.
`newClientOrderId`	No	Your own order identifier.

Output: single order record.

{
  "symbol": "BTCUSDT",
  "orderId": 28457124,
  "clientOrderId": "myOrder002",
  "side": "BUY",
  "type": "LIMIT",
  "price": "60000.00",
  "origQty": "0.00250000",
  "timeInForce": "GTC",
  "orderStatus": "NEW",
  "transactTime": 1690000000500
}

Market vs. limit: Use placeMarketOrder when you need immediate execution at whatever price is available. Use placeLimitOrder when you want a specific (or better) price and can wait — track the resulting order with getOrder / getOpenOrders.