Picks

Manage picks within favorites lists

Get statistics for a specific item

get
/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
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
get
/v1/picks/{itemId}/stats
200

Pick statistics

Get global pick statistics

get
/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
get
/v1/picks/stats
200

All picks statistics

Get all picks for a specific item

get
/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
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
get
/v1/picks/{itemId}
200

Item picks

Bulk pick/unpick operation

post
/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
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
actionstring · enumRequired

Action to perform

Possible values:
listIdsstring[]Required

List of list IDs

Responses
post
/v1/picks/{itemId}

Last updated