OPopensea
NFT Endpoints

Search NFTs across a collection group

Changed on

Search NFTs across every collection in a group, such as trading_cards, using normalized attributes that are consistent across issuers. Each attribute (franchise, grader, grade, subject, year, set, language, edition, product_type) is a repeatable query parameter, for example ?franchise=Pokemon&grader=PSA&grader=CGC&grade=10. Use /nfts/group/{group}/facets to discover values and counts.

get/api/v2/nfts/group/{group}

Request

Path parameters

groupstring required

Collection group

Query parameters

collection_slugsstring[]

Restrict results to these collections in the group (max 10). Defaults to the whole group.

querystring

Full-text match on NFT name, up to 100 characters

is_listedboolean

Only return NFTs that are listed (true) or unlisted (false)

min_estimated_value_usdnumber double

Minimum estimated value in USD, inclusive

max_estimated_value_usdnumber double

Maximum estimated value in USD, inclusive

sort_bystring

Sort field: price, top_offer, last_sale, last_sale_date, created_date, received_date, listing_created_date, best_deal, or estimated_value

sort_directionstring

Sort direction: asc or desc

limitinteger

Number of items to return per page

Example:20
nextstring
franchisestring[]

Only return NFTs whose normalized franchise is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

graderstring[]

Only return NFTs whose normalized grader is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

gradestring[]

Only return NFTs whose normalized grade is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

subjectstring[]

Only return NFTs whose normalized subject is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

yearstring[]

Only return NFTs whose normalized year is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

setstring[]

Only return NFTs whose normalized set is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

languagestring[]

Only return NFTs whose normalized language is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

editionstring[]

Only return NFTs whose normalized edition is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

product_typestring[]

Only return NFTs whose normalized product type is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

Response

OK

nextstring nullable

Cursor for the next page of results

Example response

{
  "nfts": [
    {
      "best_listing_price": {
        "amount": "120.5",
        "currency": "POL",
        "usd": "40.12"
      },
      "estimated_value_usd": "250.5"
    }
  ]
}

Changes