Sign in
Trade

New Order (TRADE)

Send in a new order.

  • LIMIT_MAKER are LIMIT orders that will be rejected if they would immediately match and trade as a taker.
  • STOP_LOSS and TAKE_PROFIT will execute a MARKET order when the stopPrice is reached.
  • Any LIMIT or LIMIT_MAKER type order can be made an iceberg order by sending an icebergQty.
  • Any order with an icebergQty MUST have timeInForce set to GTC.
  • MARKET orders using quantity specifies how much a user wants to buy or sell based on the market price.
  • MARKET orders using quoteOrderQty specifies the amount the user wants to spend (when buying) or receive (when selling) of the quote asset; the correct quantity will be determined based on the market liquidity and quoteOrderQty.
  • MARKET orders using quoteOrderQty will not break LOT_SIZE filter rules; the order will execute a quantity that will have the notional value as close as possible to quoteOrderQty.
  • same newClientOrderId can be accepted only when the previous one is filled, otherwise the order will be rejected.

Trigger order price rules against market price for both MARKET and LIMIT versions:

  • Price above market price: STOP_LOSS BUY, TAKE_PROFIT SELL
  • Price below market price: STOP_LOSS SELL, TAKE_PROFIT BUY

Weight(IP): 1

post/api/v3/order

Query parameters

symbolstring required
Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

side'SELL' | 'BUY' required
Example:SELL
type'LIMIT' | 'MARKET' | 'STOP_LOSS' | 'STOP_LOSS_LIMIT' | 'TAKE_PROFIT' | 'TAKE_PROFIT_LIMIT' | 'LIMIT_MAKER' required
Example:LIMIT

Order type

timeInForce'GTC' | 'IOC' | 'FOK'
Example:GTC

Order time in force

quantitynumber double
Example:1

Order quantity

quoteOrderQtynumber double

Quote quantity

pricenumber double
Example:219

Order price

newClientOrderIdstring

Used to uniquely identify this cancel. Automatically generated by default

strategyIdinteger
strategyTypeinteger

The value cannot be less than 1000000.

stopPricenumber double
Example:221.01

Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.

trailingDeltanumber double

Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.

icebergQtynumber double

Used with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order.

newOrderRespType'ACK' | 'RESULT' | 'FULL'

Set the response JSON. MARKET and LIMIT order types default to FULL, all other orders default to ACK.

selfTradePreventionMode'EXPIRE_TAKER' | 'EXPIRE_MAKER' | 'EXPIRE_BOTH' | 'NONE'
Example:EXPIRE_TAKER

The allowed enums is dependent on what is configured on the symbol. The possible supported values are EXPIRE_TAKER, EXPIRE_MAKER, EXPIRE_BOTH, NONE.

recvWindowinteger
Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Order result

OR
OR

Example response

{
  "symbol": "BTCUSDT",
  "orderId": 28,
  "orderListId": -1,
  "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
  "transactTime": 1507725176595
}

Changes

Changed in 5 of the 26 revisions of this API.257

  • 6622e0c151001See the full diff
    • ○

      added the new optional query request parameter selfTradePreventionMode

      new-optional-request-parameter

  • 042dad2ebffe4See the full diff
    • ○

      added the required property oneOf[orderResponseFull]/selfTradePreventionMode to the response with the 200 status

      response-required-property-added

    • ○

      added the required property oneOf[orderResponseFull]/workingTime to the response with the 200 status

      response-required-property-added

    • ○

      added the required property oneOf[orderResponseResult]/selfTradePreventionMode to the response with the 200 status

      response-required-property-added

    • ○

      added the required property oneOf[orderResponseResult]/workingTime to the response with the 200 status

      response-required-property-added

  • f9cbbeb40e316See the full diff
    • ○

      added the new optional query request parameter strategyId

      new-optional-request-parameter

    • ○

      added the new optional query request parameter strategyType

      new-optional-request-parameter

    • ○

      added the optional property oneOf[orderResponseFull]/strategyId to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property oneOf[orderResponseFull]/strategyType to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property oneOf[orderResponseResult]/strategyId to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property oneOf[orderResponseResult]/strategyType to the response with the 200 status

      response-optional-property-added

  • f008d48ec6231See the full diff
    • ○

      added the new optional query request parameter trailingDelta

      new-optional-request-parameter

  • a484ce871a72245See the full diff
    • ▲

      for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64

      request-parameter-type-changed

    • ▲

      for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64

      request-parameter-type-changed

    • ○

      for the query request parameter icebergQty, the type/format was generalized from number/float to number/double

      request-parameter-type-generalized

    • ○

      for the query request parameter price, the type/format was generalized from number/float to number/double

      request-parameter-type-generalized

    • ○

      for the query request parameter quantity, the type/format was generalized from number/float to number/double

      request-parameter-type-generalized

    • ○

      for the query request parameter quoteOrderQty, the type/format was generalized from number/float to number/double

      request-parameter-type-generalized

    • ○

      for the query request parameter stopPrice, the type/format was generalized from number/float to number/double

      request-parameter-type-generalized

    • ○

      the response property code became required for the status 400

      response-property-became-required

    • ○

      the response property code became required for the status 401

      response-property-became-required

    • ○

      the response property msg became required for the status 400

      response-property-became-required

    • ○

      the response property msg became required for the status 401

      response-property-became-required

    • ○

      the response property oneOf[orderResponseAck]/clientOrderId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseAck]/orderId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseAck]/orderListId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseAck]/symbol became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseAck]/transactTime became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/clientOrderId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/cummulativeQuoteQty became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/executedQty became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/fills became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/fills/items/commission became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/fills/items/commissionAsset became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/fills/items/price became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/fills/items/qty became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/orderId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/orderListId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/origQty became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/price became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/side became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/status became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/symbol became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/timeInForce became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/transactTime became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseFull]/type became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/clientOrderId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/cummulativeQuoteQty became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/executedQty became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/orderId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/orderListId became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/origQty became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/price became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/side became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/status became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/symbol became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/timeInForce became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/transactTime became required for the status 200

      response-property-became-required

    • ○

      the response property oneOf[orderResponseResult]/type became required for the status 200

      response-property-became-required