bunkerInsightsGetTimeseriesEstimates

LFO price estimates across all major bunkering hubs for a three-day window (26 to 28 May 2026), at a medium confidence level. Used to track how prices move across the global hub network over time: trend identification, port comparison, and price history for planning or reporting workflows.

Request

JSON

{
  "query": "query GetTimeseries($input: BunkerInsightsGetTimeseriesEstimatesInput!) { bunkerInsightsGetTimeseriesEstimates(input: $input) }",
  "variables": {
    "input": {
      "fuelType": "LFO",
      "fromDate": "2026-05-26",
      "toDate": "2026-05-28",
      "riskLevel": "Medium"
    }
  }
}

Response (truncated to first record)

JSON

{
  "data": {
    "bunkerInsightsGetTimeseriesEstimates": {
      "totalRecords": 54,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 1000,
      "hasNext": false,
      "hasPrevious": false,
      "data": [
        {
          "estimateDate": "2026-05-26",
          "estimateGeneratedOn": "2026-05-25",
          "timeseriesAvailableFromUTC": "2026-06-09 04:55:05.353945+00:00",
          "port": "NEW ORLEANS",
          "portUnlocode": "USMSY",
          "aiInferredUnlocode": false,
          "estimateUSDperMT": 825.45,
          "sensitivityToMarketConditionsUSDperMT": 1.92,
          "probabilityOfUnderEstimationPct": 51,
          "probabilityOfOverEstimationPct": 49,
          "lowPriceEstimateUSDperMT": 800.69,
          "highPriceEstimateUSDperMT": 883.23,
          "latitude": 30.0554,
          "longitude": -90.0748
        }
      ]
    }
  }
}

Full response has 54 records total (18 hubs across 3 days) for this example query.

GraphQL form

GraphQL

query BunkerInsightsGetTimeseriesEstimates {
  bunkerInsightsGetTimeseriesEstimates(input: {
    fuelType: "LFO"
    fromDate: "2026-05-26"
    toDate: "2026-05-28"
    riskLevel: "Medium"
  })
}

Input fields: BunkerInsightsGetTimeseriesEstimatesInput

Field	Type	Required	Notes
`fromDate`	string (YYYY-MM-DD)	No	Inclusive start of range. On or after 2018-01-01. Defaults to 2018-01-01
`toDate`	string (YYYY-MM-DD)	No	Inclusive end of range. On or after 2018-01-01 and on or after `fromDate`
`fuelType`	string	Yes	HFO, LFO, or MDO
`riskLevel`	enum: High, Low, Medium	No	Mapped internally to Low=0.1, Medium=0.5, High=0.9. Defaults to Medium
`page`	integer	No	1-based page number
`pageSize`	integer	No	Records per page, caps at 10000

Response fields: BunkerInsightsGetTimeseriesEstimatesOutput_Data

Field	Type	Notes
`estimateDate`	string	Date the estimate applies to
`estimateGeneratedOn`	string	Date the model generated this estimate
`timeseriesAvailableFromUTC`	string	UTC timestamp from which this estimate became visible to clients
`port`	string	Port name
`portUnlocode`	string	UN/LOCODE for the port
`aiInferredUnlocode`	boolean	True if AI-inferred rather than supplied directly
`estimateUSDperMT`	number	Estimated price, USD per metric tonne
`sensitivityToMarketConditionsUSDperMT`	number	Estimated USD/MT change from recent market volatility
`probabilityOfUnderEstimationPct`	integer	Probability the estimate is lower than the realised price
`probabilityOfOverEstimationPct`	integer	Probability the estimate is higher than the realised price
`lowPriceEstimateUSDperMT`	number	Lower bound of the estimate band
`highPriceEstimateUSDperMT`	number	Upper bound of the estimate band
`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}