Trade

Test New Order (TRADE)

Test new order creation and signature/recvWindow long. Creates and validates a new order but does not send it into the matching engine.

Weight(IP):

Without computeCommissionRates: 1
With computeCommissionRates: 20

post/api/v3/order/test

Query parameters

symbolstring required

Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

side'SELL' | 'BUY' required

Example:SELL

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.

recvWindowinteger

Example:5000

The value cannot be greater than 60000

computeCommissionRatesboolean

Default: false

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

object required

Changes

Changed in 4 of the 26 revisions of this API.213

Jun 6, 20246c02ecd56d371See the full diff
- ○
  added the new optional query request parameter computeCommissionRates
  new-optional-request-parameter
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 15, 2022f9cbbeb40e312See 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
Apr 25, 2022f008d48ec6231See the full diff
- ○
  added the new optional query request parameter trailingDelta
  new-optional-request-parameter
Oct 25, 2021a484ce871a7229See 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

Full history