FHFA House Price Index

Coverage

Licensing & provenance

License

U.S. Government Work (public domain)

License URL

https://www.usa.gov/government-works

Required attribution

Source: U.S. FHFA (public domain)

Redistribution

Permitted (served here)

Commercial use

Yes

Modification

Permitted

How to cite

U.S. Federal Housing Finance Agency, House Price Index (HPI). Compiled and redistributed by the Elkassabgi Data Library.

Processing: Retrieved from FHFA's published HPI datasets, normalized to a long {series_key, obs_date, ...} schema and stored as zstd Parquet, one file per FHFA dataset. Index columns are kept side by side as published rather than melted.

Access & mirrors

Download

Select & download fhfa series as CSV →

API

Get a free API key, then GET /v1/series/<id>.csv

Canonical landing

https://econdatalibrary.com/fhfa

Update cadence

monthly

Automated refresh

live — this database is on the daily update run

Update strategy

bulk snapshot if changed

Storage layout

Grouped cubes: data/clean_full/fhfa/<cube>.parquet for cubes {hpi_master, hpi_at_3zip_quarterly, annual_national, annual_state, annual_cbsa, annual_county, annual_zip3, annual_zip5, annual_tract} (obs: dataset, series_key, obs_date(date32), value cols index_nsa/index_sa/rstderr or hpi/hpi_1990/hpi_2000/annual_change) + <cube>__series.parquet (series meta) + <cube>.meta.json + top-level fhfa.meta.json. zstd, written whole (pandas->pyarrow, no streaming). Raw at data/raw/fhfa/ (9 files).

Full description

Full-coverage ingest of the FHFA House Price Index (HPI) datasets. Source page: https://www.fhfa.gov/data/hpi/datasets License: us-public-domain. GROUPED storage (anti-bloat): a handful of Parquet cubes under data/clean_full/fhfa/, ONE file per logical cube, each holding MANY series keyed by a `series_key` column. No one-file-per-series. Cubes written ------------- hpi_master FHFA's own consolidated master.csv: USA/CensusDiv, State, MSA levels x {traditional, distress-free, expanded-data, manufactured, non-metro, developmental} x {purchase-only, all-transactions} x {monthly, quarterly}. Columns carry both index_nsa and index_sa. hpi_at_3zip_quarterly Developmental quarterly All-Transactions index for three-digit ZIP codes (NSA only; not in master). annual_national annual_state | Annual All-Transactions "experimental" indexes annual_cbsa | (cumulative nominal appreciation). Three index annual_county | bases per obs: native (hpi), 1990 base, 2000 annual_zip3 | base, plus annual_change %. These geographies annual_zip5 | (county, zip3, zip5, tract) are NOT in master. annual_tract / Each cube => <cube>.parquet (obs) + <cube>__series.parquet (series meta) + <cube>.meta.json (verification stats). A top-level fhfa.meta.json aggregates. obs_date convention: monthly -> first of month; quarterly -> quarter END; annual -> Dec 31. Usage: python jobs/ingest_fhfa.py --download # (re)download raw files python jobs/ingest_fhfa.py # parse raw -> grouped parquet + verify python jobs/ingest_fhfa.py --download --build # do both

Structured metadata

{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "FHFA House Price Index",
  "description": "FHFA House Price Index - all-transactions; FHFA House Price Index - expanded-data. 89,706 series, 1975–2026. Free download.",
  "url": "https://econdatalibrary.com/fhfa",
  "identifier": "fhfa",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "includedInDataCatalog": {
    "@type": "DataCatalog",
    "@id": "https://econdatalibrary.com/#catalog",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com/catalog"
  },
  "creator": {
    "@type": "Organization",
    "name": "FHFA House Price Index"
  },
  "license": "https://www.usa.gov/government-works",
  "keywords": [
    "Housing",
    "Housing & Real Estate",
    "fhfa"
  ],
  "variableMeasured": [
    "FHFA House Price Index"
  ],
  "temporalCoverage": "1975-03-31/2026-05-01",
  "repeatFrequency": [
    "P1Y",
    "P1M",
    "P3M"
  ],
  "citation": "U.S. Federal Housing Finance Agency, House Price Index (HPI). Compiled and redistributed by the Elkassabgi Data Library.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-fhfa",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "name": "fhfa — CSV",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=fhfa",
      "license": "https://www.usa.gov/government-works"
    }
  ]
}

{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "fhfa",
  "description": "FHFA House Price Index - all-transactions; FHFA House Price Index - expanded-data. 89,706 series, 1975–2026. Free download.",
  "url": "https://econdatalibrary.com/fhfa",
  "creator": {
    "@type": "sc:Organization",
    "name": "FHFA House Price Index"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "https://www.usa.gov/government-works",
  "keywords": [
    "Housing",
    "Housing & Real Estate"
  ],
  "temporalCoverage": "1975-03-31/2026-05-01",
  "citation": "U.S. Federal Housing Finance Agency, House Price Index (HPI). Compiled and redistributed by the Elkassabgi Data Library.",
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "fhfa-csv",
      "name": "fhfa-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=fhfa",
      "encodingFormat": "text/csv"
    }
  ]
}