{"uid":"cap_QObTNQjs-f8QfYJ8iFqOi","slug":"locus-housing-supply-balance-99ffb65c","name":"Locus Housing Supply Balance","description":"BLS QCEW employment change over Census BPS permitted units, the permits share of ACS housing stock, cited benchmarks, and published critiques, for an address, for agents. Returns the same records as locus_housing_supply_balance. Use this when your client can only call paid x402 routes. Use locus_housing_supply_balance instead when you can call Locus free tools (REST tools/call or MCP).","url":"https://api.locus.report/api/locus-housing-supply-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","maxLength":200,"minLength":5},"latitude":{"type":"number","maximum":90,"minimum":-90},"longitude":{"type":"number","maximum":180,"minimum":-180},"permitYear":{"type":"integer","maximum":2100,"minimum":2000}}},"responseSchema":{"type":"json","example":{"ok":true,"geo":{"state":"NC","county":"Wake County","countyFips":"37183"},"kind":"housing_supply_balance","note":"Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.","point":{"latitude":35.78041800000319,"longitude":-78.63910200000142},"ratios":{"convention":"jobs in year N divided by housing units permitted in year N-1 (NAHB convention; the one-year lag reflects the time permitted units take to move through construction)","jobsPerTotalUnitPermitted":0.83,"jobsPerMultifamilyUnitPermitted":2.24},"status":"ok","caveats":["Reported inputs and a computed ratio only. Locus performs no comparison against any published benchmark and applies no label of its own."],"permits":{"year":2024,"present":true,"totalUnits":15248,"imputedShare":0.004,"multifamilyUnits":5628,"singleFamilyUnits":9620,"reportedTotalUnits":15180},"employment":{"year":2025,"basis":"place of work, UI-covered employment (BLS QCEW annual averages)","netChange":12622,"priorYear":2024,"annualAvgEmployment":665775,"priorAnnualAvgEmployment":653153},"provenance":{"permits":{"source":"U.S. Census Bureau, Building Permits Survey - annual county file (residential units authorized by building permit)","sourceUrl":"https://www.census.gov/construction/bps/","granularity":"county aggregate, calendar year"},"employment":{"source":"U.S. Bureau of Labor Statistics, Quarterly Census of Employment and Wages - annual averages, all ownerships, county total","sourceUrl":"https://www.bls.gov/cew/","granularity":"county, calendar-year annual average, place of work, UI-covered employment"},"housingStock":{"source":"U.S. Census Bureau, American Community Survey 5-year, table B25001 (total housing units)","vintage":"ACSDT5Y2023","sourceUrl":"https://data.census.gov/table/ACSDT5Y2023.B25001","granularity":"county, 5-year estimate"}},"verifyNext":[{"url":"https://www.census.gov/construction/bps/","step":"Read the county's full permit history in the Census Building Permits Survey."}],"supplyPipeline":{"note":"Permits authorized, not units delivered.","totalHousingUnits":481999,"unitsPermittedAsShareOfStockPct":3.163},"componentStatus":[{"status":"ok","component":"census_bps_county"}],"publishedCritiques":[{"url":"https://www.naahq.org/news-publications/units/october-2015-issue/article/job-growth-absorption-doesnt-add","source":"MPF Research / National Apartment Association, 2015, 'Job Growth-to-Absorption: Doesn't Add Up'","summary":"NAA / MPF Research measured this ratio family at -161 to +130 jobs per unit of demand across 50 apartment markets over 14 years and called its reliability 'surprisingly bad'."}],"publishedBenchmarks":[{"url":"https://eyeonhousing.org/2026/06/structural-demand-outpacing-supply-jobs-to-permits-ratios-highlight-housing-gap/","note":"NAHB describes this as a historical observation and does not source it further. NAHB computes at metro (MSA) level.","label":"NAHB stated balanced band, jobs per total housing unit permitted","value":"1.25 to 1.50","source":"NAHB Eye on Housing, June 2026"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nr7xhnR8JZ0tiNBKRr31M","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the jobs-to-housing-permits ratio for a county given an address, comparing BLS QCEW employment change against Census BPS permitted units relative to ACS housing stock.","exampleAgentPrompt":"For 123 Main St, Austin TX, pull the housing supply balance for 2023 — I want to know if that county is permitting enough housing units to keep up with its job growth, including the jobs-to-permits ratio and how that compares to established benchmarks.","exampleUseCases":[{"title":"County housing undersupply due diligence","prompt":"I'm evaluating a multifamily development in Denver, CO — can you check the 2022 jobs-to-housing-permits ratio for that county so I know whether there's a structural undersupply of housing relative to job growth?"},{"title":"Policy researcher housing gap analysis","prompt":"For my housing policy report, I need the jobs-to-permits ratio for the county containing 450 Serra Mall, Stanford CA for permit year 2021, along with the benchmarks and any published critiques of that metric."},{"title":"Real estate investor market signal check","prompt":"Before I make an offer on a property at 800 N Michigan Ave, Chicago IL, can you tell me whether Cook County permitted enough housing relative to its job growth in 2023 — give me the ratio and the share of existing housing stock those permits represent?"}],"resultDescription":"Returns the ratio of BLS QCEW employment change to Census BPS permitted housing units for the county containing the input address, the permits as a share of ACS total housing stock, cited benchmarks for interpreting the ratio, published critiques of the metric, and a no-charge response when the ratio cannot be computed.","failureModes":["Address cannot be geocoded to a county — returns no ratio (charge-free)","Permit year data not yet available from Census BPS — returns no ratio (charge-free)","BLS QCEW employment data unavailable for the county — ratio uncomputable, charge-free","Address outside the United States — unsupported geography","Malformed address string or missing coordinates — validation error"],"whenToPreferThis":"Use this endpoint when you need a data-backed, sourced signal on whether a county is permitting sufficient housing relative to job growth — particularly for real estate due diligence, housing policy analysis, or investment screening. It is specifically suited for US county-level analysis tied to a street address and a specific permit year, and it uniquely combines BLS employment data with Census permit and ACS stock data in a single cited response. Prefer it over generic housing or employment data endpoints when the specific jobs-to-permits framing and benchmark context are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:43:10.225Z","isFirstParty":false,"canonicalSlug":"locus-housing-supply-balance-99ffb65c"}