{"uid":"cap_Nc2pBQDNrby-g2zzNmlRP","slug":"x402-factory-building-permits-economic-data-3ac9324a","name":"x402-factory Building Permits Economic Data","description":"Building permits (Census, monthly): latest print, revisions, surprise — Latest Building permits print from the Census via FRED/ALFRED: first-release vs latest value with a revised flag (revisions never pose as print-day numbers), surprise vs a labeled expectation (market-implied when a matching prediction market exists, else trend-model), next monthly release date, and a 12-observation…","url":"https://x402-factory.com/v1/econ/building-permits?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"title":"Building Permits (SAAR)","units":"Thousands of Units","recent":[{"value":1400,"obs_date":"2025-07-01"},{"value":1347,"obs_date":"2025-08-01"},{"value":1444,"obs_date":"2025-09-01"},{"value":1418,"obs_date":"2025-10-01"},{"value":1414,"obs_date":"2025-11-01"},{"value":1482,"obs_date":"2025-12-01"},{"value":1393,"obs_date":"2026-01-01"},{"value":1540,"obs_date":"2026-02-01"},{"value":1363,"obs_date":"2026-03-01"},{"value":1423,"obs_date":"2026-04-01"},{"value":1410,"obs_date":"2026-05-01"},{"value":1374,"obs_date":"2026-06-01"}],"series":"building-permits","fred_id":"PERMIT","surprise":{"actual":1367,"expected":1398.7,"surprise":-31.7,"expectation_detail":"trend-model: mean of prior 3 levels","expectation_source":"trend-model"},"frequency":"Monthly","revisions":[{"obs_date":"2026-06-01","first_value":1367,"latest_value":1374},{"obs_date":"2026-05-01","first_value":1413,"latest_value":1410},{"obs_date":"2026-04-01","first_value":1442,"latest_value":1423}],"latest_print":{"revised":true,"headline":1367,"obs_date":"2026-06-01","latest_value":1374,"headline_basis":"first release level","headline_units":"thousands","first_released_on":"2026-07-17","first_release_value":1367},"release_name":"New Residential Construction","source_agency":"U.S. Census Bureau","next_release_date":"2026-08-18"},"meta":{"docs":"https://x402-factory.com/docs/econ.series.building-permits","sources":["fred"],"version":"1.0.0","endpoint":"/v1/econ/building-permits","data_mode":"live","freshness":"daily","request_id":"req_00000000","generated_at":"2026-08-21T03:58:57.913Z"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M-9521o10btH95SpA-CWc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest US Census building permits print via FRED/ALFRED, including first-release vs revised values, economic surprise vs expectation, next release date, and a 12-observation mini-series.","exampleAgentPrompt":"What's the latest US building permits print — did it surprise versus expectations, has it been revised from the first release, and when is the next one due?","exampleUseCases":[{"title":"Macro dashboard morning briefing","prompt":"Pull the latest building permits data for me — I want to know the headline number, whether it beat or missed expectations, and if there were any revisions since the first release."},{"title":"Housing market surprise alert","prompt":"Was there a surprise in the most recent building permits release? Tell me the actual vs expected and the source of the expectation — market-implied or trend model."},{"title":"Economic release calendar tracking","prompt":"When is the next building permits data release from the Census, and what does the recent 12-month trend look like?"}],"resultDescription":"A JSON object with the series ID and title, latest print (obs_date, headline value, units, basis, first-release value, latest revised value, revised flag), surprise object (actual, expected, surprise delta, expectation source — market-implied or trend-model — and optional prediction market details), next release date, a 12-observation recent mini-series array, and a revisions array showing first vs latest values per observation date.","failureModes":["FRED/ALFRED upstream outage — endpoint may return 503 or stale data","No surprise value if the release date hasn't occurred yet — surprise field returns null","Missing prediction market — expectation_source falls back to trend-model","Payment not completed via x402 protocol — returns 402 Payment Required","Rate limit or quota exceeded — returns 429"],"whenToPreferThis":"Choose this endpoint when you need a self-contained, structured view of the US building permits economic release — combining the first-print vs revised value distinction, an economic surprise calculation, and the next release date in a single call. Prefer it over raw FRED API when you also want surprise analytics and revision tracking without building that logic yourself. It is particularly useful for macro dashboards, economic calendars, or agents reacting to housing-sector data releases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:42:05.214Z","isFirstParty":false,"canonicalSlug":"x402-factory-building-permits-economic-data-3ac9324a"}