Lambdas

This service provides a set of utilities required by the Catalyst Server Clients\Consumers in order to retrieve or validate data.

Catalyst Server status

get
/lambdas/status

Retrieve detailed information about the services

Responses
chevron-right
200

Catalyst services information

application/json; charset=utf-8
get
/lambdas/status
200

Catalyst services information

Get Collections

get
/lambdas/collections

Retrieve the list of collections URNs

Responses
chevron-right
200

Array of collections URNs and names

application/json; charset=utf-8
get
/lambdas/collections

Download thumbnail image

get
/lambdas/collections/contents/{urn}/thumbnail

Downloads a thumbnail image for the specified urn

Path parameters
urnstringRequired

Uniform Resource Name (URN) that identifies the asset

Example: urn:decentraland:matic:collections-v2:0x04e43281f36e1f1bfae6f38bc276cb48fb8ac632:0
Responses
chevron-right
200

Thumbnail image

application/octet-stream
Responsestring · binaryExample: binary
get
/lambdas/collections/contents/{urn}/thumbnail
200

Thumbnail image

Download URN image

get
/lambdas/collections/contents/{urn}/image

Downloads the image for the specified urn

Path parameters
urnstringRequired

Uniform Resource Name (URN) that identifies the asset

Example: urn:decentraland:matic:collections-v2:0x04e43281f36e1f1bfae6f38bc276cb48fb8ac632:0
Responses
chevron-right
200

Resource image

application/octet-stream
Responsestring · binaryExample: binary
get
/lambdas/collections/contents/{urn}/image
200

Resource image

Get ERC721 Entity

get
/lambdas/collections/standard/erc721/{chainId}/{contract}/{option}/{emission}

Retrieve ERC721/NFT Entity details

Path parameters
chainIdstringRequired

Ethereum chain ID: ETHEREUM_MAINNET = 1 ETHEREUM_RINKEBY = 4 ETHEREUM_GOERLI = 5 ETHEREUM_KOVAN = 42 MATIC_MAINNET = 137 MATIC_MUMBAI = 80001

Example: 137
contractstringRequired

Hash of the Contract. This will be used to build the URN that identifies the NFT.

Example: 0x123db7844eaf7da11d88cf1754945bbd020742ef
optionstringRequired

Token Identifier

Example: 3
emissionstringRequired

Optional rarity description that will be return as part of the NFT description common: 100000 uncommon: 10000 rare: 5000 epic: 1000 legendary: 100 mythic: 10 unique: 1

Example: legendary
Responses
chevron-right
200

Resource image

application/json; charset=utf-8
get
/lambdas/collections/standard/erc721/{chainId}/{contract}/{option}/{emission}

Get list of wearables for an address

get
/lambdas/users/{address}/wearables

Get a list of wearables owned by the given address

Path parameters
addressstringRequired

Ethereum address from which you want to get the list of wearables

Example: 0xa87d168717538e86d71ac48baccaeb84162de602
Query parameters
includeEntitiesbooleanOptional

If present, response will be extended with the entity data.

Example: true
includeThirdPartybooleanOptional

If present, response will include the third-party wearables owned by the address. They will appear before other wearables if the response is paginated.

Example: true
pageNumstringOptional

The number of the requested page.

Example: 1
pageSizestringOptional

The size of the requested page.

Example: 10
orderBystringOptional

Determines the field to be sort by. By default it will be by transferredAt. Possible values: transferredAt and rarity.

Example: rarity
Responses
chevron-right
200

List of wearables owned by the given address

application/json; charset=utf-8
get
/lambdas/users/{address}/wearables

Get list of emotes for an address

get
/lambdas/users/{address}/emotes

Get a list of emotes owned by the given address

Path parameters
addressstringRequired

Ethereum address from which you want to get the list of emotes

Example: 0xf4f7512c68f358856514cd4e449fc6c5ac04bb15
Query parameters
collectionIdstringOptional

Third Party collection Id to filter emotes, if this param is not sent then the 3rd parties emotes are not shown. If it is sent, only the 3rd parties emotes are shown.

Example: urn:decentraland:matic:collections-thirdparty:ntr1-meta:ntr1-meta-1ef79e7b
includeEntitiesbooleanOptional

If present, response will be extended with the entity data.

Example: true
pageNumstringOptional

