Rating-Territory Dispersion Panel
How dispersed used-vehicle prices are by state for a segment or nameplate: percentiles, standard deviation, coefficient of variation and the tail, territory by territory.
This is the technical reference. For the price, a rendered sample and answers to common questions, see the Rating-Territory Dispersion Panel product page.
At a glance
| Price | $14.99 per run. |
| Tool name | generate_rating_territory_dispersion |
| Scope | reports:rating-territory-dispersion-panel |
| Built for | Insurance Adjuster, Market Researcher |
What it does
The rating-territory panel for one segment (a body type) or one nameplate (a make, optionally a model), optionally a model-year band: every US state where it sold, most dispersed first, each read from its latest month with 30 or more priced sales: the priced sample (n), the Low end, median and High end of the advertised asking price at exit (the 25th, 50th and 75th percentiles), the 95th percentile, the standard deviation, the coefficient of variation (standard deviation over the mean), the tail above the median (the 95th percentile minus the median), and the minimum and maximum; the nation as the reference. A read names the most and least dispersed territories, the pair of states that share a median but not a tail, the run of medians and tails, and how many states are more dispersed than the nation. A 12-month window adds each state's coefficient of variation month by month and the full state-by-month panel as a CSV. From the Sold Summary API: a sale is inferred when a listing leaves a dealer website and every price is the advertised asking price at exit, which runs above settlement and negotiated values, so the panel is a relative read between territories, never claim severities or an actual-cash-value level. Use when an actuary, insurer or researcher asks how dispersed vehicle values are by state, which territories carry the heaviest tails, or how two states with the same price level differ in spread. Do NOT use for one exact car as of a loss month (use Settlement Anchor Band), for a total-loss value with comparables (use Total Loss Report), or for where a nameplate is cheapest by state (use Regional Arbitrage Map). State grain, not ZIP or radius; territories are listed but not ranked. PRICING: $14.99 per run.
Arguments
| Argument | What it is | Example | |
|---|---|---|---|
body_type |
Recommended | The segment: SUV, Sedan, Pickup, Hatchback, Minivan, Coupe, Wagon, Convertible, Cargo Van or Passenger Van. Pass a body type or a make. | SUV |
make |
Recommended | A make (e.g. Ford) instead of a body type; add a model for one nameplate. | Ford |
model |
Optional | Model (e.g. F-150). Use with make. | F-150 |
year_range |
Optional | Model years to include, e.g. 2018-2024, for the insured fleet's age range. Leave blank for every model year. | 2018-2024 |
inventory_type |
Optional | Which market: used (the default), new, or certified pre-owned. | used |
months |
Optional | The window in months, ending at the latest data month: 3 by default, 1 to 12. Each state is read from its latest month in the window with 30 or more priced sales; 12 adds the dispersion trend. | 3 |
What comes back
- The dispersion panel: every state, most dispersed first, each from its latest month with 30 or more priced sales: n, the Low end, median and High end, the 95th percentile, the standard deviation, the coefficient of variation, the tail above the median, and the minimum and maximum
- The nation as the reference row, with its median, standard deviation, 95th percentile and coefficient of variation
- With 12 months: each state's coefficient of variation month by month, and the full state-by-month panel as a CSV
- Territory read: the most and least dispersed territories, the pair of states that share a median but not a tail, the run of medians and tails, and how many states are more dispersed than the nation
- Territories listed but not ranked, thin samples flagged, and a state with no adequate month read from its latest month with 5 or more
- A CSV of every state, and the next steps: a model-year range for the insured fleet, the Settlement Anchor Band for one car as of a loss month
Asking for it in a chat client
Rating-territory price dispersion for used SUVs by state
How dispersed are used F-150 prices across states?
Running it from a backend
Grant an agent the reports:rating-territory-dispersion-panel scope, then call the tool over MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_rating_territory_dispersion",
"arguments": {
"body_type": "SUV",
"inventory_type": "used",
"months": 3
}
}
}
See Server-side access for the token exchange and how to read the response.