OPopensea
Collection Endpoints

Get top NFT collections by profile-picture wearer count

Changed on

NFT collections ranked by how many accounts use a verified (currently-owned) NFT from the collection as their profile picture, most first. Only verified collections are ranked. A verified collection is still not ranked when it is blacklisted or trust and safety has delisted, disabled, marked it as spam, or excluded it from promotion, top and trending lists, or discovery. Name registries (ENS and Basenames) and collections with no verified wearers are never ranked. Ties are ordered by collection slug ascending. Each wearer counts for the collection their NFT belongs to, so a contract shared by several collections is split per item, and wearers are counted as get_collection_pfp_profiles lists them. The chain, category and floor price filters narrow the board, and ranks stay contiguous from 1 within it.

get/api/v2/pfp/top-collections

Request

Query parameters

limitinteger required

Maximum number of collections to return (1-50).

chain'base' | 'ethereum' | 'zora' | 'arbitrum' | 'sei' | 'avalanche' | 'polygon' | 'optimism' | 'ape_chain' | 'flow' | 'soneium' | 'ronin' | 'bera_chain' | 'solana' | 'shape' | 'unichain' | 'gunzilla' | 'abstract' | 'animechain' | 'hyperevm' | 'somnia' | 'monad' | 'hyperliquid' | 'megaeth' | 'ink' | 'robinhood' | 'stablechain'

Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')

Example:ethereum

Deprecated: use chains. Same as chains with this one chain; when both are given, wearers on any of them count.

chainsChainIdentifier[]

Chains whose wearers count, as a comma-separated list or a repeated parameter. Omit to rank across all chains. A chain that is not supported matches no wearers.

[
  "ethereum"
]
categoriesstring[]

Categories to rank, as a comma-separated list or a repeated parameter (e.g. art, gaming, memberships, music, pfps, photography, domain-names, virtual-worlds, sports-collectibles, physical-collectibles). Omit to rank every category.

min_floor_price_usdnumber double

Minimum floor (best listing) price in USD, inclusive; must not exceed max_floor_price_usd. Collections with no listing priced in USD are left out when either floor price bound is given. Rounded down to two significant digits.

max_floor_price_usdnumber double

Maximum floor (best listing) price in USD, inclusive. Collections with no listing priced in USD are left out when either floor price bound is given. Rounded up to two significant digits.

Response

Top PFP collections list

Changes