{
  "openapi": "3.1.0",
  "info": {
    "title": "RiskPulse API",
    "description": "Global risk intelligence API. AI-synthesized travel safety alerts, country risk profiles, sanctions screening, business risk analysis, supply chain disruption intelligence, nomad visa/tax guidance, expat risk assessment, and emergency evacuation protocols. Covers 195 countries with real-time data. Serves travel risk managers, insurance brokers, compliance teams, expats, and digital nomads. Travel insurance affiliates (SafetyWing, WorldNomads) included in relevant endpoints. All endpoints support any language via ?lang=. Pricing: $0.08–$0.20 USDC/call via x402 micropayment.",
    "version": "1.2.0",
    "contact": {
      "name": "The Aslan Group LLC",
      "url": "https://pulsenetwork.theaslangroupllc.com",
      "email": "info@theaslangroupllc.com"
    },
    "x-guidance": "# RiskPulse API (x402 pay-per-call)\n\nCountry risk intelligence API for travelers, expats, and businesses. 10 endpoints: comprehensive risk profiles across 6 dimensions, travel safety with advisory levels and insurance referrals, business risk and market entry analysis, side-by-side country comparisons, expat living guides, situational security alerts, evacuation planning, digital nomad scoring, sanctions exposure analysis, and supply chain risk. Powered by World Bank governance indicators and real-time intelligence. Pay-per-query v\n\nBase URL: https://riskpulse.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/risk/country — $0.1 — Comprehensive country risk profile — 6 risk dimensions, overall score, risks to watch, mitigants.\n- GET /api/risk/travel — $0.08 — Travel safety assessment — advisory level 1-4, crime/health risks, entry requirements, safe/avoid areas, insurance referrals.\n- GET /api/risk/business — $0.1 — Business risk analysis — regulatory quality, corruption, rule of law, IP protection, market entry tips, due diligence checklist.\n- GET /api/risk/compare — $0.1 — Side-by-side comparison of 2-4 countries — safety, stability, business environment, expat friendliness, overall ranking.\n- GET /api/risk/expat — $0.1 — Expat living guide — safety, healthcare, cost of living, visa ease, language, expat community, best cities, insurance links.\n- GET /api/risk/alerts — $0.1 — Situational security alerts — real-time threat level for a current location, drawing on news, conflict, and earthquake data with actionable guidance.\n- GET /api/risk/quake-check — $0.01 — Earthquake activity check, deterministic — USGS FDSN events near a lat/lon (or global M5+ feed) over the last N days with a code-computed summary (count, max/av\n- GET /api/risk/evac — $0.1 — Evacuation plan — 48-hour emergency departure plan with airports, embassy contacts, cash, documents, and transport options.\n- GET /api/risk/nomad — $0.1 — Digital nomad score — 7-dimension ranking (internet, visa, cost, safety, healthcare, community, quality of life) for any country or city.\n- GET /api/risk/sanctions — $0.15 — Sanctions exposure analysis — OFAC, EU, and UN sanctions screening for any entity, person, or country, with official screening resources.\n- GET /api/risk/supply — $0.15 — Supply chain risk — concentration risk, disruption scenarios, and diversification strategy for a product or component.\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)."
  },
  "servers": [
    {
      "url": "https://riskpulse.theaslangroupllc.com"
    }
  ],
  "paths": {
    "/api/risk/country": {
      "get": {
        "summary": "Country risk profile",
        "description": "Comprehensive risk profile across 6 dimensions: political, economic, security, health, natural disaster, and legal/regulatory. Powered by World Bank governance indicators and real-time intelligence.",
        "operationId": "riskCountry",
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Country name (e.g. Mexico, Thailand, Nigeria)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Country risk profile with dimensional scores and recommendations"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Comprehensive country profile — run first for any country-specific workflow; chain to /api/risk/travel for traveler view or /api/risk/business for enterprise view",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/travel": {
      "get": {
        "summary": "Travel safety assessment",
        "description": "Advisory level (1-4), crime and health risks, entry requirements, safe/avoid areas, emergency contacts, and travel insurance recommendations.",
        "operationId": "riskTravel",
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nationality",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Traveler nationality (default: US)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Travel safety assessment with insurance referrals"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Run before any trip booking; pairs with TravelPulse /api/travel/insurance; SafetyWing + WorldNomads insurance links auto-appended in response",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/business": {
      "get": {
        "summary": "Business risk analysis",
        "description": "Market entry risk assessment covering regulatory quality, corruption, rule of law, IP protection, contract enforcement, profit repatriation, and due diligence checklist.",
        "operationId": "riskBusiness",
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "industry",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Business risk analysis with market entry guidance"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Pairs with /api/risk/sanctions for compliance check; follow with /api/risk/supply for supply chain exposure; combine with FilingsPulse for due diligence workflows",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/compare": {
      "get": {
        "summary": "Country risk comparison",
        "description": "Side-by-side risk comparison of 2-4 countries — safety, stability, business environment, expat friendliness, category winners, and overall ranking.",
        "operationId": "riskCompare",
        "parameters": [
          {
            "name": "countries",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated country names (e.g. Mexico,Colombia,Costa Rica)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Side-by-side country risk comparison"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Risk comparison between destinations — run before trip planning to pick safer alternative; chain to /api/risk/travel for selected destination",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/expat": {
      "get": {
        "summary": "Expat living guide",
        "description": "Comprehensive expat guide covering safety, healthcare quality, cost of living, visa ease, language barrier, expat community, best cities, challenges, and travel insurance links.",
        "operationId": "riskExpat",
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Country of origin (default: US)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Expat living guide with insurance referrals"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Pairs with ImmigrationPulse /api/status for visa; pairs with RemittancePulse for cross-border payments; SafetyWing expat insurance link auto-appended",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/alerts": {
      "get": {
        "summary": "Situational security alerts",
        "description": "Real-time security awareness for a current location with actionable guidance.",
        "operationId": "riskAlerts",
        "parameters": [
          {
            "name": "location",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Location"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Response language (default en)"
          }
        ],
        "responses": {
          "200": {
            "description": "Situational security alerts"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "real-time",
        "x-agent-chaining": "Pairs with /api/risk/evac when the situation is deteriorating; combine with /api/risk/country for baseline risk context",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/quake-check": {
      "get": {
        "summary": "Earthquake activity check — deterministic USGS primitive",
        "description": "Deterministic seismic-activity tick: queries the USGS FDSN event catalog near a lat/lon within a radius (or the global M5+ feed when no point is given) over the last N days, returning each event (magnitude, place, time, depth, PAGER alert, significance) plus a code-computed summary (count, max/avg magnitude, risk level). No LLM, no key, public domain.",
        "operationId": "riskQuakeCheck",
        "parameters": [
          {
            "name": "lat",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Latitude of the point of interest (omit both lat and lon for the global feed)"
          },
          {
            "name": "lon",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Longitude of the point of interest"
          },
          {
            "name": "radius_km",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number",
              "default": 500
            },
            "description": "Search radius in km (max 5000)"
          },
          {
            "name": "min_magnitude",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "Minimum magnitude (default 4.0 with a point, 5.0 global)"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 30
            },
            "description": "Lookback window in days (max 365)"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 20
            },
            "description": "Max events returned (max 100)"
          }
        ],
        "responses": {
          "200": {
            "description": "Events plus code-computed seismic summary"
          },
          "400": {
            "description": "Invalid parameters (no payment settled)"
          },
          "402": {
            "description": "Payment required"
          },
          "502": {
            "description": "USGS unavailable — transport failure, not a statement that there were no earthquakes"
          }
        },
        "x-price-usd": 0.01,
        "x-agent-use-case": "component",
        "x-agent-chaining": "Feed into /api/risk/country or /api/risk/travel for narrative context; pair with /api/risk/alerts for a current-location read",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.010000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/evac": {
      "get": {
        "summary": "Evacuation plan",
        "description": "48-hour plan with airports, embassy contacts, cash, documents, and transport options.",
        "operationId": "riskEvac",
        "parameters": [
          {
            "name": "location",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Location"
          },
          {
            "name": "nationality",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Nationality"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Response language (default en)"
          }
        ],
        "responses": {
          "200": {
            "description": "Evacuation plan"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Chain from /api/risk/alerts once a location crosses Level 3-4; travel/expat insurance links auto-appended",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/nomad": {
      "get": {
        "summary": "Digital nomad score",
        "description": "7-dimension ranking: internet, visa, cost, safety, healthcare, community, QoL.",
        "operationId": "riskNomad",
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Country"
          },
          {
            "name": "city",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "City"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Response language (default en)"
          }
        ],
        "responses": {
          "200": {
            "description": "Digital nomad score"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Pairs with /api/risk/expat for a full relocation-risk workflow",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.100000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/sanctions": {
      "get": {
        "summary": "Sanctions exposure analysis",
        "description": "OFAC, EU, and UN sanctions exposure with official screening resources.",
        "operationId": "riskSanctions",
        "parameters": [
          {
            "name": "entity",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Entity name"
          },
          {
            "name": "entity_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Entity type (person, company, vessel)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Response language (default en)"
          }
        ],
        "responses": {
          "200": {
            "description": "Sanctions exposure analysis"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.15,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Pairs with /api/risk/business for market-entry compliance workflows",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/risk/supply": {
      "get": {
        "summary": "Supply chain risk",
        "description": "Concentration risk, disruption scenarios, and diversification strategy.",
        "operationId": "riskSupply",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Product or component"
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Country"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Response language (default en)"
          }
        ],
        "responses": {
          "200": {
            "description": "Supply chain risk"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.15,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Pairs with /api/risk/business and /api/risk/sanctions for full enterprise risk workflows",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    }
  }
}