Accounts

Query account statistics and marketplace activity

Query account statistics and activity

get

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

/v1/accounts

Retrieves accounts with their marketplace activity statistics including sales, purchases, earnings, spending, royalties, and collection counts.

Supports filtering and sorting by various metrics:

• Most sales, purchases, collections created

• Highest earnings, spending, or royalties earned

• Specific accounts by address or ID

• Network filtering (Ethereum, Polygon)

Use this endpoint to:

• Display marketplace leaderboards

• Track user trading statistics

• Analyze account activity and performance

• Identify top sellers, buyers, and creators

Results are paginated and can be sorted by different ranking criteria.

Query parameters

firstnumberOptional

Maximum number of accounts to return (default: 100, max: 1000)

Example: 100

skipnumberOptional

Number of accounts to skip for pagination (default: 0)

Example: 0

sortBystring · enumOptional

Sort accounts by specific metrics:

• most_sales: Accounts with most items sold
• most_purchases: Accounts with most items purchased
• most_royalties: Accounts earning most royalties
• most_collections: Accounts with most collections created
• most_earned: Accounts with highest total earnings
• most_spent: Accounts with highest total spending

Example: most_salesPossible values:

idstringOptional

Filter by specific account ID

addressstring[]Optional

Filter by one or more account addresses (can be repeated or comma-separated)

networkstring · enumOptional

Filter by network

Example: ETHEREUMPossible values:

Responses

200

Account statistics

application/json

totalnumberRequired

Total number of accounts matching the filters

500

Internal server error

application/json

get/v1/accounts

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "id": "0x1234567890abcdef1234567890abcdef12345678",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "sales": 43,
      "purchases": 15,
      "spent": "5000000000000000000",
      "earned": "10000000000000000000",
      "royalties": "500000000000000000",
      "collections": 3
    }
  ],
  "total": 1
}