v26

latestOpenAPI 3.0.2raw.githubusercontent.com2024-10-0834042975.6 KB

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
  }
]