Free

Collection Analytics

Analyze value, growth, and composition of collections

What This Does

Calculates total collection value and market worth
Shows investment returns (ROI) and gains
Tracks graded vs raw card composition
Identifies top gainers and most valuable cards

When To Use This

Tracking investment performance
Understanding collection composition
Finding valuable cards in collection
Making selling decisions

Real Example

Scenario

You analyze your collection to see which cards gained value

Sample Request

GET

/v1/collection/{collectionId}/analytics

What You Get Back

{
  "overview": {
    "totalCards": 150,
    "uniqueCards": 140,
    "totalQuantity": 165
  },
  "financials": {
    "totalInvested": "2500.00",
    "currentMarketValue": "3200.00",
    "totalRealizedGains": "450.00",
    "totalUnrealizedGains": "700.00",
    "overallROI": 28,
    "realizedROI": 35.5
  },
  "composition": {
    "gradedCount": 25,
    "rawCount": 125,
    "gradedPercentage": 16.67,
    "forSaleCount": 10,
    "soldCount": 15
  },
  "performance": {
    "averageCardValue": "21.33",
    "averageROI": 15.5,
    "topGainer": {
      "cardId": "550e8400-e29b-41d4-a716-446655440001",
      "cardName": "Shohei Ohtani",
      "releaseName": "2023 Topps Chrome",
      "releaseYear": "2023",
      "buyPrice": "50.00",
      "currentValue": "150.00",
      "gain": "100.00",
      "gainPercentage": 200
    },
    "topValue": {
      "cardId": "550e8400-e29b-41d4-a716-446655440002",
      "cardName": "Mike Trout",
      "releaseName": "2011 Topps Update",
      "releaseYear": "2011",
      "currentValue": "500.00",
      "quantity": 1
    }
  }
}