{
  "$schema": "https://actualwinnings.com/data/index.json",
  "name": "Actual Winnings data endpoints",
  "description": "Index of the machine-readable data published by Actual Winnings. Every endpoint is free, needs no key, and carries its own provenance.",
  "generatedAt": "2026-08-25T23:50:01.817Z",
  "license": "Free to use with attribution to https://actualwinnings.com",
  "documentation": "https://actualwinnings.com/data-api",
  "endpoints": [
    {
      "name": "State tax rates",
      "url": "https://actualwinnings.com/data/state-tax-rates.json",
      "group": "Tax data",
      "description": "Lottery tax rate for all 50 states and DC, with the reason any state departs from its headline rate.",
      "updates": "When rates change, typically once a year",
      "fields": {
        "lotteryTaxRate": "Decimal rate applied to winnings (0.05 = 5%)",
        "hasIncomeTax": "Whether the state levies an individual income tax at all",
        "additionalLocalTax": "Extra local or county rate where one applies",
        "notes": "Why this rate departs from the headline top marginal rate"
      }
    },
    {
      "name": "Federal tax brackets",
      "url": "https://actualwinnings.com/data/federal-tax-brackets.json",
      "group": "Tax data",
      "description": "Federal marginal brackets for all four filing statuses, plus the mandatory withholding rate.",
      "updates": "Once a year"
    },
    {
      "name": "Tax rate history",
      "url": "https://actualwinnings.com/data/tax-rate-history.json",
      "group": "Tax data",
      "description": "State and federal lottery tax rates archived per tax year.",
      "updates": "A new year is added each tax year"
    },
    {
      "name": "Current jackpots",
      "url": "https://actualwinnings.com/data/jackpots.json",
      "group": "Jackpots",
      "description": "Advertised jackpot, cash value, next drawing time and latest winning numbers for every game tracked.",
      "updates": "Three times daily"
    },
    {
      "name": "Jackpot history",
      "url": "https://actualwinnings.com/data/jackpot-history.json",
      "group": "Jackpots",
      "description": "Advertised jackpot and cash value per drawing, with the cash-to-annuity ratio and estimated plays sold.",
      "updates": "Three times daily",
      "fields": {
        "cashRatio": "cashValue ÷ jackpot. Null unless the cash value was actually published",
        "cashValueBasis": "\"published\" if the lottery reported the cash value, \"estimated\" if it was derived from the jackpot",
        "estimatedPlays": "Plays inferred from special-ball winner counts. An estimate of plays, not tickets or revenue",
        "openingJackpot": "First advertised amount seen for the drawing, where we watched the cycle open",
        "basis": "\"official\" from the game's published result, \"observed\" from the advertised amount beforehand"
      }
    },
    {
      "name": "Jackpot winners",
      "url": "https://actualwinnings.com/data/jackpot-winners.json",
      "group": "Jackpots",
      "description": "Every drawing whose jackpot was won, with the amount and the cash value published at the time.",
      "updates": "Three times daily",
      "fields": {
        "winningTickets": "Tickets sharing the jackpot, where counted",
        "state": "Best-effort two-letter code read from the description; may be null",
        "description": "The game’s own account of the win, unmodified"
      }
    },
    {
      "name": "Annuity schedules",
      "url": "https://actualwinnings.com/data/annuity-schedules.json",
      "group": "Jackpots",
      "description": "Each of the 30 annuity payments as a share of the advertised jackpot, applied to the current jackpots.",
      "updates": "Three times daily",
      "fields": {
        "paymentFactors": "Year 1–30, each as a share of the advertised jackpot. Sums to 1",
        "annualIncreaseRate": "Escalation between payments (0.05 = 5% a year)"
      }
    },
    {
      "name": "Number statistics",
      "url": "https://actualwinnings.com/data/number-statistics.json",
      "group": "Draw results",
      "description": "Per-number draw frequency over each game’s recorded history.",
      "updates": "Three times daily",
      "fields": {
        "sufficientForAnalysis": "False when too few drawings are recorded; frequencies are then omitted",
        "daysSinceDrawn": "Days between the number’s last appearance and generation time"
      }
    },
    {
      "name": "Draw payouts",
      "url": "https://actualwinnings.com/data/draw-payouts/{game}/{year}.json",
      "group": "Draw results",
      "description": "Winners and prize amount at every tier, for each drawing, as published by the game.",
      "updates": "Three times daily",
      "templated": true,
      "example": "https://actualwinnings.com/data/draw-payouts/powerball/2026.json",
      "fields": {
        "tiers[].winners": "Base winners at that tier; multiplier winners are a subset, not additional",
        "tiers[].oneIn": "Odds of that tier under the matrix in force on the drawing date",
        "matrix": "Ball pool in force for that drawing; both games have changed theirs more than once"
      }
    }
  ]
}