Documentation

How TrackHanta works

A complete reference for the platform — what we track, where every data point comes from, how we verify signals, and how you can build on top of it.

01 · What is TrackHanta?

TrackHanta is a real-time surveillance platform for hantavirus — a family of rodent-borne viruses that cause Hantavirus Pulmonary Syndrome (HPS) and Hemorrhagic Fever with Renal Syndrome (HFRS). We aggregate verified outbreak signals from official health agencies, peer-reviewed reports, and live news, then plot them on an interactive global map.

We also track the MV Hondius, the Dutch expedition vessel linked to the December 2025 South Atlantic cluster, in real time using public AIS satellite data.

02 · Data sources

  • WHO Disease Outbreak News (DONs) — primary source for international notifications.
  • ProMED-mail — physician-reported outbreak signals, often days ahead of WHO.
  • PAHO Epidemiological Alerts — Latin America regional surveillance.
  • ECDC & CDC — Europe & US national agencies.
  • NICD South Africa — confirmed PCR results from the South Atlantic cluster.
  • Live news — Google News RSS, country-tagged and severity-classified.
  • AISStream.io — open AIS satellite feed for vessel positions.

03 · Methodology

Every case shown on the tracker meets at least one of these criteria:

  • PCR or serology-confirmed by an official lab (NICD, CDC, ANLIS, etc.)
  • Listed in a WHO DON or PAHO Epidemiological Alert
  • Reported in ≥2 independent ProMED posts or major news outlets

The map only shows signals from the last 14 days by default to reflect the active surveillance window. Severity is classified as critical / high / moderate / low based on case count, fatality rate, and geographic spread.

04 · The live tracker

The home page (/) is a full-screen Leaflet map with verified cases, exposure sites, ProMED signals, and live news mentions. Click any marker for case details, source links, and contact-tracing summaries. The live ticker streams the latest signals, and stat cards show 14-day totals, CFR, and contacts exposed.

05 · Country pages

Every affected country has a dedicated page at /country/[ISO] (e.g. /country/ZA) with confirmed/suspected/death counts, source citations, contextual notes, and strain breakdowns.

06 · MV Hondius — live AIS

The /vessel/hondius page streams real-time AIS data via AISStream.io. We listen for Position Report (type 1/2/3), Standard Class B (type 18), and Long Range AIS Broadcast (type 27) messages for MMSI 244327000, then render position, speed-over-ground, course, and heading on an interactive map.

If the live stream is quiet (vessel out of satellite coverage or transponder off), we fall back to the most recent public position. Data is cached for 60 seconds per Worker isolate.

07 · Education & prevention

  • /how-it-spreads — rodent-to-human transmission explainer
  • /prevention — practical guide for high-risk groups (campers, farm workers, travelers)
  • /history — timeline of major outbreaks since 1993
  • /faq — symptoms, incubation period, treatment, when to seek care

08 · Public API

All verified data is available via a free, CORS-enabled JSON API. See /api for the full reference. Endpoints:

  • GET /api/public/cases
  • GET /api/public/stats
  • GET /api/public/feed
  • GET /api/public/vessel/hondius

An API key is required — pass it via the x-api-key header. Rate limit: 60 req/min per IP.

To request a key, DM @TrackHanta on X. Keys are free and usually issued within 24h.

Released under CC BY 4.0 — please attribute trackhanta.com.

09 · Telegram bot

@TrackHanta_bot opens the live tracker as a Telegram Mini App and accepts commands like /status and /cases for quick check-ins on the go.

10 · Contact & contributing

Found bad data, broken sources, or want to contribute a verified signal? Reach out on X (@TrackHanta) or via Telegram. Source citations are mandatory for any contribution.