{"dfx": {"capability": "manifest", "version": "0.3.0", "answered_at": "2026-09-26T12:14:03.579664+00:00"}, "ok": true, "name": "DFX real estate intelligence", "summary": "Machine readable United States real estate intelligence. NATIONAL: federal programme debt with maturity dates across 52 states, LIHTC compliance period endings, HUD subsidy contract expiries, distress and foreclosure flags, and commercial tenancy: who occupies a building, how much of it, and when the lease expires. MASSACHUSETTS ONLY: parcels, ownership and management relationships, and recorded sales. Building permits and certificates of occupancy are Boston only. Call dfx_coverage for the measured grid of every event family and the states each one covers.", "version": "0.3.0", "capabilities": [{"name": "need", "input": {"objective": "natural language string", "constraints": "object?"}, "output": "whether DFX can help, which capability to call, and a free sample", "price_usd": 0.0, "note": "start here if you do not know what to ask for"}, {"name": "resolve", "input": {"kind": "address|organization", "value": "string", "city": "string?", "state": "string?"}, "output": "canonical DFX object ids with the match basis and ambiguity", "price_usd": 0.0, "note": "free, and intended to stay free"}, {"name": "verify", "input": {"dfx_id": "uuid"}, "output": "current state, dated events, relationships, provenance", "price_usd": 0.0}, {"name": "search", "input": {"event_type": "string?", "state": "string?", "within_days": "int?", "limit": "int?"}, "output": "dated events over properties, with provenance", "price_usd": 0.0}, {"name": "occupancy", "input": {"dfx_id": "uuid?", "company": "string?", "address": "string?", "city": "string?", "state": "string?", "limit": "int?"}, "output": "who occupies a property, or where a company is observed to operate, with the evidence tier and the freshness of each claim", "price_usd": 0.0, "note": "pass dfx_id for a property or a company; or pass company and address together to have one occupancy claim verified"}, {"name": "changes", "input": {"since": "opaque cursor?", "event_type": "string?", "state": "string?", "place_dfx_id": "uuid?", "limit": "int?"}, "output": "events DFX has LEARNED since your cursor, ordered by learn time rather than by when they occurred", "price_usd": 0.0, "note": "call with no cursor to establish a position; pass the returned `cursor` back as `since`. Pass place_dfx_id to watch one property or parcel."}, {"name": "have", "input": {"manifest": "object"}, "output": "acknowledgement and what DFX would need to know next", "note": "metadata only. No data payload is accepted at this version."}], "coverage": {"geography": "United States, unevenly. NATIONAL: federal programme debt and maturities, LIHTC, HUD subsidy, distress and commercial tenancy. MASSACHUSETTS ONLY: parcels and ownership. RECORDED SALES: Massachusetts statewide, plus New York City deeds at or above $10m. BOSTON ONLY: permits and certificates of occupancy. coverage_by_event_type below is the measured grid, per event family, per state.", "source_families": [{"family": "County and municipal records", "what": "The property layer: assessment, recorded instruments, permits, code enforcement and tax status.", "feeds": 9}, {"family": "Federal program and statistical data", "what": "Federal programme registers and statistical series: who is funded, insured, assisted or measured.", "feeds": 4}, {"family": "Federal regulator filings", "what": "What firms, funds and plans are required to tell a federal regulator, on the regulator's own schedule.", "feeds": 1}, {"family": "Securitised debt reporting", "what": "Loan-level and servicer reporting on debt that has been securitised, month by month.", "feeds": 1}, {"family": "Public records", "what": "Public records that do not sit in one of the families above.", "feeds": 1}], "served_source_count": 16, "source_policy": "Every fact DFX serves names its own source on the row it appears in, with the date it was effective and the date it was read. The list of feeds behind those rows is not published: which sources exist, which answer, and which are worth reading is the work. Coverage is published per event type and per state, which is what a caller needs to decide whether to spend a call.", "event_types": ["BANKRUPTCY_EVENT", "CERTIFICATE_OF_OCCUPANCY", "COMPLIANCE_PERIOD_ENDING", "DEMOLITION_FILED", "DISTRESS_FLAG_RAISED", "FORECLOSURE_EVENT", "FORECLOSURE_FILED", "LEASE_EXPIRING", "LOAN_MATURITY_SCHEDULED", "LOAN_MODIFIED", "PERMIT_ISSUED", "PERMIT_STATUS_CHANGED", "PORTFOLIO_CONTRACTED", "PORTFOLIO_EXPANDED", "PROPERTY_SOLD", "SUBSIDY_CONTRACT_EXPIRING", "TAX_LIEN_LISTED", "USE_CONVERSION_PERMITTED", "VACANT_FORECLOSURE_REGISTERED"], "coverage_by_event_type": {"available": true, "stale": false, "note": null, "refreshed_at": "2026-09-26T08:24:52.648787+00:00", "by_event_type": {"BANKRUPTCY_EVENT": {"states": ["AK", "NC", "NY", "WA"], "published_events": 4, "searchable_events": 4, "geography_unknown_events": 0, "state_count": 4}, "CERTIFICATE_OF_OCCUPANCY": {"states": ["MA", "NY"], "published_events": 3273, "searchable_events": 3141, "geography_unknown_events": 0, "state_count": 2}, "COMPLIANCE_PERIOD_ENDING": {"states": ["AK", "AL", "AR", "AS", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "GU", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MP", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VI", "VT", "WA", "WI", "WV", "WY"], "published_events": 11956, "searchable_events": 11956, "geography_unknown_events": 0, "state_count": 56}, "DEMOLITION_FILED": {"states": ["MA", "PA"], "published_events": 1347, "searchable_events": 1076, "geography_unknown_events": 0, "state_count": 2}, "DISTRESS_FLAG_RAISED": {"states": ["CA", "CO", "DC", "FL", "GA", "IL", "IN", "KY", "LA", "MA", "MD", "MI", "MN", "MO", "MS", "NC", "NH", "NJ", "NY", "OH", "OK", "OR", "PA", "TX", "VA", "WA"], "published_events": 1430, "searchable_events": 171, "geography_unknown_events": 0, "state_count": 26}, "FORECLOSURE_EVENT": {"states": ["CA", "CT", "FL", "GA", "IL", "IN", "KY", "LA", "MD", "MI", "MN", "MO", "MS", "NH", "NJ", "NY", "OH", "OK", "PA", "TX", "VA"], "published_events": 123, "searchable_events": 123, "geography_unknown_events": 0, "state_count": 21}, "FORECLOSURE_FILED": {"states": ["PA"], "published_events": 4054, "searchable_events": 721, "geography_unknown_events": 0, "state_count": 1}, "LEASE_EXPIRING": {"states": ["AK", "AL", "AR", "AS", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "GU", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MP", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VI", "VT", "WA", "WI", "WV", "WY"], "published_events": 4153, "searchable_events": 4153, "geography_unknown_events": 0, "state_count": 56}, "LOAN_MATURITY_SCHEDULED": {"states": ["AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NA", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY"], "published_events": 3281, "searchable_events": 3276, "geography_unknown_events": 0, "state_count": 52}, "LOAN_MODIFIED": {"states": ["CA", "DE", "IL", "NY", "WA"], "published_events": 12, "searchable_events": 11, "geography_unknown_events": 0, "state_count": 5}, "PERMIT_ISSUED": {"states": ["IL", "MA", "PA"], "published_events": 13847, "searchable_events": 5191, "geography_unknown_events": 0, "state_count": 3}, "PERMIT_STATUS_CHANGED": {"states": [], "published_events": 13, "searchable_events": 0, "geography_unknown_events": 0, "state_count": 0}, "PORTFOLIO_CONTRACTED": {"states": ["AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "GU", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VI", "VT", "WA", "WI", "WV", "WY"], "published_events": 3181, "searchable_events": 3181, "geography_unknown_events": 0, "state_count": 54}, "PORTFOLIO_EXPANDED": {"states": ["AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "FM", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY"], "published_events": 3528, "searchable_events": 3528, "geography_unknown_events": 0, "state_count": 53}, "PROPERTY_SOLD": {"states": ["DC", "MA", "NY"], "published_events": 47479, "searchable_events": 46836, "geography_unknown_events": 0, "state_count": 3}, "SUBSIDY_CONTRACT_EXPIRING": {"states": ["AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "GU", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VI", "VT", "WA", "WI", "WV", "WY"], "published_events": 4721, "searchable_events": 4721, "geography_unknown_events": 1, "state_count": 54}, "TAX_LIEN_LISTED": {"states": ["NY"], "published_events": 29368, "searchable_events": 1, "geography_unknown_events": 0, "state_count": 1}, "USE_CONVERSION_PERMITTED": {"states": ["MA"], "published_events": 923, "searchable_events": 832, "geography_unknown_events": 0, "state_count": 1}, "VACANT_FORECLOSURE_REGISTERED": {"states": [], "published_events": 711, "searchable_events": 0, "geography_unknown_events": 0, "state_count": 0}}, "reading": "`states` is every state code under which DFX publishes a searchable event of this type; a state absent from it is a measured coverage boundary and search will refuse it as NOT_COVERED rather than scanning. `published_events` is what DFX holds and is the number the tool descriptions quote; `searchable_events` is the subset carrying a resolved place, which is what search and changes can hand back. `geography_unknown_events` carry a place but no state code and are evidence neither way about any geography."}, "object_types": {"property": "National. Federal programme multifamily: HUD, LIHTC and FHA.", "parcel": "Massachusetts. The municipal assessor and registry layer, carrying assessed value, land use and recorded sales.", "organization": "Owners, managers, lenders and servicers."}, "recorded_sales": {"states": ["DC", "MA", "NY"], "by_source": {"statewide assessor roster": {"geography": "Massachusetts, statewide", "grain": "assessor roster: one sale date and price per parcel", "has_buyer": true, "has_seller": false, "repeat_sales": false, "note": "An assessor roster carries the LAST sale, so repeat-sale pairs and hold periods are not derivable from it at any volume. A deed repeats its full consideration on every parcel it covers, so allocated_consideration is carried separately from consideration and allocation_basis says when a split is ours."}, "municipal recorder extract": {"geography": "New York City, five boroughs", "grain": "recorded instrument, grouped into economic transactions", "has_buyer": true, "has_seller": true, "repeat_sales": true, "scope": "deeds at or above $10,000,000 consideration. This is a deliberate cut by VALUE and not by date: a date cut would orphan the earlier leg of a repeat-sale pair. A smaller New York sale is outside the tranche, not absent from the city.", "note": "Fourteen same-day deeds between the same parties are ONE transaction with fourteen instrument ids preserved, and a 318-property deed is one transaction linked to 318 properties. Consideration is stated once per instrument and is never split across its properties. No natural person is named in an event headline, on either side."}}}, "known_gaps": ["Loan maturity coverage is federal programme lending only (FHA insured and agency backed). The Registries of Deeds are closed to automation, so conventionally financed property carries no debt record here. A property absent from a maturity search is NOT a property without debt.", "LIHTC compliance periods are statutory and every one falls on 31 December, so a count bucketed by day shows a December cliff that is an artefact of the statute rather than a market event.", "Permit and demolition coverage is the City of Boston only.", "No outcome has ever been observed for any prediction in this graph. Nothing served here carries a calibrated probability; every score is a ranked signal.", "One street address can carry several records. Measured across 6,114 such clusters: 2,764 agree on unit count and are plausibly one asset registered by more than one programme, while 3,350 report DIFFERENT unit counts and are probably genuinely different buildings at one address, such as a scattered-site development. DFX has merged none of them and resolve() says which case you are looking at rather than choosing.", "Property and parcel are separate populations that barely overlap: 661 clean one-to-one pairs out of roughly 100,000 each. An address may resolve to one, the other, or both, and they are returned as distinct typed objects rather than merged.", "PROPERTY RECORDS ARE NOT ONE ROW PER BUILDING. 101,991 published property records cover 94,859 distinct normalised addresses, so a total computed across them overstates by roughly 8%. 245 Park Avenue is one tower and thirteen records, because thirteen securitisation trusts each report it. Every row is individually true, which is why the distortion is invisible per row. Each record carries address_group_size so you can see it: 1 is unique, and above 1 you should deduplicate by address before summing anything. DFX has not merged them because thousands of these clusters carry different unit counts and are genuinely different buildings at one address rather than one building recorded twice.", "The sale tape is two sources with different grain, and the difference decides which questions it can answer. MASSACHUSETTS is an assessor roster: statewide, one sale per parcel, buyer named and SELLER NEVER NAMED, so repeat-sale pairs and hold periods are not derivable from it at any volume and no further ingestion of it will change that. NEW YORK is a recorder extract: five boroughs, both parties named, every instrument dated, so repeat sales and hold periods ARE derivable, but only for deeds at or above $10,000,000. Neither one is a national sale tape and DFX does not have one."]}, "rights": {"publishable_source_count": 16, "source_families": [{"family": "County and municipal records", "what": "The property layer: assessment, recorded instruments, permits, code enforcement and tax status.", "feeds": 9}, {"family": "Federal program and statistical data", "what": "Federal programme registers and statistical series: who is funded, insured, assisted or measured.", "feeds": 4}, {"family": "Federal regulator filings", "what": "What firms, funds and plans are required to tell a federal regulator, on the regulator's own schedule.", "feeds": 1}, {"family": "Securitised debt reporting", "what": "Loan-level and servicer reporting on debt that has been securitised, month by month.", "feeds": 1}, {"family": "Public records", "what": "Public records that do not sit in one of the families above.", "feeds": 1}], "policy": "A source whose redistribution terms have not been reviewed and recorded is treated as not permitted and is never served. The filter is enforced in the database view, not in application code."}, "identity": {"declare": "send X-Agent-Name, and X-Agent-Principal if you have one", "note": "no registration, no key, no signup required to call anything"}, "machine_access": {"mcp_endpoint": "https://exchange-production-9123.up.railway.app/mcp", "transport": "streamable-http", "auth": "none. Connect and call.", "tools": 95, "free_tools": 95, "start_with": "what_can_dfx_answer: give it your objective in plain language and it returns whether DFX can help, which tool to call, the exact arguments, and a real free sample.", "loan_tape": {"tool": "debt_maturity_schedule", "price_usd": 0.0, "returns": "commercial real estate loans with a CONFIRMED maturity date inside your window, with the scheduled balance, the property, the lender and the provenance of each row, up to 200 loans per call"}, "not_covered": "bank balance-sheet and conventionally financed debt, county-registry-only mortgages, and residential parcel or sale data outside Massachusetts. See coverage.known_gaps."}, "state": "OK"}