# 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

## Payment

All endpoints use x402 protocol. No payment header → HTTP 402 with PAYMENT-REQUIRED header (0.08–0.10 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
- 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.