Collections

View and search marketplace collections

List and search marketplace collections

get

/v1/collections

Retrieves marketplace collections with their metadata and statistics.

Supports comprehensive filtering:

• Search by collection name or text

• Filter by creator address

• Filter by contract address or URN

• Show only collections with items on sale

• Network filtering

Sorting options:

• Newest collections

• Recently reviewed

• Alphabetical by name

• By collection size (item count)

• Recently listed

Use this endpoint to:

• Browse marketplace collections

• Search for specific creator's collections

• Display collection catalogs

• Track new collection launches

Results include collection metadata, item counts, and listing status.

Query parameters

firstnumberOptional

Maximum number of collections to return (default: 100, max: 1000)

Example: 100

skipnumberOptional

Number of collections to skip for pagination (default: 0)

Example: 0

sortBystring · enumOptional

Sort collections by:

• newest: Most recently created
• recently_reviewed: Most recently reviewed
• name: Alphabetical order
• size: Number of items in collection
• recently_listed: Most recently listed for sale

Example: newestPossible values:

namestringOptional

Filter by exact collection name

searchstringOptional

Search collections by name or description (text search)

creatorstringOptional

Filter by creator wallet address

Example: 0x1234567890abcdef1234567890abcdef12345678

urnstringOptional

Filter by collection URN (Uniform Resource Name)

contractAddressstringOptional

Filter by collection contract address

Example: 0x1234567890abcdef1234567890abcdef12345678

isOnSalebooleanOptional

Filter collections that have items currently on sale

Example: true

networkstring · enumOptional

Filter by blockchain network (ETHEREUM or MATIC)

Example: ETHEREUMPossible values:

Responses

200

List of collections

application/json

totalnumberRequired

Total number of collections matching the filters

500

Internal server error

application/json

get/v1/collections

GET /v1/collections HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*

{
  "data": [
    {
      "urn": "urn:decentraland:matic:collections-v2:0xabcd1234...",
      "creator": "0x1234567890abcdef1234567890abcdef12345678",
      "name": "My Awesome Wearables",
      "contractAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "createdAt": 1640000000000,
      "updatedAt": 1640100000000,
      "reviewedAt": 1640050000000,
      "isOnSale": true,
      "size": 25,
      "network": "MATIC",
      "chainId": 137,
      "firstListedAt": 1640020000000
    }
  ],
  "total": 1
}