---
title: "Transactions"
method: POST
path: "/transactions"
tags: ["Auctions & Exchange"]
---

# Transactions

`POST /transactions`

## Request

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

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

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier used for plan-based authentication and quota tracking.
  - `auction_provider_ids` number[]: Optional auction-provider filter for transaction feeds that include auction venues.
  - `query` string: Free-text wine description; optional when identifiers are provided.
  - `lwin` string: Direct LWIN filter.
  - `lwins` string[]: Batch list of LWIN values when requesting multiple wines in one call.
  - `vintage` string: Vintage filter.
  - `queries` string[]: Batch list of free-text wine queries when requesting multiple wines in one call.
  - `sources` string[]: Restrict results to specific exchange sources.
  - `format` string: Bottle format filter.
  - `condition` string: Condition filter.
  - `packaging` string: Packaging filter.
  - `duty_code` string: Duty status filter (e.g., IB, DP).
  - `currency_code` string: Optional target currency for FX conversion; does not filter trades by currency.
  - `traded_at_from` string, date-time: Inclusive lower bound for trade timestamp.
  - `traded_at_to` string, date-time: Inclusive upper bound for trade timestamp.
  - `limit` number: Page size (1–500).
  - `offset` number: Pagination offset (>= 0).
  - `sort_by` string: Sort options: traded_at, price, source, volume.
  - `sort_direction` string: Sort direction: asc or desc.

## Response `200`

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

---

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