The number of the requested page.

Example: 1
pageSizestringOptional

The size of the requested page

Example: 10
Responses
chevron-right
200

List of emotes owned by the given address

application/json; charset=utf-8
get
/lambdas/users/{address}/emotes

Get list of names for an address

get
/lambdas/users/{address}/names

Get a list of names owned by the given address

Path parameters
addressstringRequired

Ethereum address from which you want to get the list of names

Example: 0xddf1eec586d8f8f0eb8c5a3bf51fb99379a55684
Query parameters
pageNumstringOptional

The number of the requested page. It needs pageSize to be present to enable a paginated response.

Example: 1
pageSizestringOptional

The size of the requested page. It needs pageNum to be present to enable a paginated response.

Example: 10
Responses
chevron-right
200

List of names owned by the given address

application/json; charset=utf-8
get
/lambdas/users/{address}/names

Get list of lands for an address

get
/lambdas/users/{address}/lands

Get a list of lands owned by the given address

Path parameters
addressstringRequired

Ethereum address from which you want to get the list of lands

Example: 0xddf1eec586d8f8f0eb8c5a3bf51fb99379a55684
Query parameters
pageNumstringOptional

The number of the requested page. It needs pageSize to be present to enable a paginated response.

Example: 1
pageSizestringOptional

The size of the requested page. It needs pageNum to be present to enable a paginated response.

Example: 10
Responses
chevron-right
200

List of lands owned by the given address

application/json; charset=utf-8
get
/lambdas/users/{address}/lands

Get the permissions for a parcel

get
/lambdas/users/{address}/parcels/{x}/{y}/permissions

Get the permissions a user has for a parcel

Path parameters
addressstringRequired

Ethereum address from which you want to get the permissions

Example: 0xddf1eec586d8f8f0eb8c5a3bf51fb99379a55684
xstringRequired

X coordinate of the parcel

Example: 100
ystringRequired

Y coordinate of the parcel

Example: 100
Responses
chevron-right
200

permissions a user has for a parcel

application/json; charset=utf-8
get
/lambdas/users/{address}/parcels/{x}/{y}/permissions

Returns the list of third party wearables for the provided address

get
/lambdas/users/{address}/third-party-wearables

Returns the list of third party wearables for the provided address

Path parameters
addressstringRequired

Ethereum address from which you want to get the list of wearables

Example: 0xf4f7512c68f358856514cd4e449fc6c5ac04bb15
Query parameters
pageNumstringOptional

The number of the requested page.

Example: 1
pageSizestringOptional

The size of the requested page.

Example: 10
Responses
chevron-right
200

Returns the list of third party wearables

application/json; charset=utf-8
get
/lambdas/users/{address}/third-party-wearables
200

Returns the list of third party wearables

Returns the list of third party wearables for the given collection

get
/lambdas/users/{address}/third-party-wearables/{collectionId}

Returns the list of third party wearables for the given collection

Path parameters
addressstringRequired

Ethereum address from which you want to get the list of wearables

Example: 0xf4f7512c68f358856514cd4e449fc6c5ac04bb15
collectionIdstringRequired

Third Party collection Id to filter wearables.

Example: urn:decentraland:matic:collections-thirdparty:ntr1-meta:ntr1-meta-1ef79e7b
Query parameters
pageNumstringOptional

The number of the requested page.

Example: 1
pageSizestringOptional

The size of the requested page.

Example: 10
Responses
chevron-right
200

Returns the list of third party wearables

application/json; charset=utf-8
get
/lambdas/users/{address}/third-party-wearables/{collectionId}
200

Returns the list of third party wearables

Deprecated

Search Wearables

get
/lambdas/collections/wearables

Search for wearables based on the applied filters and retrieve detailed information

Query parameters
collectionIdstring[]Optional

Lis of URNs that identify the collection. Maximum amount of ids allowed is 500.

Example: urn:decentraland:ethereum:collections-v1:mf_sammichgamer
wearableIdstring[]Optional

List of wearables URNs to search. Maximum amount of ids allowed is 500.

Example: urn:decentraland:ethereum:collections-v1:binance_us_collection:binance_us_hat
textSearchstringOptional

Search text

Example: Hoodie
limitintegerOptional

Limit the quantity of results that will be returned by the request. You can only request up to 500 results.

