# SovereignRisk

> SovereignRisk is a paid API for AI agents from sovereign.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns a composite sovereign economic default-risk score (0–20, LOW/MODERATE/ELEVATED/HIGH/DISTRESSED) for any country, built from IMF/World Bank macroeconomic fundamentals

## Facts

- Endpoint: GET https://sovereign.lonestaroracle.xyz/sovereign
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sovereignrisk-047292f9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3tYO0yWIiiaI7I8Yq7bFK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sovereignrisk-047292f9
```

Example prompt: What's the sovereign economic risk score for Argentina right now — is it elevated or distressed, and what are the main stress drivers pulling down the score?

## When to prefer this

Choose this endpoint when you need a fast, transparent, pay-per-call sovereign economic risk signal grounded in IMF and World Bank public data — ideal for macro agents, credit screening workflows, and country risk dashboards. Prefer it over rating-agency APIs when you want an explainable composite score with named drivers rather than an opaque letter grade, or when you need per-country on-demand lookup without a subscription. Pair it with a geopolitical risk endpoint (e.g. GeoPulse) for a full political + economic country risk picture.

## Known failure modes

- Unknown or misspelled country name returns an error or empty result — use ISO3 code as fallback
- Country not covered by IMF/World Bank data (e.g. some micro-states) may return null metrics
- Stale data if IMF WEO vintage has not been updated for the current year
- Payment failure (402) if USDC balance is insufficient
- Rate limiting or service unavailability from the upstream provider

## How this service works

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

## Output

A JSON object containing the country name and ISO3 code, a numeric risk score (0–20 scale), a categorical sovereign risk label (LOW / MODERATE / ELEVATED / HIGH / DISTRESSED), a list of named stress drivers (e.g. 'inflation 41.9% (runaway)', 'govt debt 80.3% GDP'), underlying metrics (inflation, GDP growth, government debt-to-GDP, fiscal balance, current account, FX reserves in months of import cover), the data vintage year, and a plain-language interpretation sentence. Data is sourced from IMF WEO and World Bank.

## Request schema (JSON Schema)

```json
{
 "name": "SovereignRisk",
 "tags": [
  "sovereign",
  "macro",
  "credit",
  "default-risk",
  "risk"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "risk",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "country": {
       "type": "string",
       "example": "Argentina",
       "description": "Country name (e.g. Argentina, Nigeria, Japan) or ISO3 code (ARG). Aliases accepted: nation, q, iso, code."
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "iso3": "ARG",
     "source": "IMF DataMapper (WEO) + World Bank",
     "country": "Argentina",
     "drivers": [
      "inflation 41.9% (runaway)",
      "govt debt 80.3% GDP"
     ],
     "metrics": {
      "inflation_pct": 41.9,
      "reserves_year": "2024",
      "gdp_growth_pct": 4.5,
      "govt_debt_gdp_pct": 80.3,
      "fiscal_balance_gdp_pct": -0.9,
      "reserves_months_import": 4.1,
      "current_account_gdp_pct": 1.2
     },
     "data_year": "2025",
     "max_score": 20,
     "risk_score": 7,
     "interpretation": "Multiple stress signals; sovereign credit under real strain.",
     "sovereign_risk": "ELEVATED"
    }
   }
  }
 },
 "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 — 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 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sovereignrisk-047292f9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sovereign.lonestaroracle.xyz](https://www.zero.xyz/host/sovereign.lonestaroracle.xyz/llms.txt)