economics_environment
Read-onlyIdempotent
Retrieve environmental and ESG data including carbon footprint, renewable energy metrics, and ESG scores. Use tickers for company ratings or countries for carbon and energy data.
Instructions
Environmental and ESG data. For ESG scores (E, S, G ratings) use tickers='AAPL'. For carbon footprint and renewable energy data use countries='United States'. This is the only tool that accepts BOTH tickers= and countries= depending on the indicator.
Available indicators: get_carbon_footprint, get_renewable_energy, get_esg_scores.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| indicator | Yes | Name of the specific metric to calculate, e.g. 'get_asset_turnover_ratio'. Required — omitting it returns the list of available indicators. | |
| tickers | No | Comma-separated ticker symbols, e.g. 'AAPL,MSFT,GOOGL'. | |
| countries | No | Comma-separated country names, e.g. 'United States,Germany,Japan'. | |
| start_date | No | Start of the date range in YYYY-MM-DD format. | 2021-06-22 |
| end_date | No | End of the date range in YYYY-MM-DD format. | 2026-06-21 |
| quarterly | No | Return quarterly data instead of annual when True. | |
| benchmark_ticker | No | Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'. | SPY |
| growth | No | Return period-over-period growth rates instead of absolute values. | |
| lag | No | Number of periods to lag when computing growth rates. | |
| rounding | No | Number of decimal places to round results to. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |