{
  "x402Version": 2,
  "id": 51410,
  "slug": "51410",
  "resource": "https://api.locus.report/api/locus-housing-stock",
  "description": "Census ACS tract-level housing-stock characteristics near a point: units, age, tenure, and vacancy for agents researching an area. Returns the same records as locus_housing_stock. Use this when your client can only call paid x402 routes. Use locus_housing_stock instead when you can call Locus free tools (REST tools/call or MCP).",
  "type": "http",
  "resourceType": "MCP Tool",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 60
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "FBVHMG5PTNW6sNd7uhZBsxhWkwJYRpgk34QcTgDpQdwV",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 60
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "address": "1 E Edenton St, Raleigh, NC 27601"
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "example": {
            "caveats": [
              "Tract-level ACS estimates carry margins of error; small tracts are noisy."
            ],
            "changes": {
              "bpsMultifamilyPermits": {
                "countyFips": "37183",
                "note": "Recent multifamily (5+ unit) permits authorized from Census BPS via HUD ArcGIS layer. Source for new permitted rental...",
                "permits": [],
                "provenance": {
                  "source": "U.S. Census Bureau Building Permits Survey (BPS) via HUD Residential Construction Permits by County",
                  "url": "https://services.arcgis.com/VTyQ9soqVukalItT/arcgis/rest/services/Residential_Construction_Permits_by_County/FeatureS..."
                }
              },
              "housingUnitNetChanges": {
                "countyFips": "37183",
                "exampleBulkFile": "https://www2.census.gov/geo/pvs/addcountlisting/2025/01_Alabama_AddressBlockCountList_112025.txt",
                "note": "Net housing unit changes (additions including multifamily, losses) from U.S. Census Bureau Address Count Listing File...",
                "provenance": {
                  "source": "U.S. Census Bureau Address Count Listing Files (Master Address File)",
                  "url": "https://www.census.gov/geographies/reference-files/time-series/geo/addcountlisting.html"
                }
              },
              "lihtcNearby": {
                "nearby": [
                  {
                    "CURCNTY": "183",
                    "HUD_ID": "NCA1990265",
                    "LI_UNITS": 6,
                    "N_UNITS": 6,
                    "PROJECT": "JEDAHOLU",
                    "PROJ_ADD": "627 DOROTHEA DR",
                    "PROJ_CTY": "RALEIGH",
                    "PROJ_ST": "NC",
                    "PROJ_ZIP": 27603,
                    "TYPE": 1,
                    "YR_ALLOC": 1989,
                    "YR_PIS": 1990
                  }
                ],
                "note": "LIHTC (Low-Income Housing Tax Credit) properties near the point from HUD data. Specific examples of subsidized multif...",
                "provenance": {
                  "source": "U.S. Department of Housing and Urban Development LIHTC Properties",
                  "url": "https://egis.hud.gov/arcgis/rest/services/affht/AffhtMapService/MapServer/30"
                }
              }
            },
            "county": {
              "countyFips3": "183",
              "name": "Wake County",
              "stateFips": "37"
            },
            "facts": [
              {
                "label": "housing stock (single keyed query)",
                "table": "B25001+B25002+B25003+B25064+B25077+B25035",
                "values": {
                  "B25001_001E": "3842",
                  "B25002_002E": "3018",
                  "B25002_003E": "824",
                  "B25003_001E": "3018",
                  "B25003_002E": "510",
                  "B25003_003E": "2508",
                  "B25024_002E": "112",
                  "B25024_003E": "179",
                  "B25024_004E": "65",
                  "B25024_005E": "111",
                  "B25024_006E": "40",
                  "B25024_007E": "64",
                  "B25024_008E": "241",
                  "B25024_009E": "2966",
                  "B25024_010E": "0",
                  "B25024_011E": "64",
                  "B25032_001E": "3018",
                  "B25032_007E": "40",
                  "B25032_008E": "36",
                  "B25032_009E": "71",
                  "B25032_010E": "179",
                  "B25035_001E": "2013",
                  "B25036_001E": "3018",
                  "B25036_002E": "510",
                  "B25036_003E": "43",
                  "B25036_004E": "116",
                  "B25036_005E": "167",
                  "B25036_006E": "8",
                  "B25036_007E": "18",
                  "B25064_001E": "1884",
                  "B25077_001E": "599000"
                }
              }
            ],
            "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report...",
            "ok": true,
            "point": {
              "latitude": 35.780418000003195,
              "longitude": -78.63910200000142
            },
            "provenance": {
              "api": "api.census.gov (keyed)",
              "coverage": "national, census-tract level (ACS); county (BPS/Address Counts); point (LIHTC)",
              "geocoder": "https://geocoding.geo.census.gov/geocoder/geographies/coordinates",
              "source": "U.S. Census Bureau, American Community Survey 5-year (housing-stock tables) + BPS (via HUD) + Address Count Listing F...",
              "sourcePage": "https://www.census.gov/data/developers/data-sets/acs-5year.html",
              "vintage": "ACSDT5Y2023"
            },
            "tract": {
              "geoid": "37183050100",
              "name": "Census Tract 501"
            },
            "verifyNext": [
              {
                "step": "Explore the tract's full ACS tables at data.census.gov.",
                "url": "https://data.census.gov/profile?g=1400000US37183050100"
              }
            ]
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "body": {
                "additionalProperties": false,
                "properties": {
                  "address": {
                    "maxLength": 200,
                    "minLength": 5,
                    "type": "string"
                  },
                  "latitude": {
                    "maximum": 90,
                    "minimum": -90,
                    "type": "number"
                  },
                  "longitude": {
                    "maximum": 180,
                    "minimum": -180,
                    "type": "number"
                  }
                },
                "type": "object"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              },
              "method": {
                "enum": [
                  "POST",
                  "PUT",
                  "PATCH"
                ],
                "type": "string"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    },
    "builder-code": {
      "info": {
        "a": "bc_vz5zyuko"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "a": {
            "description": "App builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "s": {
            "description": "Service builder codes",
            "items": {
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "maxItems": 11,
            "type": "array"
          },
          "w": {
            "description": "Wallet builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "locus.freePreflight": {
      "coverageBeforeCharge": true,
      "laneTool": "locus_lane_availability",
      "mcpUrl": "https://mcp.locus.report/mcp",
      "recommendedTool": "locus_coverage_check",
      "skillInstall": "npx @velinussage/locus-agent-skill add",
      "skillUrl": "https://api.locus.report/.well-known/skill.md",
      "toolsCallUrl": "https://api.locus.report/tools/call",
      "toolsListUrl": "https://api.locus.report/tools/list",
      "unsupportedReturnsFreeDiagnostic": true,
      "version": 2
    },
    "offer-receipt": {
      "info": {
        "offers": [
          {
            "acceptIndex": 0,
            "format": "eip712",
            "payload": {
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "network": "eip155:8453",
              "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
              "resourceUrl": "https://api.locus.report/api/locus-housing-stock",
              "scheme": "exact",
              "validUntil": 1791219692,
              "version": 1
            },
            "signature": "0x3f1e797eca1f6bfd8dd531cce2f69b25db1c47ba1585c4127d2390bd72d47a8b7125cdb3d982c4e1fd1c7576e947fd5bb657662d32e473847014b4dd103cb1ac1b"
          }
        ]
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "offers": {
            "items": {
              "properties": {
                "acceptIndex": {
                  "type": "integer"
                },
                "format": {
                  "type": "string"
                },
                "payload": {
                  "properties": {
                    "amount": {
                      "type": "string"
                    },
                    "asset": {
                      "type": "string"
                    },
                    "network": {
                      "type": "string"
                    },
                    "payTo": {
                      "type": "string"
                    },
                    "resourceUrl": {
                      "type": "string"
                    },
                    "scheme": {
                      "type": "string"
                    },
                    "validUntil": {
                      "type": "integer"
                    },
                    "version": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "version",
                    "resourceUrl",
                    "scheme",
                    "network",
                    "asset",
                    "payTo",
                    "amount"
                  ],
                  "type": "object"
                },
                "signature": {
                  "type": "string"
                }
              },
              "required": [
                "format",
                "signature"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "offers"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar",
    "builder-code",
    "locus.freePreflight",
    "offer-receipt"
  ],
  "sourceHost": "api.locus.report",
  "lastUpdated": "2026-10-05T17:00:32.286Z",
  "quality": {
    "calls30d": 3,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-10-05T17:00:29.95Z"
  },
  "metadata": {
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "body": {
              "address": "1 E Edenton St, Raleigh, NC 27601"
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "example": {
              "caveats": [
                "Tract-level ACS estimates carry margins of error; small tracts are noisy."
              ],
              "changes": {
                "bpsMultifamilyPermits": {
                  "countyFips": "37183",
                  "note": "Recent multifamily (5+ unit) permits authorized from Census BPS via HUD ArcGIS layer. Source for new permitted rental...",
                  "permits": [],
                  "provenance": {
                    "source": "U.S. Census Bureau Building Permits Survey (BPS) via HUD Residential Construction Permits by County",
                    "url": "https://services.arcgis.com/VTyQ9soqVukalItT/arcgis/rest/services/Residential_Construction_Permits_by_County/FeatureS..."
                  }
                },
                "housingUnitNetChanges": {
                  "countyFips": "37183",
                  "exampleBulkFile": "https://www2.census.gov/geo/pvs/addcountlisting/2025/01_Alabama_AddressBlockCountList_112025.txt",
                  "note": "Net housing unit changes (additions including multifamily, losses) from U.S. Census Bureau Address Count Listing File...",
                  "provenance": {
                    "source": "U.S. Census Bureau Address Count Listing Files (Master Address File)",
                    "url": "https://www.census.gov/geographies/reference-files/time-series/geo/addcountlisting.html"
                  }
                },
                "lihtcNearby": {
                  "nearby": [
                    {
                      "CURCNTY": "183",
                      "HUD_ID": "NCA1990265",
                      "LI_UNITS": 6,
                      "N_UNITS": 6,
                      "PROJECT": "JEDAHOLU",
                      "PROJ_ADD": "627 DOROTHEA DR",
                      "PROJ_CTY": "RALEIGH",
                      "PROJ_ST": "NC",
                      "PROJ_ZIP": 27603,
                      "TYPE": 1,
                      "YR_ALLOC": 1989,
                      "YR_PIS": 1990
                    }
                  ],
                  "note": "LIHTC (Low-Income Housing Tax Credit) properties near the point from HUD data. Specific examples of subsidized multif...",
                  "provenance": {
                    "source": "U.S. Department of Housing and Urban Development LIHTC Properties",
                    "url": "https://egis.hud.gov/arcgis/rest/services/affht/AffhtMapService/MapServer/30"
                  }
                }
              },
              "county": {
                "countyFips3": "183",
                "name": "Wake County",
                "stateFips": "37"
              },
              "facts": [
                {
                  "label": "housing stock (single keyed query)",
                  "table": "B25001+B25002+B25003+B25064+B25077+B25035",
                  "values": {
                    "B25001_001E": "3842",
                    "B25002_002E": "3018",
                    "B25002_003E": "824",
                    "B25003_001E": "3018",
                    "B25003_002E": "510",
                    "B25003_003E": "2508",
                    "B25024_002E": "112",
                    "B25024_003E": "179",
                    "B25024_004E": "65",
                    "B25024_005E": "111",
                    "B25024_006E": "40",
                    "B25024_007E": "64",
                    "B25024_008E": "241",
                    "B25024_009E": "2966",
                    "B25024_010E": "0",
                    "B25024_011E": "64",
                    "B25032_001E": "3018",
                    "B25032_007E": "40",
                    "B25032_008E": "36",
                    "B25032_009E": "71",
                    "B25032_010E": "179",
                    "B25035_001E": "2013",
                    "B25036_001E": "3018",
                    "B25036_002E": "510",
                    "B25036_003E": "43",
                    "B25036_004E": "116",
                    "B25036_005E": "167",
                    "B25036_006E": "8",
                    "B25036_007E": "18",
                    "B25064_001E": "1884",
                    "B25077_001E": "599000"
                  }
                }
              ],
              "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report...",
              "ok": true,
              "point": {
                "latitude": 35.780418000003195,
                "longitude": -78.63910200000142
              },
              "provenance": {
                "api": "api.census.gov (keyed)",
                "coverage": "national, census-tract level (ACS); county (BPS/Address Counts); point (LIHTC)",
                "geocoder": "https://geocoding.geo.census.gov/geocoder/geographies/coordinates",
                "source": "U.S. Census Bureau, American Community Survey 5-year (housing-stock tables) + BPS (via HUD) + Address Count Listing F...",
                "sourcePage": "https://www.census.gov/data/developers/data-sets/acs-5year.html",
                "vintage": "ACSDT5Y2023"
              },
              "tract": {
                "geoid": "37183050100",
                "name": "Census Tract 501"
              },
              "verifyNext": [
                {
                  "step": "Explore the tract's full ACS tables at data.census.gov.",
                  "url": "https://data.census.gov/profile?g=1400000US37183050100"
                }
              ]
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "body": {
                  "additionalProperties": false,
                  "properties": {
                    "address": {
                      "maxLength": 200,
                      "minLength": 5,
                      "type": "string"
                    },
                    "latitude": {
                      "maximum": 90,
                      "minimum": -90,
                      "type": "number"
                    },
                    "longitude": {
                      "maximum": 180,
                      "minimum": -180,
                      "type": "number"
                    }
                  },
                  "type": "object"
                },
                "bodyType": {
                  "enum": [
                    "json",
                    "form-data",
                    "text"
                  ],
                  "type": "string"
                },
                "method": {
                  "enum": [
                    "POST",
                    "PUT",
                    "PATCH"
                  ],
                  "type": "string"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method",
                "bodyType",
                "body"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      },
      "builder-code": {
        "info": {
          "a": "bc_vz5zyuko"
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "additionalProperties": false,
          "properties": {
            "a": {
              "description": "App builder code",
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "s": {
              "description": "Service builder codes",
              "items": {
                "pattern": "^[a-z0-9_]{1,32}$",
                "type": "string"
              },
              "maxItems": 11,
              "type": "array"
            },
            "w": {
              "description": "Wallet builder code",
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "locus.freePreflight": {
        "coverageBeforeCharge": true,
        "laneTool": "locus_lane_availability",
        "mcpUrl": "https://mcp.locus.report/mcp",
        "recommendedTool": "locus_coverage_check",
        "skillInstall": "npx @velinussage/locus-agent-skill add",
        "skillUrl": "https://api.locus.report/.well-known/skill.md",
        "toolsCallUrl": "https://api.locus.report/tools/call",
        "toolsListUrl": "https://api.locus.report/tools/list",
        "unsupportedReturnsFreeDiagnostic": true,
        "version": 2
      },
      "offer-receipt": {
        "info": {
          "offers": [
            {
              "acceptIndex": 0,
              "format": "eip712",
              "payload": {
                "amount": "10000",
                "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                "network": "eip155:8453",
                "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
                "resourceUrl": "https://api.locus.report/api/locus-housing-stock",
                "scheme": "exact",
                "validUntil": 1791219692,
                "version": 1
              },
              "signature": "0x3f1e797eca1f6bfd8dd531cce2f69b25db1c47ba1585c4127d2390bd72d47a8b7125cdb3d982c4e1fd1c7576e947fd5bb657662d32e473847014b4dd103cb1ac1b"
            }
          ]
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "offers": {
              "items": {
                "properties": {
                  "acceptIndex": {
                    "type": "integer"
                  },
                  "format": {
                    "type": "string"
                  },
                  "payload": {
                    "properties": {
                      "amount": {
                        "type": "string"
                      },
                      "asset": {
                        "type": "string"
                      },
                      "network": {
                        "type": "string"
                      },
                      "payTo": {
                        "type": "string"
                      },
                      "resourceUrl": {
                        "type": "string"
                      },
                      "scheme": {
                        "type": "string"
                      },
                      "validUntil": {
                        "type": "integer"
                      },
                      "version": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "version",
                      "resourceUrl",
                      "scheme",
                      "network",
                      "asset",
                      "payTo",
                      "amount"
                    ],
                    "type": "object"
                  },
                  "signature": {
                    "type": "string"
                  }
                },
                "required": [
                  "format",
                  "signature"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "offers"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.locus.report",
    "manifest_name": "api.locus.report",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}