Market Size
Estimate the size of a U.S. household market using Census data, e.g. renter households in a county or high-income families with children in a state. Returns the strongest defensible result available: an official Census estimate or a direct ACS PUMS survey estimate with a 90% margin of error. Custom criteria combinations work for states, PUMAs and counties made of whole PUMAs. Unsupported requests are refused and not charged. Not endorsed by the U.S. Census Bureau.
Offering
- Provider
- agent-vending-production.up.railway.app
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Business And Commerce
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://agent-vending-production.up.railway.app/v1/market-size- MIME type
- Not provided
- First seen
- 2026-10-16T01:51:02.144Z
- Last seen
- Tags
- market size, market sizing, TAM, household market, Census data
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"payTo": "0x0b4242adf40726d9b09688030948176752d29924"
}
]Observed health
- Status
- Reachable
- Latest latency
- 104 ms
- Average latency
- 427 ms
- HTTP status
- 405
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"body": {
"filters": [
{
"operator": "==",
"value": "renter",
"variable": "tenure"
}
],
"geography": {
"name": "Ventura County",
"state": "CA",
"type": "county"
},
"unit": "household"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"examples": [
{
"filters": [
{
"operator": "==",
"value": "renter",
"variable": "tenure"
}
],
"geography": {
"name": "Ventura County",
"state": "CA",
"type": "county"
},
"unit": "household"
},
{
"filters": [
{
"operator": ">=",
"value": 150000,
"variable": "household_income"
},
{
"operator": "==",
"value": true,
"variable": "children_present"
},
{
"operator": ">=",
"value": 3,
"variable": "household_size"
}
],
"geography": {
"state": "TX",
"type": "state"
},
"unit": "household"
},
{
"filters": [
{
"operator": ">=",
"value": 100000,
"variable": "household_income"
},
{
"operator": "==",
"value": "renter",
"variable": "tenure"
}
],
"geography": {
"puma": "03703",
"state": "CA",
"type": "puma"
},
"unit": "household"
},
{
"filters": [
{
"operator": ">=",
"value": 150000,
"variable": "household_income"
},
{
"operator": "==",
"value": "owner",
"variable": "tenure"
},
{
"operator": "between",
"value": [
35,
54
],
"variable": "householder_age"
},
{
"operator": "==",
"value": true,
"variable": "children_present"
}
],
"geography": {
"name": "Ventura County",
"state": "CA",
"type": "county"
},
"unit": "household"
}
],
"properties": {
"filters": {
"description": "All filters are combined with AND. Dollar amounts are 2023 dollars.",
"items": {
"properties": {
"operator": {
"enum": [
">=",
">",
"<",
"<=",
"==",
"between",
"in"
],
"type": "string"
},
"value": {
"description": "number; [low, high] for between; owner|renter for tenure; true/false for children_present; married_couple|other_family|nonfamily for family_status"
},
"variable": {
"enum": [
"household_income",
"tenure",
"householder_age",
"children_present",
"household_size",
"family_status",
"gross_rent",
"monthly_owner_costs",
"monthly_housing_cost",
"home_value"
],
"type": "string"
}
},
"required": [
"variable",
"operator",
"value"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"geography": {
"additionalProperties": true,
"description": "Where to size the market. Custom criteria combinations: state, puma, or a county made of whole PUMAs. us, place, tract, zcta and county_set are answered only when a published Census table covers the criteria (e.g. renter households); otherwise the request is refused, no charge.",
"properties": {
"counties": {
"description": "county_set: 2-50 counties",
"items": {
"type": "object"
},
"type": "array"
},
"county_fips": {
"description": "3-digit county FIPS (alternative to name)",
"type": "string"
},
"name": {
"description": "County name, e.g. \"Ventura County\"",
"type": "string"
},
"place_fips": {
"type": "string"
},
"puma": {
"description": "5-digit 2020 PUMA code",
"type": "string"
},
"state": {
"description": "State name, postal code or FIPS (not needed for us/zcta)",
"type": "string"
},
"tract": {
"type": "string"
},
"type": {
"enum": [
"state",
"county",
"puma",
"us",
"place",
"tract",
"zcta",
"county_set"
],
"type": "string"
},
"zcta": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"unit": {
"description": "Household markets only",
"enum": [
"household"
],
"type": "string"
}
},
"required": [
"geography",
"filters"
],
"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": {
"description": "HTTP 200 = result (charged). Refusals are never charged: 422 NOT_SUPPORTED (geography/criteria not supported, or survey quality gates failed), 400 INVALID_QUERY, 503 DATA_UNAVAILABLE, 502 UPSTREAM_ERROR; refusals include reason_code, reason, alternatives and charged=false.",
"properties": {
"alternatives": {
"type": "array"
},
"charged": {
"type": "boolean"
},
"criteria": {
"items": {
"type": "string"
},
"type": "array"
},
"data_vintage": {
"type": "string"
},
"estimate_type": {
"enum": [
"OFFICIAL_CENSUS_ESTIMATE",
"OFFICIAL_AGGREGATED",
"DIRECT_PUMS_DESIGN_BASED_ESTIMATE"
],
"type": "string"
},
"estimated_market": {
"type": "object"
},
"geography": {
"type": "object"
},
"reason_code": {
"type": "string"
},
"sample_quality": {
"type": "object"
},
"source": {
"type": "object"
},
"status": {
"enum": [
"OK",
"NOT_SUPPORTED",
"INVALID_QUERY",
"DATA_UNAVAILABLE",
"UPSTREAM_ERROR"
],
"type": "string"
},
"uncertainty": {
"type": "object"
},
"warnings": {
"type": "array"
}
},
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}