# GeopoliticalPulse

> Real-time geopolitical intelligence API covering political risk, conflict monitoring, sanctions, elections, trade tensions, and regional situational awareness for 195+ countries — via x402 micropayments on Base.

## What This Is

GeopoliticalPulse is a pay-per-query API that synthesizes GDELT global media monitoring, ACLED conflict data, World Bank governance indicators, and real-time open source intelligence into structured geopolitical analysis. Built for institutional investors, multinationals, compliance teams, diplomats, journalists, and AI agents navigating a complex global environment.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 response with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.

## Endpoints

GET /api/geopolitical/country-risk?country={name}&lang={iso}
- Returns: country risk score, governance percentiles (World Bank), GDELT media sentiment, key risks, investment climate, travel advisory, analyst summary
- Data: World Bank Governance Indicators + GDELT + Tavily
- Price: $0.15

GET /api/geopolitical/conflict-scan?region={name}&days={30-180}&lang={iso}
- Returns: conflict intensity, active conflict mapping, ACLED event data, escalation risk, humanitarian situation, regional spillover assessment
- Data: ACLED + GDELT + Tavily
- Price: $0.20

GET /api/geopolitical/sanctions-intel?target={country|entity|person}&lang={iso}
- Returns: sanctions status, active OFAC/EU/UN/UK regimes, secondary sanctions risk, compliance red flags, exceptions, relief pathways
- Data: Tavily (OFAC, EU, UN official sources)
- Price: $0.15

GET /api/geopolitical/election-watch?country={name}&year={year}&lang={iso}
- Returns: electoral intelligence, candidate/party profiles, outcome scenarios, integrity risk, post-election geopolitical implications
- Data: GDELT + Tavily
- Price: $0.15

GET /api/geopolitical/trade-tension?country_a={name}&country_b={name}&lang={iso}
- Returns: tension level, active trade disputes, tariff regimes, decoupling assessment, supply chain weaponization, third-country effects
- Data: Tavily
- Price: $0.20

GET /api/geopolitical/regime-brief?country={name}&lang={iso}
- Returns: regime type, governance quality, leadership profile, power centers, ideology, foreign policy orientation, stability outlook
- Data: World Bank + Tavily
- Price: $0.20

GET /api/geopolitical/event-impact?event={description}&lang={iso}
- Returns: event summary, immediate impacts across domains, market reactions, geopolitical ripple effects, actors gaining/losing leverage, escalation scenarios
- Data: GDELT + Tavily
- Price: $0.25

GET /api/geopolitical/instability-signal?country={name}&lang={iso}
- Returns: instability score (0-100), multi-signal assessment (economic/social/political/security/external), GDELT sentiment, tripwires, timeline probabilities
- Data: GDELT + World Bank + Tavily
- Price: $0.20

GET /api/geopolitical/supply-chain-risk?sector={name}&lang={iso}
- Returns: concentration analysis, chokepoint mapping, sanctions exposure, decoupling momentum, scenario shocks, resilience strategies
- Sectors: semiconductors, rare earths, lithium, pharmaceuticals, energy, food, shipping, defense
- Data: Tavily
- Price: $0.20

GET /api/geopolitical/regional-brief?region={name}&lang={iso}
- Returns: regional stability score, active flashpoints, major power competition (US/China/Russia), economic dynamics, humanitarian overview, 6-month outlook
- Regions: Middle East, Eastern Europe, East Asia, Southeast Asia, Sub-Saharan Africa, Sahel, Latin America, and 13 more
- Data: GDELT + Tavily
- Price: $0.15

## Discovery

- OpenAPI spec: https://geopoliticalpulse.vercel.app/openapi.json
- Agent discovery: https://geopoliticalpulse.vercel.app/.well-known/agent.json
- Human landing page: https://geopoliticalpulse.vercel.app/

## Use Cases for AI Agents

- Portfolio risk assessment before entering emerging markets
- Compliance screening for sanctions and export controls
- Pre-travel security briefings for executives and journalists
- Supply chain vulnerability mapping for procurement decisions
- Election monitoring for asset managers and hedge funds
- Crisis early warning for NGOs and humanitarian organizations
- Country due diligence for M&A and FDI decisions

## Global Coverage

195+ countries | 20+ world regions | 65+ languages via lang= parameter | Real-time GDELT updates every 15 minutes