Sold-Market Price Check
What sellers listed this exact car for before it sold in your state, the best month to buy, and what is popular near you.
This is the technical reference. For the price, a rendered sample and answers to common questions, see the Sold-Market Price Check product page.
At a glance
| Price | $0.99 per run. |
| Tool name | generate_sold_market_price_check |
| Scope | reports:sold-market-price-check |
| Built for | Car Shopper |
What it does
The shopper's price check for one exact car (year, make, model and trim) in one US state: the middle half of the advertised asking prices these cars carried when they left dealer websites in the latest month (Low end to High end, the 25th to 75th percentile), with the median, the 95th percentile, the median odometer, how many days they took to sell and n, the priced sales behind it. With fewer than 5 priced sales of the exact trim it drops the trim and says so, then widens to national and says so, and with fewer than 5 even then it reports no range rather than a guess. Adds the cheapest and dearest month of the last 12 for the model in the state (the months to buy in) and, with a city, the ten cars that left that city's dealer websites most in the latest month. Three plain-English takeaways close it. Optionally positions an asking price you have been quoted against the range. Every figure is an advertised asking price at the time the car left the dealer's website, never a negotiated or paid price: the range to negotiate inside. Use when a car shopper asks what a specific year, make, model and trim lists for in their state before it sells, whether a quoted price is fair, when the best month to buy is, or what people near them are buying. Do NOT use to vet a specific listing by VIN (use Used Car Health Check), to write the offer and the script (use Negotiation Brief), or to value a trade (use Trade-In Valuation Report). The sold data has state and city grain, not ZIP or radius; a ZIP is read as its state. PRICING: $0.99 per run.
Arguments
| Argument | What it is | Example | |
|---|---|---|---|
year |
Required | Model year of the car (e.g. 2022). | 2022 |
make |
Required | Make (e.g. Hyundai). | Hyundai |
model |
Required | Model (e.g. Tucson). | Tucson |
state |
Required | The shopper's US state, as a 2-letter code (e.g. NJ). A 5-digit ZIP is read as its state. The sold data has state and city grain only, no ZIP or radius. | NJ |
trim |
Recommended | Trim (e.g. SEL). With fewer than 5 priced sales of the exact trim the range covers every trim, and the report says so. | SEL |
city |
Recommended | The shopper's city (e.g. Newark), for the popular-near-you list. Falls back to the state when the city is thin. | Newark |
asking_price_usd |
Optional | A price the shopper has been quoted, positioned against the range (under the Low end, in the middle half, above the High end). | 21500 |
inventory_type |
Optional | Which market: used (the default), new, or certified pre-owned. | used |
What comes back
- Asking prices before it sold: the Low end, median and High end of what sellers listed the exact car for in the latest month, with the 95th percentile, the median odometer, the days to sell and n
- Stated fallbacks: the trim dropped under 5 priced sales, widened to national, or no range rather than a guess
- The best month to buy: 12 months of the model in your state, the cheapest and dearest month and the gap between them
- Popular near you: the ten cars that left dealer websites most in your city last month, with units, share, median asking price, odometer and days to sell
- Where a quoted price sits against the range, when you pass one
- The takeaway: three plain sentences, and the next steps (a Used Car Health Check on the VIN, a Negotiation Brief for the offer)
Asking for it in a chat client
What do 2022 Hyundai Tucson SELs list for in New Jersey before they sell, and when is the best month to buy?
Is $21,500 fair for a 2021 Civic EX in Ohio?
Running it from a backend
Grant an agent the reports:sold-market-price-check scope, then call the tool over MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_sold_market_price_check",
"arguments": {
"year": 2022,
"make": "Hyundai",
"model": "Tucson",
"trim": "SEL",
"state": "NJ",
"city": "Newark"
}
}
}
See Server-side access for the token exchange and how to read the response.