US Macroeconomic Data

Get U.S. CPI inflation data from the Bureau of Labor Statistics. Returns latest value, YoY change, and MoM change.

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string",
      "description": "all_items (default), core (ex food/energy), food, energy, shelter, medical",
      "default": "all_items"
    },
    "months": {
      "type": "number",
      "description": "Months of history (default 13)",
      "default": 13
    }
  }
}

Get U.S. labor market data from BLS. Unemployment rate, nonfarm payrolls, job openings, and wages.

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string",
      "description": "unemployment_rate (default), nonfarm_payrolls, job_openings, avg_hourly_earnings, labor_force_participation",
      "default": "unemployment_rate"
    },
    "months": {
      "type": "number",
      "description": "Months of history",
      "default": 13
    }
  }
}

Get macroeconomic indicators from FRED (Federal Reserve). GDP, Fed funds rate, Treasury yields, housing starts, retail sales.

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string",
      "description": "gdp, fed_funds_rate (default), treasury_10y, treasury_2y, yield_curve, housing_starts, retail_sales, consumer_sentiment",
      "default": "fed_funds_rate"
    },
    "limit": {
      "type": "number",
      "description": "Data points to return",
      "default": 12
    }
  }
}

Get energy prices from the U.S. Energy Information Administration. WTI crude, Brent crude, natural gas.

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string",
      "description": "wti_crude (default), brent_crude, natural_gas",
      "default": "wti_crude"
    },
    "limit": {
      "type": "number",
      "description": "Weekly data points",
      "default": 12
    }
  }
}

Get U.S. national debt (daily, to the penny) and average interest rates on Treasury securities from the U.S. Treasury.

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string",
      "description": "debt (national debt, default) or interest_rates",
      "default": "debt"
    },
    "limit": {
      "type": "number",
      "description": "Number of records",
      "default": 10
    }
  }
}

Get U.S. Census demographic data by state or county. Population, median income, poverty rate, unemployment, home values, and education level.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "2-letter state code (CA, TX, NY). Omit for all states."
    },
    "level": {
      "type": "string",
      "description": "state (default) or county",
      "default": "state"
    }
  }
}

U.S. County Business Patterns — number of businesses (establishments), employees, and payroll by industry (NAICS code) and state. Answers: How many tech companies in California? Total healthcare employees in Texas?

{
  "type": "object",
  "properties": {
    "naics": {
      "type": "string",
      "description": "NAICS industry code: 51=Tech/Info, 52=Finance, 53=Real Estate, 54=Professional Services, 62=Healthcare, 23=Construction, 44=Retail, 72=Food/Hospitality",
      "default": "51"
    },
    "state": {
      "type": "string",
      "description": "2-letter state code (CA, TX, NY). Omit for all states."
    },
    "year": {
      "type": "string",
      "description": "Data year (default: 2021)",
      "default": "2021"
    }
  }
}