# US Real Estate Market Profile

> US Real Estate Market Profile is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns a composite US real-estate market profile for a given geography, fusing FHFA House Price Index momentum, Census ACS demographics, Fair Market Rents, and computed derivatives like gross rental yield and affordability.

## Facts

- Endpoint: GET https://payai.agentstools.dev/realestate/market
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-real-estate-market-profile-67c063e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uTChcISeHqRg4zbbWHG3w

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 us-real-estate-market-profile-67c063e5
```

Example prompt: Can you pull the full real estate market profile for the Denver metro area — I want HPI momentum, gross rental yield, Fair Market Rents, and affordability, based on the last 20 observations?

## When to prefer this

Choose this endpoint when you need a multi-source, computed real estate market summary for a US geography at the market/metro/county/ZIP tier — not per-address valuations. It is ideal when you want HPI momentum, rental yield, affordability, and demographics fused in one call rather than assembling from multiple data sources separately.

## Known failure modes

- Invalid or unrecognized geo value returns an error
- Ambiguous 5-digit code (ZIP vs CBSA) without explicit type may resolve incorrectly — use 'type' param to disambiguate
- Range exceeding 40 or below 1 is rejected by schema validation
- Some rural or very small geographies may have limited Census ACS data coverage
- Payment not settled results in HTTP 402 before data is returned

## How this service works

A composite US real-estate market profile for one geography. Fuses the FHFA House Price Index momentum, Census ACS demographics, housing, income, tenure and vacancy, national housing context, and Fair Market Rents into one cited JSON with computed derivatives such as gross rental yield and affordability. Aggregate market tier, not a per address valuation.

## Output

A JSON object containing the geography's FHFA House Price Index time series and momentum metrics, Census ACS demographic and housing data (tenure, vacancy, median income), HUD Fair Market Rents, computed gross rental yield, affordability ratios, national housing context, and an aggregate market tier classification — all with citations.

## 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 (2-letter code or name), metro CBSA code, county FIPS, ZIP, or an address"
      },
      "type": {
       "enum": [
        "auto",
        "state",
        "county",
        "cbsa",
        "zip",
        "address"
       ],
       "type": "string",
       "description": "How to read geo. In auto a 5-digit number is a ZIP; use cbsa or county to disambiguate"
      },
      "range": {
       "type": "integer",
       "maximum": 40,
       "minimum": 1,
       "description": "Most recent N House Price 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/us-real-estate-market-profile-67c063e5/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)