Skip to main content

Live Markets

Bid Offer API v1 – Bulk feed of all live exchange best bids and offers

Bid Offer Change Since API v1 – View live bid and offer changes for a specified timeframe

Search Market API v1 – View live exchange bid and offer information using various product, geographic and pricing filters

My Positions API v2 – View your Liv-ex exchange positions (bids and offer) in your own system

Forex API v1 – View up-to-date foreign exchange rate data

Best Bid/Offer PUSH service  – Automatic messages PUSHed to your system when competitive bids/offers appear against your positions

Outbid and Underoffered PUSH service – Automatic messages PUSHed to your system when a new position out-competes yours (bids and offers)

Custom Lists

List Manager API v1 – Facilitates the creation of new lists, the editing of existing lists, or the deletion of existing lists

List Tally API v1 – Provides a summary view of your created lists

Line Manager API v1 – Facilitates the creation of new lines within a list, the editing of existing lines, or the deletion of existing lines

List View API v1 – Provides a view of the content within a specified list

Data Analysis & Valuations

Indices List API v1 – View the list of active Liv-ex indices, their description and Bloomberg / Thompson Reuter tag

Indices Components API v1 – View the list of components and their individual performance levels within a specific Liv-ex index

Time Series Export API v1 – View historical data timeseries for any LWIN or Liv-ex index

Chart Data Performance API v1 – View recent performance indications (MoM, YTD, 1yr, 2yr, 5yr) for any LWIN or Liv-ex Index

Price Data API v2– Live and historical market, trade, auction, release prices etc. for any product in the Liv-ex database

Merchant Names API v1 – Returns the trading names of the businesses identified by you for inclusion in the List Comparison service.

List Comparison API v1 – Request the prices at which specific businesses are offering a particular wine.

Auction Events API v1 – Returns historical auction data for tens of thousands of different wines.


Critic Data API v1 – View scores, tasting notes and drinking dates from wine publications you are subscribed to

Critic Data Change Since API v1 – View recent scores, tasting notes and drinking dates over a defined time period

Critic Bulk Data API v1 – View scores, tasting notes and drinking dates for large data sets for your subscribed wine publications


Trading Automation Guidelines – Considerations before you connect

Heartbeat API v1 – Check that the Liv-ex exchange is up and available

Orders API v7  – Place bids and offers on the Liv-ex exchange

Order PUSH Service – Automatic messages PUSHed to your system when trades events, edits, deletions etc. take place on the exchange

Bulk Order Action API v3 – Bulk methods to renew, reactivate or suspend your bids and offers positions

Order Status API v1 – Ping the live availability, status and price of a specific bid/offer

Photo Upload API v1 – Upload and delete photos for attachment to special offers

Photo View API v1 – View your uploaded photo assets

Order by UID API v1 – Directly offer stock stored in Liv-ex warehouse facilities

Your Trades List API v1 – Search for and view a list of your previous trades on the exchange

Your Trade Details API v1 – View detailed information about a specific trade on the exchange

Edit Trade Reference API v1 – Amend or update any reference you gave to a trade on the exchange


Cellar View API v2 – View and reconcile your stock stored with Liv-ex logistics

Pre-Advice API v1– Inform Liv-ex logistics of stock being sent in to Liv-ex facilities

Release API v2 – Instruct deliveries and collections from Liv-ex facilities

Ship API v1 – Assign stock stored by Liv-ex logistics to specific trades or instantly transfer it between subaccounts

ABV Data API v1 – View alcohol by volume data for LWIN products

ABV Bulk Data API v1 – View alcohol by volume data for large data sets

Commodity Code API v1 – Generate commodity/HS/Taric/CN codes for LWIN products


Trading Activity API v2 – Information about the status and settlement progress of your Liv-ex trades

Account Status API v2 – View your live trading status, trading limits and trading account balances

Account Users API v1 – View who in your company has a Liv-ex account, their role and their trading privileges

Invoices API v2 – View invoice data and charge breakdowns

Net Statements API v1 – View current and historic Liv-ex net statements (PDF format, generated weekly)

Data Allowance API v1 – View your historic usage of Liv-ex data and your data allowance, in MB


LWIN Search v1 – Token search the entire LWIN database to find LWIN codes. Also available as a Java SDK

LWIN View v1 – View LWIN metadata including vintage information and historical name changes

LWIN Change Since v1 – View all recent LWIN creation, edit and combine events over a defined time period

LWIN PUSH Services – Outbound PUSH service that broadcasts all LWIN creation, edit and combine events in real-time

LWIN7 Request v1 – Notify the LWIN team of a missing product that needs to be created and share details of it

LWIN11 Request v1 – Notify the LWIN team of a vintage that needs to be created for an existing LWIN7 product

LWIN Request Status Check v1 – Check the live status of any LWIN7 or LWIN11 request(s) you have made


Service Level Agreements

LWIN SLA – Service level agreement for LWIN covering standard processes for adding and amending LWIN records, expected timelines, and optional paid-for LWIN services

3rd Party SLA – Service level agreement setting out the relationship between, and the obligations and expectations of,  Liv-ex, 3rd party data providers (e.g. providers of critic scores, label images etc.) and Liv-ex customers.

API retirement schedule

Liv-ex offers a growing number of APIs. Occasionally, we need to retire legacy APIs to make room for innovation. To avoid any significant disruption, a deprecation policy is in place for services due to be retired. 

The API retirement schedule contains a full list, and dates, of APIs due to be retired.

Legacy Services

If you require documentation for an old version or legacy Liv-ex service not listed on this page, please contact [email protected]