Research

World aggregate time series (sum or mean across countries)

Changed on

Returns a Sugra-computed world aggregate across all Penn World Table countries for the requested variable subset. Pick aggregation=sum for level variables that add meaningfully across countries (rgdpo, rgdpe, pop, emp, cn, ccon), or aggregation=mean for unitless indices, shares, and price levels (hc, ctfp, cwtfp, labsh, pl_gdpo, csh_*). The Penn World Table upstream dataset does not ship a World row; this endpoint derives one at request time. Null values in the panel are skipped from the aggregate. Not every country contributes in every year, so the mix of contributing countries varies by year - keep this in mind for long-run world totals. Published under CC BY 4.0 with attribution to Penn World Table (Feenstra, Inklaar & Timmer, University of Groningen).

get/api/v1/research/pwt/world

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/research/pwt/world
  • Auth: API key in header x-api-key

Query parameters

variablesstring nullable

Comma-separated variable names to aggregate. Omit to receive every data variable (uses the requested aggregation method uniformly).

aggregationstring

Per-variable aggregation method. sum for level variables (rgdpo, pop). mean for indices and ratios (labsh, hc, pl_gdpo).

versionstring nullable

Release selector. pwt1100 (default) or pwt1001 (legacy).

Response

World-aggregate time series across the requested variable subset.

Example response

{
  "data": {
    "version": "pwt1100",
    "aggregation": "sum",
    "observations": [
      {
        "year": 2020,
        "countrycode": "USA",
        "country": "United States",
        "currency_unit": "US Dollar"
      }
    ],
    "count": 74
  },
  "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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes