Vehicle Market Value
Discover comprehensive vehicle market value including historical vehicle sale history. Learn more about above and below market pricing.
The Vehicle Market Value API provides access to a library of vehicle market value data.
The Vehicle Market Value API estimates the market value for used and new cars by VIN based on millions of historical vehicle sales stored in CarsXE's sales database.
With the assumption that sale prices are normally distributed, CarsXE's market value model estimates the "below market" and "above market" values within a distribution.
This endpoint allows you to retrieve the market value for a specific vehicle based on its VIN.
Required attributes
- Name
key
- Type
- string
- Description
Your CarsXE API key.
- Name
vin
- Type
- string
- Description
The 17 character long vehicle identification number.
Optional attributes
- Name
state
- Type
- string
- Description
The US state of the vehicle to get the market value for.
Response attributes
- Name
uid
- Type
- string
- Description
A unique identifier for for the vehicle.
- Name
input
- Type
- object
- Description
A map of the input: "vin", "state", "country" of the vehicle.
- Name
publish_date
- Type
- string
- Description
The date when the vehicle market value data was last published or updated.
- Name
data_freq
- Type
- string
- Description
The frequency of data updates. It indicates that the market value data provided by the API is updated once per day.
- Name
state
- Type
- string
- Description
The state where the vehicle's market value is being assessed, in this case, California.
- Name
country
- Type
- string
- Description
The country context for the valuation, in this case, the United States.
- Name
uvc
- Type
- string
- Description
The unique vehicle code. It is a unique identifier assigned to a specific vehicle configuration or model. This code helps in accurately identifying and retrieving precise market value data for that particular vehicle.
- Name
group_num
- Type
- string
- Description
A group identifier used to classify or associate the vehicle with a specific category, market segment, or data grouping. e.g., sedans, SUVs.
- Name
model_year
- Type
- string
- Description
The manufacturing year of the vehicle model being assessed. This information is crucial as it directly impacts the vehicle's market value, reflecting depreciation, demand, and historical relevance in pricing calculations.
- Name
make
- Type
- string
- Description
The brand or manufacturer of the vehicle, in this case, Lexus.
- Name
model
- Type
- string
- Description
The model of the vehicle, which is a particular version of the Lexus brand, here being the RX 350.
- Name
series
- Type
- string
- Description
The series associated with the vehicle.
- Name
style
- Type
- string
- Description
Describes the vehicle style or body type. In this case:
- 4D refers to a four-door vehicle.
- SUV indicates the vehicle type is a Sport Utility Vehicle.
- AWD stands for All-Wheel Drive, indicating the type of drivetrain.
- Name
mileage_cat
- Type
- string
- Description
A category for the vehicle's mileage, could represent a specific mileage range or classification.
- Name
class_code
- Type
- string
- Description
A class code that categorizes the vehicle into a specific segment or type.
- Name
class_name
- Type
- string
- Description
This is a human-readable description of the vehicle's class. It specifies that the vehicle is categorized as a large luxury crossover/SUV, helping to describe the vehicle's type or market segment.
- Name
description_score
- Type
- string
- Description
A rating or score based on the vehicle's description quality or completeness.
- Name
first_values_flag
- Type
- string
- Description
Indicates whether the vehicle's market value data is the first set of values being used or provided. In this case, it's set to false, meaning the data may not be the initial set or it has been updated or revisited.
- Name
risk_score
- Type
- string
- Description
A risk score associated with the vehicle's market value or condition. A risk score might assess factors such as potential for accidents, fraud, or reliability concerns.
- Name
whole_xclean
- Type
- object
- Description
Excellent condition, typically with no significant wear.
- Name
whole_clean
- Type
- object
- Description
Good condition, with minor wear.
- Name
whole_avg
- Type
- object
- Description
Average condition, showing moderate wear.
- Name
whole_rough
- Type
- object
- Description
Poor condition, showing significant wear or issues.
- base_whole_xclean: The base value of the vehicle in excellent condition, before adjustments (e.g., mileage or regional factors).
- mileage_whole_xclean: Adjustments for mileage (if any).
- add_deduct_whole_xclean: Any other additions or deductions (for special features or damages).
- regional_whole_xclean: Adjustments based on regional market differences.
- adjusted_whole_xclean: The final, adjusted market value for the vehicle.
- Name
retail_xclean
- Type
- object
- Description
The retail price of a vehicle in excellent condition (no significant wear, like new or almost new).
- Name
retail_clean
- Type
- object
- Description
The retail price for a vehicle in good condition (minor wear and tear, but well-maintained).
- Name
retail_avg
- Type
- object
- Description
The retail price of a vehicle in average condition (moderate wear, typically for a used vehicle).
- Name
retail_rough
- Type
- object
- Description
The retail price for a vehicle in poor condition (significant wear and tear, possible mechanical or cosmetic issues).
- Name
trade_in_clean
- Type
- object
- Description
The trade-in price for a vehicle in good condition (minor wear and tear, well-maintained, ready for resale or continued use).
- Name
trade_in_avg
- Type
- object
- Description
The trade-in price for a vehicle in average condition (moderate wear, typical for a used vehicle with normal signs of use).
- Name
trade_in_rough
- Type
- object
- Description
The trade-in price for a vehicle in poor condition (significant wear, potential mechanical or cosmetic issues, or higher depreciation).
- Name
msrp
- Type
- string
- Description
Manufacturer’s Suggested Retail Price (MSRP) is the recommended selling price set by the vehicle manufacturer for the vehicle before any dealer discounts or additions. It is often used as a starting point for pricing.
- Name
retail_equipped
- Type
- string
- Description
The retail price of the vehicle equipped with all available options and features, including any add-ons, upgrades, or packages.
- Name
price_includes
- Type
- string
- Description
This describes the options or features that are included in the vehicle’s price. It lists the additional equipment or features that are part of the specified price.
- AC: Air Conditioning
- AT: Automatic Transmission
- LTH: Leather Upholstery
- SR: Sunroof
- Name
wheel_base
- Type
- string
- Description
The wheelbase is the distance (106.9 inches) between the front and rear axles of the vehicle. It can affect the vehicle's handling, ride quality, and interior space.
- Name
tire_size
- Type
- string
- Description
The tire size indicates the dimensions of the tires installed on the vehicle. This includes:
- 225: The tire width in millimeters.
- 65: The aspect ratio (the height of the tire sidewall as a percentage of the width).
- SR: The speed rating (indicating the maximum speed the tire is rated for).
- 17: The diameter of the tire in inches.
- Name
gvw
- Type
- string
- Description
Gross Vehicle Weight (GVW) is the total weight (5,245 pounds) of the vehicle, including its maximum load (passengers, cargo, etc.).
- Name
seat_cap
- Type
- string
- Description
The seating capacity indicates the number of passengers the vehicle can accommodate.
- Name
fuel_type
- Type
- string
- Description
The type of fuel the vehicle uses.
- Name
fuel_cap
- Type
- string
- Description
The fuel capacity refers to the volume of fuel the vehicle's tank can hold, usually in gallons.
- Name
fuel_delivery
- Type
- string
- Description
Fuel delivery system type used by the vehicle. MPI stands for Multi-Point Fuel Injection, which is a type of fuel injection system where each cylinder has its own injector, allowing more precise control of fuel delivery.
- Name
hwy_mpg
- Type
- string
- Description
Highway Miles Per Gallon (MPG) represents the vehicle's fuel efficiency on highways or at constant speeds.
- Name
city_mpg
- Type
- string
- Description
City Miles Per Gallon (MPG) indicates the vehicle’s fuel efficiency in urban or stop-and-go driving conditions.
- Name
engine_description
- Type
- string
- Description
This field provides a description of the vehicle’s engine.
- 3.5L: The engine’s displacement, meaning it has a 3.5-liter engine capacity.
- V6: The engine has six cylinders arranged in a V-shape.
- SFI: Sequential Fuel Injection, a system where fuel is injected into each cylinder at the appropriate time.
- DOHC: Double Overhead Camshaft, indicating the engine has two camshafts controlling the intake and exhaust valves for better performance.
- Name
cylinders
- Type
- string
- Description
The number of cylinders in the engine.
- Name
engine_displacement
- Type
- string
- Description
The engine displacement refers to the total volume of all the cylinders in the engine, often measured in liters.
- Name
base_hp
- Type
- string
- Description
The base horsepower of the engine, which measures its maximum power output.
- 270: The engine produces 270 horsepower at the specified RPM.
- 6200: The engine reaches 270 horsepower at 6,200 RPM (revolutions per minute).
- Name
taxable_hp
- Type
- string
- Description
The taxable horsepower refers to the engine’s power rating used for tax or registration purposes, which might be calculated differently from the base horsepower.
- Name
torque
- Type
- string
- Description
The engine’s torque is a measure of its rotational force, important for acceleration and towing capacity.
- 251: The engine generates 251 lb-ft of torque.
- 4700: This torque is available at 4,700 RPM.
- Name
transmission
- Type
- string
- Description
The type of transmission the vehicle uses. The vehicle has an automatic transmission, as indicated by "A".
- Name
drivetrain
- Type
- string
- Description
The vehicle’s drivetrain indicates how power is delivered to the wheels. The vehicle has All-Wheel Drive (AWD), meaning power is distributed to all four wheels for better traction, especially in poor road conditions.
- Name
num_gears
- Type
- string
- Description
The number of gears in the vehicle's transmission.
- Name
ext_doors
- Type
- string
- Description
The number of exterior doors the vehicle has. The vehicle has 4 doors, which is typical for a sedan or a 4-door SUV.
- Name
basic_warranty
- Type
- string
- Description
The basic warranty for the vehicle, covering repairs or defects within a specified time or mileage limit.
- 4-year/50,000-mile: The warranty lasts for 4 years or 50,000 miles, whichever comes first.
- Limited: The warranty is limited, meaning it may not cover all components or may have exclusions.
- Name
add_deduct_list
- Type
- object
- Description
Represents a list of additions or deductions based on specific options or features in the vehicle, and how those features impact its market value.
- uoc: This is a unique identifier for the option or feature (UOC stands for Unique Option Code).
- name: The name of the option or feature being added or deducted.
- xclean, clean, avg, rough:
These represent how the feature or option affects the vehicle’s value depending on its condition. These values are specific adjustments to the market value based on the condition of the vehicle:
- xclean: Adjusted value for a vehicle in extra clean condition.
- clean: Adjusted value for a vehicle in clean condition.
- avg: Adjusted value for a vehicle in average condition.
- rough: Adjusted value for a vehicle in rough condition.
- auto: Indicates if the feature is automatic (whether it is part of the vehicle's default set of features or not).
- resid12, resid24, resid30, resid36, resid42, resid48, resid60, resid72:
- These represent the residual values (depreciation or remaining value) for the option at different time periods (in months). These values are used for calculating lease residuals or depreciation over time.
- Name
model_number_list
- Type
- array
- Description
This is a list of model numbers associated with the vehicle.
- Name
retail
- Type
- string
- Description
The retail value of the vehicle, which represents the expected price if the vehicle is sold to a consumer, typically by a dealership.
- Name
trade_in
- Type
- string
- Description
The trade-in value of the vehicle, which is how much a dealership would offer to accept the vehicle as a trade-in for purchasing a different vehicle.
- Name
rough_trade_in
- Type
- string
- Description
The rough trade-in value of the vehicle, which represents the lowest price a dealership would offer for a vehicle in poor condition (rough).
- Name
average_trade_in
- Type
- string
- Description
The average trade-in value, which represents a middle ground or average trade-in price for a vehicle in average condition.
- Name
loan_value
- Type
- string
- Description
The loan value of the vehicle, which is the estimated amount the vehicle would be financed for, typically used by banks or financial institutions for vehicle loans.
- Name
trade_in_values
- Type
- array
- Description
This field would typically contain additional details related to trade-in values over time or across different conditions.
- Name
auction_values
- Type
- object
- Description
The auction values represent the price range that the vehicle could sell for at an auction, which is typically lower than retail but higher than trade-in values. Auction prices depend on the vehicle's condition and demand.
- low_auction_value: The lowest expected price the vehicle could sell for at an auction, in this case, $3,150.
- average_auction_value: The average price the vehicle is expected to sell for at an auction, in this case, $4,400.
- high_auction_value: The highest expected price the vehicle could sell for at an auction, in this case, $5,675.
- date_range: The date range during which the auction values are applicable. In this case, the values are for 12/18/2024.
For each category (e.g., "whole_xclean"), there are further subfields:
Frequently asked questions
Request
curl -G https://api.carsxe.com/v2/marketvalue \
-d key=CARSXE_API_KEY \
-d vin=2T2HK31U27C037224
Response
{
"uid": "E8BD81F3",
"input": {
"vin": "2T2HK31U27C037224",
"state": "CA",
"country": "US"
},
"publish_date": "12/18/2024",
"data_freq": "D",
"state": "CA",
"country": "US",
"uvc": "2007500029",
"group_num": "7282",
"model_year": "2007",
"make": "Lexus",
"model": "RX 350",
"series": "",
"style": "4D SUV AWD",
"mileage_cat": "G",
"class_code": "T",
"class_name": "Large Luxury Crossover/SUV",
"description_score": "",
"first_values_flag": false,
"risk_score": "",
"whole_xclean": {
"base_whole_xclean": 0,
"mileage_whole_xclean": 0,
"add_deduct_whole_xclean": 0,
"regional_whole_xclean": 0,
"adjusted_whole_xclean": 0
},
"whole_clean": {
"base_whole_clean": 5675,
"mileage_whole_clean": 0,
"add_deduct_whole_clean": 0,
"regional_whole_clean": 0,
"adjusted_whole_clean": 5675
},
"whole_avg": {
"base_whole_avg": 4400,
"mileage_whole_avg": 0,
"add_deduct_whole_avg": 0,
"regional_whole_avg": 0,
"adjusted_whole_avg": 4400
},
"whole_rough": {
"base_whole_rough": 3150,
"mileage_whole_rough": 0,
"add_deduct_whole_rough": 0,
"regional_whole_rough": 0,
"adjusted_whole_rough": 3150
},
"retail_xclean": {
"base_retail_xclean": 0,
"mileage_retail_xclean": 0,
"add_deduct_retail_xclean": 0,
"regional_retail_xclean": 0,
"adjusted_retail_xclean": 0
},
"retail_clean": {
"base_retail_clean": 9625,
"mileage_retail_clean": 0,
"add_deduct_retail_clean": 0,
"regional_retail_clean": 0,
"adjusted_retail_clean": 9625
},
"retail_avg": {
"base_retail_avg": 7650,
"mileage_retail_avg": 0,
"add_deduct_retail_avg": 0,
"regional_retail_avg": 0,
"adjusted_retail_avg": 7650
},
"retail_rough": {
"base_retail_rough": 6200,
"mileage_retail_rough": 0,
"add_deduct_retail_rough": 0,
"regional_retail_rough": 0,
"adjusted_retail_rough": 6200
},
"trade_in_clean": {
"base_trade_in_clean": 5750,
"mileage_trade_in_clean": 0,
"add_deduct_trade_in_clean": 0,
"regional_trade_in_clean": 0,
"adjusted_trade_in_clean": 5750
},
"trade_in_avg": {
"base_trade_in_avg": 4475,
"mileage_trade_in_avg": 0,
"add_deduct_trade_in_clean": 0,
"regional_trade_in_clean": 0,
"adjusted_trade_in_clean": 5750
},
"trade_in_rough": {
"base_trade_in_rough": 3020,
"mileage_trade_in_rough": 0,
"add_deduct_trade_in_rough": 0,
"regional_trade_in_rough": 0,
"adjusted_trade_in_rough": 3020
},
"region2": 0,
"region3": 0,
"region4": 0,
"region5": 0,
"region6": 0,
"msrp": 38800,
"retail_equipped": 46180,
"price_includes": "AC AT LTH SR",
"wheel_base": 106.9,
"tire_size": "225/65SR17",
"gvw": 5245,
"seat_cap": "5",
"fuel_type": "Gas",
"fuel_cap": "19.2",
"fuel_delivery": "MPI",
"hwy_mpg": "24",
"city_mpg": "19",
"engine_description": "3.5L V6 SFI DOHC ",
"cylinders": "6",
"engine_displacement": "3.5L",
"base_hp": "270 @ 6200",
"taxable_hp": 32.8,
"torque": "251 @ 4700",
"transmission": "A",
"drivetrain": "AWD",
"num_gears": "5",
"ext_doors": "4",
"basic_warranty": "4-year/50,000-mile, Limited",
"add_deduct_list": [
{
"uoc": "N5",
"name": "Navigation System",
"xclean": 100,
"clean": 100,
"avg": 100,
"rough": 100,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
},
{
"uoc": "12",
"name": "w/o Moonroof",
"xclean": -100,
"clean": -100,
"avg": -100,
"rough": -100,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
},
{
"uoc": "19",
"name": "w/o Leather",
"xclean": -100,
"clean": -100,
"avg": -100,
"rough": -100,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}
],
"model_number_list": [
"9424"
],
"retail": 7650,
"trade_in": 5750,
"rough_trade_in": 3020,
"average_trade_in": 4475,
"loan_value": 9625,
"trade_in_values": [],
"auction_values": {
"low_auction_value": 3150,
"average_auction_value": 4400,
"high_auction_value": 5675,
"date_range": "12/18/2024"
}
}