Items

View marketplace items and collections

List marketplace items

get

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

/v1/items

Retrieves items from marketplace collections. Items are templates/blueprints for NFTs in collections (e.g., wearable designs, emote templates).

Filter capabilities:

• Specific contract address and item ID

• Category (wearable, emote)

• Creator addresses (multiple allowed)

• Sale and sold-out status

• Text search by name or description

• Price range filtering

• Wearable filters: category, gender, head/accessory/smart types

• Emote filters: category, play mode, sound, geometry

• Network selection (Ethereum, Polygon)

• URN and ID filtering

Pagination: Uses first and skip parameters (NOT limit/offset).

Authentication is optional but may provide personalized results including pick statistics.

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: 100)

Default: 100Example: 10

skipnumberOptional

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

Default: 0Example: 0

categorystring · enumOptional

Filter by NFT category

Example: wearablePossible values:

creatorstring[]Optional

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

Example: ["0x1234567890abcdef1234567890abcdef12345678"]

isSoldOutbooleanOptional

Filter by sold out status

Example: false

isOnSalebooleanOptional

Filter by whether item is currently on sale

Example: true

searchstringOptional

Text search across item names and descriptions

Example: cyberpunk

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

Example: upper_bodyPossible values:

emoteCategorystring · enumOptional

Filter by emote category

Example: dancePossible 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.

Example: ["0x1234567890abcdef1234567890abcdef12345678"]

itemIdstringOptional

Filter by specific item ID within a collection

Example: 0

networkstring · enumOptional

Filter by blockchain network

Example: MATICPossible values:

minPricestringOptional

Minimum price filter in ETH/MATIC (e.g., "0.1")

Example: 0.1

maxPricestringOptional

Maximum price filter in ETH/MATIC (e.g., "100")

Example: 100

urnstring[]Optional

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

idstring[]Optional

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

Responses

200

List of items with total count

application/json

400

Bad request - invalid parameters

application/json

get

/v1/items

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "image": "text",
      "category": "text",
      "rarity": "text",
      "price": 1,
      "owner": "text"
    }
  ],
  "total": 1
}