{"contractVersion":"parcelops.connector.v1","name":"fhfa-hpi","displayName":"FHFA State House Price Index","description":"Official quarterly home price trends for one state or one metro area, plus a side-by-side comparison of up to six cities and county conforming loan limits.","tags":["fhfa","house-price-index","home-prices","residential","state-market","metro-market","city-comparison","quarterly","loan-limits","conforming-loans","united-states"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"FHFA House Price Index®","sourceUrl":"https://www.fhfa.gov/hpi/download/quarterly_datasets/hpi_at_state.csv","apiBaseUrl":"https://www.fhfa.gov/hpi/download/quarterly_datasets","documentationUrl":"https://www.fhfa.gov/data/hpi/datasets"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"sourceLastModified","notes":"Follows FHFA quarterly HPI file updates."}},"coverage":{"geographic":{"status":"declared","value":["50 US states and the District of Columbia as published by FHFA","About 409 metro areas and metropolitan divisions (CBSAs) as published by FHFA"]},"temporal":{"status":"not_declared"}},"methods":{"total":5,"items":[{"name":"getStateHousePriceIndex","description":"Get recent quarterly FHFA all-transactions HPI values for one state or DC.","requiredParams":["stateAlpha"],"inputSchema":{"type":"object","properties":{"stateAlpha":{"type":"string","pattern":"^[A-Za-z]{2}$"},"startYear":{"type":"integer","minimum":1975,"maximum":2100},"endYear":{"type":"integer","minimum":1975,"maximum":2100},"limit":{"type":"integer","minimum":1,"maximum":220}},"required":["stateAlpha"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"sourceLastModified","notes":"Follows FHFA quarterly HPI file updates."},"scope":"connector"},"entities":{"status":"declared","value":["state-house-price-index-series"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The index measures relative average single-family price change, not dollar prices or parcel values.","The all-transactions state series uses sales-price and appraisal data and is not seasonally adjusted.","State indexes are normalized to 100 in 1980 Q1 and matter relative to other periods.","Metro indexes are normalized to 100 in 1995 Q1, so two metros at the same index level have risen the same amount since 1995 Q1, not to the same price.","The metro standard error published alongside each index describes the precision of that estimate; it is not an annual percent change.","Conforming loan limits are financing-program thresholds, not property values, loan approvals, or a statement that a transaction is eligible.","Relative state single-family market index only; not an appraisal, AVM, rent, comparable sale, or parcel value."]},{"name":"getMetroHousePriceIndex","description":"Get recent quarterly home price index values for one metro area, by name or CBSA code.","inputSchema":{"type":"object","properties":{"metro":{"type":"string","minLength":2,"maxLength":120,"description":"Metro area as people say it: \"houston\", \"dallas\", \"waco tx\". A name shared by several metros (\"springfield\") returns the candidates instead of guessing."},"cbsaCode":{"type":"string","pattern":"^\\d{5}$"},"startYear":{"type":"integer","minimum":1975,"maximum":2100},"endYear":{"type":"integer","minimum":1975,"maximum":2100},"limit":{"type":"integer","minimum":1,"maximum":220}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"sourceLastModified","notes":"Follows FHFA quarterly HPI file updates."},"scope":"connector"},"entities":{"status":"declared","value":["metro-house-price-index-series"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The index measures relative average single-family price change, not dollar prices or parcel values.","The all-transactions state series uses sales-price and appraisal data and is not seasonally adjusted.","State indexes are normalized to 100 in 1980 Q1 and matter relative to other periods.","Metro indexes are normalized to 100 in 1995 Q1, so two metros at the same index level have risen the same amount since 1995 Q1, not to the same price.","The metro standard error published alongside each index describes the precision of that estimate; it is not an annual percent change.","Conforming loan limits are financing-program thresholds, not property values, loan approvals, or a statement that a transaction is eligible.","Relative metro single-family market index only; not an appraisal, AVM, rent, comparable sale, or parcel value.","Not seasonally adjusted and set to 100 in 1995 Q1, so index levels compare growth since 1995 Q1, not price levels.","The published standard error describes the precision of the index estimate; it is not an annual percent change."]},{"name":"compareMetroHousePriceIndexes","description":"Compare quarterly home price trends across 2 to 6 metro areas in one call.","requiredParams":["metros"],"inputSchema":{"type":"object","properties":{"metros":{"type":"array","minItems":2,"maxItems":6,"items":{"type":"string","minLength":2,"maxLength":120},"description":"Metro names or five-digit CBSA codes, for example [\"houston\",\"dallas\"]."},"startYear":{"type":"integer","minimum":1975,"maximum":2100},"endYear":{"type":"integer","minimum":1975,"maximum":2100},"limit":{"type":"integer","minimum":1,"maximum":220}},"required":["metros"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"sourceLastModified","notes":"Follows FHFA quarterly HPI file updates."},"scope":"connector"},"entities":{"status":"declared","value":["metro-house-price-index-series"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The index measures relative average single-family price change, not dollar prices or parcel values.","The all-transactions state series uses sales-price and appraisal data and is not seasonally adjusted.","State indexes are normalized to 100 in 1980 Q1 and matter relative to other periods.","Metro indexes are normalized to 100 in 1995 Q1, so two metros at the same index level have risen the same amount since 1995 Q1, not to the same price.","The metro standard error published alongside each index describes the precision of that estimate; it is not an annual percent change.","Conforming loan limits are financing-program thresholds, not property values, loan approvals, or a statement that a transaction is eligible.","Metro indexes share a 1995 Q1 = 100 base, so a higher index means more growth since 1995 Q1, not a higher home price.","Compare the newest quarter the metros share; a newer quarter for one metro alone is not a comparison."]},{"name":"getCountyConformingLoanLimits","description":"Get the official pinned 2026 one- through four-unit conforming loan limits for one county FIPS.","requiredParams":["countyFips"],"inputSchema":{"type":"object","properties":{"countyFips":{"type":"string","pattern":"^\\d{5}$"},"year":{"type":"integer","enum":[2026]}},"required":["countyFips"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"sourceLastModified","notes":"Follows FHFA quarterly HPI file updates."},"scope":"connector"},"entities":{"status":"declared","value":["county-conforming-loan-limit"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"oneUnitLimit":"USD","twoUnitLimit":"USD","threeUnitLimit":"USD","fourUnitLimit":"USD"}},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The index measures relative average single-family price change, not dollar prices or parcel values.","The all-transactions state series uses sales-price and appraisal data and is not seasonally adjusted.","State indexes are normalized to 100 in 1980 Q1 and matter relative to other periods.","Metro indexes are normalized to 100 in 1995 Q1, so two metros at the same index level have risen the same amount since 1995 Q1, not to the same price.","The metro standard error published alongside each index describes the precision of that estimate; it is not an annual percent change.","Conforming loan limits are financing-program thresholds, not property values, loan approvals, or a statement that a transaction is eligible.","Limits are program thresholds, not an appraisal, approval, offer, or property-level lending decision."]},{"name":"getServiceInfo","description":"Return the exact state and metro files, series definitions, normalization, citation, and limits.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","observedAtField":"sourceLastModified","notes":"Follows FHFA quarterly HPI file updates."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The index measures relative average single-family price change, not dollar prices or parcel values.","The all-transactions state series uses sales-price and appraisal data and is not seasonally adjusted.","State indexes are normalized to 100 in 1980 Q1 and matter relative to other periods.","Metro indexes are normalized to 100 in 1995 Q1, so two metros at the same index level have risen the same amount since 1995 Q1, not to the same price.","The metro standard error published alongside each index describes the precision of that estimate; it is not an annual percent change.","Conforming loan limits are financing-program thresholds, not property values, loan approvals, or a statement that a transaction is eligible."]}]},"caveats":["The index measures relative average single-family price change, not dollar prices or parcel values.","The all-transactions state series uses sales-price and appraisal data and is not seasonally adjusted.","State indexes are normalized to 100 in 1980 Q1 and matter relative to other periods.","Metro indexes are normalized to 100 in 1995 Q1, so two metros at the same index level have risen the same amount since 1995 Q1, not to the same price.","The metro standard error published alongside each index describes the precision of that estimate; it is not an annual percent change.","Conforming loan limits are financing-program thresholds, not property values, loan approvals, or a statement that a transaction is eligible."]}