{
  "x402Version": 2,
  "id": 51391,
  "slug": "51391",
  "resource": "https://api.locus.report/api/locus-housing-supply-balance",
  "description": "BLS QCEW employment change over Census BPS permitted units, the permits share of ACS housing stock, cited benchmarks, and published critiques, for an address, for agents. Returns the same records as locus_housing_supply_balance. Use this when your client can only call paid x402 routes. Use locus_housing_supply_balance 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": [
              "Reported inputs and a computed ratio only. Locus performs no comparison against any published benchmark and applies no label of its own."
            ],
            "componentStatus": [
              {
                "component": "census_bps_county",
                "status": "ok"
              }
            ],
            "employment": {
              "annualAvgEmployment": 665775,
              "basis": "place of work, UI-covered employment (BLS QCEW annual averages)",
              "netChange": 12622,
              "priorAnnualAvgEmployment": 653153,
              "priorYear": 2024,
              "year": 2025
            },
            "geo": {
              "county": "Wake County",
              "countyFips": "37183",
              "state": "NC"
            },
            "kind": "housing_supply_balance",
            "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.",
            "ok": true,
            "permits": {
              "imputedShare": 0.004,
              "multifamilyUnits": 5628,
              "present": true,
              "reportedTotalUnits": 15180,
              "singleFamilyUnits": 9620,
              "totalUnits": 15248,
              "year": 2024
            },
            "point": {
              "latitude": 35.780418000003195,
              "longitude": -78.63910200000142
            },
            "provenance": {
              "employment": {
                "granularity": "county, calendar-year annual average, place of work, UI-covered employment",
                "source": "U.S. Bureau of Labor Statistics, Quarterly Census of Employment and Wages - annual averages, all ownerships, county total",
                "sourceUrl": "https://www.bls.gov/cew/"
              },
              "housingStock": {
                "granularity": "county, 5-year estimate",
                "source": "U.S. Census Bureau, American Community Survey 5-year, table B25001 (total housing units)",
                "sourceUrl": "https://data.census.gov/table/ACSDT5Y2023.B25001",
                "vintage": "ACSDT5Y2023"
              },
              "permits": {
                "granularity": "county aggregate, calendar year",
                "source": "U.S. Census Bureau, Building Permits Survey - annual county file (residential units authorized by building permit)",
                "sourceUrl": "https://www.census.gov/construction/bps/"
              }
            },
            "publishedBenchmarks": [
              {
                "label": "NAHB stated balanced band, jobs per total housing unit permitted",
                "note": "NAHB describes this as a historical observation and does not source it further. NAHB computes at metro (MSA) level.",
                "source": "NAHB Eye on Housing, June 2026",
                "url": "https://eyeonhousing.org/2026/06/structural-demand-outpacing-supply-jobs-to-permits-ratios-highlight-housing-gap/",
                "value": "1.25 to 1.50"
              }
            ],
            "publishedCritiques": [
              {
                "source": "MPF Research / National Apartment Association, 2015, 'Job Growth-to-Absorption: Doesn't Add Up'",
                "summary": "NAA / MPF Research measured this ratio family at -161 to +130 jobs per unit of demand across 50 apartment markets over 14 years and called its reliability 'surprisingly bad'.",
                "url": "https://www.naahq.org/news-publications/units/october-2015-issue/article/job-growth-absorption-doesnt-add"
              }
            ],
            "ratios": {
              "convention": "jobs in year N divided by housing units permitted in year N-1 (NAHB convention; the one-year lag reflects the time permitted units take to move through construction)",
              "jobsPerMultifamilyUnitPermitted": 2.24,
              "jobsPerTotalUnitPermitted": 0.83
            },
            "status": "ok",
            "supplyPipeline": {
              "note": "Permits authorized, not units delivered.",
              "totalHousingUnits": 481999,
              "unitsPermittedAsShareOfStockPct": 3.163
            },
            "verifyNext": [
              {
                "step": "Read the county's full permit history in the Census Building Permits Survey.",
                "url": "https://www.census.gov/construction/bps/"
              }
            ]
          },
          "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"
                  },
                  "permitYear": {
                    "maximum": 2100,
                    "minimum": 2000,
                    "type": "integer"
                  }
                },
                "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-supply-balance",
              "scheme": "exact",
              "validUntil": 1791219701,
              "version": 1
            },
            "signature": "0xd282d6fe2117f6cc93bda272d01e0d3b0183adcc2864bd3b6dea8830ac90e78d5fbd5bb27865303b7b0461ba66582479fddfcc220fac24236d924783ff14e3521b"
          }
        ]
      },
      "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:41.581Z",
  "quality": {
    "calls30d": 4,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-05T17:00:40.454Z"
  },
  "metadata": {
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "body": {
              "address": "1 E Edenton St, Raleigh, NC 27601"
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "example": {
              "caveats": [
                "Reported inputs and a computed ratio only. Locus performs no comparison against any published benchmark and applies no label of its own."
              ],
              "componentStatus": [
                {
                  "component": "census_bps_county",
                  "status": "ok"
                }
              ],
              "employment": {
                "annualAvgEmployment": 665775,
                "basis": "place of work, UI-covered employment (BLS QCEW annual averages)",
                "netChange": 12622,
                "priorAnnualAvgEmployment": 653153,
                "priorYear": 2024,
                "year": 2025
              },
              "geo": {
                "county": "Wake County",
                "countyFips": "37183",
                "state": "NC"
              },
              "kind": "housing_supply_balance",
              "note": "Awareness/diagnostic only. Full briefs are x402-paid. Agents can discover live free tools at https://api.locus.report/tools/list and paid tools, prices, and manifests at https://api.locus.report/.well-known/ai-tool/index.json.",
              "ok": true,
              "permits": {
                "imputedShare": 0.004,
                "multifamilyUnits": 5628,
                "present": true,
                "reportedTotalUnits": 15180,
                "singleFamilyUnits": 9620,
                "totalUnits": 15248,
                "year": 2024
              },
              "point": {
                "latitude": 35.780418000003195,
                "longitude": -78.63910200000142
              },
              "provenance": {
                "employment": {
                  "granularity": "county, calendar-year annual average, place of work, UI-covered employment",
                  "source": "U.S. Bureau of Labor Statistics, Quarterly Census of Employment and Wages - annual averages, all ownerships, county total",
                  "sourceUrl": "https://www.bls.gov/cew/"
                },
                "housingStock": {
                  "granularity": "county, 5-year estimate",
                  "source": "U.S. Census Bureau, American Community Survey 5-year, table B25001 (total housing units)",
                  "sourceUrl": "https://data.census.gov/table/ACSDT5Y2023.B25001",
                  "vintage": "ACSDT5Y2023"
                },
                "permits": {
                  "granularity": "county aggregate, calendar year",
                  "source": "U.S. Census Bureau, Building Permits Survey - annual county file (residential units authorized by building permit)",
                  "sourceUrl": "https://www.census.gov/construction/bps/"
                }
              },
              "publishedBenchmarks": [
                {
                  "label": "NAHB stated balanced band, jobs per total housing unit permitted",
                  "note": "NAHB describes this as a historical observation and does not source it further. NAHB computes at metro (MSA) level.",
                  "source": "NAHB Eye on Housing, June 2026",
                  "url": "https://eyeonhousing.org/2026/06/structural-demand-outpacing-supply-jobs-to-permits-ratios-highlight-housing-gap/",
                  "value": "1.25 to 1.50"
                }
              ],
              "publishedCritiques": [
                {
                  "source": "MPF Research / National Apartment Association, 2015, 'Job Growth-to-Absorption: Doesn't Add Up'",
                  "summary": "NAA / MPF Research measured this ratio family at -161 to +130 jobs per unit of demand across 50 apartment markets over 14 years and called its reliability 'surprisingly bad'.",
                  "url": "https://www.naahq.org/news-publications/units/october-2015-issue/article/job-growth-absorption-doesnt-add"
                }
              ],
              "ratios": {
                "convention": "jobs in year N divided by housing units permitted in year N-1 (NAHB convention; the one-year lag reflects the time permitted units take to move through construction)",
                "jobsPerMultifamilyUnitPermitted": 2.24,
                "jobsPerTotalUnitPermitted": 0.83
              },
              "status": "ok",
              "supplyPipeline": {
                "note": "Permits authorized, not units delivered.",
                "totalHousingUnits": 481999,
                "unitsPermittedAsShareOfStockPct": 3.163
              },
              "verifyNext": [
                {
                  "step": "Read the county's full permit history in the Census Building Permits Survey.",
                  "url": "https://www.census.gov/construction/bps/"
                }
              ]
            },
            "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"
                    },
                    "permitYear": {
                      "maximum": 2100,
                      "minimum": 2000,
                      "type": "integer"
                    }
                  },
                  "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-supply-balance",
                "scheme": "exact",
                "validUntil": 1791219701,
                "version": 1
              },
              "signature": "0xd282d6fe2117f6cc93bda272d01e0d3b0183adcc2864bd3b6dea8830ac90e78d5fbd5bb27865303b7b0461ba66582479fddfcc220fac24236d924783ff14e3521b"
            }
          ]
        },
        "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"
  }
}