Country risk heuristic (TRIPWIRE)

CEV-OS / Data API / Country risk heuristic (TRIPWIRE)

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

Use this when you need a transparent heuristic country-risk score (list or one ISO2 country) with advisory level, recent incident counts and the weighted components — not an official rating.

What it is

TRIPWIRE's country-risk heuristic: a weighted sum of recent conflict/unrest, UCDP fatalities, US State / UK FCDO advisory level, GDACS hazards and CDC outbreak notices. List all scored countries or pass country=ISO2 for the component breakdown. Location is country-level only. Heuristic, not an official rating or travel warning.

Endpoints

REST: GET /v1/country-risk on https://api.cev-os.com
Legacy host (same service): GET /v1/country-risk on https://cev-os.com
MCP tool: get_country_risk on https://mcp.cev-os.com/mcp

Parameters

Query parameters for `GET /v1/country-risk`
Name	Type	Description	Constraints
`country`	string	ISO 3166-1 alpha-2: return that country's profile instead of the ranked list.	example UA; pattern ^[A-Za-z]{2}$
`min_score`	number	List only: minimum score 0-1 (default 0).	example 0.15; min 0; max 1
`limit`	integer	List only: max countries (1-300, default 50).	example 50; min 1; max 300

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/country-risk?country=UA&min_score=0.15&limit=50"

Example response

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

{
  "heuristic": true,
  "count": 1,
  "countries": [
    {
      "country": "UA",
      "country_name": "Ukraine",
      "score": 0.62,
      "band": "severe",
      "advisory_level": 4,
      "incidents_7d": 12,
      "ucdp_direction": "stable"
    }
  ]
}

Update frequency

On request from the TRIPWIRE country-risk computation (same store and layers as the signed-in map), cached 5 min.

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

Sources, license and usage

License status: cleared with attribution. Heuristic computed by cev-os from commercially usable TRIPWIRE feeds (GDELT, UCDP, USGS, GDACS, US State, UK FCDO OGL v3, CDC). Not an official rating.

Underlying sources
Source	License	commercialOk	Terms
CEV-OS TRIPWIRE country-risk heuristic	Own work (Cutting Edge Ventures): a transparent weighted heuristic over open feeds. Not an official rating.	true	—
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	—
U.S. Department of State travel advisories	US Government work (public domain)	true	—
UK Foreign, Commonwealth & Development Office	Open Government Licence v3.0	true	https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/
CDC Travelers' Health, Travel Health Notices	US Government work (public domain). No CDC endorsement implied.	true	—

Attribution (show this wherever you display the data):

Heuristic country-risk score by cev-os TRIPWIRE; not an official rating.
Inputs: The GDELT Project; UCDP (CC BY 4.0); USGS; GDACS (EC-JRC / UN OCHA), not for life-safety use; US Department of State; Contains public sector information licensed under the Open Government Licence v3.0 (FCDO); CDC Travelers' Health (no CDC endorsement).

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

Gaps

Location is country-level only.
A missing input counts as 0 and never inflates the other weights.

Disclaimer

A transparent heuristic, not an official warning, rating or travel advisory. Not for life-safety or emergency decisions.

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.