# FHFA House Price Index Lookup

> FHFA House Price Index Lookup is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-15).

Returns the FHFA House Price Index for a US geography, including current index level, YoY/QoQ/5-year growth rates, momentum flags, and recent history.

## Facts

- Endpoint: GET https://payai.agentstools.dev/realestate/prices
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fhfa-house-price-index-lookup-1248b23e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vU7oI69SjzHkQe_FdDErt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fhfa-house-price-index-lookup-1248b23e
```

Example prompt: What's the current FHFA House Price Index for the Denver metro area, and how has it changed year over year and over the last 5 years? Show me the last 8 quarters of history.

## When to prefer this

Use this endpoint when you need official US government housing price index data (FHFA HPI) for states, metro CBSAs, counties, or ZIP codes, including growth rates and momentum signals. Prefer this over commercial real estate APIs when public-domain, authoritative benchmark data is required for research, investment analysis, or compliance purposes. Note that county and ZIP inputs resolve to state-level granularity.

## Known failure modes

- Invalid or unrecognized geo input returns an error
- Non-US geographies are not supported
- Range parameter out of bounds (must be 1–40) returns validation error
- Ambiguous geo string with type='auto' may resolve to unexpected geography level
- County FIPS or ZIP resolves to state-level only, not fine-grained local data

## How this service works

The FHFA House Price Index for a geography: the current index level plus year over year, quarter over quarter and five year growth, with momentum flags and a short history. State and metro CBSA levels are covered directly; county and ZIP resolve to the state level index. Public domain, US only.

## Output

Returns the current FHFA House Price Index level for the requested geography, along with year-over-year, quarter-over-quarter, and 5-year percentage growth figures, momentum flags indicating whether growth is accelerating or decelerating, and a short historical series of recent index observations. County and ZIP inputs resolve to the state-level index.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "geo"
     ],
     "properties": {
      "geo": {
       "type": "string",
       "description": "A state, metro CBSA code, county FIPS, ZIP, or address"
      },
      "type": {
       "enum": [
        "auto",
        "state",
        "county",
        "cbsa",
        "zip",
        "address"
       ],
       "type": "string",
       "description": "How to read geo (auto reads a 5-digit number as a ZIP)"
      },
      "range": {
       "type": "integer",
       "maximum": 40,
       "minimum": 1,
       "description": "Most recent N index observations of history"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fhfa-house-price-index-lookup-1248b23e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)
