Tools / Macro

US state data

get_regional_data

One indicator for every US state and DC in a single call, ranked, with the change from a year earlier or the previous period and the national figure where one exists: unemployment, employment, house prices, real GDP, income, population, building permits, homeownership, or any state-level series id used as the template of its group.

Questions it answers

  • Which states have the highest unemployment, and where has it risen most in a year?
  • Rank states by house price growth.

Parameters

ParameterDescription
indicator
unemployment_rate | nonfarm_employment | house_prices | real_gdp | per_capita_income | median_household_income | population | building_permits | homeownership
Preset: unemployment_rate = Unemployment rate (%); nonfarm_employment = Nonfarm employment (thousands); house_prices = All-transactions house price index (1980 Q1 = 100); real_gdp = Real GDP (millions of chained 2017 dollars); per_capita_income = Per capita personal income (dollars); median_household_income = Real median household income (dollars); population = Resident population (thousands); building_permits = New private housing units authorized by building permits (units); homeownership = Homeownership rate (%). Or give series_id
series_id
string
Any state-level series id as the template of its group when indicator is omitted, e.g. 'TXUR' (unemployment rate), 'NYSTHPI' (house prices), 'FLNA' (nonfarm employment)
date
string
Period to show (default: latest available); any date inside the period works
compare
year_ago | previous | none = "year_ago"
Comparison period for the change columns
sort
value_desc | value_asc | change_desc | change_asc | name = "value_desc"
limit
integer = 60

Use it from your agent

Add the TradingData MCP URL to Claude, ChatGPT, Cursor or any MCP client, then ask in plain words. The model sees this tool's description and calls it with the right parameters.

MCP server URL
https://mcp.tradingdata.io

More in Macro