# Sales

Query sales history and transactions

## List completed 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\`).<br>

```json
{"openapi":"3.1.0","info":{"title":"Decentraland Marketplace Server API","version":"1.0.0"},"tags":[{"name":"Sales","description":"Query sales history and transactions"}],"servers":[{"url":"https://marketplace-api.decentraland.org","description":"Production server"},{"url":"https://marketplace-api.decentraland.zone","description":"Development server"}],"security":[],"paths":{"/v1/sales":{"get":{"tags":["Sales"],"summary":"List completed sales","description":"Retrieves historical sales transactions from the marketplace.\nSales represent completed purchases of NFTs and items.\n\n**Use this endpoint to:**\n- Track sales history and market activity\n- Analyze price trends\n- View transaction details (buyer, seller, price, timestamp)\n\n**Filter options:**\n- Sale type (order, bid, mint)\n- Categories (wearable, emote, parcel, estate, ens)\n- Seller and buyer addresses\n- Contract address, token ID, and item ID\n- Time range filtering (from/to timestamps)\n- Price range (min/max)\n- Network (Ethereum, Polygon)\n\n**Sorting options:**\n- recently_sold (default)\n- most_expensive\n\n**Pagination:** Uses `first` and `skip` parameters (NOT `limit`/`offset`).\n","operationId":"getSales","parameters":[{"name":"first","in":"query","required":false,"description":"Maximum number of sales to return (default: 100)","schema":{"type":"number","default":100}},{"name":"skip","in":"query","required":false,"description":"Number of sales to skip for pagination (default: 0)","schema":{"type":"number","default":0}},{"name":"sortBy","in":"query","required":false,"description":"Sort results by specified criteria","schema":{"type":"string","enum":["recently_sold","most_expensive"]}},{"name":"type","in":"query","required":false,"description":"Filter by sale type","schema":{"type":"string","enum":["order","bid","mint"]}},{"name":"category","in":"query","required":false,"description":"Filter by NFT category. Can be repeated for multiple categories.","schema":{"type":"array","items":{"type":"string","enum":["parcel","estate","wearable","ens","emote"]}},"style":"form","explode":true},{"name":"seller","in":"query","required":false,"description":"Filter by seller wallet address","schema":{"type":"string"}},{"name":"buyer","in":"query","required":false,"description":"Filter by buyer wallet address","schema":{"type":"string"}},{"name":"contractAddress","in":"query","required":false,"description":"Filter by NFT contract address","schema":{"type":"string"}},{"name":"tokenId","in":"query","required":false,"description":"Filter by specific token ID","schema":{"type":"string"}},{"name":"itemId","in":"query","required":false,"description":"Filter by item ID","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Filter sales from this Unix timestamp (in seconds)","schema":{"type":"number"}},{"name":"to","in":"query","required":false,"description":"Filter sales up to this Unix timestamp (in seconds)","schema":{"type":"number"}},{"name":"minPrice","in":"query","required":false,"description":"Minimum sale price filter","schema":{"type":"string"}},{"name":"maxPrice","in":"query","required":false,"description":"Maximum sale price filter","schema":{"type":"string"}},{"name":"network","in":"query","required":false,"description":"Filter by blockchain network","schema":{"type":"string","enum":["ETHEREUM","MATIC"]}}],"responses":{"200":{"description":"List of sales with total count","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Sale ID"},"buyer":{"type":"string","description":"Buyer address"},"seller":{"type":"string","description":"Seller address"},"item":{"type":"object","properties":{"id":{"type":"string","description":"Item ID"},"name":{"type":"string","description":"Item name"},"description":{"type":"string","description":"Item description"},"image":{"type":"string","description":"Item image URL"},"category":{"type":"string","description":"Item category"},"rarity":{"type":"string","description":"Item rarity"},"price":{"type":"number","description":"Item price"},"owner":{"type":"string","description":"Item owner"}},"required":["id","name","category"]},"price":{"type":"number","description":"Sale price"},"timestamp":{"type":"string","format":"date-time","description":"Sale timestamp"}},"required":["id","buyer","seller","price"]}},"total":{"type":"number","description":"Total number of sales matching the filters"}},"required":["data","total"]}}}},"400":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}}}}}}}
```