Compare your prices with the market

​

Sorts the cards you have for sale into six groups by how their price compares with the market price: way-above, above, at-market, good-deals, very-low and no-market. A card counts as above market only when it is also over the market price by at least aboveMarketMinGap.

Without refresh the call returns the stored check with its computedAt. The check is refreshed after every applied or undone reprice and once a day. refresh=true recomputes it, which costs a pass over your cards and is limited to one every 10 minutes per account. A seller with no stored check gets one computed.

List the cards of a group with GET /v1/inventory/price-check/groups/{group}. Fix a group with POST /v1/inventory/reprice/runs.

Price check is open to the accounts the rollout includes. Other accounts get 403 NOT_AVAILABLE with the reason.

Requires the listings:read scope.

Query Parameters

  • refresh
    Type: boolean

    true recomputes the price check from your inventory and stores it. The result without refresh is the stored one, refreshed after every applied or undone reprice and once a day. A refresh costs a pass over your cards and is limited to one every 10 minutes.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/inventory/price-check
curl 'https://public-api.cardnexus.com/v1/inventory/price-check?refresh=false' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "region": "eu",
  "currency": "EUR",
  "marketCurrency": "EUR",
  "marketToSellerRate": 1,
  "defaultFloor": {
    "amount": 0.25,
    "currency": "EUR"
  },
  "aboveMarketMinGap": {
    "amount": 0.25,
    "currency": "EUR"
  },
  "listingsVisible": true,
  "computedAt": "2026-10-22T09:15:00.000Z",
  "totalForSale": 12430,
  "promotedCount": 1450,
  "groups": [
    {
      "group": "way-above",
      "count": 2051,
      "listedValue": {
        "amount": 41200,
        "currency": "EUR"
      },
      "stake": {
        "amount": 18700,
        "currency": "EUR"
      },
      "topSets": [
        {
          "gameSlug": "pokemon",
          "expansionSlug": "surging-sparks",
          "expansionName": "Surging Sparks",
          "count": 412
        }
      ]
    },
    {
      "group": "at-market",
      "count": 6090,
      "listedValue": {
        "amount": 53100,
        "currency": "EUR"
      },
      "stake": {
        "amount": 0,
        "currency": "EUR"
      },
      "topSets": []
    }
  ],
  "worthListing": {
    "count": 1204,
    "marketValue": {
      "amount": 9100,
      "currency": "EUR"
    },
    "minValue": {
      "amount": 2,
      "currency": "EUR"
    },
    "notForSaleCount": 2950
  }
}

Price check returned.

Previous
Repricing
Next
List the cards of a price check group