---
title: "Price History"
method: POST
path: "/price_history"
tags: ["Market Insights"]
---

# Price History

`POST /price_history`

## Request

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

Return aggregated price history for a resolved wine with client-friendly caching and currency conversion.

## 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.
  - `user_id` string, uuid, required: Authorized user identifier (accepts `user_id` or `userId`) required for market_insights access.
  - `region` string: Region alias. Supported values: world, europe, north america, south america, africa, asia, oceania, uk, united kingdom, continental europe.
  - `vintage` string: Vintage filter; use ALL to include every vintage.
  - `currency` string: Output currency (uppercased) for price conversion.
  - `start_date` string: Inclusive start date filter; rejected when the format is invalid or if it is later than `end_date`.
  - `end_date` string: Inclusive end date filter; validated against `start_date` and forwarded to the SQL query.
  - `limit` number: Rows per page (clamped 1–2000), ordered by newest date first.
  - `offset` number: Pagination offset (>= 0).

## Response `200`

Response highlights:
- `history[]`: reverse-chronological price history data with converted prices.
- `regions`: static list of available region aliases for selection.

Notes:
- Requires market_insights authorization plus either `query` or `lwin`; unresolved wines return 404.
- `start_date`/`end_date` are parsed and logged with the request metadata, and rejected when invalid or when `start_date` is later than `end_date`.

- 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)