- Conflict (ACLED) — a discrete act of political violence, armed conflict, protest, riot, or explosion that occurred.
- CAMEO+ — everything else that is a discrete event: any speech act (a threat, demand, agreement, sanction), and every non-violent event (crime, economy, corporate, technology, infrastructure, environment, health, demographic, information).
event_date, location/country, actors, a goldstein_scale
(cooperation ↔ conflict, −10..+10), and a family-specific code described below.
Conflict family (ACLED)
ACLED events form a strict containment tree:disorder_type → event_type → sub_event_type.
All three are validated together — an event can only carry a sub-type that belongs to its event
type, and a disorder type that contains it.
Filter it:
GET /api/v2/events?category=<event_type>&subcategory=<sub_event_type>. The pair
is validated — an impossible pair (e.g. category=Battles&subcategory=Peaceful protest) returns
400, never an empty 200.
CAMEO+ family
Ten domains.POLITICAL uses the numeric CAMEO 2.0 codebook (a 2-digit root with 3–4 digit
leaves); the other nine use a compact <2-letter><ordinal> scheme. You may filter on a leaf code
or, for POLITICAL, on a 2-digit root (which matches every leaf beneath it).
POLITICAL
Diplomatic, cooperative, verbal-conflict, and non-violent coercive political events Impact framing: magnitude uses the CAMEO coercion ladder (peace/truce 1 → accuse 4 → sanction/threaten-force 7-8 → use-force 9-10), and goldstein_scale carries the cooperation/conflict direction; systemic_importance asks how much the wider system depends on the government or institution acted on, not how many states are mentioned 10 · DEMAND
11 · DISAPPROVE
12 · REJECT
13 · THREATEN
15 · EXHIBIT FORCE POSTURE
16 · REDUCE RELATIONS
17 · COERCE (non-violent)
01 · MAKE PUBLIC STATEMENT
02 · APPEAL
03 · EXPRESS INTENT TO COOPERATE
04 · CONSULT
05 · ENGAGE IN DIPLOMATIC COOPERATION
06 · ENGAGE IN MATERIAL COOPERATION
07 · PROVIDE AID
08 · YIELD
09 · INVESTIGATE
CRIME
Ordinary crime, criminal justice, policing, trafficking, organized crime, and custody events Impact framing: magnitude is the realized severity of the incident on the impact tier; systemic_importance stays low for ordinary crime and rises only when the node itself matters (a central bank, a major exchange, a critical facility), not merely because the crime is seriousECONOMIC
Macroeconomic, monetary, fiscal, trade, capital flow, and market stress events Impact framing: magnitude is an impact tier (routine release 1-3 → major/systemic 7-8 → collapse 9-10); market_sensitivity is typically highest here, since a rate decision or tariff schedule can set the TERMS of a traded claimCORPORATE
Corporate structure, production, technology development, and capital allocation events Impact framing: magnitude is an impact tier scaled to deal/event size; systemic_importance asks whether others DEPEND on the company — a large firm is not automatically a systemic node, an unsubstitutable supplier isTECHNOLOGY
AI capability, military tech, cyber, space, and strategic technology control events Impact framing: magnitude is an impact tier for capability leap or disruption severity; propagation_potential reads the transmission conditions present now (shared dependency, common exposure), not a forecast of who will be hit nextINFRASTRUCTURE
Energy, transport, supply chain, communications, and water infrastructure events, including strategic buildout milestones Impact framing: magnitude uses the hazard severity tier for a realized disruption and the impact tier for a project; systemic_importance is usually the decisive metric, since infrastructure is where irreplaceability is genuinely highENVIRONMENT
Geophysical hazards, meteorological events, climate events, and environmental pollution Impact framing: magnitude is an EM-DAT-style realized-impact severity tier (1 minor local · 3 significant local · 5 severe regional · 7 major/national · 9-10 catastrophic) — NOT a scientific scale reading; a moment magnitude is used only when the event IS an earthquake and the source states oneHEALTH
Epidemic outbreaks, pandemics, vaccine milestones, health policy, and system crises Impact framing: magnitude is a realized-impact severity tier (local → national → global); propagation_potential reads observed transmission conditions rather than an inferred reproduction numberDEMOGRAPHIC
Refugee flows, migration events, population crises, and labor events Impact framing: magnitude is an impact tier scaled to the affected population; systemic_importance asks what the displaced population depends on or destabilizes, named as a specific nodeINFORMATION
Disinformation campaigns, information control, major leaks, and narrative warfare Impact framing: magnitude is an impact tier for reach and coordination; market_sensitivity is usually low because most information events touch no traded claim directlyCounts
- ACLED: 6 event types, 25 sub-types.
- CAMEO+: 10 domains. POLITICAL = 16 roots + 164 leaves; other domains = 56 codes.