# GeoPulse — Geopolitical Risk Signal

> GeoPulse — Geopolitical Risk Signal is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-14).

Returns a real-time geopolitical risk score (0–10) plus signal direction, key risks, and AI summary for any country or region by combining base risk scores with live news sentiment

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_geo_lonestaroracle_xyz
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geopulse-geopolitical-risk-signal-7024c86e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Rc7_YCReyDPOIzK7oZweK

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 geopulse-geopolitical-risk-signal-7024c86e
```

Example prompt: What's the current geopolitical risk score for Iran right now — is the situation improving or escalating? Look back at the last 48 hours of news.

## When to prefer this

Choose GeoPulse when you need a quick, combined quantitative risk score AND qualitative signal direction for a country or region, especially when live news sentiment is important alongside structural risk baselines. Prefer this over static country risk databases when recency matters (e.g. pre-trade checks, monitoring active conflicts, or tracking fast-moving political situations). Best for trading, prediction markets, macro research, and compliance use cases where a 0–10 score with directional signal is more actionable than raw news feeds alone.

## Known failure modes

- Unknown or ambiguous location name — returns error or null result if the country/region cannot be resolved
- Hours parameter out of range (must be 1–72) — validation error
- Exa AI news search unavailable — may return base score only without live sentiment component
- Rate limiting or payment failure — 402 response if USDC payment not processed correctly
- Very small or disputed territories may have sparse news coverage, reducing signal quality

## How this service works

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

## Output

Returns a geopolitical risk score from 0 to 10, a signal direction enum (improving/stable/deteriorating/escalating), a list of key risk factors, and an AI-generated narrative summary synthesizing base risk data with live news sentiment for the queried country or region.

## 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/geopulse-geopolitical-risk-signal-7024c86e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)