> ## 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 Money Positioning

> Smart money positioning for a specific market

See what profitable traders are doing on a specific market. Returns how many smart wallets are net buyers vs net sellers, average entry prices, and total volume and PnL from smart wallets.

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

### Filter Requirements

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

| Parameter          | Minimum  |
| ------------------ | -------- |
| `min_realized_pnl` | ≥ 1,000  |
| `min_total_pnl`    | ≥ 1,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>

<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>


## OpenAPI

````yaml GET /v2/polymarket/market/{condition_id}/smart-money
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/market/{condition_id}/smart-money:
    get:
      tags:
        - polymarket
        - smart-wallet
      summary: Get Smart Money Positioning
      description: >-
        Get smart money positioning for a specific market.


        **Use Case:** See what profitable traders are doing on a specific
        market.


        **Filter Requirements:**


        At least one "strong" filter must meet these minimum thresholds:

        - `min_realized_pnl >= 1000` ($1,000+ PnL)

        - `min_total_pnl >= 1000` ($1,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`.


        **Returns:**

        - How many smart wallets are net buyers vs net sellers

        - Average entry prices for smart wallets

        - Total volume and realized PnL from smart wallets
      operationId: >-
        get_smart_money_positioning_v2_polymarket_market__condition_id__smart_money_get
      parameters:
        - name: condition_id
          in: path
          required: true
          schema:
            type: string
            title: Condition Id
            description: Market condition ID
          description: Market condition ID
        - 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: 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)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmartMoneyResponse'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '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.
    SmartMoneyResponse:
      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
        positioning:
          $ref: '#/components/schemas/SmartMoneyPositioning'
          description: Smart money positioning data
      type: object
      required:
        - smart_wallet_criteria
        - window
        - positioning
      title: SmartMoneyResponse
      description: Response for smart money positioning 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
    SmartMoneyPositioning:
      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 in this market
        net_buyers:
          type: integer
          title: Net Buyers
          description: Smart wallets that are net buyers (buy_volume > sell_volume)
        net_sellers:
          type: integer
          title: Net Sellers
          description: Smart wallets that are net sellers
        neutral:
          type: integer
          title: Neutral
          description: Smart wallets with balanced buy/sell
        net_buyers_pct:
          type: number
          title: Net Buyers Pct
          description: Percentage of smart wallets that are net buyers (0-1)
        total_smart_volume:
          type: number
          title: Total Smart Volume
          description: Total volume from smart wallets (USD)
        total_smart_buy_volume:
          type: number
          title: Total Smart Buy Volume
          description: Total buy volume from smart wallets (USD)
        total_smart_sell_volume:
          type: number
          title: Total Smart Sell Volume
          description: Total sell volume from smart wallets (USD)
        avg_smart_buy_price:
          type: number
          title: Avg Smart Buy Price
          description: Volume-weighted average buy price of smart wallets (0-1)
        avg_smart_sell_price:
          type: number
          title: Avg Smart Sell Price
          description: Volume-weighted average sell price of smart wallets (0-1)
        total_smart_realized_pnl:
          type: number
          title: Total Smart Realized Pnl
          description: Total realized PnL from smart wallets (USD)
        total_smart_total_pnl:
          type: number
          title: Total 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
        avg_smart_win_rate:
          type: number
          title: Avg Smart Win Rate
          description: Average win rate of smart wallets
      type: object
      required:
        - condition_id
        - smart_wallet_count
        - net_buyers
        - net_sellers
        - neutral
        - net_buyers_pct
        - total_smart_volume
        - total_smart_buy_volume
        - total_smart_sell_volume
        - avg_smart_buy_price
        - avg_smart_sell_price
        - total_smart_realized_pnl
        - total_smart_total_pnl
        - avg_smart_roi
        - avg_smart_win_rate
      title: SmartMoneyPositioning
      description: Aggregate smart money positioning for a market.
    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

````