Catalog/data-fuel-prices

Data

Per-country fuel prices (normalized snapshot) API

Returns retail pump prices (gasoline and diesel) for a country from a curated in-module snapshot, normalized into one schema and enriched: prices in both USD/litre and USD/gallon, each fuel's deviation from the global average, and the country's expensiveness rank. The value-add: converting units, deriving comparisons, and ranking so a bare country name returns a comparable, contextualized price record. Answers 'gas price in Germany', 'diesel cost per gallon in Japan', 'how expensive is fuel here vs the world average', 'cheapest country for petrol'.

Price$0.01per request
MethodPOST
Route/v1/data/fuel-prices
StatusLive
MIME typeapplication/json
Rate limit60/minute
CacheNo cache
datafuelgas-pricespetroldieselgasolineenergypump-price
API URLhttps://x402.hexl.dev/v1/data/fuel-prices
Integration docs
Example request
{
  "country": "Germany"
}
Example response
{
  "country": "Germany",
  "countryCode": "DE",
  "currency": "USD",
  "gasoline": {
    "perLitre": 1.9,
    "perGallon": 7.192,
    "vsGlobalAvgPercent": 45.478
  },
  "diesel": {
    "perLitre": 1.79,
    "perGallon": 6.776,
    "vsGlobalAvgPercent": 43.699
  },
  "globalAverageGasolinePerLitre": 1.306,
  "globalAverageDieselPerLitre": 1.246,
  "expensivenessRank": 10,
  "countriesInSnapshot": 53,
  "snapshotPeriod": "2025-Q1"
}
Input schema
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "examples": [
        "Germany",
        "DE",
        "United States",
        "JP"
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}