Whisky Hunter · Schema

Whisky Hunter Auction Data Point

Schema representing an aggregated auction data point from the Whisky Hunter API. Covers trading volume, bid statistics, and lot counts for a single auction platform at a specific date. All monetary values are in GBP (£).

WhiskySpiritsAuctionsMarket DataCollectorsInvestors

Properties

Name Type Description
dt string Date of the auction data point (YYYY-MM-DD).
auction_name string Name of the whisky auction platform.
auction_slug string URL-safe identifier for the auction platform.
auction_trading_volume number Total trading volume (sum of winning bids) in GBP (£). Excludes lots that did not meet reserve price.
auction_lots_count integer Number of lots sold in this auction during this period.
all_auctions_lots_count integer Total lots sold across all 28 tracked auctions in this period.
winning_bid_max number Maximum (highest) winning bid in this auction in GBP (£).
winning_bid_min number Minimum (lowest) winning bid in this auction in GBP (£).
winning_bid_mean number Mean (average) winning bid in this auction in GBP (£).
View JSON Schema on GitHub

JSON Schema

whisky-hunter-auction-data-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/whisky-hunter/main/json-schema/whisky-hunter-auction-data-schema.json",
  "title": "Whisky Hunter Auction Data Point",
  "description": "Schema representing an aggregated auction data point from the Whisky Hunter API. Covers trading volume, bid statistics, and lot counts for a single auction platform at a specific date. All monetary values are in GBP (£).",
  "type": "object",
  "properties": {
    "dt": {
      "type": "string",
      "format": "date",
      "description": "Date of the auction data point (YYYY-MM-DD)."
    },
    "auction_name": {
      "type": "string",
      "description": "Name of the whisky auction platform.",
      "example": "Scotch Whisky Auctions"
    },
    "auction_slug": {
      "type": "string",
      "description": "URL-safe identifier for the auction platform.",
      "example": "scotch-whisky-auctions"
    },
    "auction_trading_volume": {
      "type": "number",
      "minimum": 0,
      "description": "Total trading volume (sum of winning bids) in GBP (£). Excludes lots that did not meet reserve price."
    },
    "auction_lots_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of lots sold in this auction during this period."
    },
    "all_auctions_lots_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Total lots sold across all 28 tracked auctions in this period."
    },
    "winning_bid_max": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum (highest) winning bid in this auction in GBP (£)."
    },
    "winning_bid_min": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum (lowest) winning bid in this auction in GBP (£)."
    },
    "winning_bid_mean": {
      "type": "number",
      "minimum": 0,
      "description": "Mean (average) winning bid in this auction in GBP (£)."
    }
  },
  "required": ["dt", "auction_name", "auction_slug"]
}