Per-country sovereign economic / default-risk score (?country=<name or ISO3>)

Per-country sovereign economic / default-risk score (?country=<name or ISO3>)

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://sovereign.lonestaroracle.xyz/sovereign

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "country": "Argentina"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "category": "risk",
  "description": "Sovereign economic / default-risk scoring made agent-callable. One x402 call returns a composite solvency-and-distress signal (LOW / MODERATE / ELEVATED / HIGH / DISTRESSED with a 0-20 score) for ANY country, built from the core sovereign-credit fundamentals: government debt as a share of GDP, the fiscal balance, the current-account balance, consumer inflation, real GDP growth (all IMF WEO), and FX reserves measured in months of import cover (World Bank). Names the exact stress drivers (e.g. 'inflation 42% (runaway)', 'govt debt 130% GDP', 'FX reserves 1.8 mo of imports (thin)') and gives a plain-language interpretation. This is the ECONOMIC complement to GeoPulse's political read \u2014 a transparent public-data sovereign-stress score a risk, credit, or macro agent can pull per-country, pay-per-call. Not a rating-agency grade; a live, auditable metric read. $0.05 in USDC on Base via x402. Sources: IMF DataMapper (WEO), World Bank (free/public). Sibling of MENAPulse, LatAmPulse and GeoPulse.",
  "name": "SovereignRisk",
  "properties": {
    "input": {
      "properties": {
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "country": {
              "description": "Country name (e.g. Argentina, Nigeria, Japan) or ISO3 code (ARG). Aliases accepted: nation, q, iso, code.",
              "example": "Argentina",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "country": "Argentina",
          "data_year": "2025",
          "drivers": [
            "inflation 41.9% (runaway)",
            "govt debt 80.3% GDP"
          ],
          "interpretation": "Multiple stress signals; sovereign credit under real strain.",
          "iso3": "ARG",
          "max_score": 20,
          "metrics": {
            "current_account_gdp_pct": 1.2,
            "fiscal_balance_gdp_pct": -0.9,
            "gdp_growth_pct": 4.5,
            "govt_debt_gdp_pct": 80.3,
            "inflation_pct": 41.9,
            "reserves_months_import": 4.1,
            "reserves_year": "2024"
          },
          "risk_score": 7,
          "source": "IMF DataMapper (WEO) + World Bank",
          "sovereign_risk": "ELEVATED"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "tags": [
    "sovereign",
    "macro",
    "credit",
    "default-risk",
    "risk"
  ],
  "type": "object",
  "version": "1.0.0"
}

This page as JSON