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
    format
    Type
    string
    Description

    The format of the response. One of json or xml. Defaults to json.

Response attributes

  • Name
    vin
    Type
    string
    Description

    The vehicle identification number.

  • Name
    success
    Type
    boolean
    Description

    Whether market value data has been retrieved.

  • Name
    retail
    Type
    string
    Description

    Retail price of the vehicle.

  • Name
    tradeIn
    Type
    string
    Description

    The trade in price of the vehicle.

  • Name
    roughTradeIn
    Type
    string
    Description

    The rough trade in price of the vehicle.

  • Name
    averageTradeIn
    Type
    string
    Description

    The average trade in of the vehicle.

  • Name
    loanValue
    Type
    string
    Description

    Loan value of vehicle.

  • Name
    msrp
    Type
    string
    Description

    Manufacturer suggested retail price of vehicle.

  • Name
    tradeInValues
    Type
    array
    Description

    A list of trade in values recorded for the vehicle.

  • Name
    auctionValues
    Type
    object
    Description

    Map of auction value ranges in a given data range.

Frequently asked questions

Request

GET
/marketvalue
curl -G https://api.carsxe.com/marketvalue \
-d key=CARSXE_API_KEY \
-d vin=WBAFR7C57CC811956

Response

{
    "retail": "16075",
    "tradeIn": "13575",
    "roughTradeIn": "10250",
    "averageTradeIn": "12050",
    "loanValue": "12225",
    "uid": 1172227,
    "msrp": "52250",
    "tradeInValues": [
      {
        "date": "2018-08-01T00:00:00.000Z",
        "value": "13575",
      },
      {
        "date": "2018-07-01T00:00:00.000Z",
        "value": "13600",
      },
      {
        "date": "2018-06-01T00:00:00.000Z",
        "value": "14175",
      },
      {
        "date": "2018-05-01T00:00:00.000Z",
        "value": "14175",
      },
      {
        "date": "2018-04-01T00:00:00.000Z",
        "value": "14650",
      },
    ],
    "auctionValues": {
      "lowAuctionValue": 9050,
      "averageAuctionValue": 11925,
      "highAuctionValue": 14825,
      "dateRange": "8/6/2018 - 8/12/2018",
    },
  }
ImagesHistory