# realestate-compare

> realestate-compare is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-16).

Rank and compare multiple US geographies side-by-side on a chosen real estate metric such as price momentum, rental yield, or median home value.

## Facts

- Endpoint: GET https://payai.agentstools.dev/realestate/compare
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/realestate-compare-edb59890
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IXy-X51eI8S9VvZN3QU8i

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 realestate-compare-edb59890
```

Example prompt: Can you compare Austin TX, Phoenix AZ, and Nashville TN on gross rental yield and tell me which market ranks highest right now?

## When to prefer this

Use this endpoint when you need a structured side-by-side ranking of multiple US real estate markets on a single metric. It is ideal for investment screening, market research, and affordability analysis where you want not just raw values but comparative rank context (highest, lowest, spread, mean). Prefer this over a single-geography lookup when the user's question is explicitly comparative ('which of these markets is best for X').

## Known failure modes

- Fewer than two geographies provided — endpoint requires at least two for comparison
- Invalid or unrecognized geography codes (bad FIPS, CBSA, or ZIP) return an error or are omitted
- Metric enum value not recognized returns a validation error
- Data unavailable for a specific geography or metric combination may return partial results or missing values
- Network or payment failure results in a 402 or timeout response

## How this service works

Compare several US geographies on one real-estate metric: price momentum, gross rental yield, price to income, median home value, median gross rent or median household income. Returns a ranking plus rank, highest and lowest, spread and mean signals.

## Output

Returns a ranked list of the submitted geographies sorted by the chosen metric, along with each geography's rank position, the metric value, which geography ranked highest and lowest, and summary statistics including the spread (max minus min) and mean across all geographies compared.

## 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": "Two or more geographies (states, metro CBSA codes, county FIPS or ZIPs), comma-separated"
      },
      "metric": {
       "enum": [
        "price_momentum_yoy",
        "gross_rental_yield",
        "price_to_income",
        "median_home_value",
        "median_gross_rent",
        "median_household_income"
       ],
       "type": "string",
       "description": "The metric to rank on (default price_momentum_yoy)"
      }
     }
    }
   },
   "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/realestate-compare-edb59890/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)