Catalog

Browse and search marketplace catalog items

Get marketplace catalog (v1)

get

https://marketplace-api.decentraland.orghttps://marketplace-api.decentraland.zone

/v1/catalog

Retrieves the marketplace catalog with items available for browsing and purchase. Supports filtering by category, price range, and various item attributes. Authentication is optional but recommended for personalized results.

Note: Consider using /v2/catalog for enhanced features and performance.

Pagination: Uses first and skip parameters.

This endpoint shares all the same filter parameters as /v1/items, plus catalog-specific options.

Authorizations

SignedFetch

AuthorizationstringOptional

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Query parameters

firstnumberOptional

Maximum number of items to return (default: 20)

Default: 20Example: 10

skipnumberOptional

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

Default: 0Example: 0

sortBystring · enumOptional

Sort results by specified criteria

Example: cheapestPossible values:

sortDirectionstring · enumOptional

Sort direction

Default: ascPossible values:

onlyListingbooleanOptional

Show only items with active listings

onlyMintingbooleanOptional

Show only items available for minting

categorystring · enumOptional

Filter by NFT category

Possible values:

creatorstring[]Optional

Filter by creator wallet address(es). Can be repeated.

isSoldOutbooleanOptional

Filter by sold out status

isOnSalebooleanOptional

Filter by whether item is currently on sale

searchstringOptional

Text search across item names and descriptions

isWearableHeadbooleanOptional

Filter for head wearables only

isWearableAccessorybooleanOptional

Filter for accessory wearables only

isWearableSmartbooleanOptional

Filter for smart wearables only

wearableCategorystring · enumOptional

Filter by specific wearable category

Possible values:

emoteCategorystring · enumOptional

Filter by emote category

Possible values:

emoteHasGeometrybooleanOptional

Filter for emotes with geometry/props

emoteHasSoundbooleanOptional

Filter for emotes with sound

contractAddressstring[]Optional

Filter by collection contract address(es). Can be repeated.

itemIdstringOptional

Filter by specific item ID within a collection

networkstring · enumOptional

Filter by blockchain network

Possible values:

minPricestringOptional

Minimum price filter in ETH/MATIC

maxPricestringOptional

Maximum price filter in ETH/MATIC

urnstring[]Optional

Filter by item URN(s). Can be repeated.

idstring[]Optional

Filter by item ID(s). Can be repeated.

Responses

200

Marketplace catalog

application/json

totalnumberRequired

Total number of items

400

Bad request

application/json

500

Internal server error

application/json

get/v1/catalog

HTTPcURLJavaScriptPython

GET /v1/catalog HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "image": "text",
      "category": "text",
      "rarity": "text",
      "price": 1,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "total": 1
}

Get marketplace catalog (v2 - Recommended)

get

https://marketplace-api.decentraland.orghttps://marketplace-api.decentraland.zone

/v2/catalog

Retrieves the marketplace catalog with enhanced filtering and sorting capabilities.

Supports comprehensive filtering by:

• Categories (wearables, emotes)

• Price ranges and sorting

• Rarities and creator addresses

• Wearable-specific filters (gender, category, accessories, smart wearables)

• Emote-specific filters (category, play mode, sound, geometry)

• Text search across item names and descriptions

Pagination: Uses first and skip parameters.

Authentication is optional but may provide personalized results and user-specific data.

This endpoint accepts all the same parameters as /v1/catalog.

Authorizations

SignedFetch

AuthorizationstringOptional

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Query parameters

firstnumberOptional

Maximum number of items to return (default: 20)

Default: 20Example: 10

skipnumberOptional

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

Default: 0Example: 0

sortBystring · enumOptional

Sort results by specified criteria

Example: cheapestPossible values:

sortDirectionstring · enumOptional

Sort direction

Default: ascPossible values:

onlyListingbooleanOptional

Show only items with active listings

onlyMintingbooleanOptional

Show only items available for minting

categorystring · enumOptional

Filter by NFT category

Possible values:

creatorstring[]Optional

Filter by creator wallet address(es). Can be repeated.

isSoldOutbooleanOptional

Filter by sold out status

isOnSalebooleanOptional

Filter by whether item is currently on sale

searchstringOptional

Text search across item names and descriptions

isWearableHeadbooleanOptional

Filter for head wearables only

isWearableAccessorybooleanOptional

Filter for accessory wearables only

isWearableSmartbooleanOptional

Filter for smart wearables only

wearableCategorystring · enumOptional

Filter by specific wearable category

Possible values:

emoteCategorystring · enumOptional

Filter by emote category

Possible values:

emoteHasGeometrybooleanOptional

Filter for emotes with geometry/props

emoteHasSoundbooleanOptional

Filter for emotes with sound

contractAddressstring[]Optional

Filter by collection contract address(es). Can be repeated.

itemIdstringOptional

Filter by specific item ID within a collection

networkstring · enumOptional

Filter by blockchain network

Possible values:

minPricestringOptional

Minimum price filter in ETH/MATIC

maxPricestringOptional

Maximum price filter in ETH/MATIC

urnstring[]Optional

Filter by item URN(s). Can be repeated.

idstring[]Optional

Filter by item ID(s). Can be repeated.

Responses

200

Marketplace catalog v2

application/json

totalnumberRequired

Total number of items

400

Bad request

application/json

500

Internal server error

application/json

get/v2/catalog

HTTPcURLJavaScriptPython

GET /v2/catalog HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "image": "text",
      "category": "text",
      "rarity": "text",
      "price": 1,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "total": 1
}