v1

latestOpenAPI 3.1.02026-07-24130315342.2 KB
Listing Endpoints

Get best listings by collection

Get the best listings for a collection sorted by price ascending. Optionally filter by item traits using the 'traits' query parameter with a JSON array of trait filters. Multiple traits are AND-combined (items must match all). Note: results are not deduplicated by token ID — if a token has multiple listings, each listing is returned individually. Filter client-side if you need unique tokens. Example: ?traits=[{"traitType":"Background","value":"Red"}]

get/api/v2/listings/collection/{slug}/best

Path parameters

slugstring required

Unique string to identify a collection on OpenSea

Query parameters

include_private_listingsboolean

Whether to include private listings; defaults to false

traitsstring

JSON array of trait filters to narrow listings by item traits. Each object has 'traitType' and 'value' fields. Multiple traits are AND-combined (items must match all). Example: [{"traitType":"Background","value":"Red"}]

limitinteger

Number of items to return per page

Example:20

Number of items to return per page

nextstring

Response

OK