> ## 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.
# Cohort Stats
> Compare performance across trading style cohorts
Understand which trading styles perform best. Cohorts are based on `primary_trading_style`: WHALE, MARKET\_MAKER, ACTIVE\_TRADER, BUY\_AND\_HOLD, DEGEN, HIGH\_CONVICTION, CONTRARIAN, VALUE\_HUNTER.
**Requires Dev or Pro tier.** This endpoint is not available on the Free tier.
See [Trading Labels](/api-reference/trading-labels) for how each cohort is defined, the criteria behind each label, and minimum requirements for classification.
**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
## OpenAPI
````yaml GET /v2/polymarket/cohorts/stats
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/cohorts/stats:
get:
tags:
- polymarket
- smart-wallet
summary: Get Cohort Stats
description: |-
Compare performance across trading style cohorts.
**Use Case:** Understand which trading styles perform best.
**Cohorts:** Based on primary_trading_style classification:
- WHALE: Large position traders
- MARKET_MAKER: Balanced buy/sell with frequent trading
- ACTIVE_TRADER: High trade frequency
- BUY_AND_HOLD: Long holding periods
- DEGEN: High-risk patterns
- HIGH_CONVICTION: Buys at high prices
- CONTRARIAN: Takes unpopular sides
- VALUE_HUNTER: Enters at uncertain odds
Returns aggregate statistics for each cohort.
operationId: get_cohort_stats_v2_polymarket_cohorts_stats_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: min_trades
in: query
required: false
schema:
anyOf:
- type: integer
minimum: 1
- type: 'null'
description: Minimum trades to be included in cohort (filters noise)
default: 10
title: Min Trades
description: Minimum trades to be included in cohort (filters noise)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CohortComparisonResponse'
'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.
CohortComparisonResponse:
properties:
window:
$ref: '#/components/schemas/TimeWindow'
description: Time window for metrics
cohorts:
items:
$ref: '#/components/schemas/CohortStats'
type: array
title: Cohorts
description: Performance stats per cohort
total_wallets:
type: integer
title: Total Wallets
description: Total wallets across all cohorts
type: object
required:
- window
- cohorts
- total_wallets
title: CohortComparisonResponse
description: Response for cohort performance comparison.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ErrorResponse:
properties:
error:
type: string
title: Error
message:
type: string
title: Message
type: object
required:
- error
- message
title: ErrorResponse
description: Standard error response.
CohortStats:
properties:
cohort_name:
type: string
title: Cohort Name
description: Name of the cohort (e.g., trading style)
wallet_count:
type: integer
title: Wallet Count
description: Number of wallets in this cohort
total_volume:
type: number
title: Total Volume
description: Total volume from this cohort (USD)
total_realized_pnl:
type: number
title: Total Realized Pnl
description: Total realized PnL from this cohort (USD)
avg_realized_pnl:
type: number
title: Avg Realized Pnl
description: Average realized PnL per wallet (USD)
median_realized_pnl:
type: number
title: Median Realized Pnl
description: Median realized PnL (USD) - approximated
avg_roi:
type: number
title: Avg Roi
description: Average ROI
avg_win_rate:
type: number
title: Avg Win Rate
description: Average win rate
avg_profit_factor:
type: number
title: Avg Profit Factor
description: Average profit factor
avg_trades:
type: number
title: Avg Trades
description: Average number of trades
profitable_wallet_pct:
type: number
title: Profitable Wallet Pct
description: Percentage of wallets with positive PnL (0-1)
total_fees_paid:
type: number
title: Total Fees Paid
description: Total taker fees paid by this cohort (USD)
default: 0
total_fees_refunded:
type: number
title: Total Fees Refunded
description: 'DEPRECATED: always 0. Refunds are already netted into fees_paid.'
default: 0
avg_fees_paid:
type: number
title: Avg Fees Paid
description: Average taker fees paid per wallet (USD)
default: 0
avg_fees_refunded:
type: number
title: Avg Fees Refunded
description: 'DEPRECATED: always 0. Refunds are already netted into fees_paid.'
default: 0
type: object
required:
- cohort_name
- wallet_count
- total_volume
- total_realized_pnl
- avg_realized_pnl
- median_realized_pnl
- avg_roi
- avg_win_rate
- avg_profit_factor
- avg_trades
- profitable_wallet_pct
title: CohortStats
description: Performance statistics for a cohort of wallets.
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
````