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
- The twelve newest vintages in the latest month: units, share of the twelve, the priced sample, median asking price at exit, median odometer, days to sell, and the same vintage a year earlier with the change
- A 12-month line per vintage for the six newest: units and the median asking price
- The full vintage-by-month panel as a CSV
- The thinning signature: which vintages sell fewer units than an older one, the biggest 12-month drop, the freshest median odometer
- The same-age test: this year's two-, three- and four-year-olds against last year's
- Next steps: the Monthly Market Index for the whole market, the Regional Arbitrage Map for one nameplate by state, a monthly monitor
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.