# RiskPulse

> Country risk intelligence API for travelers, expats, and businesses. Comprehensive risk profiles, travel safety assessments, business risk analysis, country comparisons, and expat guides — powered by World Bank governance data and real-time intelligence, via x402 micropayments on Base mainnet.

## Endpoints

GET /api/risk/country?country={name}
- Returns: overall risk score and label, risk across 6 dimensions (political, economic, security, health, natural disaster, legal), risks to watch, mitigants, best-for/not-recommended-for
- Price: $0.10

GET /api/risk/travel?country={name}&nationality={code}
- Returns: advisory level (1-4), crime risk, health risks, entry requirements, safe/avoid areas, emergency numbers, insurance recommendation with affiliate links
- nationality default: US
- Optional: lang
- Price: $0.08

GET /api/risk/business?country={name}&industry={optional}
- Returns: overall business risk, regulatory quality, corruption risk, rule of law, IP protection, contract enforcement, profit repatriation, key risks with mitigations, market entry tips, due diligence checklist
- Optional: industry, lang
- Price: $0.10

GET /api/risk/compare?countries={country1,country2,...}
- Returns: side-by-side comparison table, category winners (safest, best for business, best for expats, most stable), overall ranking, verdict
- 2-4 countries, comma-separated
- Optional: lang
- Price: $0.10

GET /api/risk/expat?country={name}&from={country}
- Returns: overall expat score, safety/healthcare/cost-of-living/visa-ease/language/expat-community ratings, best cities, challenges, practical tips, insurance links
- from default: US
- Optional: lang
- Price: $0.10

GET /api/risk/alerts?location={name}
- Returns: real-time situational security alerts for a current location — overall risk level, situation summary, recent incidents, risk breakdown (crime, terrorism, civil unrest, health, transportation), areas to avoid/safer areas, immediate actions
- Optional: lang
- Price: $0.10

GET /api/risk/evac?location={name}&nationality={code}
- Returns: 48-hour emergency evacuation plan — hour-by-hour actions, transportation options, nearest airports, border crossings, embassy contacts, financial/communications/documents checklists
- nationality default: US
- Optional: lang
- Price: $0.10

GET /api/risk/nomad?country={name}&city={optional}
- Returns: digital nomad score across 7 dimensions (internet, visa/legal, cost of living, safety, healthcare, community/coworking, quality of life), top pros/cons, comparable destinations
- Optional: city, lang
- Price: $0.10

GET /api/risk/sanctions?entity={name}&entity_type={optional}
- Returns: OFAC/EU/UN sanctions exposure analysis for a person, company, country, or vessel, with official screening resources — educational only, not a substitute for formal screening
- Optional: entity_type (person|company|vessel), lang
- Price: $0.15

GET /api/risk/supply?product={name}&country={optional}
- Returns: supply chain concentration risk for a product/material — top producing countries, chokepoints, disruption scenarios, alternative sources, mitigation strategies
- Optional: country (country of concern), lang
- Price: $0.15

## Payment

All endpoints use x402 protocol. No payment header → HTTP 402 with PAYMENT-REQUIRED header (0.08–0.15 USDC on Base mainnet). Send valid PAYMENT-SIGNATURE → 200 with structured JSON.

## Data Sources

- World Bank Worldwide Governance Indicators (api.worldbank.org/v2) — political stability, rule of law, corruption control, regulatory quality, government effectiveness, voice & accountability. Free, no key required.
- Tavily — real-time travel advisories, crime reports, business intelligence, expat community data
- ReliefWeb — humanitarian crisis reports and active disaster tracking
- USGS — recent seismic activity (earthquakes)
- ACLED — armed conflict event data (requires ACLED_USERNAME/ACLED_PASSWORD; not used for screening, only situational context)
- Claude Sonnet — synthesis and risk scoring

## Insurance Disclosure

Travel and expat responses include affiliate links to SafetyWing and World Nomads travel insurance when affiliate codes are configured.

## Disclaimer

For informational purposes only. Country risk conditions change rapidly. Always consult your government's official travel advisory and qualified legal/financial counsel before travel, relocation, or investment.