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

# Wallet Profile

> Get a complete smart wallet profile

Returns all metrics across all time windows and style classifications for a wallet. The response includes boolean label columns (`is_whale`, `is_market_maker`, `is_contrarian`, etc.) and a computed `primary_trading_style`.

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

<Info>
  See [Trading Labels](/api-reference/trading-labels) for how each label is calculated, priority rules, and minimum thresholds.
  You can use the individual boolean columns to build your own custom label combinations instead of relying on the default `primary_trading_style`.
</Info>

<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/wallet/{wallet}
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/wallet/{wallet}:
    get:
      tags:
        - polymarket
        - smart-wallet
      summary: Get Wallet Profile
      description: |-
        Get complete smart wallet profile.

        Returns all metrics across all time windows and style classifications.
      operationId: get_wallet_profile_v2_polymarket_wallet__wallet__get
      parameters:
        - name: wallet
          in: path
          required: true
          schema:
            type: string
            description: Wallet address (hex)
            title: Wallet
          description: Wallet address (hex)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletProfileResponse'
        '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:
    WalletProfileResponse:
      properties:
        user:
          type: string
          title: User
          description: Wallet address
        metrics:
          $ref: '#/components/schemas/WalletMetrics'
          description: Metrics across all windows
        trading_styles:
          $ref: '#/components/schemas/TradingStyleFlags'
          description: Trading style classifications
        entry_edge:
          anyOf:
            - type: number
            - type: 'null'
          title: Entry Edge
          description: Price edge (avg_sell - avg_buy)
        unrealized_pnl:
          anyOf:
            - type: number
            - type: 'null'
          title: Unrealized Pnl
          description: Total unrealized PnL in USD
        total_pnl:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Pnl
          description: Total PnL (realized + unrealized - net fees)
        first_trade_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: First Trade At
          description: Unix timestamp of first trade
        last_trade_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: Last Trade At
          description: Unix timestamp of last trade
        computed_at:
          anyOf:
            - type: integer
            - type: 'null'
          title: Computed At
          description: Unix timestamp when metrics were computed
      type: object
      required:
        - user
        - metrics
        - trading_styles
      title: WalletProfileResponse
      description: Full wallet profile response.
    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
    WalletMetrics:
      properties:
        one_day:
          $ref: '#/components/schemas/WindowMetrics'
          description: 1-day rolling metrics
        seven_day:
          $ref: '#/components/schemas/WindowMetrics'
          description: 7-day rolling metrics
        thirty_day:
          $ref: '#/components/schemas/WindowMetrics'
          description: 30-day rolling metrics
        all_time:
          $ref: '#/components/schemas/AllTimeMetrics'
          description: All-time metrics
      type: object
      required:
        - one_day
        - seven_day
        - thirty_day
        - all_time
      title: WalletMetrics
      description: All metrics for a wallet across all time windows.
    TradingStyleFlags:
      properties:
        is_whale:
          type: boolean
          title: Is Whale
          description: Large position trader (avg trade > $1000)
        is_market_maker:
          type: boolean
          title: Is Market Maker
          description: Balanced buy/sell + frequent trading
        is_active_trader:
          type: boolean
          title: Is Active Trader
          description: High trade frequency (>4 trades/position)
        is_buy_and_hold:
          type: boolean
          title: Is Buy And Hold
          description: Long holding periods (<=2 trades/position)
        is_degen:
          type: boolean
          title: Is Degen
          description: High-risk pattern (win rate < 35%, 50+ closes)
        is_high_conviction:
          type: boolean
          title: Is High Conviction
          description: Buys at high YES prices (>=0.80)
        is_contrarian:
          type: boolean
          title: Is Contrarian
          description: Takes unpopular sides (<=0.25)
        is_value_hunter:
          type: boolean
          title: Is Value Hunter
          description: Enters at uncertain odds (0.35-0.55)
        primary_style:
          type: string
          title: Primary Style
          description: Primary trading style classification
      type: object
      required:
        - is_whale
        - is_market_maker
        - is_active_trader
        - is_buy_and_hold
        - is_degen
        - is_high_conviction
        - is_contrarian
        - is_value_hunter
        - primary_style
      title: TradingStyleFlags
      description: Multi-label trading style classification.
    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
    WindowMetrics:
      properties:
        realized_pnl:
          type: number
          title: Realized Pnl
          description: Realized profit/loss in USD (from closed positions)
        total_pnl:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Pnl
          description: Total PnL in USD (realized + unrealized - net fees)
        volume:
          type: number
          title: Volume
          description: Trading volume in USD
        roi:
          type: number
          title: Roi
          description: Return on investment (decimal, e.g., 0.5 = 50%)
        trades:
          type: integer
          title: Trades
          description: Number of trades
        wins:
          type: integer
          title: Wins
          description: Number of winning positions closed
        losses:
          type: integer
          title: Losses
          description: Number of losing positions closed
        win_rate:
          type: number
          title: Win Rate
          description: Win rate (decimal, e.g., 0.6 = 60%)
        profit_factor:
          type: number
          title: Profit Factor
          description: Profit factor (gross profit / gross loss)
        positions_closed:
          type: integer
          title: Positions Closed
          description: Number of positions closed
        avg_buy_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Buy Price
          description: Volume-weighted average buy price (0-1)
        avg_sell_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Sell Price
          description: Volume-weighted average sell price (0-1)
        fees_paid:
          type: number
          title: Fees Paid
          description: Taker fees paid in USD
          default: 0
        fees_refunded:
          type: number
          title: Fees Refunded
          description: 'DEPRECATED: always 0. Refunds are already netted into fees_paid.'
          default: 0
      type: object
      required:
        - realized_pnl
        - volume
        - roi
        - trades
        - wins
        - losses
        - win_rate
        - profit_factor
        - positions_closed
      title: WindowMetrics
      description: Metrics for a specific time window.
    AllTimeMetrics:
      properties:
        realized_pnl:
          type: number
          title: Realized Pnl
          description: Realized profit/loss in USD (from closed positions)
        total_pnl:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Pnl
          description: Total PnL in USD (realized + unrealized - net fees)
        volume:
          type: number
          title: Volume
          description: Trading volume in USD
        roi:
          type: number
          title: Roi
          description: Return on investment (decimal, e.g., 0.5 = 50%)
        trades:
          type: integer
          title: Trades
          description: Number of trades
        wins:
          type: integer
          title: Wins
          description: Number of winning positions closed
        losses:
          type: integer
          title: Losses
          description: Number of losing positions closed
        win_rate:
          type: number
          title: Win Rate
          description: Win rate (decimal, e.g., 0.6 = 60%)
        profit_factor:
          type: number
          title: Profit Factor
          description: Profit factor (gross profit / gross loss)
        positions_closed:
          type: integer
          title: Positions Closed
          description: Number of positions closed
        avg_buy_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Buy Price
          description: Volume-weighted average buy price (YES-adjusted, 0-1)
        avg_sell_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Sell Price
          description: Volume-weighted average sell price (YES-adjusted, 0-1)
        fees_paid:
          type: number
          title: Fees Paid
          description: Taker fees paid in USD
          default: 0
        fees_refunded:
          type: number
          title: Fees Refunded
          description: 'DEPRECATED: always 0. Refunds are already netted into fees_paid.'
          default: 0
        avg_hold_time_seconds:
          type: number
          title: Avg Hold Time Seconds
          description: Average hold time in seconds
        wallet_age_days:
          type: integer
          title: Wallet Age Days
          description: Days since first trade
        total_positions:
          type: integer
          title: Total Positions
          description: Total token positions ever opened (YES and NO counted separately)
        active_positions:
          type: integer
          title: Active Positions
          description: Number of currently open positions
        max_win_streak:
          type: integer
          title: Max Win Streak
          description: Maximum consecutive wins
        max_loss_streak:
          type: integer
          title: Max Loss Streak
          description: Maximum consecutive losses
        best_position_realized_pnl:
          type: number
          title: Best Position Realized Pnl
          description: Best single position realized PnL in USD
        worst_position_realized_pnl:
          type: number
          title: Worst Position Realized Pnl
          description: Worst single position realized PnL in USD
      type: object
      required:
        - realized_pnl
        - volume
        - roi
        - trades
        - wins
        - losses
        - win_rate
        - profit_factor
        - positions_closed
        - avg_hold_time_seconds
        - wallet_age_days
        - total_positions
        - active_positions
        - max_win_streak
        - max_loss_streak
        - best_position_realized_pnl
        - worst_position_realized_pnl
      title: AllTimeMetrics
      description: Extended metrics available only for all-time window.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````