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).