Get Market Outlook
get_market_outlookWhat it returns
A composite Market Outlook score (0-100) classifying a ZIP code as a buyer's market (<40), balanced (40-60), or seller's market (>60). Built from a hybrid weighted model — 40% macro market indicators (market-heat index and forecasts), 40% Homesage.ai absorption-rate analytics, and 20% live market signals when available. Includes 1/3/6-month forecasts, days-on-market velocity, active/sold/pending counts, and a per-signal breakdown.
When to use it
Render a market-context widget on a property report.
Power a 'best markets to buy' / 'best markets to sell' ranking.
Inform pricing-strategy recommendations.
Pricing
2 credits.
FAQ
What if live market data is unavailable?
The live-signal weight rebalances to the macro and Homesage.ai components (50% / 50%). The response's weights_used field reflects the actual weights applied.
Why ZIP-level instead of city or county?
ZIP is the smallest unit that all three sources support consistently. For city/county roll-ups, query multiple ZIPs and aggregate.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"zip": "<zip>"
},
"name": "get_market_outlook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | Yes | 5-digit US ZIP code. | |
| days | No | Lookback window. Default 90 days. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||