US State Fiscal Health Analyzer

Real-time aggregation of US state fiscal health data from 4 government sources with composite 0-100 fiscal health score.

Purpose

This Actor analyzes the fiscal health of any US state by combining data from:

• US Bureau of Labor Statistics (BLS) - State unemployment rates
• USAspending.gov - Federal spending by state
• The World Bank - US economic indicators (national-level GDP proxy)
• US CDC - State health metrics (graceful skip if unavailable)

Produces a single Fiscal Health Score (0-100) combining:

1. Unemployment Rate (30% weight)
2. Federal Spending Per Capita (40% weight)
3. GDP Per Capita (30% weight)

Input

Required

• state (string) — Two-letter US state code (e.g., CA for California, NY for New York)

Optional

• includeHistorical (boolean, default: true) — Return 3-year historical trend data
• verbose (boolean, default: false) — Include detailed API metadata and source info

Output

{
  "state": "CA",
  "stateName": "California",
  "fiscalHealthScore": 68.5,
  "indicators": {
    "unemployment": 4.2,
    "federalSpendingPerCapita": 8500.25,
    "gdpPerCapita": 72500.00
  },
  "dataAvailability": {
    "bls": true,
    "usaspending": true,
    "worldBank": true,
    "cdc": false
  },
  "historicalTrends": [...],
  "sources": [
    {
      "name": "US Bureau of Labor Statistics",
      "url": "https://www.bls.gov",
      "license": "Public Domain",
      "attribution": "Data source: US Bureau of Labor Statistics"
    },
    ...
  ],
  "disclaimer": "...",
  "timestamp": "2024-04-09T00:00:00Z"
}

Examples

Basic Usage

{
  "state": "CA"
}

With Historical Trends

{
  "state": "NY",
  "includeHistorical": true,
  "verbose": false
}

Verbose Output

{
  "state": "TX",
  "verbose": true
}

Data Coverage

All 50 US states supported. Data sources:

• BLS: Available for all states (unemployment rate)
• USAspending: Available for all states (federal spending)
• World Bank: US-level indicators only (proxy for all states)
• CDC: Available where data exists (graceful skip if unavailable)

Pricing

• $0.16 per state query (Pay-per-Event model)
• Billed only when analysis completes successfully with at least 1 data source
• No charge if all APIs fail

⚠️ Legal Disclaimer

This Actor aggregates publicly available US state fiscal data from:

• US Bureau of Labor Statistics (public domain)
• USAspending.gov (CC0 public domain)
• The World Bank (CC-BY 4.0)
• US CDC (public domain)

NOT municipal bond, fiscal policy, or investment advice. This Actor provides statistical aggregation and historical data visualization only.

• Does NOT recommend fiscal policy decisions
• Does NOT guarantee data accuracy or forecasting
• Does NOT constitute financial, fiscal, or investment advice
• Users are responsible for verifying data with original sources
• Historical data does not predict future performance

All source data is redistributed under the original license terms with attribution. Data retrieved in real-time; not cached or stored by this Actor.

Attribution:

• "Data source: US Bureau of Labor Statistics (Public Domain)"
• "Data source: USAspending.gov (CC0 Public Domain)"
• "Data source: The World Bank (CC BY 4.0)"
• "Data source: US CDC (Public Domain)"

Technical Details

• Runtime: Node.js 18+
• Timeout: 120 seconds per state
• Memory: ~128MB per run
• Concurrent API calls: 4 (parallel fetch)
• Source availability: 4 US government/institutional APIs

Support

For issues or questions, please contact the developer. Data accuracy is subject to source API availability and update frequency.

---

Last updated: 2026-04-09