Climate Risk Analysis¶
Analyze total climate risk for one or more assets across different transition scenarios. Emissions data is required for climate risk analysis.
Endpoint¶
Authentication¶
Required. Include your API key in the X-API-Key header.
Overview¶
The climate risk endpoint assesses both physical and transition risks for assets under different climate scenarios. The API supports:
- Multiple asset types: equity, debt, infrastructure, property
- Multiple scenarios: Analyze risk under different climate futures
- Multiple years of analysis: Assess risk for multiple future years
- Batch processing: Submit multiple entities in a single request
Request Structure¶
See Data Models for complete documentation of entity_info, emissions, and financials fields.
Multiple Years of Data¶
Important distinction from emissions estimation:
- For emissions estimation: Providing 2-3 years of historical data improves estimation accuracy by establishing trends
- For climate risk analysis: Each year of data simply returns risk analysis for that specific point in time
If you only care about current climate risk, provide only your latest emissions and financials data. Additional historical years are only necessary if you want to analyze how climate risk has evolved over time.
Basic Example¶
[
{
"entity_info": {
"identifier": "ENRGY",
"name": "Energy Corp",
"asset_type": "equity",
"country": "United States",
"industry_classification_system": "factset",
"industry": "Energy",
"sector": "Oil & Gas"
},
"data": [
{
"year": 2023,
"emissions": {
"scope1": 500000,
"scope2": 300000,
"scope3": 1000000
},
"financials": {
"revenue": 5000000000,
"ebitda": 800000000
}
}
],
"scenarios": [
"ipcc_net_zero",
"ngfs_below_2_degrees"
],
"analysis_years": [2030, 2050]
}
]
Endpoint-Specific Fields¶
scenarios (Required)¶
Array of climate scenario identifiers to analyze.
Available Scenarios:
IPCC Scenarios¶
| Scenario ID | Description |
|---|---|
ipcc_net_zero |
IPCC Net Zero 2050 - Aggressive decarbonization aligned with 1.5°C target |
ipcc_two_degree |
IPCC 2°C Pathway - Moderate emissions reduction to limit warming to 2°C |
ipcc_four_degree |
IPCC 4°C Pathway - High emissions scenario with limited climate action |
NGFS Scenarios (Network for Greening the Financial System)¶
| Scenario ID | Description |
|---|---|
ngfs_net_zero |
NGFS Net Zero 2050 - Limits warming to 1.5°C with immediate policy action |
ngfs_below_two_degree |
NGFS Below 2°C - Gradual transition limiting warming to below 2°C |
ngfs_delayed_transition |
NGFS Delayed Transition - Late policy action leading to higher transition risks |
ngfs_current_policies |
NGFS Current Policies - Continuation of existing policies only |
ngfs_fragmented_world |
NGFS Fragmented World - Divergent policies across regions |
ngfs_low_demand |
NGFS Low Demand - Reduced energy demand through efficiency and behavioral changes |
ngfs_ndc |
NGFS NDC - Implementation of Nationally Determined Contributions |
Example:
analysis_years (Required)¶
Array of integer years for which to assess future climate risk.
Valid Range: Analysis years must be between the as-at year of your data and 2050. For example, if you provide data for 2023, you can only request analysis for years from 2023 to 2050. Years before your data year or after 2050 are not supported.
Important: The API automatically includes climate risk analysis for the year of each data point provided. For example:
- If you provide data for 2023 and 2024
- And specify analysis_years: [2030, 2050]
- The response will include analysis for:
- 2023 data: 2023, 2030, 2050
- 2024 data: 2024, 2030, 2050
Example:
Emissions (Required)¶
Unlike the emissions-estimate endpoint, climate risk analysis requires complete emissions data. Requirements vary by asset type:
Equity¶
- scope1, scope2, scope3: All three scopes required
Debt¶
- underlying_scope1, underlying_scope2, underlying_scope3: All three scopes required for the underlying entity (the borrower)
Infrastructure & Property¶
- scope1, scope2: Both scopes required
- scope3: Not applicable for infrastructure and property assets
Response Format¶
Success Response (200 OK)¶
The response includes analysis for both the data point year and the requested future years. Since the request included data for 2023 with analysis_years: [2030, 2050], the response includes risk metrics for 2023, 2030, and 2050:
{
"results": [
{
"entity_info": {
"name": "Energy Corp",
"asset_type": "equity",
"country": "United States",
"industry_classification_system": "factset",
"industry": "Energy",
"sector": "Oil & Gas"
},
"data": [
{
"year": 2023,
"scenarios": [
{
"scenario": "ipcc_net_zero",
"risk_metrics": [
{
"analysis_year": "2023",
"metrics": {
"transition_var": 0.15,
"physical_var": 0.10,
"total_climate_var": 0.25
}
},
{
"analysis_year": "2030",
"metrics": {
"transition_var": 0.25,
"physical_var": 0.15,
"total_climate_var": 0.40
}
},
{
"analysis_year": "2050",
"metrics": {
"transition_var": 0.45,
"physical_var": 0.30,
"total_climate_var": 0.75
}
}
]
},
{
"scenario": "ngfs_below_2_degrees",
"risk_metrics": [
{
"analysis_year": "2023",
"metrics": {
"transition_var": 0.12,
"physical_var": 0.12,
"total_climate_var": 0.24
}
},
{
"analysis_year": "2030",
"metrics": {
"transition_var": 0.18,
"physical_var": 0.20,
"total_climate_var": 0.38
}
},
{
"analysis_year": "2050",
"metrics": {
"transition_var": 0.32,
"physical_var": 0.38,
"total_climate_var": 0.70
}
}
]
}
]
}
]
}
]
}
Response Fields:
| Field | Description |
|---|---|
scenario |
Climate scenario identifier used for this analysis |
transition_var |
Value-at-Risk from transition risks (carbon pricing, policy changes, technology shifts) |
physical_var |
Value-at-Risk from physical climate impacts (extreme weather, sea level rise) |
total_climate_var |
Combined Value-at-Risk from all climate-related risks |
Notes: - VaR metrics are expressed as decimals (0.25 = 25% risk) - Additional metrics may be included depending on asset type and scenario