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