{"uid":"cap_a5NAJSDm2QvdBAnI1jPDO","slug":"us-real-estate-market-profile-api-85c156c1","name":"US Real Estate Market Profile API","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://api.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_JMiwmWVWxIN8rg6jcekiD","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 real-estate market profile for a US geography, fusing FHFA HPI momentum, Census ACS demographics, housing/income/tenure/vacancy data, and Fair Market Rents into a single cited JSON with computed metrics like gross rental yield and affordability index.","exampleAgentPrompt":"Can you pull the full housing market profile for the Austin-Round Rock metro area — I want to see the HPI trend over the last 20 quarters, Fair Market Rents, gross rental yield, and affordability score, with CBSA as the geography type?","exampleUseCases":null,"resultDescription":"A cited JSON object containing FHFA House Price Index momentum and historical observations, Census ACS demographics (population, income, tenure, vacancy), HUD Fair Market Rents, and computed derivatives including gross rental yield and an affordability metric, along with an aggregate market tier classification. All figures are market-level aggregates, not per-address valuations.","failureModes":["Invalid or unrecognized geo value — returns error if the geography string cannot be resolved to a known state, CBSA, county, ZIP, or address","Ambiguous 5-digit code — without specifying type=cbsa or type=county, a 5-digit number defaults to ZIP which may not be intended","Range out of bounds — range must be between 1 and 40; values outside this return a validation error","Payment failure — x402 micropayment of $0.03 USDC not completed, returns 402 Payment Required","Data unavailability — some geographies (e.g. very small counties) may have incomplete ACS or FHFA coverage"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, multi-source real estate market summary for a US geography at the state, metro, county, or ZIP level — especially when you want HPI trends, rental yield, affordability, and demographic context in a single call with cited sources. Prefer this over individual Census or FHFA API calls when you need derived metrics like gross rental yield already computed. Not suitable for per-address or per-property valuations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:03:21.464Z","isFirstParty":false}