Get a product's recent sales

Returns the product's sales on the CardNexus marketplace from the last 30 days, as a cursor-paginated list. There are no date parameters — the 30-day window is fixed.

A sale appears as soon as its order is placed, including orders still being shipped or delivered. If the order is later cancelled or refunded in full, the sale no longer appears.

Each sale carries the card's finish, condition (or grading), language, the quantity sold, the seller's market region (eu or na), and two prices: price, the per-card price the card was listed at in the listing's own currency, and priceEur, the same price converted to EUR at the exchange rate of the sale date. Sales carry no buyer or seller identifiers.

The list is ordered by soldAt, newest first. Narrow the result with finish, condition, and language. A page can hold slightly more entries than limit when one order contained several matching cards.

Walk the list by following pagination.nextCursor: pass it back as cursor until it comes back null. limit defaults to 50, maximum 100.

Requests count against the product-sales rate limit: 60 requests per hour.

Authentication is required (any valid API key); no scope.

Path Parameters
  • productId
    required

    The product to list sales for. Returned by GET /v1/products and POST /v1/products/search.

    • Type: number

      The product to list sales for. Returned by GET /v1/products and POST /v1/products/search.

Query Parameters
  • cursor
    Type: string
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Integer numbers.

  • finish
    Type: string enum

    Return only sales of this finish, e.g. Standard or Foil.

    values
    • Standard

      A standard, non-foil card.

    • Foil

      A foil card.

    • Rainbow
    • Gold
    • Rainbow Foil
  • condition
    Type: string · enum

    Card condition: NM (Near Mint), LP (Lightly Played), MP (Moderately Played), HP (Heavily Played), DMG (Damaged).

    values
    • NM

      Near Mint.

    • LP

      Lightly Played.

    • MP

      Moderately Played.

    • HP

      Heavily Played.

    • DMG

      Damaged.

  • language
    Type: string
    min length:  
    1

    Return only sales of this card language, as a two-letter code, e.g. en, de.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/products/{productId}/sales
curl https://public-api.cardnexus.com/v1/products/50212/sales \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "data": [
    {
      "soldAt": "2026-06-08T19:21:44.000Z",
      "region": "na",
      "price": {
        "amount": 46,
        "currency": "USD"
      },
      "priceEur": {
        "amount": 42.3,
        "currency": "EUR"
      },
      "quantity": 1,
      "finish": "Standard",
      "condition": "NM",
      "language": "en",
      "graded": null
    },
    {
      "soldAt": "2026-06-05T08:02:13.000Z",
      "region": "eu",
      "price": {
        "amount": 86,
        "currency": "EUR"
      },
      "priceEur": {
        "amount": 86,
        "currency": "EUR"
      },
      "quantity": 1,
      "finish": "Foil",
      "condition": null,
      "language": "en",
      "graded": {
        "grade": "9.5",
        "gradingService": "PSA",
        "certification": "0084712663"
      }
    },
    {
      "soldAt": "2026-06-06T14:40:51.000Z",
      "region": "eu",
      "price": {
        "amount": 39.5,
        "currency": "EUR"
      },
      "priceEur": {
        "amount": 39.5,
        "currency": "EUR"
      },
      "quantity": 2,
      "finish": "Standard",
      "condition": "LP",
      "language": "de",
      "graded": null
    }
  ],
  "pagination": {
    "nextCursor": "MjAyNi0wNi0wNVQwOToxMTowMi4wMDBafDY4NDhh"
  }
}