---
title: "List smart contracts and collections"
method: GET
path: "/v1/contracts"
tags: ["Contracts"]
---

# List smart contracts and collections

`GET /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

- `category` 'parcel' | 'estate' | 'ens' | 'wearable' | 'emote'
- `network` 'ETHEREUM' | 'MATIC'
- `first` number
- `skip` number

## Response `200`

List of contracts with total count

- object
  - `data` object[], required — List of contracts
    - `name` string, required — Human-readable name of the contract or collection
    - `address` string, required — Contract address
    - `category` 'parcel' | 'estate' | 'ens' | 'wearable' | 'emote', required — NFT category type: - parcel: LAND parcels - estate: Estate (group of LAND parcels) - ens: Ethereum Name Service names - wearable: Avatar wearables - emote: Avatar emotes/animations
    - `network` 'ETHEREUM' | 'MATIC', required — Blockchain network: - ETHEREUM: Ethereum mainnet - MATIC: Polygon network
    - `chainId` 1 | 137, required — Blockchain chain ID: - 1: Ethereum mainnet - 137: Polygon mainnet
  - `total` number, required — Total number of contracts matching the query

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)