Sales

Query sales history and transactions

List completed sales

get

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

/v1/sales

Retrieves historical sales transactions from the marketplace. Sales represent completed purchases of NFTs and items.

Use this endpoint to:

• Track sales history and market activity

• Analyze price trends

• View transaction details (buyer, seller, price, timestamp)

Filter options:

• Sale type (order, bid, mint)

• Categories (wearable, emote, parcel, estate, ens)

• Seller and buyer addresses

• Contract address, token ID, and item ID

• Time range filtering (from/to timestamps)

• Price range (min/max)

• Network (Ethereum, Polygon)

Sorting options:

• recently_sold (default)

• most_expensive

Pagination: Uses first and skip parameters (NOT limit/offset).

Query parameters

firstnumberOptional

Maximum number of sales to return (default: 100)

Default: 100Example: 10

skipnumberOptional

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

Default: 0Example: 0

sortBystring · enumOptional

Sort results by specified criteria

Example: recently_soldPossible values:

typestring · enumOptional

Filter by sale type

Example: orderPossible values:

sellerstringOptional

Filter by seller wallet address

Example: 0x1234567890abcdef1234567890abcdef12345678

buyerstringOptional

Filter by buyer wallet address

contractAddressstringOptional

Filter by NFT contract address

Example: 0x1234567890abcdef1234567890abcdef12345678

tokenIdstringOptional

Filter by specific token ID

itemIdstringOptional

Filter by item ID

fromnumberOptional

Filter sales from this Unix timestamp (in seconds)

Example: 1640000000

tonumberOptional

Filter sales up to this Unix timestamp (in seconds)

Example: 1650000000

minPricestringOptional

Minimum sale price filter

Example: 0.1

maxPricestringOptional

Maximum sale price filter

Example: 100

networkstring · enumOptional

Filter by blockchain network

Example: MATICPossible values:

Responses

200

List of sales with total count

application/json

totalnumberRequired

Total number of sales matching the filters

400

Bad request - invalid parameters

application/json

get/v1/sales

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "id": "text",
      "buyer": "text",
      "seller": "text",
      "item": {
        "id": "text",
        "name": "text",
        "description": "text",
        "image": "text",
        "category": "text",
        "rarity": "text",
        "price": 1,
        "owner": "text"
      },
      "price": 1,
      "timestamp": "2026-08-11T10:53:15.647Z"
    }
  ],
  "total": 1
}