Sales
Query sales history and transactions
The closing MANA/USD rate of each UTC day between two instants, read from the Chainlink MANA/USD feed on Polygon (the last round written that day) and stored by a background job. The feed starts on 2021-07-08, so earlier days are never returned. Days not yet stored are simply absent.
Inclusive start in epoch milliseconds; its UTC day is the first day returned. At most 8640000000000000.
Inclusive end in epoch milliseconds; at most 15 years after from.
One rate per stored day, oldest first
Missing, malformed or reversed bounds, or a range over 15 years.
GET /v1/rates/mana-usd?from=1&to=1 HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*
{
"data": [
{
"day": "2026-09-25",
"usd": "0.09302823"
}
]
}Every resale (order or bid sale) of an item the address created, whoever sold it, newest first. Each row carries the royalty the marketplace sent in that trade and who received it: the item's beneficiary when one is set, else the creator. Amounts are gross MANA wei as decimal strings. total and royaltiesWei cover the whole window, not only the page.
Creator wallet address (case insensitive).
^0x[a-fA-F0-9]{40}$Inclusive start in epoch milliseconds; must not exceed to.
Inclusive end in epoch milliseconds.
Page size, capped at 100.
200A page of resales, the number in the window and their royalty total
Missing or invalid creator, malformed or reversed bounds, or an invalid page.
GET /v1/sales/royalties?creator=text HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*
{
"total": 1,
"royaltiesWei": "text",
"data": [
{
"id": "text",
"timestamp": 1,
"contractAddress": "text",
"itemId": null,
"tokenId": "text",
"priceWei": "text",
"royaltyWei": "text",
"collector": null,
"buyer": "text",
"seller": "text",
"network": "text"
}
]
}Returns unpaginated aggregates from the same sales source as /v1/sales. All amounts are gross MANA wei encoded as decimal strings, including sales paid in Credits. The optional inclusive millisecond bounds apply to totals, collections and royalties. byItem counts only the seller's lifetime mint sales, ignoring both bounds; resales are excluded so the count can be subtracted from totalSupply to estimate copies minted without a sale. Items without mint sales are omitted. byItem may remain populated when the window has no sales. Royalties count order/bid sales of items whose creator is seller, regardless of who sold them. volumeWei is resale volume, not the actual royalty payout. Creator resale activity can be nonzero even if the address has no direct sales. Otherwise absent activity returns zeros and empty arrays.
Seller wallet address (case insensitive).
^0x[a-fA-F0-9]{40}$Inclusive start in epoch milliseconds; must not exceed to.
Inclusive end in epoch milliseconds.
Sales summary
Missing or invalid seller, invalid timestamps, or reversed time window.
GET /v1/sales/summary?seller=text HTTP/1.1
Host: marketplace-api.decentraland.org
Accept: */*
{
"data": {
"total": 1,
"mints": 1,
"resales": 1,
"earnedWei": "115026000000000000000",
"earnedUsd": "10.720981",
"unpricedSales": 1,
"byCollection": [
{
"contractAddress": "text",
"sold": 1,
"earnedWei": "text",
"earnedUsd": "text",
"unpricedSales": 1
}
],
"byItem": [
{
"contractAddress": "text",
"itemId": "text",
"soldLifetime": 1
}
],
"royalties": {
"resales": 1,
"volumeWei": "text",
"royaltiesWei": "text"
}
}
}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).
Maximum number of sales to return (default: 100)
100Example: 10Number of sales to skip for pagination (default: 0)
0Example: 0Sort results by specified criteria
recently_soldPossible values: Filter by sale type
orderPossible values: Filter by seller wallet address
0x1234567890abcdef1234567890abcdef12345678Filter by buyer wallet address
Filter by NFT contract address
0x1234567890abcdef1234567890abcdef12345678Filter by specific token ID
Filter by item ID
Filter sales from this Unix timestamp (in seconds)
1640000000Filter sales up to this Unix timestamp (in seconds)
1650000000Minimum sale price filter
0.1Maximum sale price filter
100Filter by blockchain network
MATICPossible values: List of sales with total count
Total number of sales matching the filters
Bad request - invalid parameters
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-01-01T00:00:00.000Z"
}
],
"total": 1
}Last updated