{
  "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",
      "url": "https://pulsenetwork.theaslangroupllc.com",
      "email": "info@theaslangroupllc.com"
    },
    "x-guidance": "# GeopoliticalPulse API (x402 pay-per-call)\n\nReal-time geopolitical intelligence API for 195+ countries. Political risk, conflict monitoring, sanctions, elections, trade tensions, instability early warning, supply chain risk, and regional situational awareness — powered by GDELT, ACLED, World Bank, and AI synthesis.\n\nBase URL: https://geopoliticalpulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/geopolitical/country-risk — $0.15 — Governance scores, GDELT sentiment, political stability analysis, investment climate rating\n- GET /api/geopolitical/conflict-scan — $0.2 — ACLED conflict mapping, escalation assessment, humanitarian situation, regional spillover risk\n- GET /api/geopolitical/sanctions-intel — $0.15 — OFAC/EU/UN/UK sanctions mapping, secondary sanctions risk, compliance red flags\n- GET /api/geopolitical/election-watch — $0.15 — Electoral intelligence, candidate profiles, outcome scenarios, geopolitical implications\n- GET /api/geopolitical/trade-tension — $0.2 — Bilateral trade disputes, tariffs, export controls, decoupling assessment\n- GET /api/geopolitical/regime-brief — $0.2 — Leadership profiles, power structures, ideology, foreign policy orientation, stability outlook\n- GET /api/geopolitical/event-impact — $0.25 — Rapid event assessment with cascading implications, market reactions, scenario modeling\n- GET /api/geopolitical/instability-signal — $0.2 — Multi-signal instability detection, tripwires, timeline probability estimates\n- GET /api/geopolitical/supply-chain-risk — $0.2 — Concentration analysis, chokepoint mapping, sanctions exposure, decoupling momentum\n- GET /api/geopolitical/regional-brief — $0.15 — Active flashpoints, power competition, economic dynamics, 6-month outlook for any world region\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)."
  },
  "servers": [
    {
      "url": "https://geopoliticalpulse.theaslangroupllc.com"
    }
  ],
  "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",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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.2,
        "x-agent-use-case": "conflict-monitoring, humanitarian-assessment, security-planning",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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.2,
        "x-agent-use-case": "trade-policy, supply-chain-strategy, investment-risk",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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.2,
        "x-agent-use-case": "country-profiling, diplomatic-intelligence, investment-due-diligence",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.250000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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.2,
        "x-agent-use-case": "early-warning, crisis-prevention, risk-monitoring",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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.2,
        "x-agent-use-case": "supply-chain-strategy, procurement, investment-screening",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/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",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    }
  }
}