# Lonestar Oracle Geopolitical Risk API

> Lonestar Oracle Geopolitical Risk API is a paid API for AI agents from geo.lonestaroracle.xyz, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-15).

Returns a real-time geopolitical risk score combining a base risk index with live news sentiment for a specified country or region

## Facts

- Endpoint: GET https://geo.lonestaroracle.xyz/risk
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lonestar-oracle-geopolitical-risk-api-3ac945bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RaJcB000gji89QN0uykAo

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 lonestar-oracle-geopolitical-risk-api-3ac945bd
```

Example prompt: What's the current geopolitical risk signal for Brazil — give me the base score and the live news sentiment?

## When to prefer this

Use this endpoint when you need a fast, real-time geopolitical risk signal combining structured base scores with live news sentiment for any country or region — ideal for investment screening, supply chain risk assessment, or travel advisory pipelines where up-to-the-moment political context matters.

## Known failure modes

- Unknown or misspelled country/region name returns an error or empty result
- Rate limiting or payment failure if x402 USDC payment is not properly handled
- Stale or unavailable news data may affect sentiment component
- Region identifiers that are ambiguous (e.g. 'Middle East') may return unexpected scope

## How this service works

Real-time geopolitical risk signal — base score + live news sentiment for any country or region

## Output

A composite geopolitical risk signal for the queried country or region, including a base risk score and a live news sentiment component, returned as a structured JSON response per call billed at $0.07 USDC via x402 payment protocol.

## Example request

```json
{
 "location": "Brazil"
}
```

## Request schema (JSON Schema)

```json
{
 "name": "GeoPulse — Geopolitical Risk Signal",
 "tags": [
  "geopolitical",
  "risk",
  "country",
  "news",
  "macro",
  "prediction-markets"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "trading",
 "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": {
      "q": {
       "type": "string",
       "title": "Q",
       "description": "Alias for location"
      },
      "hours": {
       "type": "integer",
       "title": "Hours",
       "default": 24,
       "description": "News lookback hours (1-72)"
      },
      "country": {
       "type": "string",
       "title": "Country",
       "description": "Alias for location"
      },
      "location": {
       "type": "string",
       "title": "Location",
       "description": "Country or region"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 },
 "description": "Real-time geopolitical risk scoring for any country or region. Combines base risk scores with live news sentiment via Exa AI search. Returns risk score 0-10, signal direction (improving/stable/deteriorating/escalating), key risks, and AI summary."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lonestar-oracle-geopolitical-risk-api-3ac945bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from geo.lonestaroracle.xyz](https://www.zero.xyz/host/geo.lonestaroracle.xyz/llms.txt)