Example: 2
lastIdstringOptional

The result will always be ordered by the local timestamp fields but in case of timestamp collisions, you can use the lastId field to filter the result

Example: urn:decentraland:ethereum:collections-v1:binance_us_collection:binance_us_hat
Responses
chevron-right
200

Catalyst services health information

application/json; charset=utf-8
get
/lambdas/collections/wearables

Get Catalyst Servers

get
/lambdas/contracts/servers

Retrieve the list of Catalyst Servers

Responses
chevron-right
200

List of Catalyst Servers

application/json; charset=utf-8
get
/lambdas/contracts/servers
200

List of Catalyst Servers

Retrieve DCL Point of Interests

get
/lambdas/contracts/pois

Retrieve the Point of Interest list of coordinates

Responses
chevron-right
200

List of Point of Interest coordinates. These are currently highlighted in the DCL Atlas.

application/json; charset=utf-8
Responsestring[]
get
/lambdas/contracts/pois
200

List of Point of Interest coordinates. These are currently highlighted in the DCL Atlas.

Denylisted user names

get
/lambdas/contracts/denylisted-names

Retrieve list of forbidden user names. The prohibition of these names is decided through the DAO and need to be voted, the list lives in a Smart Contract and the Catalyst just consumes this information to present it to the client. In order to add a new name a new proposal needs to be created, approved and a transaction should be sent by a DAO committee member.

Responses
chevron-right
200

Array of forbidden names by the DAO

application/json; charset=utf-8
Responsestring[]
get
/lambdas/contracts/denylisted-names
200

Array of forbidden names by the DAO

Deprecated

Validate signed message

post
/lambdas/crypto/validate-signature

Given a signed message and it's AuthChain, validate it's authenticity. A message can be signed, for example, to prove ownership of the Entity pointers that they want to modify.

Body
objectOptional
Responses
chevron-right
200

Result of the signature validation with owner address or errors

application/json
Responseobject
post
/lambdas/crypto/validate-signature

Hot Scenes

get
/lambdas/explore/hot-scenes

Returns the list of scenes where there are more users with coordinates and the list of parcels that compose the scene.

Responses
chevron-right
200

List of scenes

application/json; charset=utf-8
get
/lambdas/explore/hot-scenes
200

List of scenes

Get Realms status

get
/lambdas/explore/realms

Returns the list of realms with details about the users in it

Responses
chevron-right
200

List of the current state of the realms. The userParcels array is the list of parcels in which there are users present.

application/json; charset=utf-8
get
/lambdas/explore/realms
200

List of the current state of the realms. The userParcels array is the list of parcels in which there are users present.

Get the operators for a parcel

get
/lambdas/parcels/{x}/{y}/operators

Get the operators for a parcel

Path parameters
xstringRequired

X coordinate of the parcel

Example: 100
ystringRequired

Y coordinate of the parcel

Example: 100
Responses
chevron-right
200

operators for a parcel

application/json; charset=utf-8
get
/lambdas/parcels/{x}/{y}/operators

Get Avatars details

post
/lambdas/profiles

Returns all the Avatars details associated with the Ethereum addresses in the body

Body
idsstring[]Optional
Responses
chevron-right
200

Array of Avatars

application/json
post
/lambdas/profiles

Get Avatar details

get
/lambdas/profiles/{id}

Given a Ethereum address of a user, return the Avatars details associated with it.

Path parameters
idstringRequired

Ethereum address of the user

Example: 0x22480812a9a0669783c06d359182a583bd1d9fc2
Responses
chevron-right
200

Array of Avatars

application/json
get
/lambdas/profiles/{id}
200

Array of Avatars

Get Outfits

get
/lambdas/outfits/{id}

Given a Ethereum address of a user, return the Outfits entity.

Path parameters
idstringRequired

Ethereum address of the user

Example: 0x22480812a9a0669783c06d359182a583bd1d9fc2
Responses
chevron-right
200

Outfits entity

application/json
get
/lambdas/outfits/{id}
200

Outfits entity

Returns the list of third party integrations as well as collections

get
/lambdas/third-party-integrations

Returns the list of third party integrations and collections

Responses
chevron-right
200

Returns the list of third party integrations and collections

application/json; charset=utf-8
get
/lambdas/third-party-integrations
200

Returns the list of third party integrations and collections

Last updated