{"uid":"cap_uTChcISeHqRg4zbbWHG3w","slug":"us-real-estate-market-profile-67c063e5","name":"US Real Estate Market Profile","description":"A composite US real-estate market profile for one geography. Fuses the FHFA House Price Index momentum, Census ACS demographics, housing, income, tenure and vacancy, national housing context, and Fair Market Rents into one cited JSON with computed derivatives such as gross rental yield and affordability. Aggregate market tier, not a per address valuation.","url":"https://payai.agentstools.dev/realestate/market","method":"GET","headers":{},"bodySchema":{"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"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["geo"],"properties":{"geo":{"type":"string","description":"A state (2-letter code or name), metro CBSA code, county FIPS, ZIP, or an address"},"type":{"enum":["auto","state","county","cbsa","zip","address"],"type":"string","description":"How to read geo. In auto a 5-digit number is a ZIP; use cbsa or county to disambiguate"},"range":{"type":"integer","maximum":40,"minimum":1,"description":"Most recent N House Price Index observations of history"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mI4FpfAiDT1t_ydNSEk54","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a composite US real-estate market profile for a given geography, fusing FHFA House Price Index momentum, Census ACS demographics, Fair Market Rents, and computed derivatives like gross rental yield and affordability.","exampleAgentPrompt":"Can you pull the full real estate market profile for the Denver metro area — I want HPI momentum, gross rental yield, Fair Market Rents, and affordability, based on the last 20 observations?","exampleUseCases":[{"title":"Rental yield analysis for investor","prompt":"What's the gross rental yield and Fair Market Rent situation for ZIP code 78701 in Austin? I'm considering buying a rental property there and want to understand the market economics."},{"title":"Relocation affordability check","prompt":"I'm thinking of moving to King County, Washington — can you pull the housing affordability profile there, including median income vs home prices, vacancy rates, and recent House Price Index trends?"},{"title":"Market tier comparison for lender","prompt":"Pull me the composite real estate market profile for the Chicago-Naperville CBSA, including HPI momentum over the last 12 observations, homeownership rates, and the overall market tier classification."}],"resultDescription":"A JSON object containing the geography's FHFA House Price Index time series and momentum metrics, Census ACS demographic and housing data (tenure, vacancy, median income), HUD Fair Market Rents, computed gross rental yield, affordability ratios, national housing context, and an aggregate market tier classification — all with citations.","failureModes":["Invalid or unrecognized geo value returns an error","Ambiguous 5-digit code (ZIP vs CBSA) without explicit type may resolve incorrectly — use 'type' param to disambiguate","Range exceeding 40 or below 1 is rejected by schema validation","Some rural or very small geographies may have limited Census ACS data coverage","Payment not settled results in HTTP 402 before data is returned"],"whenToPreferThis":"Choose this endpoint when you need a multi-source, computed real estate market summary for a US geography at the market/metro/county/ZIP tier — not per-address valuations. It is ideal when you want HPI momentum, rental yield, affordability, and demographics fused in one call rather than assembling from multiple data sources separately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:06:37.617Z","isFirstParty":false}