Instant 0–100 composite score for comparing markets or making go/no-go decisions.
WHEN TO USE THIS vs analyze_market_activity:
- Use score_market_health when you need a single comparable number ("rank these markets", "is this worth investing in?")
- Use analyze_market_activity when you need volume trends over time or seasonal patterns
REQUIRED: At least one of code_postal, commune, or code_departement.
Note: latitude+longitude is NOT supported — use code_postal, commune, or code_departement only.
Optional:
- type_local: "Maison", "Appartement", "Terrain", "Local commercial"
Score interpretation:
- 0–30: Low activity — weak volume, stagnant/declining prices
- 31–60: Moderate — decent activity, neutral trends
- 61–80: Active — good volume, slight price increase
- 81–100: Very dynamic — strong demand, fast-rising prices
Returns: score (0–100), label, components (volume, price_trend, dispersion), data_quality.
Windows end on the latest DVF sale. Volume compares the latest 12 months with the 36 before.
Returns score: null if fewer than 10 transactions in the latest 12 months (data_quality.count_6m, name kept for compatibility).
Cost: 10 credits per call