IntelligenceService

ComputeEnergyShockScenario

ComputeEnergyShockScenario computes on-demand product supply shock for a given country + chokepoint.

get/api/intelligence/v1/compute-energy-shock

Request

  • Base URL: https://api.worldmonitor.app
  • URL: https://api.worldmonitor.app/api/intelligence/v1/compute-energy-shock
  • Auth: one of:
    • API key in header X-WorldMonitor-Key
    • API key in header X-Api-Key

Query parameters

country_codestring

ISO 3166-1 alpha-2 country code for the affected energy market.

chokepoint_id'hormuz_strait' | 'malacca_strait' | 'suez' | 'bab_el_mandeb'

Chokepoint identifier to model as disrupted.

disruption_pctinteger

Percent of chokepoint flow disrupted, from 0 to 100.

fuel_mode'oil' | 'gas' | 'both'

Fuel mode to model: "oil", "gas", or "both". Defaults to "oil".

jmespathstring

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

OK

countryCodestring
chokepointIdstring
disruptionPctinteger
gulfCrudeSharenumber double
crudeLossKbdnumber double
effectiveCoverDaysinteger
assessmentstring
dataAvailableboolean
jodiOilCoverageboolean

v2 fields

comtradeCoverageboolean
ieaStocksCoverageboolean
portwatchCoverageboolean
coverageLevelstring
limitationsstring[]
degradedboolean
chokepointConfidencestring
liveFlowRationumber double

Changes

No recorded changes to this operation across all 1 revision of this API.