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

# Wallet grades

> Understand wallet grades, what changes them, and how to filter by grade.

A wallet's `grade` summarizes its realized profit relative to other wallets 0xinsider tracks. Grades run from `S` to `F`; use them to compare past records and filter trades or positions.

A grade describes completed trading, rather than the result of an open position or a future trade. Recent form is a separate field, `streak_tier`, explained on [Scores](/concepts/signal-scoring).

<span id="the-bands" />

## Read a grade

| Grade | Listed on the leaderboard |
| - | - |
| `S` | Yes. |
| `A` | Yes. |
| `B` | Yes. |
| `C` | No. |
| `D` | No. |
| `F` | No. |

`score` is the returned ranking value from 0 to 100. Read the returned `grade` and `score` directly.

If no grade is available, `grade` and `score` are omitted. An ungraded wallet has no supported grade comparison yet.

<span id="filter-by-grade" />

## Filter API results

`min_grade=A` includes `S` and `A`. `min_grade=B` includes `S`, `A`, and `B`.

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

| Endpoint | Accepted `min_grade` values | Default |
| - | - | - |
| Large trades and history | `S`, `A`, `B`, `C`, `D`, `F` | No grade filter. |
| Positions and large positions | `S`, `A`, `B`, `C`, `D`, `F` | No grade filter. |
| Sharp money flows and its smart money alias | `S`, `A`, `B`, `C`, `D`, `F` | `B`. |
| Stream and event replay | `S`, `A`, `B`, `C`, `D`, `F` | No grade filter. |
| Market holders and pre-game sides | `S`, `A`, `B` | `B`. |

Market holders and pre-game sides return `400` for `C`, `D`, or `F`, with `error.param` set to `min_grade`. The [leaderboard](/api-reference/endpoint/get-leaderboard) has no `min_grade` parameter and lists only `S`, `A`, and `B` wallets.

<span id="terms-on-this-page" />

<span id="what-sets-the-grade" />

## What determines the grade

A grade summarizes completed trading, with realized profit as its main basis. It can change as records are updated.

Realized P\&L is profit and loss on closed positions, including fees and credited maker and taker rebates. Open-position gains and losses are excluded.

A resolved market is one that has settled, so its result is known. Use the wallet's measured record and [quant metrics](/concepts/quant-metrics) for the underlying performance context.

<span id="caps-that-lower-a-grade" />

<span id="floors-that-raise-a-grade" />

## Availability

Missing or unverified records can limit the available grade evidence. Read [trust metadata](/concepts/trust-metadata) when you need the source and freshness of a returned value.

<span id="what-this-does-not-tell-you" />

## Limits

A grade does not explain every change in a wallet's rank. It also does not measure its open-position P\&L, current form, or the outcome of its next trade; read those fields separately.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.