Bunker Fuel API for
Maritime Shipping

Integration Example: Bunker Procurement Optimizer

// Find optimal bunkering port for a voyage
const optimizeBunkering = async (route, fuelNeeded, fuelType = 'vlsfo') => {
  // Get prices for all ports on route
  const portPrices = await Promise.all(
    route.ports.map(async (port) => {
      const response = await fetch(
        `https://api.oilpriceapi.com/v1/marine-fuels/${fuelType}?port=${port}`,
        { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
      );
      return response.json();
    })
  );

  // Calculate total cost at each port including deviation
  const options = portPrices.map((price, i) => ({
    port: route.ports[i],
    pricePerMT: price.price,
    totalFuelCost: price.price * fuelNeeded,
    deviationCost: route.deviationCosts[i] || 0,
    totalCost: (price.price * fuelNeeded) + (route.deviationCosts[i] || 0)
  }));

  // Sort by total cost
  const optimal = options.sort((a, b) => a.totalCost - b.totalCost)[0];

  return {
    recommendedPort: optimal.port,
    pricePerMT: optimal.pricePerMT,
    totalCost: optimal.totalCost.toFixed(2),
    savings: (options[0].totalCost - optimal.totalCost).toFixed(2),
    allOptions: options
  };
};

// Example: Singapore -> Rotterdam voyage, need 2000 MT VLSFO
const result = await optimizeBunkering(
  { ports: ['Singapore', 'Fujairah', 'Gibraltar'], deviationCosts: [0, 5000, 8000] },
  2000
);