---
title: "List completed sales"
method: GET
path: "/v1/sales"
tags: ["Sales"]
---

# List completed sales

`GET /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

- `first` number
- `skip` number
- `sortBy` 'recently_sold' | 'most_expensive'
- `type` 'order' | 'bid' | 'mint'
- `category` string[]
- `seller` string
- `buyer` string
- `contractAddress` string
- `tokenId` string
- `itemId` string
- `from` number
- `to` number
- `minPrice` string
- `maxPrice` string
- `network` 'ETHEREUM' | 'MATIC'

## Response `200`

List of sales with total count

- object
  - `data` object[], required
    - `id` string, required — Sale ID
    - `buyer` string, required — Buyer address
    - `seller` string, required — Seller address
    - `item` object
      - `id` string, required — Item ID
      - `name` string, required — Item name
      - `description` string — Item description
      - `image` string — Item image URL
      - `category` string, required — Item category
      - `rarity` string — Item rarity
      - `price` number — Item price
      - `owner` string — Item owner
    - `price` number, required — Sale price
    - `timestamp` string, date-time — Sale timestamp
  - `total` number, required — Total number of sales matching the filters

## Other responses

- `400` — Bad request - invalid parameters

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)