latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Contracts

List smart contracts and collections

Retrieves smart contract addresses and collection information available in the marketplace.

This endpoint returns both marketplace contracts (LAND, Estates, Names, etc.) and collection contracts (primarily wearables) from the database.

Contract Types:

  • Marketplace Contracts: Core Decentraland contracts including LAND parcels, Estates, ENS Names, and legacy wearable collections
  • Collection Contracts: Third-party and creator collections, primarily wearables on Polygon network

Filter Options:

  • Category filtering (parcel, estate, ens, wearable, emote)
  • Network filtering
  • Pagination (first/skip)

Pagination:

  • Use first and skip parameters for pagination
  • first=0 returns all results (no limit)
  • skip allows you to skip the first N results
  • Pagination is applied after category and network filters

Use Cases:

  • Retrieve contract addresses for specific NFT categories
  • List all available collections in the marketplace
  • Filter contracts by network
  • Paginate through large result sets

Response Structure: Each contract includes:

  • Contract address
  • Contract name
  • NFT category (parcel, estate, ens, wearable, emote)
  • Network
  • Chain ID

Performance Notes:

  • Collection contracts are cached for 1 hour to improve performance
  • Use category and network filters to reduce response size
  • Pagination is applied in-memory after fetching all matching contracts
get/v1/contracts

Query parameters

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

Filter by NFT category

network'ETHEREUM' | 'MATIC'

Filter by network

firstnumber

Maximum number of contracts to return. Use 0 to return all results (default: 0)

skipnumber

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

Response

List of contracts with total count

totalnumber required

Total number of contracts matching the query