---
title: "Historical Price Stats"
method: POST
path: "/historical_price_stats"
tags: ["Market Data"]
---

# Historical Price Stats

`POST /historical_price_stats`

## Request

- Base URL: `https://external-api.wine-labs.com`
- URL: `https://external-api.wine-labs.com/historical_price_stats`
- Auth: none declared

Retrieve the historical time series of aggregated pricing statistics for a wine — one row per date (roughly the last 14 months) instead of the single latest snapshot returned by `/price_stats`.

## Request body

- object
  - `query` string: Free-text wine description. Required when `lwin` is not provided.
  - `lwin` string: Direct LWIN lookup. Required when `query` is not provided.
  - `region` string: Target region alias. Supported values: world, europe, north america, south america, africa, asia, oceania.
  - `currency` string: Optional output currency (uppercased) used for price conversion.
  - `user_id` string, uuid, required: Account identifier issued during onboarding; used for authentication and quota tracking.

## Response `200`

Response highlights:
- `vintage`: vintage tied to the returned series.
- `region`: normalized region label from the request.
- `lwin`: resolved LWIN when present.
- `results[]`: time series ordered by date — one entry per date (created_at, date, median_value, average, min, p25, p75, max, count, count_outliers, winelabs_price), covering roughly the last 14 months.

Notes:
- Same request shape as `/price_stats`; `/price_stats` returns the latest snapshot while `/historical_price_stats` returns the full dated history.
- Returns an empty `results` array when no historical pricing is available for the selected wine and region.
- Usage limit: up to 150,000 requests per rolling 30 days across Market Data endpoints.

- object

---

[API](https://skmtc.dev/winelabs/apis/wine-labs-api.md) · [All operations](https://skmtc.dev/winelabs/apis/wine-labs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winelabs/apis/wine-labs-api/revisions/f8898ca9974e?raw)