Picks
Manage picks within favorites lists
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.
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.
Unique identifier of the marketplace item
Pick statistics
Item ID
Number of picks
Number of lists containing this item
GET /v1/picks/{itemId}/stats HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Pick statistics
{
"itemId": "text",
"pickCount": 1,
"listsCount": 1
}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.
All picks statistics
Total number of picks
Total number of items picked
Total number of lists
GET /v1/picks/stats HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*
All picks statistics
{
"totalPicks": 1,
"totalItems": 1,
"totalLists": 1
}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.
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.
Unique identifier of the marketplace item
Item picks
Pick ID
Item ID
List ID
User address
Pick creation timestamp
GET /v1/picks/{itemId} HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Item picks
[
{
"id": "text",
"itemId": "text",
"listId": "text",
"user": "text",
"createdAt": "2026-01-01T00:00:00.000Z"
}
]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.
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.
Unique identifier of the marketplace item to pick/unpick
Action to perform
List of list IDs
Bulk operation completed
Operation success status
Number of items processed
Unauthorized - invalid signed fetch
Forbidden - invalid metadata
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
}Last updated