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.

yearinteger required

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

limitinteger

Maximum rows to return (1 to 50).

versionstring nullable

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"
    ]
  }
}

Changes

Changed in 1 of the 21 revisions of this API.12

Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history