NFT Metadata

Endpoints for retrieving NFT metadata for parcels and estates. Metadata follows the OpenSea Metadata Standard.

Get metadata for a specific parcel

get

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

/v2/parcels/{x}/{y}

Returns detailed NFT metadata for a specific parcel, following the OpenSea Metadata Standard. Includes information about the parcel's location, name, description, owner, and various attributes.

Path parameters

xintegerRequired

X coordinate of the parcel

Example: 23

yintegerRequired

Y coordinate of the parcel

Example: -23

Responses

200

Parcel metadata

application/json

NFT metadata following the OpenSea Metadata Standard

idstringRequired

Unique identifier for the NFT

Example: parcel-23--23

namestringRequired

Name of the NFT

Example: Parcel 23,-23

descriptionstringRequired

Description of the NFT

Example: A beautiful parcel in Genesis City

imagestring · uriRequired

URL to the NFT image

Example: https://api.decentraland.org/v2/parcels/23/-23/map.png

external_urlstring · uriRequired

External URL to view the NFT in Decentraland

Example: https://market.decentraland.org/contracts/0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d/tokens/115792089237316195423570985008687907832452644793752989267978113781140059103329

background_colorstringOptional

Background color for the NFT (6-character hex code without

Example: ff0044

403

Invalid coordinates

text/plain

404

Parcel not found

application/json

503

Service not ready

text/plain

get/v2/parcels/{x}/{y}

HTTPcURLJavaScriptPython

GET /v2/parcels/{x}/{y} HTTP/1.1
Host: api.decentraland.org
Accept: */*

{
  "id": "parcel-23--23",
  "name": "Parcel 23,-23",
  "description": "A beautiful parcel in Genesis City",
  "image": "https://api.decentraland.org/v2/parcels/23/-23/map.png",
  "external_url": "https://market.decentraland.org/contracts/0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d/tokens/115792089237316195423570985008687907832452644793752989267978113781140059103329",
  "background_color": "ff0044",
  "attributes": [
    {
      "trait_type": "X",
      "value": 23,
      "display_type": "number"
    }
  ]
}

Get metadata for a specific estate

get

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

/v2/estates/{id}

Returns detailed NFT metadata for a specific estate, following the OpenSea Metadata Standard. Includes information about all parcels in the estate, as well as estate-level metadata. If the estate has been dissolved, returns the dissolved estate metadata.

Path parameters

idstringRequired

Estate ID

Example: 12345

Responses

200

Estate metadata

application/json

NFT metadata following the OpenSea Metadata Standard

idstringRequired

Unique identifier for the NFT

Example: parcel-23--23

namestringRequired

Name of the NFT

Example: Parcel 23,-23

descriptionstringRequired

Description of the NFT

Example: A beautiful parcel in Genesis City

imagestring · uriRequired

URL to the NFT image

Example: https://api.decentraland.org/v2/parcels/23/-23/map.png

external_urlstring · uriRequired

External URL to view the NFT in Decentraland

Example: https://market.decentraland.org/contracts/0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d/tokens/115792089237316195423570985008687907832452644793752989267978113781140059103329

background_colorstringOptional

Background color for the NFT (6-character hex code without

Example: ff0044

403

Invalid estate ID

text/plain

404

Estate not found

application/json

503

Service not ready

get/v2/estates/{id}

HTTPcURLJavaScriptPython

GET /v2/estates/{id} HTTP/1.1
Host: api.decentraland.org
Accept: */*

{
  "id": "parcel-23--23",
  "name": "Parcel 23,-23",
  "description": "A beautiful parcel in Genesis City",
  "image": "https://api.decentraland.org/v2/parcels/23/-23/map.png",
  "external_url": "https://market.decentraland.org/contracts/0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d/tokens/115792089237316195423570985008687907832452644793752989267978113781140059103329",
  "background_color": "ff0044",
  "attributes": [
    {
      "trait_type": "X",
      "value": 23,
      "display_type": "number"
    }
  ]
}

Get NFT metadata by contract address and token ID

get

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

/v2/contracts/{address}/tokens/{id}

Returns NFT metadata for a parcel or estate by providing the contract address and token ID. This endpoint follows the OpenSea Metadata Standard and is commonly used by NFT marketplaces.

Contract Addresses (Mainnet)

• LAND: 0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d

• Estate: 0x959e104e1a4db6317fa58f8295f586e1a978c297

For LAND parcels, responses include extended cache headers for immutability.

Path parameters

addressstringRequired

Contract address (LAND or Estate contract)

Example: 0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d

idstringRequired

Token ID

Example: 115792089237316195423570985008687907832452644793752989267978113781140059103329

Responses

200

Token metadata

application/json

404

Token not found

application/json

503

Service not ready

get/v2/contracts/{address}/tokens/{id}

HTTPcURLJavaScriptPython

GET /v2/contracts/{address}/tokens/{id} HTTP/1.1
Host: api.decentraland.org
Accept: */*

{
  "id": "parcel-23--23",
  "name": "Parcel 23,-23",
  "description": "A beautiful parcel in Genesis City",
  "image": "https://api.decentraland.org/v2/parcels/23/-23/map.png",
  "external_url": "https://market.decentraland.org/contracts/0xf87e31492faf9a91b02ee0deaad50d51d56d5d4d/tokens/115792089237316195423570985008687907832452644793752989267978113781140059103329",
  "background_color": "ff0044",
  "attributes": [
    {
      "trait_type": "X",
      "value": 23,
      "display_type": "number"
    }
  ]
}