Markets

The Markets endpoints provide aggregate market data at the ZIP code level, including current statistics and historical trends.

Get market data

GET /v1/markets/{zipCode}

Returns current market statistics for a ZIP code.

Path parameters

Parameter	Type	Description
zipCode	string	Five-digit ZIP code

Example request

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

Example response

{
  "data": {
    "zipCode": "90210",
    "city": "Beverly Hills",
    "state": "CA",
    "snapshot": {
      "date": "2026-03-09",
      "medianListPrice": 3450000,
      "medianSoldPrice": 3200000,
      "activeListings": 142,
      "newListings30d": 38,
      "soldLast30d": 22,
      "medianDaysOnMarket": 45,
      "averagePricePerSqft": 1180,
      "inventoryMonths": 6.5,
      "listToSoldRatio": 0.93
    }
  }
}

Response fields

Field	Type	Description
medianListPrice	integer	Median active listing price
medianSoldPrice	integer	Median sold price in last 30 days
activeListings	integer	Total active listings
newListings30d	integer	New listings in last 30 days
soldLast30d	integer	Properties sold in last 30 days
medianDaysOnMarket	integer	Median days on market for sold properties
averagePricePerSqft	integer	Average price per square foot
inventoryMonths	number	Months of inventory (active / sold per month)
listToSoldRatio	number	Ratio of sold price to list price

---

Get market history

GET /v1/markets/{zipCode}/history

Returns monthly market statistics over time for trend analysis.

Path parameters

Parameter	Type	Description
zipCode	string	Five-digit ZIP code

Query parameters

Parameter	Type	Default	Description
months	integer	12	Number of months of history (max 60)

Example request

curl "https://api.straply.com/v1/markets/90210/history?months=6" \
  -H "Authorization: Bearer stp_live_YOUR_KEY"

Example response

{
  "data": {
    "zipCode": "90210",
    "city": "Beverly Hills",
    "state": "CA",
    "history": [
      {
        "month": "2026-03",
        "medianListPrice": 3450000,
        "medianSoldPrice": 3200000,
        "activeListings": 142,
        "soldCount": 22,
        "medianDaysOnMarket": 45,
        "averagePricePerSqft": 1180
      },
      {
        "month": "2026-02",
        "medianListPrice": 3380000,
        "medianSoldPrice": 3150000,
        "activeListings": 135,
        "soldCount": 19,
        "medianDaysOnMarket": 48,
        "averagePricePerSqft": 1150
      },
      {
        "month": "2026-01",
        "medianListPrice": 3320000,
        "medianSoldPrice": 3100000,
        "activeListings": 118,
        "soldCount": 15,
        "medianDaysOnMarket": 52,
        "averagePricePerSqft": 1120
      }
    ]
  }
}