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.

  • For each category (e.g., "whole_xclean"), there are further subfields:

    • 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.

Frequently asked questions

Request

GET
/v2/marketvalue
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"
  }
}