Documentation by Category

Live Markets

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

Market Depth API v1– View the complete market availability and recent trading information for a product

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

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

 

Data Analysis & Valuations

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

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 historic market, trade, auction, release prices etc. for any product in the Liv-ex database

 

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

 

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

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

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 v1 – View sales 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

 

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 support@liv-ex.com