{
  "schema": "commodity-public-provenance/1",
  "edition_date": "2026-10-16",
  "retrieved_at": "2026-10-16T11:02:54.819574Z",
  "sources": [
    {
      "id": "crude",
      "source_url": "https://www.eia.gov/dnav/pet/hist_xls/WCESTUS1w.xls",
      "retrieved_at": "2026-10-16T11:02:50.823586Z",
      "raw_sha256": "c4deaec57d4768142e80e3142ef14f187f05848f12d2fa6ae897e7831af50acd",
      "raw_bytes": 130048,
      "unit": "thousand barrels",
      "selection": "Worksheet Data 1, WCESTUS1 column; all 313 week-ending observations from 2019-01-04 through 2024-12-27; independently matched to the EIA HTML history.",
      "source_date": "2026-10-15",
      "source_date_meaning": "Retrieved historical workbook release date, not each observation's original release",
      "rights": {
        "attribution": "U.S. Energy Information Administration",
        "policy_url": "https://www.eia.gov/about/copyrights_reuse.php",
        "basis": "Selected original federal government statistical data; attributed reuse. Third-party charts, logos and licensed data are excluded."
      }
    },
    {
      "id": "gas",
      "source_url": "https://ir.eia.gov/ngs/ngshistory.xls",
      "retrieved_at": "2026-10-16T11:02:50.515657Z",
      "raw_sha256": "90f49a2a3934ac2302eaba8d3712a02a89e0f86ef8db363219e0635a5c1697fb",
      "raw_bytes": 771072,
      "unit": "Bcf",
      "selection": "Worksheet html_report_history, Total Lower 48 column; all 313 week-ending observations from 2019-01-04 through 2024-12-27; every selected record labelled EIA-912.",
      "source_date": "2026-10-15",
      "source_date_meaning": "Retrieved historical workbook release date, not each observation's original release",
      "rights": {
        "attribution": "U.S. Energy Information Administration",
        "policy_url": "https://www.eia.gov/about/copyrights_reuse.php",
        "basis": "Selected original federal government statistical data; attributed reuse. Third-party charts, logos and licensed data are excluded."
      }
    },
    {
      "id": "corn-may",
      "source_url": "https://esmis.nal.usda.gov/usda-esmis/files/3t945q76s/mp48v3615/cz30rh065/wasde0524.pdf",
      "retrieved_at": "2026-10-16T11:02:51.934018Z",
      "raw_sha256": "8f41bab602c4beee3fd2299f3055cb82bfe0c4f87337b8dc4eae6846e32b1e50",
      "raw_bytes": 843688,
      "unit": "million bushels",
      "selection": "Printed page 12, CORN table, rightmost May 2024/25 projected column; eleven reported balance fields, not the aggregate feed-grain table.",
      "source_date": "2024-05-10",
      "source_date_meaning": "Dated WASDE publication vintage; forecast for 2024/25",
      "rights": {
        "attribution": "U.S. Department of Agriculture",
        "policy_url": "https://www.usda.gov/about-usda/policies-and-links",
        "basis": "Selected original federal government statistical data; attributed reuse. Third-party charts, logos and licensed data are excluded."
      }
    },
    {
      "id": "corn-august",
      "source_url": "https://esmis.nal.usda.gov/usda-esmis/files/3t945q76s/r781z751z/m613pp61v/wasde0824.pdf",
      "retrieved_at": "2026-10-16T11:02:51.940369Z",
      "raw_sha256": "e33b5332b039004ab10174240a1a336f69fe2855f585dccd0a591294df8f718e",
      "raw_bytes": 840155,
      "unit": "million bushels",
      "selection": "Printed page 12, CORN table, rightmost August 2024/25 projected column; eleven reported balance fields. Retain rounded reported totals, including their one-million-bushel component difference.",
      "source_date": "2024-08-12",
      "source_date_meaning": "Dated WASDE publication vintage; forecast for 2024/25",
      "rights": {
        "attribution": "U.S. Department of Agriculture",
        "policy_url": "https://www.usda.gov/about-usda/policies-and-links",
        "basis": "Selected original federal government statistical data; attributed reuse. Third-party charts, logos and licensed data are excluded."
      }
    }
  ],
  "normalized_extracts": [
    {
      "name": "inventories.json",
      "sha256": "7a05d1689fc4d6873326832ebe20aa2f97c3d1b18986d14b5db1d181d30b3fff",
      "bytes": 52347
    },
    {
      "name": "corn.json",
      "sha256": "82c435ff40d16ea4cb0ba6c39e95a883a9a9712ba8be2a339755da3a316b7956",
      "bytes": 1956
    }
  ],
  "method": {
    "inventory_months": "Arithmetic mean of weekly observations whose week-ending dates fall within the calendar month; not a monthly flow or time-weighted average.",
    "seasonal_baseline": "Equal-weight mean of the five preceding calendar years' corresponding monthly means; each requires at least four observations. The range is the min/max of those five monthly means, not EIA's official weekly interpolated band.",
    "corn_ratio": "Reported ending stocks divided by reported total use, multiplied by 100; compare the same 2024/25 projected marketing year across two dated documents.",
    "limits": "Current retrieved inventory history can include revisions; no point-in-time backtest, price forecast, investment return or live refresh is represented."
  }
}