---
title: "Forecast by street address"
method: GET
path: "/api/v1/forecast"
tags: ["Forecasts"]
---

# Forecast by street address

`GET /api/v1/forecast`

## Request

- Base URL: `https://www.homecastr.com`
- URL: `https://www.homecastr.com/api/v1/forecast`
- Auth: none required

Geocodes a US address to an H3 cell and returns probabilistic value forecasts. Best coverage: Houston metro. Returns P10/P50/P90 and a 5-year fan chart.

## Query parameters

- `address` string, required
- `year` integer

## Response `200`

Forecast data

- object

## Other responses

- `400`: Missing or invalid parameters
- `404`: No forecast for address
- `429`: Rate limit exceeded (demo tier)

---

[API](https://skmtc.dev/homecastr/apis/homecastr-api.md) · [All operations](https://skmtc.dev/homecastr/apis/homecastr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/homecastr/apis/homecastr-api/revisions/5776141a0e7f?raw)