bunkerInsightsGetEstimates | Veson Help Center

Asks for today's price estimate for LFO at Singapore, for a typical mid-range (500 MT) stem size at a medium confidence level (0.5). This is the most common starting point: a caller wants to know what to expect to pay at a specific port on a specific date.

Request

JSON

{
  "query": "query GetEstimates($input: BunkerInsightsGetEstimatesInput!) { bunkerInsightsGetEstimates(input: $input) }",
  "variables": {
    "input": {
      "date": "2026-05-28",
      "fuelType": "LFO",
      "ports": ["Singapore"],
      "riskLevel": "0.5",
      "quantityLevel": "Average"
    }
  }
}

Response

JSON

{
  "data": {
    "bunkerInsightsGetEstimates": {
      "estimateGeneratedOn": "2026-05-27",
      "estimateDate": "2026-05-28",
      "data": [
        {
          "port": "SINGAPORE",
          "portUnlocode": "SGSIN",
          "aiInferredUnlocode": false,
          "quantityMT": 500,
          "referenceBunkeringHub": "SINGAPORE",
          "estimateUSDperMT": 806.77,
          "sensitivityToMarketConditionsUSDperMT": 6.55,
          "probabilityOfUnderEstimationPct": 57,
          "probabilityOfOverEstimationPct": 43,
          "lowPriceEstimateUSDperMT": 782.57,
          "highPriceEstimateUSDperMT": 863.24,
          "latitude": 1.2476,
          "longitude": 103.8362
        }
      ]
    }
  }
}

GraphQL form

GraphQL

query BunkerInsightsGetEstimates {
  bunkerInsightsGetEstimates(input: {
    date: "2026-05-28"
    fuelType: "LFO"
    ports: ["Singapore"]
    riskLevel: "0.5"
    quantityLevel: "Average"
  })
}

Input fields: BunkerInsightsGetEstimatesInput

Field	Type	Required	Notes
`date`	string (YYYY-MM-DD)	No	On or after 2018-01-01. Omit to use the model's latest available date
`fuelType`	string	Yes	HFO, LFO, or MDO
`riskLevel`	string	No	Stringified float, 0.1 to 0.9
`ports`	[string]	No	Mutually exclusive with `portUnlocodes`
`portUnlocodes`	[string]	No	Mutually exclusive with `ports`
`quantityLevel`	enum: Average, High, Low	No	Defaults to Average when omitted

Response fields: BunkerInsightsGetEstimatesOutput_Data

Field	Type	Notes
`port`	string	Port name
`portUnlocode`	string	UN/LOCODE for the port
`aiInferredUnlocode`	boolean	True if the UN/LOCODE was AI-inferred from a port name rather than supplied directly
`quantityMT`	integer	Bunker quantity used by the model
`referenceBunkeringHub`	string	Reference hub used as price baseline for this port
`estimateUSDperMT`	number	Estimated price, USD per metric tonne
`sensitivityToMarketConditionsUSDperMT`	number	Estimated USD/MT change from recent bunker and crude market volatility
`probabilityOfUnderEstimationPct`	integer	Probability the estimate is lower than the realised price. Null near 2018-01-01 where observed data is statistically insufficient
`probabilityOfOverEstimationPct`	integer	Probability the estimate is higher than the realised price. Same null condition as above
`lowPriceEstimateUSDperMT`	number	Lower bound of the estimate band. Same null condition as above
`highPriceEstimateUSDperMT`	number	Upper bound of the estimate band. Same null condition as above
`latitude`	number	Port latitude, decimal degrees, WGS84
`longitude`	number	Port longitude, decimal degrees, WGS84

_{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}