# SovereignRisk

Per-country sovereign economic / default-risk score, agent-callable. One 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, fiscal balance, current-account balance, consumer inflation, real GDP growth (IMF WEO), and FX reserves in months of import cover (World Bank). Names the exact stress drivers and gives a plain-language read. The ECONOMIC complement to GeoPulse's political score — a transparent public-data sovereign-stress read, pay-per-call. Not a rating-agency grade. $0.05 via x402 on Base or Solana. Sources: IMF DataMapper (WEO), World Bank (all free). | Sibling: MENAPulse + LatAmPulse + GeoPulse | Full catalog: lonestaroracle.xyz

Base URL: https://sovereign.lonestaroracle.xyz
Payment: x402 micropayment in USDC on Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp); a 402 response returns payment terms.

## Endpoints
### GET /sovereign?country=<name or ISO3>
Per-country sovereign economic / default-risk score. Required param: country (a full name like Argentina, Nigeria, Japan, or an ISO3 code like ARG). Aliases accepted: nation, q, iso, code.

## Related services
Other LoneStarOracle feeds often used with this one:
- GeoPulse (geo.lonestaroracle.xyz, $0.07) - country geopolitical (political) risk score
- MENAPulse (mena.lonestaroracle.xyz, $0.05) - Middle East & North Africa macro pulse
- LatAmPulse (latam.lonestaroracle.xyz, $0.05) - Latin America macro pulse
- CascadeWatch (cascade.lonestaroracle.xyz, $0.10) - systemic / contagion risk

Agent manual (SKILL.md): https://sovereign.lonestaroracle.xyz/SKILL.md