# Rental Market Snapshot API (x402)

> Rental Market Snapshot API (x402) is a paid API for AI agents from 192.3.171.233, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns authoritative U.S. rental market benchmarks, trends, geography, and optional budget fit analysis for a given ZIP code and bedroom count, sourced from Zillow ZORI and HUD Fair Market Rent data.

## Facts

- Endpoint: POST https://192.3.171.233/v1/rentals/market-snapshot?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rental-market-snapshot-api-x402-fdbd2137
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MIvM0AfdHCpHphCu799xt

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 rental-market-snapshot-api-x402-fdbd2137 -d '<json body>'
```

Example prompt: What does the rental market look like for a 2-bedroom apartment in ZIP code 78701? My monthly budget is $2,300 — pull the Zillow and HUD benchmarks and tell me if I'm above or below the typical asking rent.

## When to prefer this

Use this endpoint when you need authoritative, sourced U.S. rental market benchmarks (Zillow ZORI + HUD FMR) for a specific ZIP code and bedroom count — especially when you need data provenance, trend percentages, and optional budget fit analysis in a single call. Prefer this over general web search when you need structured, reproducible rent benchmark data with attribution and content hashes. Not suitable for live unit listings, lease price negotiation data, or non-U.S. markets.

## Known failure modes

- Unsigned requests receive an x402 payment challenge and are not charged
- Invalid credentials or requests that cannot produce the advertised minimum result are rejected before payment and not charged
- ZIP code not found or not mappable to ZCTA geography returns an error
- Bedroom count outside 0-4 range is rejected by schema validation
- Budget value of 0 or exceeding maximum is rejected
- ZORI or HUD data unavailable for the requested geography may return partial results with warnings

## How this service works

An x402-paid API suite for autonomous agents. The freight operation preserves deterministic U.S. DOT/FMCSA carrier checks. A self-contained rental market snapshot returns available public rent benchmarks, trends, provenance, and optional budget fit from a ZIP code and bedroom count. Other rental operations normalize, deduplicate, search, compare, and analyze rental observations supplied by a caller who is authorized to process them. Zillow Research ZORI, U.S. Census ZCTA geography, and HUD Fair Market Rent data are not represented as unit-level listings or executed lease rents. Unsigned requests receive the x402 challenge before validation. Credential-bearing retries that are invalid or cannot produce the advertised minimum result are rejected before payment verification and settlement and are not charged.

## Output

A JSON object containing: normalized input (ZIP, bedrooms, budget), rent trend percentages (1-month, 3-month, 12-month), area-level rent benchmarks (ZORI typical asking rent and HUD Fair Market Rent in cents), optional budget fit verdict with per-benchmark comparisons and basis-point differences, geographic metadata (lat/lon, HUD area code and name), and full data provenance evidence records including source URLs, content hashes, and observation timestamps. Warnings clarify that benchmarks are area-level public data, not live unit listings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bedrooms": {
   "type": "integer",
   "maximum": 4,
   "minimum": 0
  },
  "postalCode": {
   "type": "string",
   "pattern": "^[0-9]{5}(-[0-9]{4})?$"
  },
  "monthlyBudgetCents": {
   "type": "integer",
   "maximum": 100000000,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "input": {
   "bedrooms": 2,
   "postalCode": "78701",
   "monthlyBudgetCents": 230000
  },
  "trends": {
   "asOf": "2026-07",
   "change1MonthPct": 0.4,
   "change3MonthPct": 1.2,
   "change12MonthPct": 2.8
  },
  "evidence": [
   {
    "id": "ev_zori",
    "dataset": "Zillow Observed Rent Index (ZORI)",
    "sourceId": "zillow-research",
    "sourceUrl": "https://www.zillow.com/research/data/",
    "fieldPaths": [
     "/benchmarks",
     "/trends"
    ],
    "observedAt": "2026-07-31T00:00:00Z",
    "attribution": "Data Provided by Zillow Group; Zillow Research ZORI",
    "contentHash": "sha256:ccdbf127d9e36d25f3c0e535a3cb4280c7b67117399e6fe42a41a914f1c9087a",
    "retrievedAt": "2026-08-24T12:05:00Z"
   },
   {
    "id": "ev_hud",
    "dataset": "HUD Fair Market Rents",
    "sourceId": "hud-pdr",
    "sourceUrl": "https://www.huduser.gov/portal/dataset/fmr-api.html",
    "fieldPaths": [
     "/geography/hudAreaCode",
     "/geography/hudAreaName",
     "/benchmarks"
    ],
    "observedAt": "2026-08-24T12:00:00Z",
    "contentHash": "sha256:7f1f38d06d9f1880b1811d889d33637384c6d768031bdd087be6c4b98e4d0055",
    "retrievedAt": "2026-08-24T12:05:00Z"
   }
  ],
  "warnings": [
   "Public benchmarks are area-level context and are not live unit inventory."
  ],
  "budgetFit": {
   "verdict": "BUDGET_ABOVE_PRIMARY_BENCHMARK",
   "comparisons": [
    {
     "verdict": "ABOVE_BENCHMARK",
     "benchmarkId": "ZORI_TYPICAL_ASKING_RENT",
     "differenceCents": 20000,
     "benchmarkRentCents": 210000,
     "monthlyBudgetCents": 230000,
     "differenceBasisPoints": 952
    },
    {
     "verdict": "NEAR_BENCHMARK",
     "benchmarkId": "HUD_FAIR_MARKET_RENT",
     "differenceCents": 10000,
     "benchmarkRentCents": 220000,
     "monthlyBudgetCents": 230000,
     "differenceBasisPoints": 455
    }
   ],
   "reasonCodes": [
    "BUDGET_AT_LEAST_5_PERCENT_ABOVE_PRIMARY_BENCHMARK"
   ],
   "interpretation": "The primary benchmark is ZORI when available, otherwise the requested-bedroom HUD Fair Market Rent. Positive differences mean the stated budget is above a benchmark.",
   "primaryBenchmarkId": "ZORI_TYPICAL_ASKING_RENT",
   "thresholdBasisPoints": 500
  },
  "geography": {
   "latitude": 30.2713,
   "longitude": -97.7426,
   "postalCode": "78701",
   "hudAreaCode": "METRO12420M12420",
   "hudAreaName": "Austin-Round Rock-Georgetown, TX HUD Metro FMR Area"
  },
  "benchmarks": [
   {
    "id": "ZORI_TYPICAL_ASKING_RENT",
    "as
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rental-market-snapshot-api-x402-fdbd2137/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 192.3.171.233](https://www.zero.xyz/host/192.3.171.233/llms.txt)