0.6.0 API Update: Historical Financial and Inventory Endpoints, New Categories and Two New Markets
At Parcl Labs, we take pride in delivering the most up-to-date, precise, and insightful data on residential real estate, empowering our users to make informed decisions. Our real-time data capabilities set us apart as the only real estate data provider offering daily price points for any US housing market.
This unique feature has paved the way for another groundbreaking addition to Parcl Labs’ API capabilities – the ability to closely monitor market changes over time. Driven by our API beta user community’s feedback, we are thrilled to introduce our most requested API feature: the Historical Financials and Historical Inventory endpoints.
So, what does this mean for you?
With these new endpoints, you can now:
- Uncover market trends over time – Identify which markets are more susceptible to fluctuations due to recent macroeconomic shifts, or pinpoint areas where condo construction has outpaced single-family residence development.
- Create captivating charts that engage and inform your users – Visually represent historical data, making it easier for your audience to grasp complex trends and insights.
- Forecast future trends with greater accuracy – Leverage historical data to make informed predictions, helping you stay ahead of the curve and devise effective strategies for your real estate endeavors.
Ready to get started? Let’s dive in.
Introducing the Historical Inventory Endpoint
With the historical inventory endpoint, you can now access the yearly historical physical inventory for any available market going back to 2010. This data includes the stock of available owner-occupied units broken out by single family residences, townhomes, and condos. The Historical Inventory endpoint can be used to take historical snapshots of markets, track the trend in residential real estate growth over time, or see what property types outpace others.
How can you access historical inventory?
Overview of the metrics returned by historical inventory
The Historical Inventory response object includes the parcl_id and an array of historical inventory data. Each object in the array provides data for a specific date, including the number of available units for each unit type and the total number of units.
Dates for past years are snapped to 12-31, as these objects represent the inventory available at the end of each year. Date for the current year is when this endpoint was last updates, and represents inventory built up until that point. See the full explanation of these metrics.
Use the Historical Inventory Endpoint to Track Growth Rate over Time
Users can leverage the historical inventory endpoint to track growth trends in residential real estate growth over time, or to see which property types outpace others. See this example recipe to learn how to use this new endpoint with python to track inventory growth rates.
To get started with the Parcl Labs API, please follow the quick start
guide to get your API key:
This quick recipe outputs a time series graph visualizing inventory growth rates.
Introducing the Financials History Endpoint
With Historical Financials, you can now access historical financial metrics for any given market. These metrics include alpha and beta, correlation coefficient, annual volatility, sharpe_ratio, average return, compound annual growth rate and kurtosis. The historical financial metrics go back to 1/31/2021, with the 1/31/2021 being built from 2020 data.
For example, a metric with a date of 1/31/2010 will include 365 days worth of price feed market data to calculate the average return, compound annual growth rate, annual volatility, etc. Essentially this is a rolling year of data that is indexed at the end of each month. Historical financials provides a monthly checkpoint of the prior year of key financials metrics about any given metric.
How can you access historical financials?
Overview of the metrics returned by historical financials
The Historical Financials response object includes monthly financial data for alpha and beta, correlation coefficient, annual volatility, sharpe_ratio, average return, compound annual growth rate and kurtosis. See the full explanation of these metrics.
Use the Historical Financials Endpoint to Analyze Market Dynamics over Time
User can now analyze market dynamics over time by leveraging monthly financial data that goes back to 1/31/2021. See this example recipe to learn how to visualize housing market volatility over time:
This quick recipe outputs a time series graph visualizing housing volatility for key markets:
Introducing Two New Markets
We are pleased to announce the addition of two new markets: Reno, NV (parcl_id: 5377231) and Broward County, FL (parcl_id: 5821600). With the inclusion of these markets, we are expanding all of our metrics and insights in the API to allow users better understand the trends and dynamics of the real estate industry in these regions.
Introducing New Endpoint Categories and Updated Paths
Introducing three new endpoint categories: financials, inventory, and price_feed, which will make it easier to path the hierarchy of current and historical versions of endpoints. We have refactored existing endpoints to new paths to enable better organization of data. The table below shows the old and new endpoint paths:
Old Endpoint Path → New Endpoint Path
v1/place/<parcl_id>/price_feed → v1/price_feed/<parcl_id>/history
v1/place/<parcl_id>/price_feed_stats → v1/price_feed/<parcl_id>/stats
v1/place/price_feed_last → v1/price_feed/latest
v1/parcls/<parcl_id>/financials → v1/financials/<parcl_id>/current
v1/parcls/<parcl_id>/inventory → v1/inventory/<parcl_id>/current
These updates will allow for more efficient access to relevant data, improving the overall performance of our API. We encourage all users to update their code to reflect these changes to ensure uninterrupted use of our API.