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

# Market Quality

`GET /v2/zip/market_grade`

Obtain HouseCanary's proprietary market grade, representing the relative desirability and volatility of the ZIP code compared to others in the same market, to better assess investment opportunities at different points throughout the housing cycle. 

Source: HouseCanary 

Pricing Tier: Basic 

Updated: Annually

## 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><th>Enum Values</th></tr>
<tr><td>market_grade</td><td>string</td><td>Grade derived from a HouseCanary proprietary cluster algorithm. One of [A, B, C, D, F] with A being least volatile across market cycles and F being most volatile.</td><td>A</td>
        <td>[A, B, C, D, F]</td></tr>
</table>

## Query parameters

- `zipcode` string, required

## Response `200`

Success

- object[]
  - `zip/market_grade` object
    - `api_code_description` string
    - `api_code` unknown
    - `result` object, nullable
      - `market_grade` 'A' | 'B' | 'C' | 'D' | 'F' — Grade derived from a HouseCanary proprietary cluster algorithm. One of [A, B, C, D, F] with A being least volatile across market cycles and F being most 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)