Sales - EXC

GET /v1/collections/{id}/sales

Completed sales, newest first. Includes EXC sales and purchases made through outside marketplaces — marketplace tells you which.

Parameter	Type	Default
`limit`	integer	`25`
`cursor`	string	—

curl "https://exclusivo.one/v1/collections/base_0xabc.../sales?limit=50"

A short page isn’t the end

The page window is cut first, and rows whose stored price can’t be interpreted are dropped afterwards. So data.length can be less than limit — even zero — while hasMore is true.Page on hasMore and nextCursor. Never stop because a page came back empty.

async function allSales(collectionId, pages = 20) {
  const out = [];
  let cursor = null;
  let i = 0;

  do {
    const qs = new URLSearchParams({ limit: '50', ...(cursor ? { cursor } : {}) });
    const { data, pagination } = await fetch(
      `https://exclusivo.one/v1/collections/${collectionId}/sales?${qs}`
    ).then(r => r.json());

    out.push(...data);                      // may be empty — keep going
    cursor = pagination.hasMore ? pagination.nextCursor : null;
  } while (cursor && ++i < pages);

  return out;
}

Response

Same shape as listings, with the sale fields filled in:

{
  "data": [
    {
      "chain": "base",
      "contractAddress": "0xabc…",
      "tokenId": "1421",
      "mint": null,
      "collectionId": "base_0xabc…",
      "price": { "raw": "48000000000000000", "decimal": 0.048, "currency": "ETH", "usd": 172.4 },
      "seller": "0x11…",
      "buyer": "0x22…",
      "marketplace": "opensea",
      "status": "sold",
      "timestamp": "2026-08-20T07:41:00.000Z",
      "orderId": null,
      "tx": "0xdead…"
    }
  ],
  "pagination": { "hasMore": true, "nextCursor": "50" }
}

Field	On a sale
`buyer`	Filled in
`tx`	The settling transaction
`status`	`sold`
`orderId`	The listing it came from — may be null

A 404 has two meanings

Either the id doesn’t resolve, or it resolves to a collection with no stored contract address — sales are keyed by that address. So a 404 here doesn’t prove the collection doesn’t exist. Check /v1/collections/{id} to tell the two apart. Errors: 400, 404, 429, 502. Unlike most of this API, sales can 502.

Working out volume

Sum price.raw and do the arithmetic in integer base units. decimal loses precision on large wei values, and usd can be null on any row. Also worth knowing: rows with prices we couldn’t interpret are dropped before you see them, so a total from this endpoint is a total of interpretable sales.

Listings — the active side of the same shape.
Collections — aggregate volume without paging the whole feed.