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

# Hrizn Market Maker overview

> Hrizn Market Maker endpoints (Unlimited + market_data:read)

**Hrizn Market Maker** powers local competitive listings, market days supply, fleet pricing checks, VIN predicted price, and related used-car desk workflows.

**Requirements**

* Scope: `market_data:read`
* Plan: **Unlimited** (legacy `unlimited` or `unlimited_v2`), or an explicit Unlimited feature override
* Geography: **US only**
* Dealership ZIP/state is resolved from site metadata unless you pass an override

**Privacy**

* Dealer **cost** and **gross** are never returned
* Underlying data vendors are never branded in responses or errors — only Hrizn Market Maker

**Rate / cost note**

These calls hit a paid external provider. Prefer tight make/model filters and avoid polling.

| Endpoint                         | Method    | Purpose                               |
| -------------------------------- | --------- | ------------------------------------- |
| `/market/local-listings`         | GET, POST | Segment listings + price/DOM stats    |
| `/market/days-supply`            | GET, POST | Market days supply / sell-through     |
| `/market/competitive-set`        | GET, POST | Competing dealer listings             |
| `/market/inventory-pricing`      | POST      | Fleet vs local market median          |
| `/market/appraise`               | POST      | YMM appraisal without inventory VIN   |
| `/market/price-cut-candidates`   | POST      | Aged + over-market units              |
| `/market/stocking-opportunities` | POST      | Stock / acquire by local velocity     |
| `/market/vehicle-position`       | GET, POST | One inventory VIN vs market (no cost) |
| `/market/price-analysis`         | GET, POST | VIN predicted price + comps           |
| `/market/options-packages/{vin}` | GET       | Factory options/packages              |

On plan denial, responses use HTTP **403** with error code `plan_upgrade_required`.