Fuel Intelligence | Freight Rate Intelligence API

curl -X POST https://freightrateintelligence.com/v1/diesel-trend \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "series": [
    {
      "region": "string",
      "label": "string",
      "data_points": 1,
      "latest_price": 1.1,
      "latest_date": "2023-01-15",
      "wow_change_pct": 1.1,
      "period_change_pct": 1.1
    }
  ],
  "analytics": {
    "national_avg": 1.1,
    "highest_region": "string",
    "lowest_region": "string",
    "spread": 1.1
  },
  "days": 1,
  "source": "EIA",
  "confidence": {
    "level": "HIGH",
    "score": 1.1,
    "label": "string",
    "factors": [
      "string"
    ]
  },
  "model_type": "DIESEL_TREND",
  "model_disclaimer": "string",
  "factor_versions": [
    {
      "source": "EIA",
      "series_id": "PET.EMD_EPD2DXL0_PTE_R30_DPG.W",
      "version": "latest",
      "fetched_at": "2024-01-15T09:30:00Z"
    }
  ]
}

PADD regional diesel price trends with week-over-week and quarter-over-quarter analytics from EIA historical data.

Authentication

AuthorizationBearer

Your Freight Rate Intelligence API key. Get one at freightrateintelligence.com/dashboard/settings

Request

This endpoint expects an object.

regionenumOptional

PADD region filter. PADD1-PADD5 or omit for all regions.

Allowed values:

daysintegerOptional7-730Defaults to 90

Lookback period in days. Default: 90 (1 quarter).

Response

Diesel trend analysis with regional comparison

serieslist of objects

Per-PADD region trend data

analyticsobject or null

Cross-region analytics (null if only 1 region)

daysinteger

Lookback period used

sourcestring

confidenceobject

model_typestring

model_disclaimerstring

factor_versionslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error