Skip to main content
POST
/
v1beta1
/
search_executions
Search Executions
curl --request POST \
  --url https://traderapi.us-east-1.privatelink.preprod.polymarketexchange.com/api/v1beta1/search_executions \
  --header 'Content-Type: application/json' \
  --data '
{
  "accounts": [
    "<string>"
  ],
  "client_account_id": "<string>",
  "client_participant_id": "<string>",
  "clord_id": "<string>",
  "end_time": "2023-11-07T05:31:56Z",
  "end_transact_trade_date": {
    "day": 123,
    "month": 123,
    "year": 123
  },
  "exec_ids": [
    "<string>"
  ],
  "newest_first": true,
  "order_id": "<string>",
  "page_size": 123,
  "page_token": "<string>",
  "parent_order_id": "<string>",
  "start_time": "2023-11-07T05:31:56Z",
  "start_transact_trade_date": {
    "day": 123,
    "month": 123,
    "year": 123
  },
  "symbol": "<string>",
  "symbol_sub_type": "<string>",
  "types": [
    "EXECUTION_TYPE_NEW"
  ]
}
'
{
  "executions": [
    {
      "id": "1ABC2DEF3GHI4",
      "type": "EXECUTION_TYPE_PARTIAL_FILL",
      "last_px": "5500",
      "last_shares": "50",
      "transact_time": "2025-01-15T18:31:00Z",
      "order": {
        "id": "1ABC2DEF3GHI4",
        "account": "trading-account-456",
        "symbol": "aec-nfl-buf-nyj-2025-01-15",
        "side": "SIDE_BUY",
        "type": "ORDER_TYPE_LIMIT",
        "order_qty": "100",
        "price": "5500",
        "price_scale": "10000",
        "leaves_qty": "50",
        "cum_qty": "50",
        "state": "ORDER_STATE_PARTIALLY_FILLED"
      }
    }
  ],
  "eof": true,
  "next_page_token": ""
}

Body

application/json

Request to search for executions filtered using the given details.

​
accounts
string[]

Fully qualified resource account names to filter upon (ie: "firms/[firmid]/accounts/[accountid]").

​
client_account_id
string

Client account ID to filter upon.

​
client_participant_id
string

Client participant ID to filter upon.

​
clord_id
string

Client assigned order ID to filter upon.

​
end_time
string<date-time>

End time for the orders to be fetched.

​
end_transact_trade_date
object

Date represents a whole or partial calendar date.

​
exec_ids
string[]

Execution IDs to filter upon.

​
newest_first
boolean

A flag that if set indicates that executions found should be sorted from most recent to oldest.

​
order_id
string

Exchange assigned order ID of the order to filter upon.

​
page_size
integer<int32>

The maximum number of fills to return in a response. This field is optional.

​
page_token
string

A pagination token returned from a previous call to SearchExecutionsRequest. that indicates where this listing should continue from. This field is optional.

​
parent_order_id
string

Parent order ID to filter upon.

​
start_time
string<date-time>

Start time for the orders to be fetched.

​
start_transact_trade_date
object

Date represents a whole or partial calendar date.

​
symbol
string

Instrument symbol to filter upon.

​
symbol_sub_type
string

Symbol sub type to filter upon.

​
types
enum<string>[]

Execution types to filter upon.

ExecutionType denotes the execution type.

Available options:
EXECUTION_TYPE_NEW,
EXECUTION_TYPE_PARTIAL_FILL,
EXECUTION_TYPE_FILL,
EXECUTION_TYPE_CANCELED,
EXECUTION_TYPE_REPLACE,
EXECUTION_TYPE_REJECTED,
EXECUTION_TYPE_EXPIRED,
EXECUTION_TYPE_DONE_FOR_DAY

Response

A successful response.

​
eof
boolean

A flag that if set indicates the end of file has been reached and there are no further pages.

​
executions
object[]

List of executions found.

​
next_page_token
string

A pagination token returned from a previous call to SearchExecutions. that indicates from where listing should continue. This field is optional.