v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Research

Top-N countries ranked by a Penn World Table variable

Ranks countries by a Penn World Table variable in descending order for one year. Use for cross-country league tables - largest output-side real GDP (rgdpo), highest TFP level (ctfp), largest capital stock (cn), highest human capital index (hc), biggest labor share (labsh). The variable must be a Penn World Table column name. Call /api/v1/research/pwt/definitions for the full variable dictionary with descriptions and units. Published under CC BY 4.0 with attribution to Penn World Table (Feenstra, Inklaar & Timmer, University of Groningen).

get/api/v1/research/pwt/top

Query parameters

variablestring

Penn World Table variable to rank by. See /definitions.

Penn World Table variable to rank by. See /definitions.

yearinteger required

Year to rank by. Must be within the panel range (1950 to latest year).

Year to rank by. Must be within the panel range (1950 to latest year).

limitinteger

Maximum rows to return (1 to 50).

Maximum rows to return (1 to 50).

versionstring nullable

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

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

Response

Ranked countries with variable value plus variable description.

Example response

{
  "data": {
    "version": "pwt1100",
    "variable": "rgdpo",
    "type": "real-gdp-ppp",
    "year": 2020,
    "limit": 20,
    "ranking": [
      {
        "rank": 1,
        "countrycode": "USA",
        "country": "United States",
        "value": 20953.03
      }
    ],
    "count": 20
  },
  "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"
    ]
  }
}