Statistics of the World

Get all key statistics for a country. Returns GDP, population, life expectancy, inflation, unemployment, and more.

{
  "type": "object",
  "properties": {
    "country_id": {
      "type": "string",
      "description": "ISO 3166-1 alpha-3 code (e.g., USA, CAN, GBR, CHN, JPN, DEU)"
    }
  },
  "required": [
    "country_id"
  ]
}

Rank countries by an indicator available to the caller's tier. Supports top N and bottom N queries.

{
  "type": "object",
  "properties": {
    "indicator_id": {
      "type": "string",
      "description": "Indicator ID. GDP accepts IMF.NGDPD or the World Bank original NY.GDP.MKTP.CD; also e.g. SP.POP.TOTL for population, FP.CPI.TOTL.ZG for inflation. Call get_available_indicators or search_indicators to browse the listed catalog."
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default 10)"
    },
    "order": {
      "type": "string",
      "enum": [
        "desc",
        "asc"
      ],
      "description": "\"desc\" for highest first, \"asc\" for lowest first"
    }
  },
  "required": [
    "indicator_id"
  ]
}

Get historical time series (20+ years) for a country and indicator pair.

{
  "type": "object",
  "properties": {
    "indicator_id": {
      "type": "string",
      "description": "Indicator ID"
    },
    "country_id": {
      "type": "string",
      "description": "ISO 3166-1 alpha-3 code"
    }
  },
  "required": [
    "indicator_id",
    "country_id"
  ]
}

Compare 2-10 countries on selected indicators.

{
  "type": "object",
  "properties": {
    "country_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of country codes (max 10)"
    },
    "indicator_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Indicator IDs to compare (default: GDP, population, life expectancy, etc.)"
    }
  },
  "required": [
    "country_ids"
  ]
}

Search for indicators by keyword. Use when you need to find the right indicator ID.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search term (e.g., \"gdp\", \"population\", \"education\", \"co2\")"
    }
  },
  "required": [
    "query"
  ]
}

List all available indicators grouped by category.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Optional: filter by category name"
    }
  }
}

List all 218 countries with metadata (region, income level, capital).

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "Optional: filter by region"
    }
  }
}

High-frequency (daily/weekly/monthly) series: US Treasury yield curve (UST.YC.3M … UST.YC.30Y), SOFR/EFFR/OBFR, CORRA and GoC yields, central bank policy rates for ~38 economies (BIS.CBPOL.M/D), monthly CPI inflation for ~190 countries (IMF.CPI.YOY.M, IMF.CPI.FOOD.YOY.M), monthly 10-year government bond yields for 40+ countries (OECD.IRLT.10Y), monthly unemployment (ILO.UNEMP.RT.M, EUROSTAT.UNEMP.RT.M), Eurostat HICP/industrial production/retail (EUROSTAT.*.M), monthly electricity (EMBER.ELEC.*.M), and daily shipping chokepoint transits plus weekly port trade volumes (PORTWATCH.*). Call list_series to browse. Every response carries source licence and attribution.

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "Series ID, e.g. UST.YC.10Y, OECD.IRLT.10Y, ILO.UNEMP.RT.M"
    },
    "geo": {
      "type": "string",
      "description": "ISO3 country code (e.g. USA, DEU). Omit with latest=true for a cross-country view."
    },
    "latest": {
      "type": "boolean",
      "description": "true: newest stored observation for every geography. Do not combine with geo, from or limit; reference periods can differ."
    },
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD"
    },
    "limit": {
      "type": "number",
      "description": "Max observations (default 120)"
    }
  },
  "required": [
    "series_id"
  ]
}

List the high-frequency series catalog (rates, yields, monthly labour and energy) with frequency, unit, source, and licence for each.

{
  "type": "object",
  "properties": {}
}

Cross-source reconciliation: for one concept (e.g. GDP), return the IMF, World Bank, and UN values side by side per country, with the year each source reports. Sources legitimately disagree — different vintages, exchange-rate conventions, and revision cycles; this tool makes the disagreement visible instead of hiding it. Works for concepts with a multi-source mapping (GDP, GDP per capita, GDP growth, population, and others).

{
  "type": "object",
  "properties": {
    "indicator_id": {
      "type": "string",
      "description": "Concept key, e.g. IMF.NGDPD (GDP), IMF.NGDPDPC (GDP per capita), IMF.NGDP_RPCH (real growth)"
    },
    "country_id": {
      "type": "string",
      "description": "Optional ISO3 code to return a single country instead of all"
    }
  },
  "required": [
    "indicator_id"
  ]
}

Institutional release schedules with primary source URLs. Date-passed status does not confirm publication. Related series readings retain their own reference periods and current values; their match to the scheduled release is not verified.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (default: today)"
    },
    "to": {
      "type": "string",
      "description": "End date YYYY-MM-DD (default: +180 days)"
    },
    "institution": {
      "type": "string",
      "description": "Optional: ECB, BOC, BEA, BLS, EUROSTAT, IMF, G7, G20"
    },
    "country": {
      "type": "string",
      "description": "Optional: US, CA, EU, or Global"
    },
    "report_type": {
      "type": "string",
      "description": "Optional: policy_decision, data_release, flagship_report, or meeting"
    },
    "limit": {
      "type": "number",
      "description": "Max events (default 100)"
    }
  }
}