Cancel open orders (TRADE)
Cancel all open orders on a symbol. This includes orders that are part of an order list.
Cancel open orders (TRADE) › Authorization
Cancel open orders (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Cancel open orders (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Cancel open orders (TRADE) › Responses
Cancel open orders
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorigClientOrderIdorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
origClientOrderIdorderIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesidestopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
icebergQtyAppears only if the parameter icebergQty was sent in the request.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
selfTradePreventionModepreventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountOrder Amend Keep Priority (TRADE)
Reduce the quantity of an existing open order.
This adds 0 orders to the EXCHANGE_MAX_ORDERS filter and the MAX_NUM_ORDERS filter.
Read Order Amend Keep Priority FAQ to learn more.
Order Amend Keep Priority (TRADE) › Authorization
Order Amend Keep Priority (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Order Amend Keep Priority (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolnewQtynewQty must be greater than 0 and less than the order's quantity.
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
orderIdorderId or origClientOrderId must be sent
origClientOrderIdorderId or origClientOrderId must be sent
newClientOrderIdThe new client order ID for the order after being amended.
If not sent, one will be randomly generated.
It is possible to reuse the current clientOrderId by sending it as the newClientOrderId.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Order Amend Keep Priority (TRADE) › Responses
Order Amend Keep Priority
idstatustransactTimeexecutionIdsymbolorderIdorderListIdorigClientOrderIdclientOrderIdpriceqtyexecutedQtypreventedQtyquoteOrderQtycumulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
orderListIdcontingencyTypelistOrderStatuslistClientOrderIdsymbolsymbolorderIdclientOrderIdrateLimitTypeintervalintervalNumlimitcountCancel order (TRADE)
Cancel an active order.
Cancel order (TRADE) › Authorization
Cancel order (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Cancel order (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
orderIdorigClientOrderIdnewClientOrderIdUsed to uniquely identify this cancel. Automatically generated by default.
cancelRestrictionsSupported values: ONLY_NEW - Cancel will succeed if the order status is NEW.
ONLY_PARTIALLY_FILLED - Cancel will succeed if order status is PARTIALLY_FILLED.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Cancel order (TRADE) › Responses
Cancel order
idstatussymbolorigClientOrderIdorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesidestopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
trailingDeltaDelta price change required before order activation.
icebergQtyAppears only if the parameter icebergQty was sent in the request.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
selfTradePreventionModepreventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
contingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolorderIdclientOrderIdsymbolorigClientOrderIdorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountCancel and replace order (TRADE)
- Cancel an existing order and immediately place a new order instead of the canceled one.
- A new order that was not attempted (i.e. when
newOrderResult: NOT_ATTEMPTED), will still increase the unfilled order count by 1. - You can only cancel an individual order from an orderList using this method, but the result is the same as canceling the entire orderList.not attempted (i.e. when
newOrderResult: NOT_ATTEMPTED), will still increase the unfilled order count by 1.
Cancel and replace order (TRADE) › Authorization
Cancel and replace order (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Cancel and replace order (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolcancelReplaceModeThe allowed values are:
STOP_ON_FAILURE - If the cancel request fails, the new order placement will not be attempted.
ALLOW_FAILURE - new order placement will be attempted even if cancel request fails.
sidetypePlease see Enums for supported values.
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
cancelOrderIdEither cancelOrderId or cancelOrigClientOrderId must be sent.
If both cancelOrderId and cancelOrigClientOrderId parameters are provided, the cancelOrderId is searched first, then the cancelOrigClientOrderId from that result is checked against that order.
If both conditions are not met the request will be rejected.
cancelOrigClientOrderIdEither cancelOrderId or cancelOrigClientOrderId must be sent.
If both cancelOrderId and cancelOrigClientOrderId parameters are provided, the cancelOrderId is searched first, then the cancelOrigClientOrderId from that result is checked against that order.
If both conditions are not met the request will be rejected.
cancelNewClientOrderIdUsed to uniquely identify this cancel. Automatically generated by default.
timeInForcepricequantityquoteOrderQtynewClientOrderIdUsed to identify the new order.
newOrderRespTypeAllowed values:
ACK, RESULT, FULL
MARKET and LIMIT orders types default to FULL; all other orders default to ACK
stopPriceUsed with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.
trailingDeltaicebergQtyUsed with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order.
strategyIdstrategyTypeThe value cannot be less than 1000000.
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. The possible supported values are: STP Modes.
cancelRestrictionsSupported values: ONLY_NEW - Cancel will succeed if the order status is NEW.
ONLY_PARTIALLY_FILLED - Cancel will succeed if order status is PARTIALLY_FILLED.
orderRateLimitExceededModeSupported values:
DO_NOTHING (default)- will only attempt to cancel the order if account has not exceeded the unfilled order rate limit
CANCEL_ONLY - will always cancel the order
pegPriceTypePRIMARY_PEG or MARKET_PEG
See Pegged Orders
pegOffsetValuePrice level to peg the price to (max: 100)
See Pegged Orders
pegOffsetTypeOnly PRICE_LEVEL is supported
See Pegged Orders
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Cancel and replace order (TRADE) › Responses
Cancel and replace order
idstatuscancelResultnewOrderResultsymbolorigClientOrderIdorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
symbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountCancel Order list (TRADE)
Cancel an active order list.
Cancel Order list (TRADE) › Authorization
Cancel Order list (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Cancel Order list (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symboltimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
orderListIdEither orderListId or listClientOrderId must be provided
listClientOrderIdEither orderListId or listClientOrderId must be provided
newClientOrderIdUsed to uniquely identify this cancel. Automatically generated by default.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Cancel Order list (TRADE) › Responses
Cancel Order list
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountPlace new OCO - Deprecated (TRADE)
Send in a new one-cancels-the-other (OCO) pair:
LIMIT_MAKER + STOP_LOSS/STOP_LOSS_LIMIT orders (called legs),
where activation of one order immediately cancels the other.
This adds 1 order to EXCHANGE_MAX_ORDERS filter and the MAX_NUM_ORDERS filter
Place new OCO - Deprecated (TRADE) › Authorization
Place new OCO - Deprecated (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Place new OCO - Deprecated (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolsidepricequantitytimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
listClientOrderIdA unique Id for the entire orderList
limitClientOrderIdA unique Id for the limit order
limitIcebergQtyUsed to make the LIMIT_MAKER leg an iceberg order.
limitStrategyIdlimitStrategyTypeThe value cannot be less than 1000000.
stopPricetrailingDeltastopClientOrderIdA unique Id for the stop loss/stop loss limit leg
stopLimitPriceIf provided, stopLimitTimeInForce is required.
stopLimitTimeInForceValid values are GTC/FOK/IOC
stopIcebergQtyUsed with STOP_LOSS_LIMIT leg to make an iceberg order.
stopStrategyIdstopStrategyTypeThe value cannot be less than 1000000.
newOrderRespTypeFormat of the JSON response. Supported values: Order Response Type
selfTradePreventionModeThe allowed values are dependent on what is configured on the symbol. Supported values: STP Modes
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Place new OCO - Deprecated (TRADE) › Responses
Place new OCO - Deprecated
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountPlace new Order list - OCO (TRADE)
Send in an one-cancels-the-other (OCO) pair, where activation of one order immediately cancels the other.
-
An OCO has 2 orders called the above order and below order.
-
One of the orders must be a
LIMIT_MAKER/TAKE_PROFIT/TAKE_PROFIT_LIMITorder and the other must beSTOP_LOSSorSTOP_LOSS_LIMITorder. -
Price restrictions:
- If the OCO is on the
SELLside:LIMIT_MAKER/TAKE_PROFIT_LIMITprice> Last Traded Price >STOP_LOSS/STOP_LOSS_LIMITstopPriceTAKE_PROFIT stopPrice> Last Traded Price >STOP_LOSS/STOP_LOSS_LIMIT stopPrice
- If the OCO is on the
BUYside:LIMIT_MAKERprice< Last Traded Price <STOP_LOSS/STOP_LOSS_LIMITstopPriceTAKE_PROFIT stopPrice> Last Traded Price >STOP_LOSS/STOP_LOSS_LIMIT stopPrice
- If the OCO is on the
-
OCOs add 2 orders to the
EXCHANGE_MAX_ORDERSfilter andMAX_NUM_ORDERSfilter.
Place new Order list - OCO (TRADE) › Authorization
Place new Order list - OCO (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Place new Order list - OCO (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolsideBUY or SELL
quantityQuantity for both orders of the order list.
aboveTypebelowTypeSupported values: STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
listClientOrderIdArbitrary unique ID among open order lists. Automatically generated if not sent. A new order list with the same listClientOrderId is accepted only when the previous one is filled or completely expired. listClientOrderId is distinct from the aboveClientOrderId and the belowClientOrderId.
aboveClientOrderIdArbitrary unique ID among open orders for the above order. Automatically generated if not sent.
aboveIcebergQtyNote that this can only be used if aboveTimeInForce is GTC.
abovePriceCan be used if aboveType is STOP_LOSS_LIMIT, LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price.
aboveStopPriceCan be used if aboveType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT. Either aboveStopPrice or aboveTrailingDelta or both, must be specified.
aboveTrailingDeltaaboveTimeInForceRequired if aboveType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT.
aboveStrategyIdArbitrary numeric value identifying the above order within an order strategy.
aboveStrategyTypeArbitrary numeric value identifying the above order strategy. Values smaller than 1000000 are reserved and cannot be used.
abovePegPriceTypeabovePegOffsetTypeabovePegOffsetValuebelowClientOrderIdArbitrary unique ID among open orders for the below order. Automatically generated if not sent.
belowIcebergQtyNote that this can only be used if belowTimeInForce is GTC.
belowPriceCan be used if belowType is STOP_LOSS_LIMIT, LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price.
belowStopPriceCan be used if belowType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT. Either belowStopPrice or belowTrailingDelta or both, must be specified.
belowTrailingDeltabelowTimeInForceRequired if belowType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT.
belowStrategyIdArbitrary numeric value identifying the below order within an order strategy.
belowStrategyTypeArbitrary numeric value identifying the below order strategy. Values smaller than 1000000 are reserved and cannot be used.
belowPegPriceTypebelowPegOffsetTypebelowPegOffsetValuenewOrderRespTypeSelect response format: ACK, RESULT, FULL.
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. Supported values: STP Modes
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Place new Order list - OCO (TRADE) › Responses
Place new Order list - OCO
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountOPO (TRADE)
Place an OPO.
- OPOs add 2 orders to the EXCHANGE_MAX_NUM_ORDERS filter and MAX_NUM_ORDERS filter.
OPO (TRADE) › Authorization
OPO (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
OPO (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolworkingTypeSupported values: LIMIT, LIMIT_MAKER
workingSideworkingPricePrice for the working order.
workingQuantitySets the quantity for the working order.
pendingTypeSupported values: Order Types. Note that MARKET orders using quoteOrderQty are not supported.
pendingSidetimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
listClientOrderIdArbitrary unique ID among open order lists. Automatically generated if not sent. A new order list with the same listClientOrderId is accepted only when the previous one is filled or completely expired. listClientOrderId is distinct from the workingClientOrderId and the pendingClientOrderId.
newOrderRespTypeFormat of the JSON response. Supported values: Order Response Type
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. Supported values: STP Modes
workingClientOrderIdArbitrary unique ID among open orders for the working order. Automatically generated if not sent.
workingIcebergQtyThis can only be used if workingTimeInForce is GTC, or if workingType is LIMIT_MAKER.
workingTimeInForceworkingStrategyIdArbitrary numeric value identifying the working order within an order strategy.
workingStrategyTypeArbitrary numeric value identifying the working order strategy. Values smaller than 1000000 are reserved and cannot be used.
workingPegPriceTypeworkingPegOffsetTypeworkingPegOffsetValuependingClientOrderIdArbitrary unique ID among open orders for the pending order. Automatically generated if not sent.
pendingPricePrice for the pending order.
pendingStopPriceStop price for the pending order.
pendingTrailingDeltaTrailing delta for the pending order.
pendingIcebergQtyThis can only be used if pendingTimeInForce is GTC or if pendingType is LIMIT_MAKER.
pendingTimeInForcependingStrategyIdArbitrary numeric value identifying the pending order within an order strategy.
pendingStrategyTypeArbitrary numeric value identifying the pending order strategy. Values smaller than 1000000 are reserved and cannot be used.
pendingPegPriceTypependingPegOffsetTypependingPegOffsetValuerecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
OPO (TRADE) › Responses
OPO
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorderIdorderListIdclientOrderIdtransactTimepriceexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModeorigQtyicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
OPOCO (TRADE)
Place an OPOCO.
OPOCO (TRADE) › Authorization
OPOCO (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
OPOCO (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolworkingTypeworkingSideworkingPricePrice for the working order.
workingQuantitySets the quantity for the working order.
pendingSidependingAboveTypeSupported values: STOP_LOSS_LIMIT, STOP_LOSS, LIMIT_MAKER, TAKE_PROFIT, TAKE_PROFIT_LIMIT
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
listClientOrderIdArbitrary unique ID among open order lists. Automatically generated if not sent. A new order list with the same listClientOrderId is accepted only when the previous one is filled or completely expired. listClientOrderId is distinct from the workingClientOrderId and the pendingClientOrderId.
newOrderRespTypeFormat of the JSON response. Supported values: Order Response Type
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. Supported values: STP Modes
workingClientOrderIdArbitrary unique ID among open orders for the working order. Automatically generated if not sent.
workingIcebergQtyThis can only be used if workingTimeInForce is GTC, or if workingType is LIMIT_MAKER.
workingTimeInForceworkingStrategyIdArbitrary numeric value identifying the working order within an order strategy.
workingStrategyTypeArbitrary numeric value identifying the working order strategy. Values smaller than 1000000 are reserved and cannot be used.
workingPegPriceTypeworkingPegOffsetTypeworkingPegOffsetValuePrice level for pegging (max: 100). See Pegged Orders
pendingAboveClientOrderIdArbitrary unique ID among open orders for the pending above order. Automatically generated if not sent.
pendingAbovePriceCan be used if pendingAboveType is STOP_LOSS_LIMIT, LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price.
pendingAboveStopPriceCan be used if pendingAboveType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT.
pendingAboveTrailingDeltapendingAboveIcebergQtyThis can only be used if pendingAboveTimeInForce is GTC or pendingAboveType is LIMIT_MAKER.
pendingAboveTimeInForceRequired if pendingAboveType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT.
pendingAboveStrategyIdArbitrary numeric value identifying the pending above order within an order strategy.
pendingAboveStrategyTypeArbitrary numeric value identifying the pending above order strategy. Values smaller than 1000000 are reserved and cannot be used.
pendingAbovePegPriceTypependingAbovePegOffsetTypependingAbovePegOffsetValuePrice level for pegging (max: 100). See Pegged Orders
pendingBelowTypeSupported values: STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT
pendingBelowClientOrderIdArbitrary unique ID among open orders for the pending below order. Automatically generated if not sent.
pendingBelowPriceCan be used if pendingBelowType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT to specify the limit price.
pendingBelowStopPriceCan be used if pendingBelowType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT. Either pendingBelowStopPrice or pendingBelowTrailingDelta or both, must be specified.
pendingBelowTrailingDeltapendingBelowIcebergQtyThis can only be used if pendingBelowTimeInForce is GTC or pendingBelowType is LIMIT_MAKER.
pendingBelowTimeInForcependingBelowStrategyIdArbitrary numeric value identifying the pending below order within an order strategy.
pendingBelowStrategyTypeArbitrary numeric value identifying the pending below order strategy. Values smaller than 1000000 are reserved and cannot be used.
pendingBelowPegPriceTypependingBelowPegOffsetTypependingBelowPegOffsetValuerecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
OPOCO (TRADE) › Responses
OPOCO
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorderIdorderListIdclientOrderIdtransactTimepriceexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModestopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
origQtyicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
Place new Order list - OTO (TRADE)
Places an OTO.
-
An OTO (One-Triggers-the-Other) is an order list comprised of 2 orders.
-
The first order is called the working order and must be
LIMITorLIMIT_MAKER. Initially, only the working order goes on the order book. -
The second order is called the pending order. It can be any order type except for
MARKETorders using parameterquoteOrderQty. The pending order is only placed on the order book when the working order gets fully filled. -
If either the working order or the pending order is cancelled individually, the other order in the order list will also be canceled or expired.
-
When the order list is placed, if the working order gets immediately fully filled, the placement response will show the working order as
FILLEDbut the pending order will still appear asPENDING_NEW. You need to query the status of the pending order again to see its updated status. -
OTOs add 2 orders to the
EXCHANGE_MAX_NUM_ORDERSfilter andMAX_NUM_ORDERSfilter.
Place new Order list - OTO (TRADE) › Authorization
Place new Order list - OTO (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Place new Order list - OTO (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolworkingTypeSupported values: LIMIT, LIMIT_MAKER
workingSideworkingPriceworkingQuantitySets the quantity for the working order.
pendingTypeSupported values: Order Types. Note that MARKET orders using quoteOrderQty are not supported.
pendingSidependingQuantitySets the quantity for the pending order.
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
listClientOrderIdArbitrary unique ID among open order lists. Automatically generated if not sent. A new order list with the same listClientOrderId is accepted only when the previous one is filled or completely expired. listClientOrderId is distinct from the workingClientOrderId and the pendingClientOrderId.
newOrderRespTypeFormat of the JSON response. Supported values: Order Response Type
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. Supported values: STP Modes
workingClientOrderIdArbitrary unique ID among open orders for the working order. Automatically generated if not sent.
workingIcebergQtyThis can only be used if workingTimeInForce is GTC, or if workingType is LIMIT_MAKER.
workingTimeInForceworkingStrategyIdArbitrary numeric value identifying the working order within an order strategy.
workingStrategyTypeArbitrary numeric value identifying the working order strategy. Values smaller than 1000000 are reserved and cannot be used.
workingPegPriceTypeworkingPegOffsetTypeworkingPegOffsetValuependingClientOrderIdArbitrary unique ID among open orders for the pending order. Automatically generated if not sent.
pendingPricependingStopPricependingTrailingDeltapendingIcebergQtyThis can only be used if pendingTimeInForce is GTC or if pendingType is LIMIT_MAKER.
pendingTimeInForcependingStrategyIdArbitrary numeric value identifying the pending order within an order strategy.
pendingStrategyTypeArbitrary numeric value identifying the pending order strategy. Values smaller than 1000000 are reserved and cannot be used.
pendingPegOffsetTypependingPegPriceTypependingPegOffsetValuerecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Place new Order list - OTO (TRADE) › Responses
Place new Order list - OTO
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountPlace new Order list - OTOCO (TRADE)
Place an OTOCO.
- An OTOCO (One-Triggers-One-Cancels-the-Other) is an order list comprised of 3 orders.
- The first order is called the working order and must be
LIMITorLIMIT_MAKER. Initially, only the working order goes on the order book.- The behavior of the working order is the same as the OTO.
- OTOCO has 2 pending orders (pending above and pending below), forming an OCO pair. The pending orders are only placed on the order book when the working order gets fully filled.
- The rules of the pending above and pending below follow the same rules as the Order list OCO.
- OTOCOs add 3 orders to the
EXCHANGE_MAX_NUM_ORDERSfilter andMAX_NUM_ORDERSfilter.
Place new Order list - OTOCO (TRADE) › Authorization
Place new Order list - OTOCO (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Place new Order list - OTOCO (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolworkingTypeSupported values: LIMIT, LIMIT_MAKER
workingSideworkingPriceworkingQuantitySets the quantity for the working order.
pendingSidependingQuantitySets the quantity for the pending orders.
pendingAboveTypeSupported values: STOP_LOSS_LIMIT, STOP_LOSS, LIMIT_MAKER, TAKE_PROFIT, TAKE_PROFIT_LIMIT
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
listClientOrderIdArbitrary unique ID among open order lists. Automatically generated if not sent. A new order list with the same listClientOrderId is accepted only when the previous one is filled or completely expired. listClientOrderId is distinct from the workingClientOrderId and the pendingClientOrderId.
newOrderRespTypeFormat of the JSON response. Supported values: Order Response Type
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. Supported values: STP Modes
workingClientOrderIdArbitrary unique ID among open orders for the working order. Automatically generated if not sent.
workingIcebergQtyThis can only be used if workingTimeInForce is GTC, or if workingType is LIMIT_MAKER.
workingTimeInForceworkingStrategyIdArbitrary numeric value identifying the working order within an order strategy.
workingStrategyTypeArbitrary numeric value identifying the working order strategy. Values smaller than 1000000 are reserved and cannot be used.
workingPegPriceTypeworkingPegOffsetTypeworkingPegOffsetValuependingAboveClientOrderIdArbitrary unique ID among open orders for the pending above order. Automatically generated if not sent.
pendingAbovePriceCan be used if pendingAboveType is STOP_LOSS_LIMIT, LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price.
pendingAboveStopPriceCan be used if pendingAboveType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT.
pendingAboveTrailingDeltapendingAboveIcebergQtyThis can only be used if pendingAboveTimeInForce is GTC or if pendingAboveType is LIMIT_MAKER.
pendingAboveTimeInForceRequired if pendingAboveType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT.
pendingAboveStrategyIdArbitrary numeric value identifying the pending above order within an order strategy.
pendingAboveStrategyTypeArbitrary numeric value identifying the pending above order strategy. Values smaller than 1000000 are reserved and cannot be used.
pendingAbovePegPriceTypependingAbovePegOffsetTypependingAbovePegOffsetValuependingBelowTypeSupported values: STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT
pendingBelowClientOrderIdArbitrary unique ID among open orders for the pending below order. Automatically generated if not sent.
pendingBelowPriceCan be used if pendingBelowType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT to specify the limit price.
pendingBelowStopPriceCan be used if pendingBelowType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT. Either pendingBelowStopPrice or pendingBelowTrailingDelta or both, must be specified.
pendingBelowTrailingDeltapendingBelowIcebergQtyThis can only be used if pendingBelowTimeInForce is GTC, or if pendingBelowType is LIMIT_MAKER.
pendingBelowTimeInForceRequired if pendingBelowType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT.
pendingBelowStrategyIdArbitrary numeric value identifying the pending below order within an order strategy.
pendingBelowStrategyTypeArbitrary numeric value identifying the pending below order strategy. Values smaller than 1000000 are reserved and cannot be used.
pendingBelowPegPriceTypependingBelowPegOffsetTypependingBelowPegOffsetValuerecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Place new Order list - OTOCO (TRADE) › Responses
Place new Order list - OTOCO
idstatusorderListIdcontingencyTypelistStatusTypelistOrderStatuslistClientOrderIdtransactionTimesymbolsymbolorderIdclientOrderIdsymbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModeicebergQtyAppears only if the parameter icebergQty was sent in the request.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
trailingDeltaDelta price change required before order activation.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountPlace new order (TRADE)
Send in a new order.
This adds 1 order to the EXCHANGE_MAX_ORDERS filter and the MAX_NUM_ORDERS filter.
Place new order (TRADE) › Authorization
Place new order (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Place new order (TRADE) › Request Parameters optional
idClient-generated request identifier.
methodWebSocket API method name.
symbolsidetypePlease see Enums for supported values.
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
timeInForcepricequantityquoteOrderQtynewClientOrderIdA unique id among open orders. Automatically generated if not sent.
Orders with the same newClientOrderID can be accepted only when the previous one is filled, otherwise the order will be rejected.
newOrderRespTypeMARKET and LIMIT order types default to FULL, all other orders default to ACK.
stopPriceUsed with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.
trailingDeltaSee Trailing Stop order FAQ
icebergQtyUsed with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order.
strategyIdstrategyTypeThe value cannot be less than 1000000.
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol.
pegPriceTypeSee Pegged Orders Info
pegOffsetValuePrice level to peg the price to (max: 100). See Pegged Orders Info
pegOffsetTypeOnly PRICE_LEVEL is supported. See Pegged Orders Info
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Place new order (TRADE) › Responses
Place new order
idstatussymbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimeselfTradePreventionModestopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
trailingDeltaDelta price change required before order activation.
icebergQtyAppears only if the parameter icebergQty was sent in the request.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
trailingTimeTime when the trailing order is now active and tracking price changes.
usedSorField that determines whether order used SOR.
workingFloorDetermines whether the order is being filled by the SOR or by the order book.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
priceqtycommissioncommissionAssettradeIdrateLimitTypeintervalintervalNumlimitcountTest new order (TRADE)
Test order placement.
Validates new order parameters and verifies your signature but does not send the order into the matching engine.
Test new order (TRADE) › Authorization
Test new order (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
| Condition | Request Weight |
|---|---|
Without computeCommissionRates | 1 |
With computeCommissionRates | 20 |
Test new order (TRADE) › Request Parameters optional
idClient-generated request identifier.
methodWebSocket API method name.
symbolsidetypePlease see Enums for supported values.
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
computeCommissionRatesDefault: false
See Commissions FAQ to learn more.
timeInForcepricequantityquoteOrderQtynewClientOrderIdA unique id among open orders. Automatically generated if not sent. Orders with the same newClientOrderID can be accepted only when the previous one is filled, otherwise the order will be rejected.
newOrderRespTypeSet the response JSON. ACK, RESULT, or FULL; MARKET and LIMIT order types default to FULL, all other orders default to ACK.
stopPriceUsed with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.
trailingDeltaicebergQtyUsed with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order.
strategyIdstrategyTypeThe value cannot be less than 1000000.
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. Supported values: STP Modes
pegPriceTypepegOffsetValuePrice level for pegging (max: 100). See Pegged Orders
pegOffsetTyperecvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Test new order (TRADE) › Responses
Test new order
idstatusmakertakermakertakermakertakerenabledForAccountenabledForSymboldiscountAssetdiscountrateLimitTypeintervalintervalNumlimitcountPlace new order using SOR (TRADE)
Places an order using smart order routing (SOR).
This adds 1 order to the EXCHANGE_MAX_ORDERS filter and the MAX_NUM_ORDERS filter.
Read SOR FAQ to learn more.
Place new order using SOR (TRADE) › Authorization
Place new order using SOR (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
Place new order using SOR (TRADE) › Request Parameters
idClient-generated request identifier.
methodWebSocket API method name.
symbolsideBUY or SELL
typeOnly LIMIT and MARKET orders are supported.
quantitytimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
timeInForceApplicable only to LIMIT order type.
pricenewClientOrderIdA unique id among open orders. Automatically generated if not sent.
Orders with the same newClientOrderID can be accepted only when the previous one is filled, otherwise the order will be rejected.
newOrderRespTypeSet the response JSON. ACK, RESULT, or FULL. Default to FULL
icebergQtyUsed with LIMIT to create an iceberg order.
strategyIdstrategyTypeThe value cannot be less than 1000000.
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. The possible supported values are: STP Modes.
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Place new order using SOR (TRADE) › Responses
Place new order using SOR
idstatussymbolorderIdorderListIdclientOrderIdtransactTimepriceorigQtyexecutedQtyorigQuoteOrderQtycummulativeQuoteQtystatustimeInForcetypesideworkingTimematchTypepriceqtycommissioncommissionAssettradeIdallocIdworkingFloorDetermines whether the order is being filled by the SOR or by the order book.
selfTradePreventionModeusedSorField that determines whether order used SOR.
stopPriceAppears for STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT orders.
trailingDeltaDelta price change required before order activation.
icebergQtyAppears only if the parameter icebergQty was sent in the request.
strategyIdAppears only if the strategyId parameter was provided upon order placement.
strategyTypeAppears only if the strategyType parameter was provided upon order placement.
preventedMatchIdAppears only if the order expired due to STP.
preventedQuantityOrder quantity that expired due to STP.
trailingTimeTime when the trailing order is now active and tracking price changes.
pegPriceTypePrice peg type. Only for pegged orders.
pegOffsetTypePrice peg offset type. Only for pegged orders, if requested.
pegOffsetValuePrice peg offset value. Only for pegged orders, if requested.
peggedPriceCurrent price order is pegged at. Only for pegged orders, once determined.
expiryReasonCause of the order's expiration. Appears when an order has expired.
rateLimitTypeintervalintervalNumlimitcountTest new order using SOR (TRADE)
Test new order creation and signature/recvWindow using smart order routing (SOR). Creates and validates a new order but does not send it into the matching engine.
Test new order using SOR (TRADE) › Authorization
Test new order using SOR (TRADE) › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Learn more in the Rate limits section.
| Condition | Request Weight |
|---|---|
Without computeCommissionRates | 1 |
With computeCommissionRates | 20 |
Test new order using SOR (TRADE) › Request Parameters optional
idClient-generated request identifier.
methodWebSocket API method name.
symbolsidetypequantitytimestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
apiKeyAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
computeCommissionRatesDefault: false
timeInForcepricenewClientOrderIdA unique id among open orders. Automatically generated if not sent. Orders with the same newClientOrderID can be accepted only when the previous one is filled, otherwise the order will be rejected.
newOrderRespTypeSet the response JSON. ACK, RESULT, or FULL. Default to FULL.
icebergQtyUsed with LIMIT to create an iceberg order.
strategyIdstrategyTypeThe value cannot be less than 1000000.
selfTradePreventionModeThe allowed enums is dependent on what is configured on the symbol. Supported values: STP Modes
recvWindowSupports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified.
Test new order using SOR (TRADE) › Responses
Test new order using SOR
idstatusmakertakermakertakerenabledForAccountenabledForSymboldiscountAssetdiscountrateLimitTypeintervalintervalNumlimitcount