Api Endpoint

LoneStarOracle

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

Open interactive test console

Offering

Provider
sovereign.lonestaroracle.xyz
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://sovereign.lonestaroracle.xyz/sovereign
MIME type
application/json
First seen
2026-10-16T01:50:04.338Z
Last seen
Tags
sovereign, Macro, credit, default-risk, Risk, X402, financial-data, real-economy, lonestaroracle, equities, Crypto, compliance, Data

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.05 USDC
Atomic price: 50000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Payment option 3
50000 atomic units
Atomic price: 50000 · Network: eip155:5042 · Asset: 0x3600000000000000000000000000000000000000 · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "payTo": "0x52Ab53912D37759B2ad364f22dD06B16714b6C06"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "50000",
    "payTo": "3nmeVj5m9Uq2hSTfsVsn3tJMHRJQNMKR1AjzyUJbrSgw"
  },
  {
    "scheme": "exact",
    "network": "eip155:5042",
    "asset": "0x3600000000000000000000000000000000000000",
    "amount": "50000",
    "payTo": "0xeF2a4B6756895aAf1374640dcFCD4947959442ab"
  }
]

Observed health

Status
Healthy
Latest latency
37 ms
Average latency
36 ms
HTTP status
402
Last checked
Reachability
100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "required": [
    "type",
    "method"
  ],
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "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 schema

{
  "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 — 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"
}