# SYNTHORA GDELT Geopolitical Tension Index

> SYNTHORA GDELT Geopolitical Tension Index is a paid API for AI agents from gdelt-tension.hergertsynthora.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-27).

Analyzes GDELT news data to compute a real-time geopolitical tension index for any topic or country, including mention volume spike vs 7-day baseline, average tone shift, escalation flag, and driving headlines.

## Facts

- Endpoint: POST https://gdelt-tension.hergertsynthora.com/service?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-gdelt-geopolitical-tension-index-0769cdb4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xo9_MyEyK9G8u2p1qO244

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 synthora-gdelt-geopolitical-tension-index-0769cdb4 -d '<json body>'
```

Example prompt: What's the current geopolitical tension index for Taiwan? I want to know if there's been a news mention spike versus the 7-day baseline, what the tone shift looks like, whether an escalation flag has been triggered, and which recent headlines are driving it.

## When to prefer this

Choose this endpoint when you need a quantified, near-real-time geopolitical tension signal derived from global news coverage rather than a simple headline search. It is purpose-built for detecting escalation events, volume anomalies, and tone shifts for any topic or country using GDELT's global news graph — making it ideal for political risk monitoring, conflict early warning, and investment due diligence workflows where a structured numeric signal is more useful than raw news results.

## Known failure modes

- Invalid or empty input string returns an error field with no result
- Payment not provided or rejected by x402 protocol results in 402 Payment Required response
- GDELT data unavailable for very niche or obscure topics may return low-confidence or empty series
- Network timeouts if GDELT upstream is slow
- ok: false with error message if the query fails server-side

## How this service works

Live x402 resource on Base. POST /service; payment required responses use x402.

## Output

Returns a JSON object with: ok status, a niche identifier ('gdelt_tension'), and a result object containing the query string, daily mention series, the window in days, tension level label (e.g. low/medium/high), a boolean spike flag, daily baseline count, ratio of recent mentions vs baseline, recent headline titles, average tone score of recent coverage, and mention count in the last 24 hours. Also includes a payment receipt with cryptographic signature.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "maximum": 30,
   "minimum": 2
  },
  "query": {
   "type": "string",
   "maxLength": 250,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "result": {
   "ok": true,
   "niche": "gdelt_tension",
   "result": {},
   "partial": true,
   "schema_version": "1.0.0"
  },
  "receipt": {},
  "_documentation": {
   "state": "SCHEMA_ONLY_NOT_A_DELIVERY",
   "freshness": "NOT_ASSERTED",
   "payment_receipt": "NOT_PRESENT"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-gdelt-geopolitical-tension-index-0769cdb4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gdelt-tension.hergertsynthora.com](https://www.zero.xyz/host/gdelt-tension.hergertsynthora.com/llms.txt)