GetOilStocksAnalysis
GetOilStocksAnalysis retrieves the IEA oil stocks days-of-cover ranking and regional summary.
Authorizations
User-issued WorldMonitor API key.
Query Parameters
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
Successful response
GetOilStocksAnalysisResponse contains the IEA oil stocks days-of-cover analysis.
UTC ISO-8601 timestamp when this analysis was written.
Data month in YYYY-MM format (source: IEA monthly release).
ISO2 codes of countries currently below the 90-day obligation.
OilStocksRegionalSummary holds regional aggregates for the three IEA regions.
True when upstream seed data is unavailable (fallback result). True when the upstream or seed-backed variant is unavailable; empty payload fields are graceful degradation, not confirmed zero data.
