Returns and Risk Information (Batch)

Review HouseCanary's proprietary historical price return metrics for a MSA, including 1-year and 10-year compound annual growth rates, based on the HouseCanary home price index (HPI).

Source: HouseCanary

Pricing Tier: Basic

Updated: Monthly

Request Body Fields

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>[]</td><td>object</td><td></td><td></td> </tr> <tr><td>[].msa</td><td>string</td><td>5-digit US-census msa ID</td><td>38060</td> </tr> </table>

Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>msa</td><td>string</td><td>5-digit US-census msa ID</td><td>38060</td> </tr> <tr><td>msa_name</td><td>string</td><td>Name of the msa</td><td>San Francisco-Oakland-Hayward, CA</td> </tr> <tr><td>cagr_1</td><td>number</td><td>Historical 1-year compound annual growth rate (CAGR)</td><td>0.0432</td> </tr> <tr><td>cagr_5</td><td>number</td><td>Historical 5-year compound annual growth rate (CAGR)</td><td>0.0319</td> </tr> <tr><td>cagr_10</td><td>number</td><td>Historical 10-year compound annual growth rate (CAGR)</td><td>0.0256</td> </tr> <tr><td>cagr_20</td><td>number</td><td>Historical 20-year compound annual growth rate (CAGR)</td><td>0.0198</td> </tr> <tr><td>returns_1</td><td>number</td><td>Home price appreciation for the last year based on HPI</td><td>0.0376</td> </tr> <tr><td>returns_5</td><td>number</td><td>Home price appreciation for the last 5 years based on HPI</td><td>0.1812</td> </tr> <tr><td>returns_10</td><td>number</td><td>Home price appreciation for the last 10 years based on HPI</td><td>0.3197</td> </tr> <tr><td>returns_20</td><td>number</td><td>Home price appreciation for the last 20 years based on HPI</td><td>0.5123</td> </tr> <tr><td>max_12mo_loss</td><td>number</td><td>Historical maximum percentage 12-month loss in HPI</td><td>-0.0792</td> </tr> <tr><td>risk_12mo_loss</td><td>number</td><td>Probability that this market's HPI will be lower 12 months from now than the current HPI</td><td>0.158</td> </tr> </table>

[
  {
    "msa": "38060"
  }
]

[
  {
    "msa/details": {
      "result": {
        "msa": "38060",
        "msa_name": "San Francisco-Oakland-Hayward, CA",
        "cagr_1": 0.0432,
        "cagr_5": 0.0319,
        "cagr_10": 0.0256,
        "cagr_20": 0.0198,
        "returns_1": 0.0376,
        "returns_5": 0.1812,
        "returns_10": 0.3197,
        "returns_20": 0.5123,
        "max_12mo_loss": -0.0792,
        "risk_12mo_loss": 0.158
      }
    },
    "msa_info": {
      "msa": "41860",
      "msa_name": "San Francisco-Oakland-Hayward, CA"
    }
  }
]