---
title: "Exchange Trades"
method: POST
path: "/exchange/trades"
tags: ["Auctions & Exchange"]
---

# Exchange Trades

`POST /exchange/trades`

## Request

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

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

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier used for plan-based authentication and quota tracking.
  - `query` string: Free-text wine description; optional when identifiers are provided.
  - `lwin` string: Direct LWIN filter.
  - `vintage` string: Vintage filter.
  - `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:
- 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

---

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