Skip to main content
POST
/
v1
/
report
/
trades
/
search
Search trades
curl --request POST \
  --url https://api.polymarketexchange.com/v1/report/trades/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "pageSize": 123,
  "pageToken": "<string>",
  "orderId": "<string>",
  "tradeId": "<string>",
  "execId": "<string>",
  "startTime": "2023-11-07T05:31:56Z",
  "endTime": "2023-11-07T05:31:56Z",
  "symbol": "<string>",
  "accounts": [
    "<string>"
  ],
  "states": [
    "TRADE_STATE_NEW"
  ],
  "tradeLinkId": "<string>"
}
'
{
  "trade": [
    {
      "id": "<string>",
      "aggressor": {
        "id": "<string>",
        "order": {
          "id": "<string>",
          "type": "ORDER_TYPE_MARKET_TO_LIMIT",
          "side": "SIDE_BUY",
          "orderQty": "<string>",
          "symbol": "<string>",
          "clordId": "<string>",
          "timeInForce": "TIME_IN_FORCE_DAY",
          "account": "<string>",
          "cumQty": "<string>",
          "avgPx": "<string>",
          "leavesQty": "<string>",
          "state": "ORDER_STATE_PARTIALLY_FILLED",
          "participant": "<string>",
          "price": "<string>",
          "insertTime": "2023-11-07T05:31:56Z",
          "stopPrice": "<string>",
          "minQty": "<string>",
          "createTime": "2023-11-07T05:31:56Z",
          "allOrNone": true,
          "crossId": "<string>",
          "hostCrossId": "<string>",
          "submittingParticipant": "<string>",
          "clientAccountId": "<string>",
          "clientParticipantId": "<string>",
          "parentOrderId": "<string>",
          "commissionsBasisPoints": "<string>",
          "participateDontInitiate": true,
          "cashOrderQty": "<string>",
          "strictLimit": true,
          "goodTillTime": "2023-11-07T05:31:56Z",
          "bestLimit": true,
          "immediatelyExecutableLimit": true,
          "lastTradeId": "<string>",
          "commissionNotionalTotalCollected": "<string>",
          "selfMatchPreventionInstruction": "SELF_MATCH_PREVENTION_INSTRUCTION_REJECT_AGGRESSOR",
          "orderCapacity": "ORDER_CAPACITY_AGENCY",
          "ignorePriceValidityChecks": true,
          "lastTransactTime": "2023-11-07T05:31:56Z",
          "makerCommissionsBasisPoints": "<string>",
          "manualOrderIndicator": "MANUAL_ORDER_INDICATOR_MANUAL"
        },
        "lastShares": "<string>",
        "lastPx": "<string>",
        "type": "EXECUTION_TYPE_PARTIAL_FILL",
        "text": "<string>",
        "orderRejectReason": "ORD_REJECT_REASON_UNKNOWN_SYMBOL",
        "transactTime": "2023-11-07T05:31:56Z",
        "legPrices": [
          {
            "symbol": "<string>",
            "anchor": true,
            "px": "<string>",
            "qty": "<string>",
            "side": "<string>",
            "referencePx": "<string>"
          }
        ],
        "tradeId": "<string>",
        "aggressor": true,
        "commissionNotionalCollected": "<string>",
        "unsolicitedCancelReason": "UNSOLICITED_CXL_REASON_CONNECTION_LOSS",
        "traceId": "<string>",
        "commissionSpreadPx": "<string>",
        "transactTradeDate": {
          "year": 123,
          "month": 123,
          "day": 123
        }
      },
      "passive": {
        "id": "<string>",
        "order": {
          "id": "<string>",
          "type": "ORDER_TYPE_MARKET_TO_LIMIT",
          "side": "SIDE_BUY",
          "orderQty": "<string>",
          "symbol": "<string>",
          "clordId": "<string>",
          "timeInForce": "TIME_IN_FORCE_DAY",
          "account": "<string>",
          "cumQty": "<string>",
          "avgPx": "<string>",
          "leavesQty": "<string>",
          "state": "ORDER_STATE_PARTIALLY_FILLED",
          "participant": "<string>",
          "price": "<string>",
          "insertTime": "2023-11-07T05:31:56Z",
          "stopPrice": "<string>",
          "minQty": "<string>",
          "createTime": "2023-11-07T05:31:56Z",
          "allOrNone": true,
          "crossId": "<string>",
          "hostCrossId": "<string>",
          "submittingParticipant": "<string>",
          "clientAccountId": "<string>",
          "clientParticipantId": "<string>",
          "parentOrderId": "<string>",
          "commissionsBasisPoints": "<string>",
          "participateDontInitiate": true,
          "cashOrderQty": "<string>",
          "strictLimit": true,
          "goodTillTime": "2023-11-07T05:31:56Z",
          "bestLimit": true,
          "immediatelyExecutableLimit": true,
          "lastTradeId": "<string>",
          "commissionNotionalTotalCollected": "<string>",
          "selfMatchPreventionInstruction": "SELF_MATCH_PREVENTION_INSTRUCTION_REJECT_AGGRESSOR",
          "orderCapacity": "ORDER_CAPACITY_AGENCY",
          "ignorePriceValidityChecks": true,
          "lastTransactTime": "2023-11-07T05:31:56Z",
          "makerCommissionsBasisPoints": "<string>",
          "manualOrderIndicator": "MANUAL_ORDER_INDICATOR_MANUAL"
        },
        "lastShares": "<string>",
        "lastPx": "<string>",
        "type": "EXECUTION_TYPE_PARTIAL_FILL",
        "text": "<string>",
        "orderRejectReason": "ORD_REJECT_REASON_UNKNOWN_SYMBOL",
        "transactTime": "2023-11-07T05:31:56Z",
        "legPrices": [
          {
            "symbol": "<string>",
            "anchor": true,
            "px": "<string>",
            "qty": "<string>",
            "side": "<string>",
            "referencePx": "<string>"
          }
        ],
        "tradeId": "<string>",
        "aggressor": true,
        "commissionNotionalCollected": "<string>",
        "unsolicitedCancelReason": "UNSOLICITED_CXL_REASON_CONNECTION_LOSS",
        "traceId": "<string>",
        "commissionSpreadPx": "<string>",
        "transactTradeDate": {
          "year": 123,
          "month": 123,
          "day": 123
        }
      },
      "tradeType": "TRADE_TYPE_REGULAR",
      "state": "TRADE_STATE_NEW",
      "reportingCounterparty": "SIDE_BUY",
      "text": "<string>",
      "tradeLinkId": "<string>",
      "metadata": {}
    }
  ],
  "nextPageToken": "<string>"
}

Body

application/json
pageSize
integer<int32>
pageToken
string
orderId
string
tradeId
string
execId
string
startTime
string<date-time>
endTime
string<date-time>
symbol
string
accounts
string[]
states
enum<string>[]

TradeState indicates the state of a trade.

Available options:
TRADE_STATE_NEW,
TRADE_STATE_CLEARED,
TRADE_STATE_BUSTED,
TRADE_STATE_INFLIGHT,
TRADE_STATE_PENDING_RISK,
TRADE_STATE_PENDING_CLEARED,
TRADE_STATE_REJECTED,
TRADE_STATE_CLEARING_ACKNOWLEDGED,
TRADE_STATE_RETRY_REQUEST

Response

200 - application/json

A successful response.

trade
object[]
nextPageToken
string