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

# market_data:read

> Hrizn Market Maker — local listings, days supply, competitive set, and pricing insights (Unlimited)

<code>market\_data:read</code>

The `market_data:read` scope unlocks **Hrizn Market Maker** endpoints under `/public/market/*`. These endpoints also require an **Unlimited** plan entitlement on the dealership. Non-Unlimited sites receive `403` with `plan_upgrade_required`.

Use the **MCP (Read + Market)** API key preset for hosted Hrizn MCP Market Maker tools.

## Endpoints

| Method         | Path                                    | Description                         |
| -------------- | --------------------------------------- | ----------------------------------- |
| `GET` / `POST` | `/public/market/local-listings`         | Local market listings for a segment |
| `GET` / `POST` | `/public/market/days-supply`            | Market days supply                  |
| `GET` / `POST` | `/public/market/competitive-set`        | Competitive dealer set              |
| `POST`         | `/public/market/inventory-pricing`      | Fleet pricing vs market             |
| `POST`         | `/public/market/appraise`               | Appraise year/make/model            |
| `POST`         | `/public/market/price-cut-candidates`   | Aged + over-market units            |
| `POST`         | `/public/market/stocking-opportunities` | Stock / acquire recommendations     |
| `GET` / `POST` | `/public/market/vehicle-position`       | Single VIN position verdict         |
| `GET` / `POST` | `/public/market/price-analysis`         | VIN market price analysis           |
| `GET`          | `/public/market/options-packages/{vin}` | Factory options and packages        |

## Plan upgrade response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": {
    "code": "plan_upgrade_required",
    "message": "Unlimited plan required for Hrizn Market Maker."
  }
}
```