{"uid":"cap_3tYO0yWIiiaI7I8Yq7bFK","slug":"sovereignrisk-047292f9","name":"SovereignRisk","description":"Per-country sovereign economic / default-risk score (?country=<name or ISO3>)","url":"https://sovereign.lonestaroracle.xyz/sovereign","method":"GET","headers":{},"bodySchema":{"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 Base via x402. Sources: IMF DataMapper (WEO), World Bank (free/public). Sibling of MENAPulse, LatAmPulse and GeoPulse."},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZFmR5_v_7yVyu4fVM5QP6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Emerging market bond screening","prompt":"I'm evaluating sovereign bonds across frontier markets — can you pull the sovereign risk scores for Nigeria, Kenya, and Pakistan and flag which ones are ELEVATED or worse?"},{"title":"Country risk dashboard for a macro fund","prompt":"Give me the sovereign risk score and key stress drivers for Turkey — I need to know if government debt and inflation are the main issues before we take a position."},{"title":"Credit exposure review for a trade finance deal","prompt":"We're considering extending trade finance into Egypt — can you check Egypt's sovereign risk rating and tell me whether FX reserves and fiscal balance are under strain?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:32:34.212Z","isFirstParty":false}