查询杠杆账户被阻止的撮合记录 (USER_DATA)

接口描述

获取因STP(自我交易预防)而过期的订单列表

HTTP请求

GET /sapi/v1/margin/myPreventedMatches

请求权重

10(IP)

请求参数

名称	类型	是否必需	描述
symbol	STRING	YES
preventedMatchId	LONG	NO	预防撮合ID
orderId	LONG	NO
fromPreventedMatchId	LONG	NO	分页查询的起始预防撮合ID
recvWindow	LONG	NO	最大值为 60000 毫秒。支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestamp	LONG	YES
isIsolated	STRING	NO	是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"

• 支持的参数组合:
  • symbol + preventedMatchId
  • symbol + orderId
  • symbol + orderId + fromPreventedMatchId
• 如果提供 orderId，将返回与该订单相关的所有被阻止撮合记录。
• 如果提供 preventedMatchId，将返回指定的被阻止撮合记录。
• 单次请求最多返回500条记录。如果记录超过500条，需要使用 symbol + orderId + fromPreventedMatchId 组合进行分页查询。

响应示例

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

响应参数

名称	类型	描述
symbol	STRING	交易对
preventedMatchId	LONG	被阻止匹配的ID
takerOrderId	LONG	吃单方订单ID
makerSymbol	STRING	挂单方交易对
makerOrderId	LONG	挂单方订单ID
tradeGroupId	LONG	交易组ID
selfTradePreventionMode	STRING	自我交易预防模式，可能的值: EXPIRE_TAKER, EXPIRE_MAKER, EXPIRE_BOTH
price	STRING	价格
makerPreventedQuantity	STRING	挂单方被阻止的数量
transactTime	LONG	交易时间