# StationFX: New Residential Building Permits (Total Units) > StationFX: New Residential Building Permits (Total Units) is a paid API for AI agents from stationfx.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02). Returns monthly U.S. residential building permit counts with trend statistics — a leading indicator of housing construction activity 1-3 months ahead of housing starts. ## Facts - Endpoint: GET https://stationfx.com/economic-data/housing/new-privately-owned-housing-units-authorized-in-permit-issuing-places-total-units?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-02 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/stationfx-new-residential-building-permits-total-units-6acb6ede - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vvzm6_JwGBMxw3ZuIBtwY Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability stationfx-new-residential-building-permits-total-units-6acb6ede ``` Example prompt: Pull the StationFX new residential building permits series from January 2022 through March 2025 in JSON format, and include the year-over-year change and 5-year z-score so I can see where permit activity stands relative to history. ## When to prefer this Choose this endpoint when you need a monthly leading indicator of U.S. housing construction that precedes housing starts by 1-3 months. Preferred over housing starts data when forecasting near-term construction pipeline, modeling homebuilder revenues, or assessing the housing cycle's current phase. Best used alongside Fed funds rate or yield curve data from StationFX's sibling endpoints for rate-cycle context. ## Known failure modes - Invalid date format returns an error — must be YYYY-MM-DD - date_from after date_to returns empty or error response - Requesting fields not available in the series returns null values or error - Unsupported fmt enum value returns a 400 error - Data may lag by 1-2 months reflecting BLS/Census publication schedule ## How this service works Number of new residential building permits issued — a leading indicator of future housing construction activity. Leads housing starts by 1-3 months. Use for housing cycle analysis and construction sector modeling. Monthly frequency. ## Output Returns a time-series array of monthly permit observations, each with: raw value (units authorized), month-over-month and year-over-year absolute and percentage changes, 12-month and 5-year z-scores, 5-year percentile rank, 3-month and 12-month rolling averages, and an above-trend binary flag. Supports JSON or compact 'toon' format. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http", "description": "Always \"http\" for HTTP endpoints" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string", "description": "HTTP method. Always GET for StationFX query endpoints" }, "queryParams": { "type": "object", "properties": { "fmt": { "enum": [ "json", "toon" ], "type": "string", "description": "Response format. Use toon for compact agent-friendly output." }, "fields": { "type": "string", "description": "Comma-separated metric names" }, "date_to": { "type": "string", "description": "End date YYYY-MM-DD" }, "date_from": { "type": "string", "description": "Start date YYYY-MM-DD" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string", "description": "Response format. Always \"json\" (or \"toon\" if fmt=toon was requested)" }, "example": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "Observation date YYYY-MM-DD" }, "value": { "type": "number", "description": "Raw observed value in series units" }, "mom_pct": { "type": "number", "description": "Month-over-month % change" }, "yoy_pct": { "type": "number", "description": "Year-over-year % change" }, "zscore_5y": { "type": "number", "description": "Z-score relative to trailing 5 years" }, "mom_change": { "type": "number", "description": "Month-over-month absolute change" }, "yoy_change": { "type": "number", "description": "Year-over-year absolute change" }, "zscore_12m": { "type": "number", "description": "Z-score relative to trailing 12 … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "description": "Observation date YYYY-MM-DD" }, "value": { "type": "number", "description": "Raw observed value in series units" }, "mom_pct": { "type": "number", "description": "Month-over-month % change" }, "yoy_pct": { "type": "number", "description": "Year-over-year % change" }, "zscore_5y": { "type": "number", "description": "Z-score relative to trailing 5 years" }, "mom_change": { "type": "number", "description": "Month-over-month absolute change" }, "yoy_change": { "type": "number", "description": "Year-over-year absolute change" }, "zscore_12m": { "type": "number", "description": "Z-score relative to trailing 12 months" }, "above_trend": { "type": "integer", "description": "1 if value is above long-run trend, else 0" }, "pct_rank_5y": { "type": "number", "description": "Percentile rank over trailing 5 years (0-100)" }, "rolling_3m_avg": { "type": "number", "description": "3-month rolling average" }, "rolling_12m_avg": { "type": "number", "description": "12-month rolling average" }, "trend_direction": { "type": "integer", "description": "Trend: 1 rising, -1 falling, 0 flat" } } }, "description": "Observations ordered by date ascending" }, "meta": { "type": "object", "description": "Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields" } }, "description": "Station f(x) response with metadata and pre-computed derived metrics" }, "example": { "data": [ { "date": "2024-01-01", "value": 5.33, "mom_pct": 0, "yoy_change": 0.5, "zscore_12m": 1.2, "trend_direction": 1 } ], "meta": { "frequency": "M", "source_key": "PERMIT" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stationfx-new-residential-building-permits-total-units-6acb6ede/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from stationfx.com](https://www.zero.xyz/host/stationfx.com/llms.txt)