Auctions & Exchange

Auctions

Access historical auction results from the supported self-serve auction dataset or your custom authorized scopes.

post/auctions

Request

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

Request body

user_idstring uuid required

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

auction_provider_idsnumber[]

Filter results to specific auction providers.

querystring

Free-text wine description; optional when providing identifiers.

lwinstring

Direct LWIN filter.

vintagestring

Vintage filter.

lot_idstring

Internal Wine Labs lot identifier.

auction_lot_idstring

Provider-specific lot identifier.

auction_idstring

Auction event identifier.

sold_date_fromstring date

Inclusive lower bound for sold date.

sold_date_tostring date

Inclusive upper bound for sold date.

limitnumber

Page size (1–500).

offsetnumber

Pagination offset (>= 0).

sort_bystring

Sort options: sold_date, auction_date, hammer_price_usd, realised_price_usd, bottle_price_usd, auction_id.

sort_directionstring

Sort direction: asc or desc.

Response

Response highlights:

  • limit, offset, count, total_available: pagination metadata.
  • results[]: auction lots with provider info, hammer prices (native and USD), bottle price, currency, and resolved wine identifiers.

Notes:

  • Self-serve auction plans include the supported auction-provider dataset with no provider-level conditions applied.
  • Usage limits depend on your active auction subscription and renew each billing cycle.
  • Custom plans are available when you need bespoke scopes, limits, or integration support.
object required

Changes

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