bunkerInsightsGetScenarioEstimates

What LFO would cost at Singapore if crude oil were trading at 75 USD/barrel, regardless of where crude is actually priced today, for a 530 MT stem. A what-if tool for modelling how bunker costs change under different crude price assumptions: budget planning, contract negotiation, voyage P&L stress tests.

Request

JSON

{
  "query": "query GetScenario($input: BunkerInsightsGetScenarioEstimatesInput!) { bunkerInsightsGetScenarioEstimates(input: $input) }",
  "variables": {
    "input": {
      "date": "2026-05-28",
      "fuelType": "LFO",
      "ports": ["Singapore"],
      "crudePriceScenario": 75,
      "quantity": 530,
      "riskLevel": "0.5"
    }
  }
}

Response

JSON

{
  "data": {
    "bunkerInsightsGetScenarioEstimates": {
      "modelTrainedOn": "2026-05-27",
      "estimateScenarioDate": "2026-05-28",
      "data": [
        {
          "port": "SINGAPORE",
          "portUnlocode": "SGSIN",
          "aiInferredUnlocode": false,
          "crudePriceScenarioUSDperBarrel": 75,
          "quantityMT": 530,
          "referenceBunkeringHub": "SINGAPORE",
          "estimateUSDperMT": 787.18,
          "sensitivityToMarketConditionsUSDperMT": 2.46,
          "probabilityOfUnderEstimationPct": 57,
          "probabilityOfOverEstimationPct": 43,
          "lowPriceEstimateUSDperMT": 763.56,
          "highPriceEstimateUSDperMT": 842.28
        }
      ],
      "warnings": [],
      "substitutions": []
    }
  }
}

GraphQL form

GraphQL

query BunkerInsightsGetScenarioEstimates {
  bunkerInsightsGetScenarioEstimates(input: {
    date: "2026-05-28"
    fuelType: "LFO"
    ports: ["Singapore"]
    crudePriceScenario: 75
    quantity: 530
    riskLevel: "0.5"
  })
}

Input fields: BunkerInsightsGetScenarioEstimatesInput

Field	Type	Required	Notes
`date`	string (YYYY-MM-DD)	No	On or after 2018-01-01. Omit to use the model's default
`fuelType`	string	Yes	HFO, LFO, or MDO
`riskLevel`	string	No	Stringified float, 0.1 to 0.9
`crudePriceScenario`	number	No	Hypothetical crude oil price, USD/bbl. Omit to use the model's default scenario
`ports`	[string]	No	Mutually exclusive with `portUnlocodes`
`portUnlocodes`	[string]	No	Mutually exclusive with `ports`
`quantity`	number	No	Bunker quantity override in MT. Greater than 0, less than 5000. Omit to use the model's default

Response fields: BunkerInsightsGetScenarioEstimatesOutput

Field	Type	Notes
`modelTrainedOn`	string	Date the underlying model was last trained (UTC)
`estimateScenarioDate`	string	Target date of the estimated price
`data`	[Data]	One row per requested port. See Data fields below
`warnings`	[string]	Free-text warnings from the model. Empty unless the AI agent was triggered to resolve unrecognised ports or UN/LOCODEs
`substitutions`	[Substitution]	Port substitutions applied by the AI agent, populated only when it was triggered

Data fields: port, portUnlocode, aiInferredUnlocode, crudePriceScenarioUSDperBarrel, quantityMT, referenceBunkeringHub, estimateUSDperMT, sensitivityToMarketConditionsUSDperMT, probabilityOfUnderEstimationPct, probabilityOfOverEstimationPct, lowPriceEstimateUSDperMT, highPriceEstimateUSDperMT. Same meaning as the equivalent fields on bunkerInsightsGetEstimates.

Substitution fields: originalPort (the requested port or UN/LOCODE that was not on the standard list, and was remapped), suggestedPorts (known port(s) the AI agent used in its place).

_{CME Group market data is used under license as a source of information for certain Veson Nautical LLC (Veson) products. CME Group has no other connection to Veson products and services and does not sponsor, endorse, recommend or promote any Veson products or services. CME Group has no obligation or liability in connection with the Veson products and services. CME Group does not guarantee the accuracy and/or the completeness of any market data licensed to Veson and shall not have any liability for any errors, omissions, or interruptions therein. There are no third-party beneficiaries of any agreements or arrangements between CME Group and Veson}