Auctions & Exchange

Exchange Trades

Retrieve historical executed trades from the supported self-serve exchange venues or your custom authorized sources.

post/exchange/trades

Request

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

Request body

user_idstring uuid required

Authorized user identifier used for plan-based authentication and quota tracking.

querystring

Free-text wine description; optional when identifiers are provided.

lwinstring

Direct LWIN filter.

vintagestring

Vintage filter.

sourcesstring[]

Restrict results to specific exchange sources.

formatstring

Bottle format filter.

conditionstring

Condition filter.

packagingstring

Packaging filter.

duty_codestring

Duty status filter (e.g., IB, DP).

currency_codestring

Optional target currency for FX conversion; does not filter trades by currency.

traded_at_fromstring date-time

Inclusive lower bound for trade timestamp.

traded_at_tostring date-time

Inclusive upper bound for trade timestamp.

limitnumber

Page size (1–500).

offsetnumber

Pagination offset (>= 0).

sort_bystring

Sort options: traded_at, price, source, volume.

sort_directionstring

Sort direction: asc or desc.

Response

Response highlights:

  • limit, offset, count, total_available: pagination metadata.
  • results[]: executed trades with trade identifiers, provider context, wine identifiers, price, currency, volume, condition, packaging, duty status, and execution timestamp.

Notes:

  • Self-serve exchange plans include bordeaux_index, winebourse, cru_world_wine, cultx, cult_wines, vinovest, bbx, and arvest_wine.
  • Transactions API includes auctions, exchange trades, and exchange order book under one shared allowance. All exchanges except Liv-ex are included. Legacy Exchange Endpoints subscriptions retain their original split allowances.
  • Use traded_at_from and traded_at_to to constrain the time horizon of results.
  • Custom plans are available if you need additional venues, custom scopes, or higher throughput.
object required

Changes

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