> ## 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 Profiles (Batch)

> Get wallet profiles for multiple addresses in a single request

Returns the same data as the [single wallet profile](/api-reference/wallet/wallet-profile) endpoint, but for up to 20 wallets at once. Wallets not found are omitted from the response.

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


## OpenAPI

````yaml GET /v2/polymarket/wallets/profiles
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/wallets/profiles:
    get:
      tags:
        - polymarket
        - smart-wallet
      summary: Get Wallet Profiles Batch
      description: >-
        Get wallet profiles for multiple addresses in a single request.


        Returns the same data as the single wallet profile endpoint, but for
        multiple wallets.

        Wallets not found are omitted from the response.
      operationId: get_wallet_profiles_batch_v2_polymarket_wallets_profiles_get
      parameters:
        - name: addresses
          in: query
          required: true
          schema:
            type: string
            description: Comma-separated wallet addresses (max 20)
            title: Addresses
          description: Comma-separated wallet addresses (max 20)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WalletProfileResponse'
                title: >-
                  Response Get Wallet Profiles Batch V2 Polymarket Wallets
                  Profiles Get
        '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:
    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

````