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

# Trading Labels

> How Predexon classifies wallet trading behavior and entry styles

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

<Tip>
  **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.
</Tip>

## Behavioral Labels

These describe *how* a wallet trades based on trade frequency, sizing, and win rate.

| Label              | Column             | Criteria                                             |
| ------------------ | ------------------ | ---------------------------------------------------- |
| **WHALE**          | `is_whale`         | Average trade size at least 1,000 USD                |
| **MARKET\_MAKER**  | `is_market_maker`  | Buy ratio 40–60% AND at least 10 trades per position |
| **ACTIVE\_TRADER** | `is_active_trader` | More than 4 trades per position                      |
| **BUY\_AND\_HOLD** | `is_buy_and_hold`  | 2 or fewer trades per position                       |
| **DEGEN**          | `is_degen`         | Win 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.

| Label                | Column               | Criteria                                                 |
| -------------------- | -------------------- | -------------------------------------------------------- |
| **HIGH\_CONVICTION** | `is_high_conviction` | Avg buy price at or above 0.80 (buys heavy favorites)    |
| **CONTRARIAN**       | `is_contrarian`      | Avg buy price at or below 0.25 (takes unpopular sides)   |
| **VALUE\_HUNTER**    | `is_value_hunter`    | Avg 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).

<Note>
  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.
</Note>

## Minimum Requirements

Labels are only assigned once a wallet meets minimum activity thresholds to ensure statistical significance:

| Requirement            | Threshold                                          |
| ---------------------- | -------------------------------------------------- |
| General classification | At least **5 trades** and **3 days** of wallet age |
| Entry price labels     | At least **100 USD** in buy volume                 |
| DEGEN label            | At 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](/api-reference/analytics/leaderboard) with:

```
GET /v2/polymarket/leaderboard?is_whale=true&is_contrarian=true
```

Or use the [cohort stats](/api-reference/analytics/cohort-stats) endpoint to compare aggregate performance across any label.

## Next Steps

<CardGroup cols={2}>
  <Card title="Wallet Profile" icon="user" href="/api-reference/wallet/wallet-profile">
    See all labels for a specific wallet
  </Card>

  <Card title="Cohort Stats" icon="chart-bar" href="/api-reference/analytics/cohort-stats">
    Compare performance across trading styles
  </Card>

  <Card title="Leaderboard" icon="trophy" href="/api-reference/analytics/leaderboard">
    Filter the leaderboard by any label combination
  </Card>

  <Card title="Filter Wallets" icon="filter" href="/api-reference/analytics/filter-wallets">
    Find wallets by market activity and labels
  </Card>
</CardGroup>
