---
title: "Trade Signals"
method: POST
path: "/trade_signals"
tags: ["Market Insights"]
---

# Trade Signals

`POST /trade_signals`

## Request

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

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

## 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.
  - `userId` string, uuid, required: Authorized user identifier required for market_insights access.
  - `region` string: Continent-level geography filter; overrides `continents` when provided. Supported values: world, europe, north america, south america, africa, asia, oceania.
  - `currency` string: Output currency (uppercased) for price conversion.
  - `onlyTrustedMerchants` boolean: Filter results to trusted merchants only.
  - `continents` string[]: Geographic filter applied when `region` is not set.
  - `countries` string[]: 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.
  - `formats` string[]: Standardized format filters (e.g., bottle sizes).
  - `vintages` string[]: Filter to specific vintages.
  - `changeTypes` string[]: Types of changes to surface (e.g., removed, increased, decreased).
  - `since` string: Lower bound timestamp for detected changes.
  - `lastOnly` boolean: Return only the latest signal per location when true.
  - `limit` number: Rows per page (clamped 1–10).
  - `offset` number: Pagination offset (>= 0).
  - `minPercentChange` number: Minimum percent change threshold; defaults to 3 when unset or non-finite.

## Response `200`

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

---

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