# US Real Estate Market Profile API

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

Returns a composite real-estate market profile for a US geography, fusing FHFA HPI momentum, Census ACS demographics, housing/income/tenure/vacancy data, and Fair Market Rents into a single cited JSON with computed metrics like gross rental yield and affordability index.

## Facts

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

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-api-85c156c1
```

Example prompt: Can you pull the full housing market profile for the Austin-Round Rock metro area — I want to see the HPI trend over the last 20 quarters, Fair Market Rents, gross rental yield, and affordability score, with CBSA as the geography type?

## When to prefer this

Use this endpoint when you need a comprehensive, multi-source real estate market summary for a US geography at the state, metro, county, or ZIP level — especially when you want HPI trends, rental yield, affordability, and demographic context in a single call with cited sources. Prefer this over individual Census or FHFA API calls when you need derived metrics like gross rental yield already computed. Not suitable for per-address or per-property valuations.

## Known failure modes

- Invalid or unrecognized geo value — returns error if the geography string cannot be resolved to a known state, CBSA, county, ZIP, or address
- Ambiguous 5-digit code — without specifying type=cbsa or type=county, a 5-digit number defaults to ZIP which may not be intended
- Range out of bounds — range must be between 1 and 40; values outside this return a validation error
- Payment failure — x402 micropayment of $0.03 USDC not completed, returns 402 Payment Required
- Data unavailability — some geographies (e.g. very small counties) may have incomplete ACS or FHFA coverage

## 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 cited JSON object containing FHFA House Price Index momentum and historical observations, Census ACS demographics (population, income, tenure, vacancy), HUD Fair Market Rents, and computed derivatives including gross rental yield and an affordability metric, along with an aggregate market tier classification. All figures are market-level aggregates, not per-address valuations.

## 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-api-85c156c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)