AI Storefront
Browse the documentation

Late-Model Cohort Thinning

Which model years of used cars are getting scarce: twelve vintages of used volume, price, odometer and days to sell, month by month.

This is the technical reference. For the price, a rendered sample and answers to common questions, see the Late-Model Cohort Thinning product page.

At a glance

Price $4.99 per run.
Tool name generate_late_model_cohort_thinning
Scope reports:late-model-cohort-thinning
Built for Market Researcher, Auto Lender, Auctions & Wholesale, Automaker

What it does

Used sales by model year, from twelve months of sold-market data: for the twelve newest vintages selling used (the newest model year back eleven years), the latest month's units that left dealer websites, each vintage's share of the twelve, the priced sample, the median asking price at exit, the median odometer and the median days to sell, beside the same vintage's units in the same month a year earlier and the change. The thinning signature is read from the numbers: which vintages sell fewer units than an older one, the vintage with the biggest 12-month drop, the freshest median odometer, and the same-age comparison (this year's two-, three- and four-year-olds against last year's). Adds a 12-month line per vintage for the six newest and the full vintage-by-month panel as a CSV. Nationally, or for one state, and optionally for one make, model or body type. From the Sold Summary API: a sale is inferred when a listing leaves a dealer website, every price is the advertised asking price at exit (never a negotiated transaction price), and the data runs through the latest complete month. Use when an analyst, lender or remarketer asks whether the lease-return cohort is thinning, which model years are scarce or plentiful, how the used market's vintage mix is shifting, or how a vintage's price and odometer move. Do NOT use for the whole market's monthly index (use the Monthly Market Index) or for a state price map of one nameplate (use the Regional Arbitrage Map). Used vehicles only; state grain, not ZIP or radius. PRICING: $4.99 per run.

Arguments

Argument What it is Example
state Recommended A US state as a 2-letter code (e.g. TX) for a state cohort. Leave blank for the national cohort. TX
make Recommended Make (e.g. Toyota) to narrow the cohort to one make. Pass make and model for one nameplate. Toyota
model Recommended Model (e.g. Camry). Use with make. Camry
body_type Optional A body type to narrow the cohort to one segment: SUV, Sedan, Pickup, Hatchback, Minivan, Coupe, Wagon, Convertible, Cargo Van or Passenger Van. SUV
months Optional How many months of the vintage panel to pull, ending at the latest complete data month: 2 to 12 (12 by default). The year-earlier comparison always uses the same calendar month a year before the latest. 12

What comes back

Asking for it in a chat client

Is the lease-return cohort thinning? Show used volume by model year over 12 months

Which model years of used Camrys are getting scarce in Texas?

Running it from a backend

Grant an agent the reports:late-model-cohort-thinning scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_late_model_cohort_thinning",
    "arguments": {
      "months": 12
    }
  }
}

See Server-side access for the token exchange and how to read the response.