Rank countries by greenhouse-gas emissions for a gas and window
Rank every country / territory in the Climate TRACE inventory by total emissions of a selected gas over a start / end window. Optionally restrict to a continent or named country group (g7, g20, g77, eu, aosis, arab_league). Each row returns the emissions total, per-capita figure, share of the global total, and year-over-year percentage change. Data sourced from Climate TRACE under CC BY 4.0.
Query parameters
Gas identifier from /definitions/gases. co2e_100yr uses GWP100 and is the default for climate comparison.
Gas identifier from /definitions/gases. co2e_100yr uses GWP100 and is the default for climate comparison.
Start of the aggregation window. Accepts year (YYYY), year-month (YYYY-MM), or ISO date (YYYY-MM-DD).
Start of the aggregation window. Accepts year (YYYY), year-month (YYYY-MM), or ISO date (YYYY-MM-DD).
End of the aggregation window. Same formats as start.
End of the aggregation window. Same formats as start.
Comma-separated sector slugs. Reserved keyword all_no_forest excludes forestry-and-land-use.
Comma-separated sector slugs. Reserved keyword all_no_forest excludes forestry-and-land-use.
Comma-separated subsector slugs.
Comma-separated subsector slugs.
Named country group slug (e.g. g7, g20, eu).
Named country group slug (e.g. g7, g20, eu).
Continent name restricting the ranking scope.
Continent name restricting the ranking scope.
Response
Country rows ranked by emissions plus global totals and a time-series breakdown.
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"
]
}
}