> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xinsider.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trader Grades

> What S, A, B, C, D, F mean, with real profile examples.

Every trader gets one letter grade. It answers one question: should you pay attention to this wallet?

Grades show up on the leaderboard, on every trader profile, and inside every whale trade object.

## The scale

| Grade | One-line meaning                                                     | On the leaderboard? |
| ----- | -------------------------------------------------------------------- | ------------------- |
| **S** | Elite. Years of evidence, outsized P\&L, high win rate, real volume. | Yes                 |
| **A** | Strong. Consistently profitable, well-diversified across markets.    | Yes                 |
| **B** | Above average. Solid recent track record, smaller sample.            | Yes                 |
| **C** | Roughly breakeven. Not a clear signal.                               | No                  |
| **D** | Net losing across the sample.                                        | No                  |
| **F** | Persistently losing. Often coin-flip or chasing resolved markets.    | No                  |

The leaderboard ranks only S, A, and B. Those are the wallets worth following.

## What goes into the grade

The score is a composite (0-100) of five inputs:

1. **Realized P\&L**: actual profit from closed positions, not unrealized markings.
2. **Win rate**: share of markets that resolved in their favor.
3. **Volume**: total traded size. More volume means more signal per trade.
4. **Market count**: distinct markets they have touched (diversification).
5. **Recency**: penalizes wallets that have not traded in a long time.

Score thresholds assign the letter. Only B or better makes the leaderboard.

## Two real profiles, side by side

### S-grade: deep history, sustained edge

```json theme={null}
{
  "object": "trader",
  "data": {
    "id": "trd_0x863134d00841b2e200492805a01e1e2f5defaa53",
    "username": "RepTrump",
    "grade": "S",
    "score": 97.94,
    "pnl": 7532409.67,
    "win_rate": 1.0,
    "markets_traded": 28,
    "strategy_type": "swing_trader",
    "best_category": "politics"
  }
}
```

Very high realized P\&L, near-perfect win rate, a classifiable strategy, a clear category strength.

### C-grade: noisy and small

```json theme={null}
{
  "object": "trader",
  "data": {
    "id": "trd_0xc111...",
    "username": null,
    "grade": "C",
    "score": 42.10,
    "pnl": 318.55,
    "win_rate": 0.5238,
    "markets_traded": 21,
    "strategy_type": null,
    "best_category": null
  }
}
```

P\&L near breakeven, a coin-flip win rate, no detectable strategy. Visible in the API, but not on the leaderboard.

## Using grades in the API

### Filter whale trades by grade

Only see trades from A-grade or better:

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/whale-trades?min_grade=A&limit=50"
```

`min_grade` accepts `S`, `A`, `B`. Setting `min_grade=A` returns S **and** A.

### Filter the leaderboard by strategy

Pull only S/A/B-grade swing traders:

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/leaderboard?strategy=swing_trader"
```

Some traders make the leaderboard but lack a classifiable strategy. Their `strategy_type` is `null`, so treat the field as nullable when filtering client-side.

### Combine grade + category

What are A-grade or better crypto traders trading right now? (Each item carries its `side` in the response, so you can split buys from sells client-side.)

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/whale-trades?min_grade=A&category=crypto&limit=50"
```

## A note on null strategies

A leaderboard trader without a strategy classification just means we haven't detected a stable pattern yet. They are still a graded trader. Don't filter them out unless you actually need a labeled strategy.