FHFA House Price Index

Important notes

• House Price Index; NSA index in index_nsa (relational cube), seasonally-adjusted in index_sa.

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. Retrieved from https://www.fhfa.gov. Compiled and redistributed by the Elkassabgi Data Library.

Processing: Retrieved from the official source, normalized to a long {series_key, obs_date, value} schema (period-start dates), de-duplicated, and stored as zstd Parquet. Compiled and redistributed by the Elkassabgi Data Library.

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.html

Update cadence

monthly

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": "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…",
  "url": "https://econdatalibrary.com/fhfa.html",
  "identifier": "fhfa",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "creator": {
    "@type": "Organization",
    "name": "FHFA House Price Index"
  },
  "license": "https://www.usa.gov/government-works",
  "keywords": [
    "housing",
    "fhfa"
  ],
  "temporalCoverage": "1975-01-01/2026-03-01",
  "repeatFrequency": [
    "P1M",
    "P3M"
  ],
  "citation": "U.S. Federal Housing Finance Agency, House Price Index. Retrieved from https://www.fhfa.gov. Compiled and redistributed by the Elkassabgi Data Library.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-fhfa",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "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": "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…",
  "url": "https://econdatalibrary.com/fhfa.html",
  "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"
  ],
  "temporalCoverage": "1975-01-01/2026-03-01",
  "citation": "U.S. Federal Housing Finance Agency, House Price Index. Retrieved from https://www.fhfa.gov. 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"
    }
  ]
}