macroeconomics
Retrieve macroeconomic indicators such as GDP, inflation rate, and trade balance for one or more countries, with options for date ranges, quarterly frequency, growth rates, and inflation adjustment.
Instructions
Macroeconomic indicators by country (GDP, CPI, inflation rate, trade balance, imports, exports, investment, consumption, business/consumer confidence, house prices, rent prices, exchange rates). Requires countries='United States' — use comma-separated values for multiple countries. Do NOT use tickers= for this tool. Supports start_date/end_date and quarterly=true.
Available indicators: get_business_confidence_index, get_composite_leading_indicator, get_consumer_confidence_index, get_consumer_price_index, get_current_account_balance, get_current_account_balance_to_gdp_ratio, get_exchange_rates, get_exports, get_exports_to_gdp_ratio, get_fixed_investment, get_fixed_investment_to_gdp_ratio, get_gross_domestic_product, get_gross_domestic_product_deflator, get_house_prices, get_imports, get_imports_to_gdp_ratio, get_inflation_rate, get_investment, get_investment_to_gdp_ratio, get_money_supply, get_rent_prices, get_share_prices, get_total_consumption, get_total_consumption_to_gdp_ratio.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lag | No | Number of periods to lag when computing growth rates. | |
| growth | No | Return period-over-period growth rates instead of absolute values. | |
| period | No | Observation frequency, e.g. 'monthly', 'quarterly', or 'annual'. | |
| measure | No | Sub-measure selector, e.g. 'M1', 'M2', or 'M3' for money supply. | |
| end_date | No | End of the date range in YYYY-MM-DD format. | 2026-06-27 |
| countries | No | Comma-separated country names, e.g. 'United States,Germany,Japan'. | |
| indicator | Yes | Name of the specific metric to calculate, e.g. 'get_asset_turnover_ratio'. Required — omitting it returns the list of available indicators. | |
| quarterly | No | Return quarterly data instead of annual when True. | |
| start_date | No | Start of the date range in YYYY-MM-DD format. | 2021-06-28 |
| gmdb_source | No | Use the OECD Global Macro Data Bank as the data source when True. | |
| show_columns | No | Comma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage. | |
| inflation_adjusted | No | Adjust nominal values for inflation when True. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |