Skip to main content

Overview

Every wallet on Predexon is automatically classified with trading labels based on its on-chain activity. These labels power the wallet profile, cohort stats, leaderboard filtering, and smart money analytics. Labels fall into two categories: behavioral labels (how a wallet trades) and entry price labels (what prices a wallet buys at).
Don’t like the defaults? Every label is exposed as an individual boolean column (e.g. is_whale, is_contrarian), so you can ignore primary_trading_style entirely and build your own composite filters using the leaderboard or filter endpoints.

Behavioral Labels

These describe how a wallet trades based on trade frequency, sizing, and win rate.
LabelColumnCriteria
WHALEis_whaleAverage trade size at least 1,000 USD
MARKET_MAKERis_market_makerBuy ratio 40–60% AND at least 10 trades per position
ACTIVE_TRADERis_active_traderMore than 4 trades per position
BUY_AND_HOLDis_buy_and_hold2 or fewer trades per position
DEGENis_degenWin rate below 35% AND at least 50 closed positions

Entry Price Labels

These describe what prices a wallet enters positions at, revealing conviction and risk appetite.
LabelColumnCriteria
HIGH_CONVICTIONis_high_convictionAvg buy price at or above 0.80 (buys heavy favorites)
CONTRARIANis_contrarianAvg buy price at or below 0.25 (takes unpopular sides)
VALUE_HUNTERis_value_hunterAvg buy price between 0.35–0.55 (enters near 50/50 odds)

Primary Trading Style

Each wallet is assigned a single primary_trading_style label, derived by priority order:
WHALE > MARKET_MAKER > ACTIVE_TRADER > DEGEN > BUY_AND_HOLD > MIXED > UNKNOWN
This means a wallet that qualifies as both a WHALE and an ACTIVE_TRADER will be classified as WHALE. If no behavioral label applies, the wallet is labeled MIXED (has some activity but no dominant style) or UNKNOWN (insufficient data).
Entry price labels (HIGH_CONVICTION, CONTRARIAN, VALUE_HUNTER) are independent and do not affect the primary trading style. A wallet can be a WHALE and a CONTRARIAN at the same time.

Minimum Requirements

Labels are only assigned once a wallet meets minimum activity thresholds to ensure statistical significance:
RequirementThreshold
General classificationAt least 5 trades and 3 days of wallet age
Entry price labelsAt least 100 USD in buy volume
DEGEN labelAt least 50 closed positions
Wallets below these thresholds will have primary_trading_style: "UNKNOWN" and all boolean label columns set to false.

Custom Filtering

The primary_trading_style field is a convenient default, but you are not limited to it. Every label is available as an individual boolean field, so you can combine them however you like. For example, to find wallets that are both whales and contrarians, filter the leaderboard with:
GET /v2/polymarket/leaderboard?is_whale=true&is_contrarian=true
Or use the cohort stats endpoint to compare aggregate performance across any label.

Next Steps