---
title: "Get Smart Activity Markets"
method: GET
path: "/v2/polymarket/markets/smart-activity"
tags: ["polymarket", "smart-wallet"]
---

# Get Smart Activity Markets

`GET /v2/polymarket/markets/smart-activity`

Discover markets where high-performing wallets are active.

**Use Case:** Find alpha by seeing where profitable traders are putting their money.

**How it works:**
1. Define "smart wallets" using the filter criteria (min_realized_pnl, min_total_pnl, min_roi, etc.)
2. Find all markets these wallets have traded
3. Rank markets by smart wallet activity (volume, count, realized PnL)

**Filter Requirements:**

At least one "strong" filter must meet configured minimum thresholds.
Defaults in this service:
- `min_realized_pnl >= 5000` ($5,000+ PnL)
- `min_total_pnl >= 5000` ($5,000+ net total PnL)
- `min_roi >= 0.15` (15%+ ROI)
- `min_trades >= 100` (100+ trades)
- `min_volume >= 10000` ($10,000+ volume)

If using `min_win_rate` or `min_profit_factor` without a strong filter,
you must also specify `min_trades >= 50`.

These requirements ensure meaningful wallet filtering and fast query performance.

Returns markets sorted by smart wallet activity metrics.

## Query parameters

- `window` '1d' | '7d' | '30d' | 'all_time' — Time window for rolling metrics.
- `sort_by` 'smart_volume' | 'smart_wallet_count' | 'smart_realized_pnl' | 'smart_total_pnl' | 'avg_smart_roi' — Sort options for smart activity markets.
- `order` 'asc' | 'desc' — Sort order direction enum.
- `min_realized_pnl` number, nullable — Minimum global realized PnL to be 'smart' (USD)
- `min_total_pnl` number, nullable — Minimum global total PnL to be 'smart' (USD, net of fees)
- `min_roi` number, nullable — Minimum global ROI to be 'smart' (decimal)
- `min_win_rate` number, nullable — Minimum global win rate (decimal)
- `min_profit_factor` number, nullable — Minimum global profit factor
- `min_trades` integer, nullable — Minimum global trade count
- `min_volume` number, nullable — Minimum global volume (USD)
- `status` string, nullable — Filter by market status: open or closed
- `limit` integer — Results per page
- `pagination_key` string, nullable — Cursor for pagination

## Response `200`

Successful Response

- SmartActivityResponse — Response for market discovery endpoint.
  - `smart_wallet_criteria` object, required — Criteria used to define smart wallets
  - `window` '1d' | '7d' | '30d' | 'all_time', required — Time window for rolling metrics.
  - `markets` SmartActivityMarket[], required — Markets with smart wallet activity
    - `condition_id` string, required — Market condition ID
    - `title` string, nullable — Market title
    - `market_slug` string, nullable — Market slug for URL construction
    - `smart_wallet_count` integer, required — Number of smart wallets that traded this market
    - `smart_volume` number, required — Total volume from smart wallets (USD)
    - `smart_realized_pnl` number, required — Total realized PnL from smart wallets (USD)
    - `smart_total_pnl` number, required — Total net total PnL from smart wallets (USD)
    - `avg_smart_roi` number, required — Average ROI of smart wallets in this market
    - `avg_smart_win_rate` number, required — Average win rate of smart wallets in this market
    - `net_buyers_pct` number, required — Percentage of smart wallets that are net buyers (0-1)
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/versions/80a306fbdb39/schema)