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

# Price Stats

`POST /price_stats`

## Request

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

Retrieve the latest aggregated pricing statistics for a wine in a target region.

## 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 snapshot.
- `region`: normalized region label from the request.
- `lwin`: resolved LWIN when present.
- `results[]`: array of pricing metrics (created_at, date, median_value, min, p25, p75, max, count, count_outliers, winelabs_price).

Notes:
- Returns an empty `results` array when no recent 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)