Contracts

Query smart contracts and collections available in the marketplace

List smart contracts and collections

get

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

/v1/contracts

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

Query parameters

categorystring · enumOptional

Filter by NFT category

Example: wearablePossible values:

networkstring · enumOptional

Filter by network

Example: MATICPossible values:

firstnumberOptional

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

Default: 0Example: 10

skipnumberOptional

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

Default: 0Example: 0

Responses

200

List of contracts with total count

application/json

totalnumberRequired

Total number of contracts matching the query

500

Internal server error

application/json

get

/v1/contracts

HTTPcURLJavaScriptPython

GET /v1/contracts HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*

{
  "data": [
    {
      "name": "Decentraland Wearables",
      "address": "0x123456789abcdef123456789abcdef0123456789",
      "category": "wearable",
      "network": "MATIC",
      "chainId": 137
    }
  ],
  "total": 1
}