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