Incidents tagged with affected assets (TRIPWIRE)

CEV-OS / Data API / Incidents tagged with affected assets (TRIPWIRE)

CEV-OS Data API · last updated 2026-11-04. Status: live. Version 1.

Use this when you need recent geopolitical, conflict and natural-hazard incidents mapped to the asset classes and liquid proxies they are tagged against (oil, grains, gas, semis, gold, Treasuries, country ETFs).

What it is

Incidents from TRIPWIRE built only from commercially usable feeds (GDELT, UCDP CC BY 4.0, USGS, GDACS), coarsened to country + broad region (no coordinates or place names), each with rule-based asset tags and the reason for each tag. Tags are exposures, not predictions; no prices.

Endpoints

REST: GET /v1/incident-assets on https://api.cev-os.com
Legacy host (same service): GET /v1/incident-assets on https://cev-os.com
MCP tool: get_incident_assets on https://mcp.cev-os.com/mcp

Parameters

Query parameters for `GET /v1/incident-assets`
Name	Type	Description	Constraints
`since_hours`	integer	Incidents updated in the last N hours (1-168, default 24).	example 24; min 1; max 168
`min_severity`	integer	Minimum severity 1-5.	min 1; max 5
`asset`	string	Case-insensitive substring filter on asset tags, e.g. oil, semiconductors, gold.	—
`region`	string	Region filter.	enum: Middle East, Europe, East Asia, South & Southeast Asia, Africa, Americas, Oceania, Other

Example request

No account and no key. Query values below are the examples or defaults from the registry. An optional free key (header x-api-key) raises the limits; create one at https://cev-os.com/#api_keys after signing in with a verified email (Google sign-in is already verified).

curl -s "https://api.cev-os.com/v1/incident-assets?since_hours=24"

Example response

Every /v1 response is a JSON envelope (schema_version, product, timestamps, license, attribution, data). The registry example is the data member:

{
  "count": 1,
  "incidents": [
    {
      "id": "inc_2026-10-16_ab12cd34ef",
      "type": "conflict",
      "country": "Yemen",
      "region": "Middle East",
      "severity": 4,
      "asset_tags": [
        {
          "asset": "Crude oil (WTI/Brent)",
          "kind": "commodity",
          "why": "Yemen is a major oil producer/transit route"
        }
      ]
    }
  ]
}

Update frequency

On request from the TRIPWIRE incident store (GDELT 15-min, USGS 5-min, GDACS 15-min, UCDP monthly), cached 5 min.

Public cache: 300 seconds (Cache-Control: public, max-age=300).

Sources, license and usage

License status: cleared with attribution. Only incidents whose every source is commercially usable (GDELT with citation, UCDP CC BY 4.0, USGS public domain, GDACS with attribution). Tags are cev-os's own.

Underlying sources
Source	License	commercialOk	Terms
The GDELT Project	Free, unrestricted use incl. commercial, with citation and link	true	https://www.gdeltproject.org/about.html
Uppsala Conflict Data Program (UCDP) Candidate Events	CC BY 4.0 (cite UCDP)	true	—
U.S. Geological Survey earthquakes	US Government work (public domain); credit requested	true	—
GDACS (EC-JRC / UN OCHA)	Attribution required; not for life-safety use (EC-JRC content CC BY 4.0)	true	—

Attribution (show this wherever you display the data):

The GDELT Project (https://www.gdeltproject.org/); Uppsala Conflict Data Program (UCDP), CC BY 4.0; U.S. Geological Survey; GDACS (EC-JRC / UN OCHA), not for life-safety use. Asset tagging by cev-os TRIPWIRE.

Privacy class: public-derived. Access: public. Price: free (price is null; pay-per-call is not active).

Gaps

No subsequent 1h/1d moves of the tagged proxies (needs licensed prices).
Location is deliberately coarse (country/region).

Data API hub (all products, limits, license notes)
MCP Registry listing com.cev-os/data
OpenAPI 3.1
Machine product list: /v1/products
CEV-OS TRIPWIRE incidents (explainer)

Reference data, not investment advice.