Picks

Manage picks within favorites lists

Get statistics for a specific item

get

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

/v1/picks/{itemId}/stats

Retrieves pick statistics for a specific marketplace item.

Returns:

• Total number of times the item has been picked (added to lists)

• Number of different lists containing this item

• Popularity metrics

Authentication is optional but may provide additional user-specific data.

Authorizations

SignedFetch

AuthorizationstringOptional

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

itemIdstringRequired

Unique identifier of the marketplace item

Responses

200

Pick statistics

application/json

itemIdstringRequired

Item ID

pickCountnumberRequired

Number of picks

listsCountnumberRequired

Number of lists containing this item

get/v1/picks/{itemId}/stats

HTTPcURLJavaScriptPython

GET /v1/picks/{itemId}/stats HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Pick statistics

{
  "itemId": "text",
  "pickCount": 1,
  "listsCount": 1
}

Get global pick statistics

get

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

/v1/picks/stats

Retrieves aggregated statistics across all picks in the marketplace.

Returns:

• Total number of picks across all lists

• Total number of unique items that have been picked

• Total number of active lists

Use this endpoint for global marketplace analytics and engagement metrics.

Responses

200

All picks statistics

application/json

totalPicksnumberRequired

Total number of picks

totalItemsnumberRequired

Total number of items picked

totalListsnumberRequired

Total number of lists

get/v1/picks/stats

HTTPcURLJavaScriptPython

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

200

All picks statistics

{
  "totalPicks": 1,
  "totalItems": 1,
  "totalLists": 1
}

Get all picks for a specific item

get

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

/v1/picks/{itemId}

Retrieves all pick instances for a specific marketplace item. Shows which lists contain this item and associated pick metadata.

Authentication is optional but may provide access to private lists if the user has permissions.

Authorizations

SignedFetch

AuthorizationstringOptional

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

itemIdstringRequired

Unique identifier of the marketplace item

Responses

200

Item picks

application/json

idstringRequired

Pick ID

itemIdstringRequired

Item ID

listIdstringRequired

List ID

userstringRequired

User address

createdAtstring · date-timeOptional

Pick creation timestamp

get/v1/picks/{itemId}

HTTPcURLJavaScriptPython

GET /v1/picks/{itemId} HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Item picks

[
  {
    "id": "text",
    "itemId": "text",
    "listId": "text",
    "user": "text",
    "createdAt": "2026-07-09T19:14:43.085Z"
  }
]

Bulk pick/unpick operation

post

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

/v1/picks/{itemId}

Adds or removes an item from multiple favorites lists in a single operation.

Authentication Required: User must be authenticated and authorized.

Use cases:

• Add an item to multiple lists at once

• Remove an item from multiple lists at once

This is more efficient than making individual pick/unpick requests when managing multiple lists.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

itemIdstringRequired

Unique identifier of the marketplace item to pick/unpick

Body

application/json

actionstring · enumRequired

Action to perform

Possible values:

listIdsstring[]Required

List of list IDs

Responses

200

Bulk operation completed

application/json

successbooleanRequired

Operation success status

processednumberRequired

Number of items processed

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

post/v1/picks/{itemId}

HTTPcURLJavaScriptPython

POST /v1/picks/{itemId} HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "action": "pick",
  "listIds": [
    "text"
  ]
}

{
  "success": true,
  "processed": 1
}