---
title: "Market Volatility"
method: GET
path: "/v2/zip/volatility"
tags: ["Zipcode Level"]
---

# Market Volatility

`GET /v2/zip/volatility`

Obtain HouseCanary's proprietary market volatility metrics for a local ZIP code, including beta, Sharpe ratio, and Modigliani-Modigliani risk-adjusted return, based on the HouseCanary home price index (HPI). 

Source: HouseCanary 

Pricing Tier: Basic 

Updated: Monthly

## Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>zipcode</td><td>string</td><td>5-digit zipcode</td><td>33019</td>
        </tr>
</table>

## Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>beta</td><td>number</td><td>Beta is a measure of the volatility, or systematic risk, of a security or a portfolio in comparison to the market as a whole. Beta is calculated by comparing the security's or portfolio's price movement to the movement of the market index. A beta of 1 indicates that the security's price moves with the market. A beta above 1 indicates that the security's price is more volatile than the market, while a beta below 1 indicates that the security's price is less volatile than the market.</td><td>1.2</td>
        </tr>
<tr><td>sharpe_ratio</td><td>number</td><td>Sharpe ratio is a measure for calculating risk-adjusted return. It is the average return earned in excess of the risk-free rate per unit of volatility or total risk. A high Sharpe ratio indicates that the risk-adjusted return is high. A low Sharpe ratio indicates that the risk-adjusted return is low.</td><td>0.75</td>
        </tr>
<tr><td>modigliani_risk_adjusted_return</td><td>number</td><td>Measure of volatility in zip HPI relative to national HPI. Values greater than 1 indicate that zip HPI is more volatile.</td><td>0.85</td>
        </tr>
</table>

## Query parameters

- `zipcode` string, required

## Response `200`

Success

- object[]
  - `zip/volatility` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `beta` number — Beta is a measure of the volatility, or systematic risk, of a security or a portfolio in comparison to the market as a whole. Beta is calculated by comparing the security's or portfolio's price movement to the movement of the market index. A beta of 1 indicates that the security's price moves with the market. A beta above 1 indicates that the security's price is more volatile than the market, while a beta below 1 indicates that the security's price is less volatile than the market.
      - `sharpe_ratio` number — Sharpe ratio is a measure for calculating risk-adjusted return. It is the average return earned in excess of the risk-free rate per unit of volatility or total risk. A high Sharpe ratio indicates that the risk-adjusted return is high. A low Sharpe ratio indicates that the risk-adjusted return is low.
      - `modigliani_risk_adjusted_return` number — Measure of volatility in zip HPI relative to national HPI. Values greater than 1 indicate that zip HPI is more volatile.
  - `zipcode_info` ZipcodeInfo
    - `zip` string, nullable — 5-digit zip code

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis.md) · [All operations](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/housecanary/housecanary-analytics-and-portfolio-monitoring-apis/revisions/38afb6724de7/schema)