Rank countries by an IMF WEO indicator (incl. forecast years) API

Cross-country leaderboard for an IMF World Economic Outlook indicator in a chosen year — including FUTURE/forecast years — with rank and percentile, aggregates filtered out. Answers 'which countries will have the highest inflation next year', 'rank economies by projected GDP growth', 'IMF-forecast debt leaderboard'.

Price$0.01per request

MethodPOST

Route/v1/gov/imf-weo-ranking

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

govecon-dataimfweorankingforecastinflationleaderboardpercentile

API URLhttps://x402.hexl.dev/v1/gov/imf-weo-ranking

Integration docs

Example request

{
  "metric": "inflation",
  "year": 2026,
  "limit": 5
}

Example response

{
  "indicator": "PCPIPCH",
  "metric": "inflation",
  "year": 2026,
  "isForecast": true,
  "order": "desc",
  "countriesRanked": 191,
  "leaderboard": [
    {
      "country": "VEN",
      "iso3": "VEN",
      "value": 387.4,
      "rank": 1,
      "percentile": 100
    },
    {
      "country": "SDN",
      "iso3": "SDN",
      "value": 75.1,
      "rank": 2,
      "percentile": 99.47
    },
    {
      "country": "IRN",
      "iso3": "IRN",
      "value": 68.9,
      "rank": 3,
      "percentile": 98.95
    },
    {
      "country": "ARG",
      "iso3": "ARG",
      "value": 30.4,
      "rank": 4,
      "percentile": 98.42
    },
    {
      "country": "TUR",
      "iso3": "TUR",
      "value": 28.6,
      "rank": 5,
      "percentile": 97.89
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "description": "Plain name: gdp-growth, gdp-per-capita, inflation, unemployment, government-debt-pct-gdp, current-account-pct-gdp, gdp-usd."
    },
    "indicator": {
      "type": "string",
      "description": "Raw IMF WEO code (e.g. PCPIPCH); overrides metric."
    },
    "year": {
      "type": "integer",
      "description": "Year (may be a forecast year); defaults to current year."
    },
    "order": {
      "type": "string",
      "enum": [
        "desc",
        "asc"
      ],
      "default": "desc"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}