Market cycle classification (Pro+ tier)

GET/v1/suburbs/{state}/{suburb}/market_cycle1 credit

2-axis classification (heat x momentum x volatility) fusing 16 momentum signals (including the PropRadar 12-month growth outlook) with absolute-price gates that stop phase labels from contradicting headline growth. Pick a property type with `?property_type=houses|units` (default houses). Suburbs without enough sample to classify return 404 insufficient_data. Hobby/Starter callers get 403 plan_upgrade_required; the credits are refunded.

Parameters

Name	In	Required	Description
state	path	yes	Two-letter state code
suburb	path	yes	Suburb name (URL-encoded)
property_type	query	no	houses (default) or units
postcode	query	no	4-digit postcode. Use to disambiguate when a suburb name spans multiple postcodes.

Example request

curl "https://api.propradar.com.au/v1/suburbs/VIC/Pascoe%20Vale/market_cycle?property_type=houses" \
  -H "X-API-Key: pr_live_..."

Example response

{
  "suburb": "PASCOE VALE", "state": "VIC", "postcode": 3044,
  "property_type": "houses",
  "market_cycle": {
    "phase": "rising", "confidence": "high",
    "dps": 62, "dps_level": "medium",
    "momentum_score": 0.80, "momentum_direction": "positive",
    "volatility_score": 0.32, "volatility_level": "moderate",
    "signal_quality_score": 0.81, "signal_alignment": 0.74,
    "estimated_months_to_next_phase": 15,
    "override_applied": false,
    "top_signals": [
      { "name": "Vacancy Pressure", "value": "1% vacancy rate",
        "metrics": [{ "key": "vacancy_rate_pct", "label": "Vacancy rate", "value": 1.0, "unit": "percent" }],
        "score": 2, "direction": "positive", "weight": 0.18, "contribution": 0.36, "available": true },
      ...
    ],
    "signals": [ ... 15 entries ... ]
  },
  "as_of": "2026-05-12T03:00:00Z"
}

Get an API key

Every endpoint takes an X-API-Key header. The free tier needs no credit card.

Get a free API key Full API documentation

Other endpoints

Many suburbs in one call: statistics and recent sales POST /v1/suburbs/batch
List every suburb in the dataset (coverage index) GET /v1/suburbs
Authenticated health probe GET /v1/health
Account usage and credit allowance GET /v1/usage
Resolve an address to a property_id GET /v1/properties/search
Look up a single property GET /v1/properties/{property_id}
Recent sold comparables (Hobby+; lat/lng mode Pro+) GET /v1/comparables
Suburb statistics GET /v1/suburbs/{state}/{suburb}
Trust-gated suburb rankings (Pro+ tier) GET /v1/suburbs/rankings
Multi-criteria suburb screener (Pro+ tier) GET /v1/suburbs/screen
Recent sold properties in a suburb GET /v1/suburbs/{state}/{suburb}/sold
Current active listings in a suburb GET /v1/suburbs/{state}/{suburb}/listings
Search current listings across a whole state (Pro+ tier) GET /v1/properties/listings
Property event history GET /v1/properties/{property_id}/history
Most recent sold record (Hobby+ tier) GET /v1/properties/{property_id}/sold_summary
Potential sell price confidence band GET /v1/properties/{property_id}/psp_with_confidence
Similar active listings GET /v1/properties/{property_id}/similar
Nearby active listings GET /v1/properties/{property_id}/nearby
Batch property lookup (Starter+ tier) POST /v1/properties/bulk
Value an off-market address: instant estimate or enhanced valuation (Hobby+ tier) POST /v1/valuations
Poll an off-market valuation job GET /v1/valuations/{id}
Valuation range for a locality, no address needed (Pro+ tier) POST /v1/valuations/estimate
12-month outlook for house/unit price and rent (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/forecast
Development applications near a point (Pro+ tier) GET /v1/developments/nearby
Properties currently advertised for rent in a suburb (Hobby+ tier) GET /v1/suburbs/{state}/{suburb}/rentals
Weekly rent estimate for a locality, no address needed (Pro+ tier) POST /v1/rent/estimate
Recently-modified event feed (Starter+ tier) GET /v1/properties/recently-modified
Investment score + cashflow (Pro+ tier) GET /v1/properties/{property_id}/investment_analysis
Annual price/rent/yield time-series (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/price_history
Market-heat time-series (Pro+ tier) GET /v1/suburbs/{state}/{suburb}/heat_history
List macro regions (Growth+ tier) GET /v1/regions
Region macro indicators (Growth+ tier) GET /v1/regions/{slug}
Suggest addresses as the user types GET /v1/addresses/suggest
Turn free text into suburbs GET /v1/suburbs/resolve