Sign in
latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

NFTs

List and search 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.

get/v1/nfts

Query parameters

firstnumber

Maximum number of NFTs to return (default: 100)

skipnumber

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

sortBy'name' | 'newest' | 'recently_listed' | 'recently_sold' | 'cheapest' | 'rental_listing_date' | 'rented_date' | 'max_rental_price' | 'min_rental_price'

Sort results by specified criteria

category'parcel' | 'estate' | 'wearable' | 'ens' | 'emote'

Filter by NFT category

ownerstring

Filter by owner wallet address

isOnSaleboolean

Filter by whether NFT is currently on sale

isOnRentboolean

Filter by whether NFT (LAND) is available for rent

searchstring

Text search across NFT names and descriptions

isLandboolean

Filter for LAND parcels and estates only

isWearableHeadboolean

Filter for head wearables only

isWearableAccessoryboolean

Filter for accessory wearables only

isWearableSmartboolean

Filter for smart wearables only

wearableCategory'eyebrows' | 'eyes' | 'facial_hair' | 'hair' | 'body_shape' | 'mouth' | 'upper_body' | 'lower_body' | 'feet' | 'earring' | 'eyewear' | 'hat' | 'helmet' | 'mask' | 'tiara' | 'top_head' | 'skin' | 'hands_wear'

Filter by specific wearable category

wearableGenderstring[]

Filter by wearable gender compatibility. Can be repeated.

emoteCategory'dance' | 'stunt' | 'greetings' | 'fun' | 'poses' | 'reactions' | 'horror' | 'miscellaneous'

Filter by emote category

emoteGenderstring[]

Filter by emote gender compatibility. Can be repeated.

emotePlayModestring[]

Filter by emote play mode. Can be repeated.

emoteHasGeometryboolean

Filter for emotes with geometry/props

emoteHasSoundboolean

Filter for emotes with sound

contractAddressstring[]

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

creatorstring[]

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

tokenIdstring

Filter by specific token ID

itemRaritystring[]

Filter by item rarity. Can be repeated.

itemIdstring

Filter by specific item ID within a collection

network'ETHEREUM' | 'MATIC'

Filter by blockchain network

rentalStatusstring[]

Filter by rental status (for LAND). Can be repeated.

adjacentToRoadboolean

Filter for LAND parcels adjacent to roads

minDistanceToPlazanumber

Minimum distance to plaza (for LAND filtering)

maxDistanceToPlazanumber

Maximum distance to plaza (for LAND filtering)

tenantstring

Filter by tenant wallet address (for rented LAND)

minPricestring

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

maxPricestring

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

minEstateSizenumber

Minimum estate size (number of parcels)

maxEstateSizenumber

Maximum estate size (number of parcels)

rentalDaysnumber[]

Filter by rental period in days. Can be repeated.

Response

List of NFTs with total count

totalnumber required

Total number of NFTs matching the filters