# AgentsTools Real Estate Rents API

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

Returns HUD Fair Market Rents by bedroom count and Census ACS median gross rent for a US geography, with an aggregate market tier classification.

## Facts

- Endpoint: GET https://api.agentstools.dev/realestate/rents
- 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/agentstools-real-estate-rents-api-a8949d05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F7zOAIlJIknSj7B23O_Xs

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 agentstools-real-estate-rents-api-a8949d05
```

Example prompt: What are the HUD Fair Market Rents by bedroom size and the census median gross rent for ZIP code 78701 in Austin, Texas?

## When to prefer this

Use this endpoint when you need authoritative US rental market data combining HUD Fair Market Rents (by bedroom count) with Census ACS median gross rent for a specific geography — ideal for housing affordability analysis, tenant assistance calculations, market research, or real estate investment screening at the state, metro, county, ZIP, or address level. Prefer this over generic real estate APIs when you need government-sourced rent benchmarks rather than listing-based estimates.

## Known failure modes

- Invalid or unrecognized geography string returns an error or empty result
- Non-US geographies are not supported and will fail
- HUD data unavailable if HUD token not configured — falls back to ACS rent only
- Ambiguous geography (e.g. a city name matching multiple counties) may return unexpected scope
- Payment not provided or insufficient USDC (x402) results in 402 payment required error

## How this service works

Rental market indicators for a geography: HUD Fair Market Rents by bedroom count when a HUD token is configured, plus the Census ACS median gross rent as context. Falls back to the ACS rent when HUD is not configured. Aggregate market tier, US only.

## Output

Returns HUD Fair Market Rents broken down by bedroom count (0–4+ BR) when HUD token is configured, plus the Census ACS median gross rent as market context, and an aggregate rental market tier classification (e.g. low/moderate/high/premium) for the specified US geography.

## 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)"
      }
     }
    }
   },
   "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/agentstools-real-estate-rents-api-a8949d05/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)