AI Storefront
Browse the documentation

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

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.