market_data:read

market_data:read 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

{
  "error": {
    "code": "plan_upgrade_required",
    "message": "Unlimited plan required for Hrizn Market Maker."
  }
}

Last modified on July 26, 2026

inventory:write

site:read

Getting Started

Concepts

Guides

Scopes

Endpoints

Plan upgrade response

​Endpoints

​Plan upgrade response

Endpoints

Plan upgrade response