NFTs

Query and manage NFTs including wearables, emotes, and LAND

List and search NFTs

get

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

/v1/nfts

Retrieves NFTs from the Decentraland marketplace with comprehensive filtering capabilities.

Supports multiple NFT types:

• Wearables (clothing, accessories)

• LAND parcels and Estates

• ENS names

• Emotes

Advanced filtering options:

• Ownership and sale/rental status

• Categories and search text

• Price ranges (min/max)

• LAND-specific: distance to plaza, adjacent to roads, estate size

• Rental status and rental days for LAND parcels

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

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

• Network selection (Ethereum mainnet, Polygon)

• Sort by: name, newest, recently listed/sold, cheapest, rental metrics

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

Authentication is optional but provides access to user-specific data like favorites.

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 NFTs to return (default: 100)

Default: 100Example: 10

skipnumberOptional

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

Default: 0Example: 0

sortBystring · enumOptional

Sort results by specified criteria

Example: newestPossible values:

categorystring · enumOptional

Filter by NFT category

Example: wearablePossible values:

ownerstringOptional

Filter by owner wallet address

Example: 0x1234567890abcdef1234567890abcdef12345678

isOnSalebooleanOptional

Filter by whether NFT is currently on sale

Example: true

isOnRentbooleanOptional

Filter by whether NFT (LAND) is available for rent

searchstringOptional

Text search across NFT names and descriptions

Example: genesis

isLandbooleanOptional

Filter for LAND parcels and estates only

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.

creatorstring[]Optional

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

tokenIdstringOptional

Filter by specific token ID

itemIdstringOptional

Filter by specific item ID within a collection

networkstring · enumOptional

Filter by blockchain network

Example: MATICPossible values:

adjacentToRoadbooleanOptional

Filter for LAND parcels adjacent to roads

minDistanceToPlazanumberOptional

Minimum distance to plaza (for LAND filtering)

maxDistanceToPlazanumberOptional

Maximum distance to plaza (for LAND filtering)

tenantstringOptional

Filter by tenant wallet address (for rented LAND)

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

minEstateSizenumberOptional

Minimum estate size (number of parcels)

maxEstateSizenumberOptional

Maximum estate size (number of parcels)

rentalDaysnumber[]Optional

Filter by rental period in days. Can be repeated.

Responses

200

List of NFTs with total count

application/json

totalnumberRequired

Total number of NFTs matching the filters

400

Bad request - invalid parameters

application/json

get

/v1/nfts

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "id": "text",
      "tokenId": "text",
      "contract": "text",
      "owner": "text",
      "metadata": {},
      "price": 1
    }
  ],
  "total": 1
}