AP
MCP Tool · x402 · early usage

BLS QCEW employment change over Census BPS permitted units, the permits share of ACS ho…

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…

by api.locus.report · discovered, not yet claimed by its owner · updated 2026-10-05

30d calls4
30d payers2
MethodPOST
Outputjson

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

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).

Tags: bazaar · builder-code · locus.freePreflight · offer-receipt

Call contract

Method
POST
Input
json
Output
json
Last paid call
2026-10-05
Input example from Bazaar metadata
{
  "address": "1 E Edenton St, Raleigh, NC 27601"
}
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/"
    }
  ]
}

Use with an agent

  1. Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
  2. Inspect. Fetch /resources/51391.json for the price and payment options.
  3. Pay. Call GET https://api.locus.report/api/locus-housing-supply-balance. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
  4. Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Solana, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price
$0.01 / request
Protocol
x402 v2
Auth
No account or API key. Pay per request.
Networks
Base, Solana
Demand
4 calls · 2 unique payers in 30d (public x402 Bazaar data)

x402 payment requirements

SchemeNetworkAssetAmountPay toTimeout
exactBase
eip155:8453
USDC$0.010xF121fbeceC43e1B616D47285851c20d5fC64431b60s
exactSolana
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
USDC$0.01FBVHMG5PTNW6sNd7uhZBsxhWkwJYRpgk34QcTgDpQdwV60s
accepts[] (raw JSON)
[
  {
    "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
  }
]

Schemas

Output schema (JSON Schema)
{
  "properties": {
    "example": {
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}
Example shape — generated from the schema, not a captured live response
{
  "example": {},
  "type": "string"
}

Examples

curl
curl "https://api.locus.report/api/locus-housing-supply-balance"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.locus.report/api/locus-housing-supply-balance");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}
Python
import httpx
res = httpx.get("https://api.locus.report/api/locus-housing-supply-balance")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider
api.locus.report
Endpoint
https://api.locus.report/api/locus-housing-supply-balance
Machine-readable
/resources/51391.json