Markets

Aggregate market statistics and historical trends by ZIP code. Track median prices, inventory levels, and market velocity over time.

Get Market Data

Retrieve the latest market snapshot for a ZIP code. Returns aggregate statistics computed from current and recently sold listings, including pricing, inventory, and market velocity metrics.

GET /v1/markets/{zipCode}

Path Parameters

Parameter Type Description
zipCode required string 5-digit ZIP code.

Request

curl
curl "https://api.straply.com/v1/markets/62704" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

200 OK
{
  "zipCode": "62704",
  "city": "Springfield",
  "state": "IL",
  "snapshot": {
    "date": "2026-03-10",
    "medianListPrice": 289900,
    "medianSoldPrice": 275000,
    "activeListings": 147,
    "newListings30d": 38,
    "soldLast30d": 29,
    "medianDaysOnMarket": 22,
    "averagePricePerSqft": 148.50,
    "inventoryMonths": 5.1,
    "listToSoldRatio": 0.965
  }
}

Response Fields

Field Type Description
medianListPrice integer Median asking price of active listings in dollars.
medianSoldPrice integer Median sale price of properties sold in the last 30 days.
activeListings integer Total number of currently active listings in this ZIP code.
newListings30d integer Number of new listings added in the last 30 days.
soldLast30d integer Number of properties sold in the last 30 days.
medianDaysOnMarket integer Median days on market for recently sold properties.
averagePricePerSqft number Average list price per square foot across active listings.
inventoryMonths number Months of supply at the current absorption rate. Below 4 indicates a seller's market; above 6 indicates a buyer's market.
listToSoldRatio number Ratio of median sold price to median list price. Values above 1.0 indicate homes are selling above asking.

Get Market History

Retrieve monthly market snapshots over time for a ZIP code. Each data point contains the same fields as the market snapshot endpoint, allowing you to track trends in pricing, inventory, and market velocity.

GET /v1/markets/{zipCode}/history

Path Parameters

Parameter Type Description
zipCode required string 5-digit ZIP code.

Query Parameters

Parameter Type Description
months integer Number of months of history to return. Default 12, maximum 60.

Request

curl
curl "https://api.straply.com/v1/markets/62704/history?months=3" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

200 OK
{
  "zipCode": "62704",
  "city": "Springfield",
  "state": "IL",
  "history": [
    {
      "date": "2026-03-01",
      "medianListPrice": 289900,
      "medianSoldPrice": 275000,
      "activeListings": 147,
      "newListings30d": 38,
      "soldLast30d": 29,
      "medianDaysOnMarket": 22,
      "averagePricePerSqft": 148.50,
      "inventoryMonths": 5.1,
      "listToSoldRatio": 0.965
    },
    {
      "date": "2026-02-01",
      "medianListPrice": 284500,
      "medianSoldPrice": 271000,
      "activeListings": 132,
      "newListings30d": 31,
      "soldLast30d": 24,
      "medianDaysOnMarket": 28,
      "averagePricePerSqft": 145.20,
      "inventoryMonths": 5.5,
      "listToSoldRatio": 0.958
    },
    {
      "date": "2026-01-01",
      "medianListPrice": 279000,
      "medianSoldPrice": 268000,
      "activeListings": 118,
      "newListings30d": 22,
      "soldLast30d": 19,
      "medianDaysOnMarket": 35,
      "averagePricePerSqft": 142.80,
      "inventoryMonths": 6.2,
      "listToSoldRatio": 0.952
    }
  ]
}

Tip: Use market history to build trend charts and detect shifts in market conditions. A rising inventoryMonths combined with declining listToSoldRatio can signal a cooling market.