Auctions & Exchange

Transactions

Retrieve historical transaction data across the auction and exchange scopes available to your self-serve or custom access package.

post/transactions

Request

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

Request body

user_idstring uuid required

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

auction_provider_idsnumber[]

Optional auction-provider filter for transaction feeds that include auction venues.

querystring

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

lwinstring

Direct LWIN filter.

lwinsstring[]

Batch list of LWIN values when requesting multiple wines in one call.

vintagestring

Vintage filter.

queriesstring[]

Batch list of free-text wine queries when requesting multiple wines in one call.

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:

  • Transactions access follows the same self-serve and custom authorization rules as the auctions and exchange endpoints above.
  • Transactions API shares one monthly allowance across auctions, exchange trades, and exchange order book. The combined /transactions endpoint counts once per wine, without billing its internal auction and trade calls again. Batch requests count per wine. All auction houses and exchanges except Liv-ex are included.
  • Use query/lwin for a single wine request, or queries/lwins for multi-wine batch style requests.
  • Use traded_at_from and traded_at_to to constrain the time horizon of results.
object required

Changes

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