World Chaos Map Docs
Loading...
Open map

Frequently Asked Questions

Quick answers to common questions about World Chaos Map.

What is World Chaos Map?

A real-time visualization of global instability. Each country gets a 0–100 pressure score based on aggregated incident signals (conflicts, disasters, protests, cyber attacks, etc.). The map uses color bands to show which regions are under stress.

What does the score mean?

The score represents "pressure" — an abstract measure of instability signals. It's not a prediction or safety index. Higher scores mean more recent activity detected.

0–29 Stable 30–59 Moderate 60–84 Unstable 85–100 Severe
How often does it update?

The ingestion pipeline runs every 6 hours (01:00, 07:00, 13:00, 19:00 UTC). Scores combine fresh incidents with decayed historical pressure and asymmetric continuity rules.

Where is the data from?

Structured APIs (USGS, GDACS, ReliefWeb, WHO, GDELT) plus curated RSS feeds from major news outlets, humanitarian orgs, and conflict monitors.

View all sources →
How accurate is it?

The system detects signals, not ground truth. High-profile conflicts are well-tracked; localized civil unrest may lag. Accuracy varies by country based on source coverage.

Why is event X not reflected?

Possible reasons:

  • Event not yet in our feeds
  • Duplicate detection merged it with similar incident
  • Keywords triggered demotion (sports, anniversaries)

Note: Score increases appear immediately, but decreases are gradual (max −8/day) to prevent sudden drops during de-escalation.

Can I use this commercially?

The map and docs are free to view. For commercial API access or white-label licensing, contact shaw@worldchaosmap.app.

Is there a public API?

Not yet. A read-only API for scores and incidents is planned. Check back on the Changelog for updates.

Have more questions?

Reach out directly or browse the methodology.