Aggregated emissions broken down by sector, subsector, and gas
Aggregate total emissions across all matching sources for a year, broken down by sector, subsector, gas, and month. Apply filters to restrict the aggregation to a country (via gadm_id), a GADM state or county, a city, a country group, a continent, or a set of owner entities. Data sourced from Climate TRACE under CC BY 4.0.
Query parameters
Calendar year of the aggregation.
Calendar year of the aggregation.
Gas identifier from /definitions/gases.
Gas identifier from /definitions/gases.
Comma-separated sector slugs. Use all_no_forest to exclude forestry-and-land-use.
Comma-separated sector slugs. Use all_no_forest to exclude forestry-and-land-use.
Comma-separated subsector slugs.
Comma-separated subsector slugs.
GADM administrative area identifier to restrict the aggregation scope.
GADM administrative area identifier to restrict the aggregation scope.
GHS Functional Urban Area identifier.
GHS Functional Urban Area identifier.
Named country group slug.
Named country group slug.
Continent name.
Continent name.
Comma-separated owner identifiers from /owners.
Comma-separated owner identifiers from /owners.
Response
Totals block plus per-sector / per-subsector / per-gas aggregate rows over the requested window.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}