> For the complete documentation index, see [llms.txt](https://holoscope-trade.gitbook.io/holoscope/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://holoscope-trade.gitbook.io/holoscope/intelligence/graded-rarity.md).

# Graded Rarity

Graded Rarity describes how scarce a card is at its specific grade within the grading company's reported population. It appears in your inventory and on the listing detail page, including the sticky information bar and supply section.

It is a HoloScope indicator, not an official designation from a grader or the card's printed rarity, such as Rare or Ultra Rare.

## What affects the rating?

* **Copies at this grade:** how much of the reported population sits at the card's exact grade.
* **Copies graded higher:** how much higher-grade supply exists above it.
* **Grading difficulty:** verified gem-rate evidence can add context for eligible gem grades.
* **Extremely low total graded supply:** a verified ultra-low population guarantees Legendary regardless of the card's age. Higher-grade supply then determines its score within the Legendary band rather than lowering its tier.
* **Total graded supply and age:** very low reported supply can support Legendary for a vintage card, even when higher grades exist.

These are considered relative to the same card's reported population. A count of 300 copies can mean something very different for a card with thousands of graded copies than for one with only a few hundred.

The indicator uses a proprietary model. The inputs are explained here so you can interpret the result; the formula, weights, and tier boundaries are not published.

## Read the indicator

| Tier      | Color      | Meaning                                                  |
| --------- | ---------- | -------------------------------------------------------- |
| Common    | Gray       | Lower relative graded scarcity.                          |
| Uncommon  | Green      | Some relative scarcity at this grade.                    |
| Rare      | Blue       | Stronger relative scarcity.                              |
| Epic      | Purple     | High relative scarcity.                                  |
| Legendary | Gold       | The highest graded-scarcity tier.                        |
| Unknown   | Muted gray | Suitable population evidence is missing or inconsistent. |

The bar shows the tier progression and marks where this card falls. The information below it provides population context for a closer look. The inventory rarity mix summarizes the tiers in your collection.

The number is a **score out of 100**, not a percentage chance, an investment rating, or a percentile ranking against every other card. A score of 90 does not mean the card is rarer than 90% of all cards.

Higher-graded copies always retain a penalty: a card with reported higher-grade supply cannot reach or display 100. A score of 100 does not mean only one copy exists.

## Why isn't every Grade 10 Legendary?

A high grade alone does not guarantee scarcity. If a large share of that card's reported population achieves the same grade, a Grade 10 can receive a lower tier. A lower grade can receive a strong rating when its relative population supports it.

Grading companies and grade lanes are kept separate. A PSA result should not be treated as interchangeable with CGC or BGS, including their premium grade labels.

## What it does not tell you

Population reports count reported graded copies, not every surviving card. They do not establish the total print run, ungraded supply, or how many copies are available to buy today.

Legendary does not automatically mean valuable, underpriced, or easy to sell. Common does not mean poor condition or a bad card. Read rarity alongside the estimate, completed sales, liquidity, and confidence.

Reports can grow or change, and the indicator reflects the population data currently available to HoloScope rather than a live census. A tier can change when that evidence changes. Unknown means insufficient evidence, not zero supply.

Sometimes a report is shared across several versions of the same card and only belongs to one of them. HoloScope withholds that copy rather than treating it as the version's own population, so the card can show Unknown.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://holoscope-trade.gitbook.io/holoscope/intelligence/graded-rarity.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.