Regional Arbitrage Map
Where a used nameplate sells cheapest and dearest by state, with the odometer beside every price, and when it peaks nationally.
This is the technical reference. For the price, a rendered sample and answers to common questions, see the Regional Arbitrage Map product page.
At a glance
| Price | $4.99 per run. |
| Tool name | generate_regional_arbitrage_map |
| Scope | reports:regional-arbitrage-map |
| Built for | Auctions & Wholesale, Dealer Group, Auto Lender, Automaker |
What it does
A state price map for one used nameplate (make and model, optionally a model-year range) from sold-market data: every state where at least 20 units left dealer websites in a month of the window (3 months by default), cheapest first by the median asking price at exit in the state's latest qualifying month (with that month's n), with units summed over the window, the average price weighted by priced sales, the median odometer, the median days to sell and a note on how the state sits against the national median and odometer for the same month. The spread table sets the five cheapest states against the five dearest with each state's price above the cheapest and its odometer against the cheapest state's, so the reader sees how much of a spread travels with mileage. Adds the nameplate's national 12-month series with the cheapest and dearest months (the Seasonal Buy-Sell Calendar's ranking) for timing. 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 or lane price), and the data runs through the latest complete month. Transport, fees and reconditioning are not modelled. Use when a wholesaler, auction, dealer group or lender remarketing team asks where a model is cheap or dear by state, which states to buy in and sell into, whether a spread is mileage, or when the model peaks. Do NOT use for one state's twelve months of a nameplate (use the Seasonal Buy-Sell Calendar), for trims and a max bid near a ZIP (use the Stocking Guide), or to value one vehicle (use the Vehicle Valuation Report). Used vehicles only; state grain, not ZIP, metro or radius. PRICING: $4.99 per run.
Arguments
| Argument | What it is | Example | |
|---|---|---|---|
make |
Required | Make of the nameplate (e.g. Ford). | Ford |
model |
Required | Model of the nameplate (e.g. F-150). | F-150 |
year_range |
Recommended | Model years to include, e.g. 2020-2023. Leave blank for every model year. | 2020-2023 |
months |
Optional | The window in months, ending at the latest complete data month: 1 to 12 (3 by default). A state needs 20 sales in a month for that month to count; units are summed over the qualifying months and the median is the latest qualifying month's. | 3 |
What comes back
- Every state where at least 20 units left dealer websites in a month of the window, cheapest first by the median asking price at exit in its latest qualifying month, with n, units over the window, the average price, the median odometer, days to sell, and how the state sits against the national median and odometer
- The spread: the five cheapest and five dearest states, each with its price above the cheapest and its odometer against the cheapest state's
- The nameplate nationally for 12 months with the cheapest and dearest months
- Three sentences: where it is cheap, where it is dear, when it peaks
- Territories listed but not ranked, thin samples flagged, and a short map says so
- Next steps: transport from the cheap state, the Seasonal Buy-Sell Calendar for one state, the Stocking Guide for trims and a max bid
Asking for it in a chat client
Where are used F-150s cheapest and dearest by state, mileage-adjusted?
Regional price map for 2020-2023 Silverado 1500s
Running it from a backend
Grant an agent the reports:regional-arbitrage-map scope, then call the tool over MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_regional_arbitrage_map",
"arguments": {
"make": "Ford",
"model": "F-150",
"months": 3
}
}
}
See Server-side access for the token exchange and how to read the response.