Run-List Retail Demand Check
For every vehicle on a run list: how many sold at retail in your target states last month, at what price and odometer, how fast, and the lane order.
This is the technical reference. For the price, a rendered sample and answers to common questions, see the Run-List Retail Demand Check product page.
At a glance
| Price | $0.25 per line delivered. Minimum $2.99 per run. A batch is quoted before it runs: the first call returns a total and charges nothing. |
| Tool name | generate_run_list_demand_check |
| Scope | reports:run-list-retail-demand-check |
| Built for | Auctions & Wholesale, Small Dealer, Dealer Group |
What it does
The retail demand check for an auction run list: paste one vehicle per line (year make model, a trim if you have it, or a 17-character VIN, which is decoded) and one to three target states, and every vehicle gets, per state, the units that left dealer websites in the latest data month, the priced sample, the median asking price at exit, the median odometer and the median days to sell. The list comes back in lane order (fastest clearing first, with the state that clears each fastest), with a segment turn-speed table per state (body types with 50 or more sales ranked by median days to sell) and a demand read: coverage of the list, the deepest demand, the fastest and slowest to clear. From the Sold Summary API: a sale is inferred when a listing leaves a US dealer website, every price is the advertised asking price at exit (never a lane, hammer or negotiated price), and the data runs through the latest complete month, one to two months behind the calendar. Use when an auction, remarketer, wholesaler or dealer asks whether the retail market in the lane's draw states is absorbing the vehicles on a run list, at what price level and how fast, or which units to run first. Do NOT use to rank VINs for one dealer's lot (use Acquisition Fit Report), to find the best-fit rooftop for a unit (use Placement Report), or for a state price map of one nameplate (use Regional Arbitrage Map). State grain only, no ZIP or radius; lines are matched on model year, make and model, every trim together. PRICING: metered at $0.25 per vehicle with retail sales in at least one target state, with a $2.99 minimum, up to 200 lines per run; lines that cannot be read, vehicles with no sales in the target states, and a vehicle pasted more than once (looked up once) are not billed. A list that could cost more than $2.99 requires cost confirmation: call first WITHOUT confirm_cost_usd for an up-to quote (this charges nothing and warms the data), then again with confirm_cost_usd set to the quoted cap once the user approves.
Arguments
| Argument | What it is | Example | |
|---|---|---|---|
lines |
Required | One vehicle per line as year make model with an optional trim (e.g. "2021 Ford F-150 XLT"), or a 17-character VIN, which is decoded to its year, make and model. A lot number before the year, or a "ref | vehicle" form, is kept as the line's reference. Up to 200 lines. Metered at $0.25 per vehicle with retail sales in at least one target state, $2.99 minimum. | 2021 Ford F-150 XLT |
target_states |
Required | One to three US states the lanes draw from, as 2-letter codes separated by commas (e.g. TX, OK, AR). The sold data has state grain only, no ZIP or radius. | TX, OK, AR |
inventory_type |
Recommended | Which market: used (the default), new, or certified pre-owned. | used |
months |
Optional | Whole months to count units over, ending at the latest data month: 1 by default (the latest month), up to 3. The medians always describe the latest month with 5 or more priced sales. | 1 |
confirm_cost_usd |
Optional | Only for a list that could cost more than the $2.99 floor (12 lines or more). After quoting the user the up-to cap and getting approval, call again with this set to the quoted cap. Charged only for vehicles with retail sales, never above the cap. Leave empty on the first (quote) call. | 10 |
What comes back
- Run list by state: for every line and target state, the units that left dealer websites in the latest month, the priced sample, the median asking price at exit, the median odometer and the median days to sell
- Lane order: the vehicles with sales, fastest clearing first, with the state that clears each fastest, its days to sell there, units and median asking price
- Segment turn speed: every body type with 50 or more sales in each target state, ranked by median days to sell
- Demand read: coverage of the list, the deepest demand, the fastest and slowest to clear, and how each state's segments turn
- Lines that cannot be read, vehicles with no sales and repeated vehicles marked and not billed; thin samples flagged
- A CSV of every line and state, and the next steps: the Regional Arbitrage Map for a nameplate, the Acquisition Fit Report for one dealer's lot
Asking for it in a chat client
Check retail demand for this run list in TX, OK and AR (paste list)
Which of these 40 units sell fastest at retail in Georgia?
Running it from a backend
Grant an agent the reports:run-list-retail-demand-check scope, then call the tool over MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_run_list_demand_check",
"arguments": {
"lines": "2021 Ford F-150 XLT\n2022 Chevrolet Silverado 1500 LT\n2020 Toyota Tacoma\n2021 Jeep Grand Cherokee\n2019 Honda CR-V\n2022 Porsche 911",
"target_states": "TX, GA",
"inventory_type": "used"
}
}
}
See Server-side access for the token exchange and how to read the response.