Understanding Responses

interface JustTCGApiResponse<T> {
  /** The main data payload from the API */
  data: T;
  
  /** Pagination metadata (only on paginated endpoints) */
  pagination?: {
    total: number;
    limit: number;
    offset: number;
    hasMore: boolean;
  };
  
  /** API usage metadata (included in every response) */
  usage: {
    apiRequestLimit: number;
    apiDailyLimit: number;
    apiRateLimit: number;
    apiRequestsUsed: number;
    apiDailyRequestsUsed: number;
    apiRequestsRemaining: number;
    apiDailyRequestsRemaining: number;
    apiPlan: string;
  };
  
  /** Error message (if API returns an error) */
  error?: string;
  code?: string;
}

interface Card {
    /** The unique identifier for the card */
    id: string;
    
    /** The name of the card */
    name: string;
    
    /** The game this card belongs to */
    game: string;
    
    /** The set ID this card belongs to */
    set: string;

    /** The set name this card belongs to */
    set_name: string;
    
    /** The card number within the set */
    number: string | null;
    
    /** The rarity of the card */
    rarity: string | null;
    
    /** The TCGPlayer ID for the card */
    tcgplayerId: string | null;
    
    /** Additional details about the card */
    details?: string | null;
    
    /** The different variants of the card */
    variants: Variant[];
  }

interface Variant {
  /** The unique identifier for this variant. */
  id: string;

  /** The condition of the card variant (e.g., Near Mint). */
  condition: string;

  /** The printing type of the card variant (e.g., Foil, 1st Edition). */
  printing: string;

  /** The language of the card variant, if applicable. */
  language: string | null;

  /** The current price of the card variant in dollars. */
  price: number;

  /** The last time the price was updated, as an epoch timestamp in seconds. */
  lastUpdated: number; // Epoch seconds

  /** The percentage change in price over the last 24 hours. */
  priceChange24hr?: number | null; // Percentage

  // --- 7d stats ---
  /** The percentage change in price over the last 7 days. */
  priceChange7d?: number | null; // Percentage
  /** The average price over the last 7 days. */
  avgPrice?: number | null; // Dollars
  /** The price history entries over the last 7 days. */
  priceHistory?: PriceHistoryEntry[] | null;
  minPrice7d?: number | null; // Dollars
  maxPrice7d?: number | null; // Dollars
  stddevPopPrice7d?: number | null;
  covPrice7d?: number | null;
  iqrPrice7d?: number | null;
  trendSlope7d?: number | null;
  priceChangesCount7d?: number | null;

  // --- 30d stats ---
  priceChange30d?: number | null; // Percentage
  avgPrice30d?: number | null; // Dollars
  minPrice30d?: number | null; // Dollars
  maxPrice30d?: number | null; // Dollars
  priceHistory30d?: PriceHistoryEntry[] | null;
  stddevPopPrice30d?: number | null;
  covPrice30d?: number | null;
  iqrPrice30d?: number | null;
  trendSlope30d?: number | null;
  priceChangesCount30d?: number | null;
  priceRelativeTo30dRange?: number | null;

  // --- 90d stats ---
  priceChange90d?: number | null; // Percentage
  avgPrice90d?: number | null; // Dollars
  minPrice90d?: number | null; // Dollars
  maxPrice90d?: number | null; // Dollars
  stddevPopPrice90d?: number | null;
  covPrice90d?: number | null;
  iqrPrice90d?: number | null;
  trendSlope90d?: number | null;
  priceChangesCount90d?: number | null;
  priceRelativeTo90dRange?: number | null;

  // --- 1y stats ---
  minPrice1y?: number | null;
  maxPrice1y?: number | null;

  // --- All-time stats ---
  minPriceAllTime?: number | null;
  minPriceAllTimeDate?: string | null;
  maxPriceAllTime?: number | null;
  maxPriceAllTimeDate?: string | null;
}

interface PriceHistoryEntry {
  /** Epoch timestamp in seconds */
  t: number;
  
  /** Price in dollars */
  p: number;
}

interface PaginationInfo {
  /** Total number of results available */
  total: number;
  
  /** Number of results per page */
  limit: number;
  
  /** Number of results skipped */
  offset: number;
  
  /** Whether there are more results available */
  hasMore: boolean;
}

interface UsageInfo {
  /** Your total request limit */
  apiRequestLimit: number;
  
  /** Your daily request limit */
  apiDailyLimit: number;
  
  /** Your rate limit (requests per minute) */
  apiRateLimit: number;
  
  /** Requests used in this call */
  apiRequestsUsed: number;
  
  /** Daily requests used */
  apiDailyRequestsUsed: number;
  
  /** Requests remaining in this call */
  apiRequestsRemaining: number;
  
  /** Daily requests remaining */
  apiDailyRequestsRemaining: number;
  
  /** Your current plan */
  apiPlan: string;
}