# Locus Market Context

> Locus Market Context is a paid API for AI agents from api.locus.report, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns housing market indicators for a US county and ZIP code, including median listing price, active listings, days on market (with YoY changes), ACS median home value, and gross rent.

## Facts

- Endpoint: POST https://api.locus.report/api/locus-market-context
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/locus-market-context-b71c812e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q8NIfi5QKFDjnfiP8Xze8

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 locus-market-context-b71c812e -d '<json body>'
```

Example prompt: What does the housing market look like near 742 Evergreen Terrace, Springfield, IL? I want to know the median listing price, how many homes are active, how long they're sitting, and what rents look like.

## When to prefer this

Choose this endpoint when you need quick, nationally-consistent housing market context (listing prices, inventory, days on market, rent levels) for any US address or coordinate — especially for buyer/seller research, loan underwriting context, or investor due diligence. Prefer this over manual FRED queries or paid MLS APIs when a free, geocoded, one-call market snapshot is sufficient and a formal appraisal or valuation is not required.

## Known failure modes

- Address not geocodable — returns error if address cannot be resolved to a county/ZIP
- No FRED/Realtor.com data available for the county or ZIP — may return partial or null fields for less-populated areas
- Invalid coordinates (out of range) — validation error from schema constraints
- Missing both address and coordinates — request rejected due to insufficient location input
- Non-US address — endpoint covers only US geographies, international inputs will fail or return no data

## How this service works

Housing market context for a county and ZIP: median listing price, active listings, and days on market with year-over-year change (Realtor.com series on FRED, monthly) plus ACS median home value and gross rent. Perfect for: 'what is the market like around this address', 'listing price trend in this county'. Market context estimates, never a valuation or ranking. National. Free at /tools/call.

## Output

Returns a JSON object with county- and ZIP-level housing market data: median listing price, active listing count, and median days on market (each with year-over-year percentage change from Realtor.com/FRED monthly series), plus ACS-sourced median home value and gross rent. Data reflects recent monthly snapshots and is intended as market context, not a property valuation or ranking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "maxLength": 200,
   "minLength": 5
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "locus_example",
  "caveats": [
   "Example artifact; not live data."
  ],
  "records": [],
  "generatedAt": "2026-01-01T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/locus-market-context-b71c812e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.locus.report](https://www.zero.xyz/host/api.locus.report/llms.txt)
