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.

• Wine Data API v1 – View attributed wine data such as drinking windows for any LWIN11 or list

• Market Price and Benchmark API v1 – View Market Price, Last Trade or Benchmark data points in bulk for any LWIN11/16/18 or list
• Offex Data API – View transactional data from our members’ own sales channels, outside of the Liv-ex exchange​

Critics

• 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

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

Logistics

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

• 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

Finance

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

LWIN

• 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

Other

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]