Skip to main content
GET
/
v2
/
polymarket
/
wallets
/
filter
Filter Wallets By Markets
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/wallets/filter \
  --header 'x-api-key: <api-key>'
{
  "markets": [
    "<string>"
  ],
  "market_logic": "and",
  "window": "1d",
  "sort_by": "realized_pnl",
  "entries": [
    {
      "rank": 123,
      "user": "<string>",
      "metrics": {
        "realized_pnl": 123,
        "volume": 123,
        "roi": 123,
        "trades": 123,
        "wins": 123,
        "losses": 123,
        "win_rate": 123,
        "profit_factor": 123,
        "positions_closed": 123,
        "total_pnl": 123,
        "avg_buy_price": 123,
        "avg_sell_price": 123,
        "fees_paid": 0,
        "fees_refunded": 0
      },
      "markets_matched": 123,
      "entry_edge": 123
    }
  ],
  "pagination": {
    "limit": 123,
    "count": 123,
    "has_more": true,
    "pagination_key": "<string>"
  }
}
Find wallets that traded specific markets with configurable logic. Use AND to find wallets that traded all specified markets, or OR to find wallets that traded any of them. Filter by combined performance metrics across those markets.
Requires Dev or Pro tier. This endpoint is not available on the Free tier.
Rolling total PnL accuracy timeline - Total PnL (realized + unrealized - net fees) uses rolling windows that need time to accumulate full data:
  • All-time total PnL: accurate immediately (February 10, 2026)
  • 1-day rolling total PnL: fully accurate starting February 11, 2026
  • 7-day rolling total PnL: fully accurate starting February 17, 2026
  • 30-day rolling total PnL: fully accurate starting March 12, 2026
ConstraintValue
limit1–100 (default 100)

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
markets
string
required

Comma-separated market condition IDs (1-10 markets)

Example:

"0x123,0x456,0x789"

​
market_logic
enum<string>
default:and

AND = traded ALL markets, OR = traded ANY market

Available options:
and,
or
​
window
enum<string>
default:all_time

Time window for metrics

Available options:
1d,
7d,
30d,
all_time
​
sort_by
enum<string>
default:total_pnl

Sort field (based on combined metrics)

Available options:
realized_pnl,
total_pnl,
volume,
roi,
profit_factor,
win_rate,
trades
​
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
​
min_realized_pnl
number | null

Minimum combined realized PnL across specified markets (USD)

​
max_realized_pnl
number | null

Maximum combined realized PnL across specified markets (USD)

​
min_total_pnl
number | null

Minimum combined total PnL across specified markets (USD, net of fees)

​
max_total_pnl
number | null

Maximum combined total PnL across specified markets (USD, net of fees)

​
min_volume
number | null

Minimum combined volume across specified markets (USD)

Required range: x >= 0
​
min_trades
integer | null

Minimum combined trade count across specified markets

Required range: x >= 1
​
min_roi
number | null

Minimum combined ROI across specified markets (decimal)

​
min_profit_factor
number | null

Minimum combined profit factor

Required range: x >= 0
​
min_win_rate
number | null

Minimum combined win rate (decimal)

Required range: 0 <= x <= 1
​
min_avg_buy_price
number | null

Minimum combined avg buy price (0-1)

Required range: 0 <= x <= 1
​
max_avg_buy_price
number | null

Maximum combined avg buy price (0-1)

Required range: 0 <= x <= 1
​
min_avg_sell_price
number | null

Minimum combined avg sell price (0-1)

Required range: 0 <= x <= 1
​
max_avg_sell_price
number | null

Maximum combined avg sell price (0-1)

Required range: 0 <= x <= 1
​
min_entry_edge
number | null

Minimum combined entry edge

Required range: -1 <= x <= 1
​
max_entry_edge
number | null

Maximum combined entry edge

Required range: -1 <= x <= 1
​
limit
integer
default:100

Results per page

Required range: 1 <= x <= 100
​
pagination_key
string | null

Cursor for pagination

Response

Successful Response

Response for wallet filter by markets endpoint.

​
markets
string[]
required

Market condition IDs used in filter

​
market_logic
enum<string>
required

Logic used: AND or OR

Available options:
and,
or
​
window
enum<string>
required

Time window for metrics

Available options:
1d,
7d,
30d,
all_time
​
sort_by
enum<string>
required

Sort field used

Available options:
realized_pnl,
total_pnl,
volume,
roi,
profit_factor,
win_rate,
trades
​
entries
WalletFilterEntry · object[]
required

Matching wallets

​
pagination
CursorPagination · object
required

Pagination info