GetOilStocksAnalysis

curl --request GET \
  --url https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis \
  --header 'X-WorldMonitor-Key: <api-key>'

import requests

url = "https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis"

headers = {"X-WorldMonitor-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-WorldMonitor-Key': '<api-key>'}};

fetch('https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-WorldMonitor-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-WorldMonitor-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-WorldMonitor-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "belowObligation": [
    "example"
  ],
  "dataMonth": "example",
  "ieaMembers": [
    {
      "belowObligation": true,
      "daysOfCover": 7,
      "iso2": "US",
      "netExporter": true,
      "obligationMet": true
    }
  ],
  "regionalSummary": {
    "asiaPacific": {
      "avgDays": 7,
      "countBelowObligation": 1,
      "minDays": 7
    },
    "europe": {
      "avgDays": 7,
      "countBelowObligation": 1,
      "minDays": 7
    },
    "northAmerica": {
      "avgDays": 7,
      "netExporters": 1
    }
  },
  "unavailable": false
}

{
  "violations": [
    {
      "field": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "code": "subscription_lapsed",
  "requiredTier": 123,
  "currentTier": 123,
  "planKey": "<string>"
}

{
  "message": "<string>"
}

{
  "error": "<string>",
  "code": "renewal_verification_pending",
  "requiredTier": 123
}

{
  "message": "<string>"
}

GET

api

economic

get-oil-stocks-analysis

GetOilStocksAnalysis

curl --request GET \
  --url https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis \
  --header 'X-WorldMonitor-Key: <api-key>'

import requests

url = "https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis"

headers = {"X-WorldMonitor-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-WorldMonitor-Key': '<api-key>'}};

fetch('https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-WorldMonitor-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-WorldMonitor-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.worldmonitor.app/api/economic/v1/get-oil-stocks-analysis")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-WorldMonitor-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "belowObligation": [
    "example"
  ],
  "dataMonth": "example",
  "ieaMembers": [
    {
      "belowObligation": true,
      "daysOfCover": 7,
      "iso2": "US",
      "netExporter": true,
      "obligationMet": true
    }
  ],
  "regionalSummary": {
    "asiaPacific": {
      "avgDays": 7,
      "countBelowObligation": 1,
      "minDays": 7
    },
    "europe": {
      "avgDays": 7,
      "countBelowObligation": 1,
      "minDays": 7
    },
    "northAmerica": {
      "avgDays": 7,
      "netExporters": 1
    }
  },
  "unavailable": false
}

{
  "violations": [
    {
      "field": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "code": "subscription_lapsed",
  "requiredTier": 123,
  "currentTier": 123,
  "planKey": "<string>"
}

{
  "message": "<string>"
}

{
  "error": "<string>",
  "code": "renewal_verification_pending",
  "requiredTier": 123
}

{
  "message": "<string>"
}

Authorizations

X-WorldMonitor-Key

string

header

required

User-issued WorldMonitor API key.

Query Parameters

jmespath

string

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.

updatedAt

string

UTC ISO-8601 timestamp when this analysis was written.

dataMonth

string

Data month in YYYY-MM format (source: IEA monthly release).

ieaMembers

object[]

Show child attributes

belowObligation

string[]

ISO2 codes of countries currently below the 90-day obligation.

regionalSummary

object

OilStocksRegionalSummary holds regional aggregates for the three IEA regions.

Show child attributes

unavailable

boolean

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.