Housing Prices · Data API

United States House Price Index

Long-run US home price trends for the nation, states and metro areas.

The government house price index from the Federal Housing Finance Agency, tracking repeat-sale home price changes back to the 1970s at national, census division, state and metro level, with seasonally adjusted and unadjusted values. Proptech, mortgage, real-estate investment and AI research agents use it to benchmark home values.

Source: Federal Housing Finance Agency - House Price Index Master File · Public Domain (U.S. Government Work) · Source: U.S. Federal Housing Finance Agency, House Price Index.

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

  • GET /v1/data/united-states-house-price-index
  • GET /v1/data/united-states-house-price-index/search?q=...
  • GET /v1/data/united-states-house-price-index/{key}

Base path /v1/data/united-states-house-price-index · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

FieldTypeDescription
hpi_typestrIndex type (e.g. traditional, distress-free)
hpi_flavorstrPurchase-only, all-transactions, expanded-data
frequencystrmonthly or quarterly
levelstrGeography level (USA, State, MSA, Census Division)
place_namestrGeography name
place_idstrGeography code
yearintYear
periodintMonth or quarter number
index_nsafloatIndex, not seasonally adjusted
index_safloatIndex, seasonally adjusted

What you get

Data back to the 1970s
National, state, division and metro coverage
Seasonally adjusted and unadjusted values
Monthly and quarterly series
Free government benchmark

FAQ

Is this an actual price in dollars?
No. It is an index of repeat-sale price changes; compare values over time to get percentage changes.
How often is it updated?
Monthly series update monthly and quarterly series update quarterly.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day
  • 100 API requests per day
  • All endpoints included
  • Community support
Most popular

Pro

$9/month

For production apps and AI agents

10,000 requests/day
  • 10,000 API requests per day
  • All endpoints included
  • Priority support
  • Usage dashboard

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests
  • Unlimited API requests
  • All endpoints included
  • Priority support
  • Usage dashboard
  • Dedicated support channel

Getting Started

Start building in minutes

Register for a free API key, make your first request, and upgrade when you're ready.

1

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'
2

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"
3

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"
4

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"