{ "openapi": "3.1.0", "info": { "title": "GeopoliticalPulse API", "description": "Real-time geopolitical intelligence for investors, compliance teams, and AI agents. Political risk, conflict monitoring, sanctions, elections, trade tensions, and regional situational awareness for 195+ countries. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.", "version": "1.0.0", "contact": { "name": "The Aslan Group LLC", "email": "info@theaslangroupllc.com", "url": "https://geopoliticalpulse.vercel.app" } }, "servers": [ { "url": "https://geopoliticalpulse.vercel.app" } ], "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 payment signature (USDC on Base mainnet). Send a GET request without this header to receive a 402 response with payment requirements, then sign and retry." } } }, "security": [{ "x402": [] }], "paths": { "/api/geopolitical/country-risk": { "get": { "summary": "Country Risk Assessment", "description": "Comprehensive political risk assessment using World Bank governance indicators, GDELT real-time media sentiment, and open source intelligence. Returns risk score, governance percentiles, media tone trends, investment climate rating, travel advisory, and analyst summary.", "operationId": "countryRisk", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country name or code (e.g., Russia, China, Iran, Venezuela, Nigeria)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code (en, es, fr, de, ar, zh, pt, ja, ko, ru)" } ], "responses": { "200": { "description": "Country risk assessment", "content": { "application/json": { "schema": { "type": "object", "properties": { "country": { "type": "string" }, "overall_risk_score": { "type": "number", "minimum": 0, "maximum": 100 }, "risk_tier": { "type": "string", "enum": ["LOW", "MODERATE", "HIGH", "CRITICAL"] }, "governance_scores": { "type": "object" }, "media_sentiment": { "type": "object" }, "key_risks": { "type": "array", "items": { "type": "string" } }, "investment_climate": { "type": "string" }, "travel_advisory": { "type": "string" }, "analyst_summary": { "type": "string" }, "generated_at": { "type": "string", "format": "date-time" } } } } } }, "402": { "description": "Payment required. Check PAYMENT-REQUIRED header for x402 details.", "headers": { "PAYMENT-REQUIRED": { "schema": { "type": "string" } } } } }, "x-price-usd": 0.15, "x-agent-use-case": "country-due-diligence, portfolio-risk, compliance-screening" } }, "/api/geopolitical/conflict-scan": { "get": { "summary": "Conflict Scan", "description": "Armed conflict intelligence using ACLED event data and GDELT media monitoring. Returns conflict intensity, active conflict mapping, humanitarian situation, escalation risk, and regional spillover assessment.", "operationId": "conflictScan", "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country or region to scan (e.g., Ukraine, Gaza, Sudan, Myanmar, Sahel)" }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 30, "maximum": 180, "default": 90 }, "description": "Lookback window in days" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Conflict intelligence scan" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.20, "x-agent-use-case": "conflict-monitoring, humanitarian-assessment, security-planning" } }, "/api/geopolitical/sanctions-intel": { "get": { "summary": "Sanctions Intelligence", "description": "Comprehensive sanctions mapping across OFAC, EU, UN, and UK regimes. Returns sanctions status, active designations, secondary sanctions risk, compliance red flags, exceptions, and relief pathways.", "operationId": "sanctionsIntel", "parameters": [ { "name": "target", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country, entity, or individual to assess (e.g., Russia, Iran, North Korea, Huawei)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Sanctions intelligence report" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.15, "x-agent-use-case": "compliance-screening, trade-diligence, financial-compliance" } }, "/api/geopolitical/election-watch": { "get": { "summary": "Election Watch", "description": "Electoral intelligence including candidate/party profiles, polling aggregation, outcome scenario modeling, electoral integrity risk, and post-election geopolitical implications.", "operationId": "electionWatch", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country holding an election (e.g., France, Germany, Brazil, India, Mexico)" }, { "name": "year", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Election year (e.g., 2025, 2026)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Electoral intelligence brief" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.15, "x-agent-use-case": "election-monitoring, political-forecasting, investment-positioning" } }, "/api/geopolitical/trade-tension": { "get": { "summary": "Trade Tension Analyzer", "description": "Bilateral trade dispute analysis covering tariffs, export controls, technology restrictions, decoupling assessment, supply chain weaponization, and third-country effects.", "operationId": "tradeTension", "parameters": [ { "name": "country_a", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First country (e.g., US, EU, China, India)" }, { "name": "country_b", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second country (e.g., China, Russia, Taiwan, Mexico)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Trade tension analysis" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.20, "x-agent-use-case": "trade-policy, supply-chain-strategy, investment-risk" } }, "/api/geopolitical/regime-brief": { "get": { "summary": "Regime Brief", "description": "Government intelligence covering regime type, governance quality, leadership profiles, power structures, ideology, foreign policy orientation, and 2-year stability outlook.", "operationId": "regimeBrief", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country to profile (e.g., China, Russia, Saudi Arabia, Iran, Turkey)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Regime intelligence brief" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.20, "x-agent-use-case": "country-profiling, diplomatic-intelligence, investment-due-diligence" } }, "/api/geopolitical/event-impact": { "get": { "summary": "Geopolitical Event Impact", "description": "Rapid assessment of geopolitical events with cascading implications across diplomatic, economic, military, and humanitarian domains. Includes market reactions, scenario modeling, and historical analogues.", "operationId": "eventImpact", "parameters": [ { "name": "event", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Event to analyze (e.g., Russia-Ukraine ceasefire, Taiwan strait incident, Iran nuclear deal)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Event impact analysis" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.25, "x-agent-use-case": "rapid-assessment, scenario-planning, market-impact" } }, "/api/geopolitical/instability-signal": { "get": { "summary": "Instability Early Warning Signal", "description": "Multi-signal early warning system detecting pre-crisis conditions across economic distress, social unrest, political dysfunction, security stress, and external pressure. Returns instability score, tripwires, and timeline probability estimates.", "operationId": "instabilitySignal", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Country to assess (e.g., Haiti, Pakistan, Ethiopia, Venezuela, Lebanon)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Instability signal assessment" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.20, "x-agent-use-case": "early-warning, crisis-prevention, risk-monitoring" } }, "/api/geopolitical/supply-chain-risk": { "get": { "summary": "Supply Chain Geopolitical Risk", "description": "Geopolitical supply chain analysis covering concentration risks, critical dependencies, chokepoint mapping, sanctions exposure, decoupling momentum, and resilience strategies.", "operationId": "supplyChainRisk", "parameters": [ { "name": "sector", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Sector or commodity (e.g., semiconductors, rare earths, lithium, pharmaceuticals, energy, food)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Supply chain risk analysis" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.20, "x-agent-use-case": "supply-chain-strategy, procurement, investment-screening" } }, "/api/geopolitical/regional-brief": { "get": { "summary": "Regional Situational Brief", "description": "Comprehensive regional geopolitical assessment covering active flashpoints, major power competition (US/China/Russia), economic dynamics, humanitarian overview, and 6-month stability outlook.", "operationId": "regionalBrief", "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string" }, "description": "World region (Middle East, Eastern Europe, East Asia, Southeast Asia, Sub-Saharan Africa, Sahel, Latin America, etc.)" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "Response language ISO 639-1 code" } ], "responses": { "200": { "description": "Regional intelligence brief" }, "402": { "description": "Payment required" } }, "x-price-usd": 0.15, "x-agent-use-case": "situational-awareness, regional-strategy, portfolio-monitoring" } } } }