Whiskystats market index data.
Whiskystats Whisky Index
Returns latest statistics and historical index values of the Whiskystats Whisky Index.
The Whiskystats Whisky Index is the broadest auction price index calculated by Whiskystats. It depicts the value changes of the historically 500 most traded whiskies each month and is the best way to gauge the movement of the overall whisky auction market.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Data Response
index_idintegerUnique identifier of the index for reference.
namestringDisplay name of the index.
currency_codestringThree-character currency code. All auction prices are normalized to this currency before index calculation.
statsobjectHigh-level aggregate statistics for the index.
index_valuesobject[]Historical time-series data for the index.
Market Indices
Returns a list of all whisky auction market indices calculated by Whiskystats.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Data Response
index_idintegerUnique identifier of the market index for reference.
namestringDisplay name of the market index.
descriptionstringA short text describing the market index.
index_groupstring · enumCategory of the index. Either Country, Region, Brand or Bottler.
Enum values:CountryRegionBrandBottlercurrency_codestringThree-character currency code. All auction prices are normalized to this currency before index calculation.
Market Index
Returns latest statistics and historical index values of the requested market index.
Use the Market Indices endpoint to look up available index_id values.
query Parameters
index_idinteger · requiredUnique identifier of the market index. Use the Market Indices endpoint to list available indices.
Default: null
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Data Response
index_idintegerUnique identifier of the index for reference.
namestringDisplay name of the index.
currency_codestringThree-character currency code. All auction prices are normalized to this currency before index calculation.
statsobjectHigh-level aggregate statistics for the index.
index_valuesobject[]Historical time-series data for the index.
Market Index Whiskies
Returns the whiskies included in a market index, together with their index weight.
The whiskies driving an index can change on a monthly basis. This endpoint returns every whisky that was ever included in the index, not only those in the current month.
Whiskies are sorted by index weight in descending order. Results are paginated with a fixed page size of 20.
Use the Market Indices endpoint to look up available index_id values.
query Parameters
index_idinteger · requiredUnique identifier of the market index. Use the Market Indices endpoint to list available indices.
Default: nullpageinteger · requiredThe page number to return (starts at 1). Each page contains 20 whiskies.
Default: null
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Data Response
index_idintegerUnique identifier of the index for reference.
pageintegerCurrent page number in the paginated list of index whiskies.
pagesintegerTotal number of pages available. Each page contains 20 whiskies.
totalintegerTotal number of whiskies that were ever included in the index.
index_whiskiesobject[]Paginated list of whiskies that were ever included in the index, with their index weight.