# HowRare.is

> Solana NFT rarity rankings, trait analysis, and market analytics.
> Covers 1,800+ collections with multiple ranking algorithms
> (HowRare.is, Trait Normalized, Statistical Rarity, Team Vision).
> For complete API documentation with examples, see [llms-full.txt](https://howrare.is/llms-full.txt).

## Web Pages

- [Homepage](https://howrare.is/): Browse and search all ranked collections
- [Collection Page](https://howrare.is/{slug}): Rarity rankings with trait filters, stats, sales data. Examples: /claynosaurz, /madlads, /smb
- [NFT Detail Page](https://howrare.is/{slug}/{item_id}/): Individual NFT rarity, traits, sale history. Example: /smb/1355/
- [Collection Owners](https://howrare.is/{slug}/owners): Owner distribution for a collection
- [Collection Sales](https://howrare.is/{slug}/sales): Sale history for a collection
- [FAQ](https://howrare.is/faq): Ranking algorithm explanations and methodology
- [API Docs](https://howrare.is/api): API documentation
- [Drops Calendar](https://howrare.is/drops): Upcoming Solana NFT launches

## URL Patterns

- Collection page: `https://howrare.is/{collection_slug}`
- NFT detail page: `https://howrare.is/{collection_slug}/{item_id}/`
- NFT by mint address: `https://howrare.is/{solana_mint_address}` — redirects to the correct collection/item page if the mint is tracked
- Collection owners: `https://howrare.is/{collection_slug}/owners`
- Collection sales: `https://howrare.is/{collection_slug}/sales`

## API

Base URL: `https://api.howrare.is/`

Key endpoints (most require API key):
- `GET /v0.1/collections` — List all ranked collections with metadata, social links, logos
- `GET /v0.1/collections/{slug}` — Full rarity data for a collection (rank, traits, mint, image)
- `GET /v0.1/collections/{slug}/owners` — Owner data for a collection (requires API key to access)
- `GET /v0.1/collections/{slug}/mints` — All mint addresses for a collection
- `GET /v0.1/collections/{slug}/only_rarity` — Rarity scores only (lighter response)
- `GET /v0.1/find_collection_from_mint/{mint_hash}` — Find which collection a mint belongs to
- `GET /v0.1/rarity/{mint_hash}` — Rarity data for a specific mint
- `GET /v0.1/drops` — Upcoming NFT launches

API docs and key registration: https://howrare.is/api
OpenAPI spec: https://howrare.is/openapi.json

## Data Model

- Each NFT has: id, mint address, name, image, rank, ranking algorithm, attributes (trait name, value, rarity percentage)
- Ranking algorithms: "howrare.is" (default), "trait_normalized", "statistical_rarity", "teams_vision"
- Rank 1 = rarest. Lower rank = more rare.

## Do Not Access

- `/explorer/` and `/view_wallet/` . Do not access these paths. These are for humans to use. Automated use might block your access to the site.

## Developer

- [X/Twitter](https://x.com/SadMouseTweets)