How Real-Time Fuel Price Alerts Save Transport Companies $100k/Year

Step 1: Calculate Your Break-Even Threshold

First, determine at what diesel price your routes become unprofitable. This varies by company based on your cost structure.

Step 2: Create Your Webhook Endpoint

Create a simple endpoint in your existing TMS or operations system to receive webhook alerts.

const express = require('express');
const crypto = require('crypto');

const app = express();
app.use(express.json());

app.post('/webhooks/fuel-price', (req, res) => {
  // Verify webhook signature
  const signature = req.headers['x-oilpriceapi-signature'];
  const timestamp = req.headers['x-oilpriceapi-signature-timestamp'];
  const payload = JSON.stringify(req.body);

  const expectedSig = crypto
    .createHmac('sha256', process.env.WEBHOOK_SECRET)
    .update(`${payload}.${timestamp}`)
    .digest('hex');

  if (signature !== expectedSig) {
    return res.status(401).send('Invalid signature');
  }

  // Process the alert
  const { data } = req.body;

  if (data.current_value > data.threshold_value) {
    // Diesel crossed break-even threshold
    console.log(`ALERT: Diesel at $${data.current_value}`);

    // Trigger your pricing update logic
    updateFuelSurcharge(data.current_value);
    notifyOperationsTeam(data);
  }

  res.status(200).send('OK');
});

app.listen(3000);

Step 3: Configure Your Price Alert

Use the OilPriceAPI to create your alert with custom thresholds and metadata.

curl -X POST "https://api.oilpriceapi.com/v1/alerts" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "price_alert": {
      "name": "Diesel Break-Even Alert",
      "commodity_code": "DIESEL_USD",
      "condition_operator": "greater_than",
      "condition_value": 4.00,
      "webhook_url": "https://your-tms.com/webhooks/fuel-price",
      "metadata": {
        "route_type": "long_haul",
        "alert_purpose": "profitability_threshold",
        "created_by": "operations_manager"
      },
      "cooldown_minutes": 60,
      "enabled": true
    }
  }'

Step 4: Test Your Integration

Before going live, test that your webhook endpoint correctly receives and processes alerts.

curl -X POST "https://api.oilpriceapi.com/v1/alerts/{alert_id}/test" \
  -H "Authorization: Token YOUR_API_KEY"

This sends a test webhook to your endpoint with sample data. Verify that your system receives it, validates the signature, and triggers your pricing update logic correctly.

How do fuel price alerts save transport companies money?

Fuel price alerts enable you to adjust route pricing immediately when diesel crosses profitability thresholds. By automating this monitoring, you avoid operating routes at a loss and can optimize surcharges in real-time. Transport companies typically save $50,000-$100,000+ annually by eliminating stale pricing losses.

What is the ROI of automated fuel price monitoring?

For a mid-sized transport company with 500+ routes, the ROI calculation is: 700 gallons per job × $0.50 savings per gallon × 200 jobs = $70,000 in direct savings. Adding labor savings ($20k) and efficiency gains ($25k) totals $115,000 annually. With API costs of $1,548/year, that's a 7,400% ROI or 74× return on investment.

How fast do fuel price alerts deliver?

Webhooks deliver fuel price alerts within 10 seconds of detecting a price change that crosses your threshold. This near-instant notification enables you to make real-time pricing decisions before competitors react to market changes. The system checks diesel prices automatically on each source update.

Can I set different fuel price thresholds for different routes?

Yes. The API allows you to create up to 25 webhook endpoints with custom thresholds, metadata, and webhook URLs. You can set different break-even points for short-haul vs long-haul routes, or by geographic region, customer contract, or any other criteria. Each alert can include custom metadata like job IDs or contract numbers.

How do I integrate webhooks with my existing TMS?

Webhooks are just HTTP POST requests sent to an endpoint you configure in your TMS. Most modern transportation management systems support webhook integrations. You create a simple endpoint that receives the price alert (with HMAC signature verification), then triggers your existing pricing update logic. Implementation typically takes 1-2 hours.

What happens if the webhook fails to deliver?

The system automatically retries failed webhooks with exponential backoff (1 second, 5 seconds, 25 seconds). This provides a 99.5% delivery success rate even if your server has temporary issues. All webhook attempts are logged for debugging, and you can view delivery status in your dashboard.

Can I get alerts via email instead of webhooks?

Yes. While webhooks are recommended for TMS integration (automated pricing updates), you can also configure email alerts for manual notification to operations managers. However, webhooks provide the fastest response time (10 seconds vs minutes) and enable full automation.

Which fuel commodities can I monitor?

The API provides real-time monitoring for US Diesel, WTI Crude Oil, Brent Crude Oil, Natural Gas, Gasoline (unleaded), Heating Oil, and Jet Fuel. You can set alerts on any of these commodities or combinations (for spread monitoring between WTI and Brent, for example).