Market Insights

Trade Signals

Return price movement alerts for a wine with optional geography, format, and change-type filters.

post/trade_signals

Request

  • Base URL: https://external-api.wine-labs.com
  • URL: https://external-api.wine-labs.com/trade_signals
  • Auth: none declared

Request body

querystring

Free-text wine description. Required when lwin is not provided.

lwinstring

Direct LWIN lookup. Required when query is not provided.

userIdstring uuid required

Authorized user identifier required for market_insights access.

regionstring

Continent-level geography filter; overrides continents when provided. Supported values: world, europe, north america, south america, africa, asia, oceania.

currencystring

Output currency (uppercased) for price conversion.

onlyTrustedMerchantsboolean

Filter results to trusted merchants only.

continentsstring[]

Geographic filter applied when region is not set.

countriesstring[]

Restrict results to the provided countries. Accepts full names (e.g. "France") or ISO alpha-2/alpha-3 codes (e.g. "FR", "FRA"). Note: use "UK" or "GB" for the United Kingdom.

formatsstring[]

Standardized format filters (e.g., bottle sizes).

vintagesstring[]

Filter to specific vintages.

changeTypesstring[]

Types of changes to surface (e.g., removed, increased, decreased).

sincestring

Lower bound timestamp for detected changes.

lastOnlyboolean

Return only the latest signal per location when true.

limitnumber

Rows per page (clamped 1–10).

offsetnumber

Pagination offset (>= 0).

minPercentChangenumber

Minimum percent change threshold; defaults to 3 when unset or non-finite.

Response

Response highlights:

  • data[]: trade signal entries with merchant and location metadata.

Notes:

  • Requires market_insights authorization plus either query or lwin; unresolved wines return 404.
object required

Changes

No recorded changes to this operation across all 1 revision of this API.