Market Value
Returns the latest market value of a whisky.
The market value is the 90-day moving average of auction buyer prices (hammer price plus buyer fees). The market value date indicates the day of the latest auction trade.
If the Whisky ID is unknown, status code 204 is returned.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
whisky_idstring · requiredThe Whisky ID.
Use "WB" as a prefix for Whiskybase IDs (e.g. "WB37719"). Use "BG" as a prefix for Whiskystats Bottle Group IDs (e.g. "BG124"). See our Documentation for more details.
currency_codestring · requiredThree-character currency code (e.g. "EUR"). See our Documentation for more details.
Responses
Data Response
whisky_idstringThe requested Whisky ID for reference.
market_valuenumberThe latest market value of the whisky in the requested currency.
market_value_datestring · dateThe date at which the whisky was last traded at auctions.
currency_codestringThe requested currency code for reference.
Latest Auction Price
Returns the latest auction price observation of a whisky.
Price information includes buyer fees. The price date indicates the day of the latest auction trade. If multiple bottles were sold at the same day, the average buyer price is provided.
If the Whisky ID is unknown, status code 204 is returned.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
whisky_idstring · requiredThe Whisky ID.
Use "WB" as a prefix for Whiskybase IDs (e.g. "WB37719"). Use "BG" as a prefix for Whiskystats Bottle Group IDs (e.g. "BG124"). See our Documentation for more details.
currency_codestring · requiredThree-character currency code (e.g. "EUR"). See our Documentation for more details.
Responses
Data Response
whisky_idstringThe requested Whisky ID for reference.
buyer_pricenumberThe latest auction buyer price of the whisky in the requested currency.
price_datestring · dateThe date at which the whisky was last traded at auctions.
currency_codestringThe requested currency code for reference.
Lowest Retail Price
Returns the lowest current retail price.
Global retail prices are compared by converting them to EUR using the daily interbank exchange rate.
If the Whisky ID is unknown, status code 204 is returned.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
whisky_idstring · requiredThe Whisky ID.
Use "WB" as a prefix for Whiskybase IDs (e.g. "WB37719"). Use "BG" as a prefix for Whiskystats Bottle Group IDs (e.g. "BG124"). See our Documentation for more details.
currency_codestring · requiredThree-character currency code (e.g. "EUR"). See our Documentation for more details.
Responses
Data Response
whisky_idstringThe requested Whisky ID for reference.
retail_pricenumberThe lowest retail price of the whisky in the requested currency.
currency_codestringThe requested currency code for reference.
Whiskybase Rating
Returns the average Whiskybase rating.
The highest and lowest ratings are removed when calculating the average but not for the rating count.
If the Whisky ID is unknown, status code 204 is returned.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
whisky_idstring · requiredThe Whisky ID.
Use "WB" as a prefix for Whiskybase IDs (e.g. "WB37719"). Use "BG" as a prefix for Whiskystats Bottle Group IDs (e.g. "BG124"). See our Documentation for more details.
Responses
Data Response
whisky_idstringThe requested Whisky ID for reference.
whiskybase_ratingnumberThe Whiskybase rating of the whisky.
whiskybase_rating_countnumberThe number of Whiskybase ratings.