> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driv.ly/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Data

> Access real-time and historical data related to the automotive market.

## Overview

The Market Data API offers real-time and historical automotive market data. Users can explore trends across vehicle types and regions, track days of supply for inventory management, and gain insights into pricing dynamics.

| Capabilities                           | Description                                                                              |
| -------------------------------------- | ---------------------------------------------------------------------------------------- |
| [Supply](#days-of-supply)              | Retrieve days of supply data for different vehicle types and regions.                    |
| [Historical](#historical-price-trends) | Get historical price trends for specific vehicle models and makes.                       |
| [Sales](#sales-volume-analysis)        | Access sales volume data for different vehicle types and regions.                        |
| [Vehicles](#vehicle-trends)            | Retrieve insights into how specific vehicle models and makes are trending in the market. |
| [Pricing](#pricing-books)              | Get market-specific valuations such as MSRP, trade-in values, wholesale prices, etc.     |

***

## Days of Supply

Retrieve days of supply data for different vehicle types and regions. This data can help dealers manage inventory more effectively by providing insights into how long vehicles typically stay on the market.

```json theme={null}
{
  "daysOfSupply": {
    "type": "sedan",
    "region": "US",
    "startDate": "2022-01-01",
    "endDate": "2022-12-31",
    "data": [
      {
        "date": "2022-01-01",
        "daysSupply": 45
      },
      {
        "date": "2022-01-02",
        "daysSupply": 46
      },
      ...
    ]
  }
}
```

***

## Historical Price Trends

Get historical price trends for specific vehicle models and makes. This data can be useful for analyzing market trends and making pricing decisions.

```json theme={null}
{
  "priceTrends": {
    "make": "Ford",
    "model": "Explorer",
    "startDate": "2022-01-01",
    "endDate": "2022-12-31",
    "data": [
      {
        "date": "2022-01-01",
        "averagePrice": 25000
      },
      {
        "date": "2022-01-02",
        "averagePrice": 25500
      },
      ...
    ]
  }
}
```

***

## Sales Volume Analysis

Access sales volume data for different vehicle types and regions. This data can provide insights into market demand and consumer preferences.

```json theme={null}
{
  "salesVolumeAnalysis": {
    "type": "sedan",
    "region": "US",
    "startDate": "2022-01-01",
    "endDate": "2022-12-31",
    "data": [
      {
        "date": "2022-01-01",
        "salesVolume": 10000
      },
      {
        "date": "2022-01-02",
        "salesVolume": 10500
      },
      ...
    ]
  }
}
```

***

## Vehicle Trends

Retrieve insights into how specific vehicle models and makes are trending in the market. This data can help businesses understand pricing dynamics, popularity, and availability.

```json theme={null}
{
  "vehicleTrends": {
    "make": "Ford",
    "model": "Explorer",
    "region": "US",
    "data": [
      {
        "date": "2022-01-01",
        "averagePrice": 25000,
        "salesVolume": 1000
      },
      {
        "date": "2022-01-02",
        "averagePrice": 25500,
        "salesVolume": 1050
      },
      ...
    ]
  }
}
```

***

## Pricing Books

Get market-specific valuations such as MSRP, trade-in values, wholesale prices, private party estimates, and retail pricing, catering to different conditions and market positions of the vehicle.

<Info>Coming soon!</Info>
