Read the value history of your inventory

​

Returns the daily snapshots of the market value of your inventory over a period, oldest first. With no game a point is the total across games for that day; with game it is that game only. Values are quantity multiplied by market price, in EUR for EU market prices and USD for NA ones.

The snapshots come from the nightly portfolio record: a day without a snapshot is absent and a new account returns points: []. Sealed products are part of the value.

Requires the inventory:read scope.

Query Parameters

  • period
    Type: stringenum

    The range, ending today. Default 30d.

    values
    • 7d

      The last 7 days.

    • 30d

      The last 30 days.

    • 90d

      The last 90 days.

    • 365d

      The last 365 days.

  • granularity
    Type: stringenum

    Spacing of the points. Default daily for 7d and 30d, weekly for 90d and 365d. daily with 365d is refused.

    values
    • daily

      One point per day with a snapshot.

    • weekly

      The last snapshot of each week, weeks starting on Monday.

  • game
    Type: string

    Restricts the history to one game, by slug.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/inventory/value-history
curl 'https://public-api.cardnexus.com/v1/inventory/value-history?period=30d&granularity=daily' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "period": "90d",
  "granularity": "weekly",
  "points": [
    {
      "date": "2026-07-26",
      "cards": 58210,
      "marketValue": {
        "eu": {
          "amount": 44980.5,
          "currency": "EUR"
        },
        "na": {
          "amount": 49310.2,
          "currency": "USD"
        }
      }
    }
  ]
}

History returned.

Previous
Summarise your inventory
Next
Get an inventory line