> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predexon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Activity Markets

> Discover markets where high-performing wallets are active

Find alpha by seeing where profitable traders are putting their money. Define "smart wallets" using filter criteria (min PnL, win rate, etc.), then see which markets they're trading and rank by smart wallet activity.

<Note>**Requires Dev or Pro tier.** This endpoint is not available on the Free tier.</Note>

<Warning>
  **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
</Warning>

| Constraint | Value               |
| ---------- | ------------------- |
| `limit`    | 1–100 (default 100) |

### Market Status Filter

Use the optional `status` parameter to filter by trading status:

| Value       | Description                     |
| ----------- | ------------------------------- |
| `open`      | Currently tradable markets only |
| `closed`    | Resolved/settled markets only   |
| *(omitted)* | All markets (default)           |

Filtering by `status=open` improves query performance by skipping resolved markets.

### Filter Requirements

At least **one** strong filter must meet threshold:

| Parameter          | Minimum  |
| ------------------ | -------- |
| `min_realized_pnl` | ≥ 5,000  |
| `min_total_pnl`    | ≥ 5,000  |
| `min_roi`          | ≥ 0.15   |
| `min_trades`       | ≥ 100    |
| `min_volume`       | ≥ 10,000 |

<Warning>`min_win_rate` and `min_profit_factor` require `min_trades >= 50` to be valid.</Warning>


## OpenAPI

````yaml GET /v2/polymarket/markets/smart-activity
openapi: 3.1.0
info:
  title: Predexon API
  description: Prediction market data aggregation and matching API
  version: 2.0.0
servers:
  - url: https://api.predexon.com
security:
  - apiKey: []
paths:
  /v2/polymarket/markets/smart-activity:
    get:
      tags:
        - polymarket
        - smart-wallet
      summary: Get Smart Activity Markets
      description: >-
        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.
      operationId: get_smart_activity_markets_v2_polymarket_markets_smart_activity_get
      parameters:
        - name: window
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/TimeWindow'
            description: Time window for metrics
            default: all_time
          description: Time window for metrics
        - name: sort_by
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/SmartActivitySortBy'
            description: Sort markets by this metric
            default: smart_volume
          description: Sort markets by this metric
        - name: order
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/OrderDirection'
            description: Sort order
            default: desc
          description: Sort order
        - name: min_realized_pnl
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: Minimum global realized PnL to be 'smart' (USD)
            title: Min Realized Pnl
          description: Minimum global realized PnL to be 'smart' (USD)
        - name: min_total_pnl
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: Minimum global total PnL to be 'smart' (USD, net of fees)
            title: Min Total Pnl
          description: Minimum global total PnL to be 'smart' (USD, net of fees)
        - name: min_roi
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: Minimum global ROI to be 'smart' (decimal)
            title: Min Roi
          description: Minimum global ROI to be 'smart' (decimal)
        - name: min_win_rate
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                maximum: 1
                minimum: 0
              - type: 'null'
            description: Minimum global win rate (decimal)
            title: Min Win Rate
          description: Minimum global win rate (decimal)
        - name: min_profit_factor
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
            description: Minimum global profit factor
            title: Min Profit Factor
          description: Minimum global profit factor
        - name: min_trades
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 1
              - type: 'null'
            description: Minimum global trade count
            title: Min Trades
          description: Minimum global trade count
        - name: min_volume
          in: query
          required: false
          schema:
            anyOf:
              - type: number
                minimum: 0
              - type: 'null'
            description: Minimum global volume (USD)
            title: Min Volume
          description: Minimum global volume (USD)
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: 'Filter by market status: open or closed'
            title: Status
          description: 'Filter by market status: open or closed'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Results per page
            default: 100
            title: Limit
          description: Results per page
        - name: pagination_key
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Cursor for pagination
            title: Pagination Key
          description: Cursor for pagination
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmartActivityResponse'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Service Unavailable
components:
  schemas:
    TimeWindow:
      type: string
      enum:
        - 1d
        - 7d
        - 30d
        - all_time
      title: TimeWindow
      description: Time window for rolling metrics.
    SmartActivitySortBy:
      type: string
      enum:
        - smart_volume
        - smart_wallet_count
        - smart_realized_pnl
        - smart_total_pnl
        - avg_smart_roi
      title: SmartActivitySortBy
      description: Sort options for smart activity markets.
    OrderDirection:
      type: string
      enum:
        - asc
        - desc
      title: OrderDirection
      description: Sort order direction enum.
    SmartActivityResponse:
      properties:
        smart_wallet_criteria:
          type: object
          title: Smart Wallet Criteria
          description: Criteria used to define smart wallets
        window:
          $ref: '#/components/schemas/TimeWindow'
          description: Time window for metrics
        markets:
          items:
            $ref: '#/components/schemas/SmartActivityMarket'
          type: array
          title: Markets
          description: Markets with smart wallet activity
        pagination:
          $ref: '#/components/schemas/CursorPagination'
          description: Pagination info
      type: object
      required:
        - smart_wallet_criteria
        - window
        - markets
        - pagination
      title: SmartActivityResponse
      description: Response for market discovery endpoint.
    ErrorResponse:
      properties:
        error:
          type: string
          title: Error
        message:
          type: string
          title: Message
      type: object
      required:
        - error
        - message
      title: ErrorResponse
      description: Standard error response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SmartActivityMarket:
      properties:
        condition_id:
          type: string
          title: Condition Id
          description: Market condition ID
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
          description: Market title
        market_slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Market Slug
          description: Market slug for URL construction
        smart_wallet_count:
          type: integer
          title: Smart Wallet Count
          description: Number of smart wallets that traded this market
        smart_volume:
          type: number
          title: Smart Volume
          description: Total volume from smart wallets (USD)
        smart_realized_pnl:
          type: number
          title: Smart Realized Pnl
          description: Total realized PnL from smart wallets (USD)
        smart_total_pnl:
          type: number
          title: Smart Total Pnl
          description: Total net total PnL from smart wallets (USD)
        avg_smart_roi:
          type: number
          title: Avg Smart Roi
          description: Average ROI of smart wallets in this market
        avg_smart_win_rate:
          type: number
          title: Avg Smart Win Rate
          description: Average win rate of smart wallets in this market
        net_buyers_pct:
          type: number
          title: Net Buyers Pct
          description: Percentage of smart wallets that are net buyers (0-1)
      type: object
      required:
        - condition_id
        - smart_wallet_count
        - smart_volume
        - smart_realized_pnl
        - smart_total_pnl
        - avg_smart_roi
        - avg_smart_win_rate
        - net_buyers_pct
      title: SmartActivityMarket
      description: Market with smart wallet activity stats.
    CursorPagination:
      properties:
        limit:
          type: integer
          title: Limit
          description: Requested limit
        count:
          type: integer
          title: Count
          description: Number of items in current response
        pagination_key:
          anyOf:
            - type: string
            - type: 'null'
          title: Pagination Key
          description: Base64-encoded cursor for next page
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more items available
      type: object
      required:
        - limit
        - count
        - has_more
      title: CursorPagination
      description: Cursor-based pagination for endpoints that don't support offset.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````