Get a product's current prices

Returns the product's current prices from three sources, keyed by finish:

  • cardmarket — Cardmarket's daily price snapshot, in EUR: low/mid/high/marketValue tiers plus 24h/7d/30d trend percentages.
  • tcgplayer — TCGplayer's daily price snapshot, in USD, with the same fields.
  • cardnexus — the listings live on the CardNexus marketplace right now. low is the cheapest listing anywhere on the marketplace, converted to EUR at the current exchange rate; listingCount and availableQuantity count every region's listings. regions breaks the same numbers down per market region — eu in EUR and na in USD, each with its own cheapest listing, counts, and per-condition / per-language breakdowns. A region's prices are in that region's currency and never mixed with the other region's. A region with no live listings has no key. Graded listings count toward the totals but have no condition bucket.

A source block is absent when it has no data — a finish with no live listings has no cardnexus block, and a product with no prices at all returns an empty pricesByFinish object.

For day-by-day price history, see GET /v1/products/{productId}/prices/history. To download prices for a whole game in one file, see GET /v1/feeds/{gameId}/prices.

Requests count against the pricing-snapshot rate limit: 600 requests per hour.

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

Path Parameters
  • productId
    required

    The product to get prices for. Returned by GET /v1/products and POST /v1/products/search.

    • Type: number

      The product to get prices for. Returned by GET /v1/products and POST /v1/products/search.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/products/{productId}/prices
curl https://public-api.cardnexus.com/v1/products/50212/prices \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "productId": 50212,
  "pricesByFinish": {
    "Standard": {
      "cardmarket": {
        "currency": "EUR",
        "low": 38.9,
        "mid": 44.5,
        "high": 59.99,
        "marketValue": 43.75,
        "change24h": 0.4,
        "change7d": -1.2,
        "change30d": 5.7
      },
      "tcgplayer": {
        "currency": "USD",
        "low": 42.5,
        "mid": 48,
        "high": 64.99,
        "marketValue": 47.2,
        "change24h": 0.2,
        "change7d": -0.8,
        "change30d": 6.1
      },
      "cardnexus": {
        "low": {
          "amount": 38.5,
          "currency": "EUR"
        },
        "listingCount": 14,
        "availableQuantity": 26,
        "regions": {
          "eu": {
            "currency": "EUR",
            "low": 38.5,
            "listingCount": 12,
            "availableQuantity": 23,
            "byCondition": {
              "NM": {
                "low": 42,
                "listingCount": 7,
                "availableQuantity": 11,
                "byLanguage": {
                  "de": {
                    "low": 45.5,
                    "listingCount": 2,
                    "availableQuantity": 3
                  },
                  "en": {
                    "low": 42,
                    "listingCount": 5,
                    "availableQuantity": 8
                  }
                }
              },
              "LP": {
                "low": 38.5,
                "listingCount": 5,
                "availableQuantity": 12,
                "byLanguage": {
                  "en": {
                    "low": 38.5,
                    "listingCount": 5,
                    "availableQuantity": 12
                  }
                }
              }
            }
          },
          "na": {
            "currency": "USD",
            "low": 47,
            "listingCount": 2,
            "availableQuantity": 3,
            "byCondition": {
              "NM": {
                "low": 47,
                "listingCount": 2,
                "availableQuantity": 3,
                "byLanguage": {
                  "en": {
                    "low": 47,
                    "listingCount": 2,
                    "availableQuantity": 3
                  }
                }
              }
            }
          }
        }
      }
    },
    "Foil": {
      "cardmarket": {
        "currency": "EUR",
        "low": 72,
        "mid": 81.5,
        "high": 99,
        "marketValue": 79.9,
        "change24h": 0.1,
        "change7d": 2.2,
        "change30d": 3.1
      }
    }
  }
}