Sign in
Trade

Query Prevented Matches

Displays the list of orders that were expired because of STP.

For additional information on what a Prevented match is, as well as Self Trade Prevention (STP), please refer to our STP FAQ page.

These are the combinations supported:

  • symbol + preventedMatchId
  • symbol + orderId
  • symbol + orderId + fromPreventedMatchId (limit will default to 500)
  • symbol + orderId + fromPreventedMatchId + limit

Weight(IP):

Case Weight If symbol is invalid: 2 Querying by preventedMatchId: 2 Querying by orderId: 20

get/api/v3/myPreventedMatches

Query parameters

symbolstring required
Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

preventedMatchIdinteger
Example:1
orderIdinteger

Order id

fromPreventedMatchIdinteger
Example:1
limitinteger
Example:5

Default 500; max 1000.

recvWindowinteger
Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Order list that were expired due to STP

symbolstring required
preventedMatchIdinteger required
takerOrderIdinteger required
makerOrderIdinteger required
tradeGroupIdinteger required
selfTradePreventionModestring required
pricestring required
makerPreventedQuantitystring required
transactTimeinteger required

Example response

[
  {
    "symbol": "BTCUSDT",
    "preventedMatchId": 1,
    "takerOrderId": 5,
    "makerOrderId": 3,
    "tradeGroupId": 1,
    "selfTradePreventionMode": "EXPIRE_MAKER",
    "price": "1.100000",
    "makerPreventedQuantity": "1.300000",
    "transactTime": 1669101687094
  }
]

Changes

Changed in 2 of the 26 revisions of this API.11