{ "x402Version": 2, "id": 37816, "slug": "37816", "resource": "https://agent-vending-production.up.railway.app/v1/market-size", "description": "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.", "type": "http", "serviceName": "Market Size", "resourceType": "Market Data", "accepts": [ { "scheme": "exact", "network": "eip155:8453", "payTo": "0x0b4242adf40726d9b09688030948176752d29924", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "10000", "amountUsd": 0.01, "maxTimeoutSeconds": 300 } ], "outputSchema": { "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" }, "extensions": { "bazaar": { "info": { "input": { "body": { "filters": [ { "operator": "==", "value": "renter", "variable": "tenure" } ], "geography": { "name": "Ventura County", "state": "CA", "type": "county" }, "unit": "household" }, "bodyType": "json", "method": "POST", "type": "http" }, "output": { "example": { "criteria": [ "tenure=renter" ], "data_vintage": "ACS 2019-2023 5-year (2023 release)", "estimate_type": "OFFICIAL_CENSUS_ESTIMATE", "estimated_market": { "count": 100000, "display": "~100,000 households", "raw": 99657 }, "geography": { "display_name": "Ventura County, California", "geoid": "06111", "type": "county" }, "source": { "label": "2023 ACS 5-year, table B25003", "table": "B25003", "universe": "Occupied housing units (households)" }, "status": "OK", "uncertainty": { "display": "97,600–101,700 households", "label": "90% margin of error (official Census)", "level": 0.9, "lower": 97600, "upper": 101700 }, "warnings": [] }, "type": "json" } }, "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" } } }, "tags": [ "market size", "market sizing", "TAM", "household market", "Census data", "bazaar" ], "sourceHost": "agent-vending-production.up.railway.app", "lastUpdated": "2026-10-03T19:17:32.287Z", "quality": { "calls30d": 5, "uniquePayers30d": 2, "lastCalledAt": "2026-10-03T19:17:32.055Z" }, "metadata": { "serviceName": "Market Size", "extensions": { "bazaar": { "info": { "input": { "body": { "filters": [ { "operator": "==", "value": "renter", "variable": "tenure" } ], "geography": { "name": "Ventura County", "state": "CA", "type": "county" }, "unit": "household" }, "bodyType": "json", "method": "POST", "type": "http" }, "output": { "example": { "criteria": [ "tenure=renter" ], "data_vintage": "ACS 2019-2023 5-year (2023 release)", "estimate_type": "OFFICIAL_CENSUS_ESTIMATE", "estimated_market": { "count": 100000, "display": "~100,000 households", "raw": 99657 }, "geography": { "display_name": "Ventura County, California", "geoid": "06111", "type": "county" }, "source": { "label": "2023 ACS 5-year, table B25003", "table": "B25003", "universe": "Occupied housing units (households)" }, "status": "OK", "uncertainty": { "display": "97,600–101,700 households", "label": "90% margin of error (official Census)", "level": 0.9, "lower": 97600, "upper": 101700 }, "warnings": [] }, "type": "json" } }, "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" } } } }, "liveness": { "reliability": null }, "verified": false, "featured": false, "provider": { "host": "agent-vending-production.up.railway.app", "manifest_name": "agent-vending-production.up.railway.app", "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": { "alternatives": [ "value" ], "charged": true, "criteria": [ "string" ], "data_vintage": "string", "estimate_type": "OFFICIAL_CENSUS_ESTIMATE", "estimated_market": {}, "geography": {}, "reason_code": "string", "sample_quality": {}, "source": {}, "status": "OK", "uncertainty": {}, "warnings": [ "value" ] }, "type": "string" } }