Sign in
latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Sales

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).

get/v1/sales

Query parameters

firstnumber

Maximum number of sales to return (default: 100)

skipnumber

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

sortBy'recently_sold' | 'most_expensive'

Sort results by specified criteria

type'order' | 'bid' | 'mint'

Filter by sale type

categorystring[]

Filter by NFT category. Can be repeated for multiple categories.

sellerstring

Filter by seller wallet address

buyerstring

Filter by buyer wallet address

contractAddressstring

Filter by NFT contract address

tokenIdstring

Filter by specific token ID

itemIdstring

Filter by item ID

fromnumber

Filter sales from this Unix timestamp (in seconds)

tonumber

Filter sales up to this Unix timestamp (in seconds)

minPricestring

Minimum sale price filter

maxPricestring

Maximum sale price filter

network'ETHEREUM' | 'MATIC'

Filter by blockchain network

Response

List of sales with total count

totalnumber required

Total number of sales matching the filters