Free

Collection Breakdown

Analyze collection by release, year, grade, player, or manufacturer

What This Does

Group cards by different dimensions (release, year, grade, player, manufacturer)
Calculate value and ROI per group
Identify concentration risks and opportunities
View top cards within each group

When To Use This

Understanding how your collection is distributed
Finding which releases or players are most valuable
Identifying concentration in specific years or grades
Making strategic collecting decisions

Real Example

Scenario

You break down your collection by release to see which sets are most valuable

Sample Request

GET

/v1/collection/{collectionId}/breakdown?groupBy=release&sortBy=value

What You Get Back

{
  "summary": {
    "totalGroups": 5,
    "totalCards": 150,
    "totalQuantity": 165,
    "totalValue": "3200.00",
    "totalInvested": "2500.00",
    "overallRoi": 28,
    "groupedBy": "release",
    "mostValuableGroup": {
      "name": "2023 Topps Chrome",
      "value": "1800.00"
    },
    "bestPerformingGroup": {
      "name": "2021 Bowman Chrome",
      "roi": 45.5
    }
  },
  "groups": [
    {
      "groupKey": "2023 Topps Chrome",
      "groupId": "550e8400-e29b-41d4-a716-446655440001",
      "cardCount": 75,
      "uniqueCardCount": 70,
      "totalQuantity": 80,
      "totalBuyPrice": "1200.00",
      "totalCurrentValue": "1800.00",
      "roi": 50,
      "percentageOfCollection": 50,
      "topCards": [
        {
          "cardId": "550e8400-e29b-41d4-a716-446655440010",
          "cardName": "Shohei Ohtani",
          "currentValue": "150.00"
        }
      ]
    }
  ],
  "pagination": {
    "total_count": 5,
    "skip": 0,
    "take": 20,
    "page": 1,
    "pages": 1
  }
}