---
title: "Get market trends"
method: GET
path: "/api/v1/market/trends"
tags: ["Market"]
---

# Get market trends

`GET /api/v1/market/trends`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/market/trends`
- Auth: HTTP bearer

Retrieve quarterly time series of market metrics for one or more counties or a state. Requires an API key (or a signed-in session); metered.

## Query parameters

- `county_fips` string
- `state_fips` string

## Response `200`

Market trend time series returned.

- object
  - `data` object[], required
    - `quarter` string, nullable, required
    - `total_sales` integer, nullable, required
    - `median_price` number, nullable, required
    - `total_volume` integer, nullable, required
    - `avg_dom` number, nullable, required
    - `county_fips` string
    - `county_name` string
    - `quarters` object[]
      - `quarter` string
      - `sale_count` integer
      - `median_price` number
      - `avg_price` number
      - `yoy_change` number, float
  - `mode` string, required

## Other responses

- `400`: A query or body parameter is invalid. Nothing was read or charged.
- `401`: Missing, malformed or invalid credential.
- `402`: Monthly call cap reached (free tier, or a paid tier with the hard cap enabled).
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error. The body never carries database or driver text.

---

[API](https://skmtc.dev/propraven/apis/propraven-api.md) · [All operations](https://skmtc.dev/propraven/apis/propraven-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propraven/apis/propraven-api/revisions/37f8158c4eda?raw)