bunkerInsightsGetEstimates

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