# opendata402 France Fuel Prices

> opendata402 France Fuel Prices is a paid API for AI agents from opendata402.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-15).

Returns live fuel prices (diesel, SP95, SP98, E10, E85, LPG) at French filling stations, filterable by city or postcode and sortable by fuel type.

## Facts

- Endpoint: GET https://opendata402.com/v1/fuel/fr?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/opendata402-france-fuel-prices-f688d931
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a_a6xMeirBkYF7SIl5BKK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability opendata402-france-fuel-prices-f688d931
```

Example prompt: What are the cheapest gazole stations right now in Lyon — can you show me up to 10 results sorted by diesel price?

## When to prefer this

Use this endpoint when you need live, official French government fuel price data updated every ~10 minutes across all fuel types and all stations in France. Prefer it over scraped or third-party aggregators for accuracy and legal compliance. Ideal for route planning, price comparison apps, or alerting users to local fuel shortages.

## Known failure modes

- Unknown city name returns empty results or a 404/400 error
- Invalid postcode format (not 5 digits) rejected by schema validation
- Fuel enum value misspelled causes validation error
- Limit out of range (>50 or <1) rejected
- Station data may be stale if a station hasn't reported in over 10 minutes
- No stations found in a very small commune returns empty list

## How this service works

Live fuel prices at every filling station in France (prix-carburants, updated about every 10 minutes): diesel (gazole), SP95, SP98, E10, E85 and LPG per station, by postcode or city, with address, coordinates, update time and shortages. Sort by price for one fuel. Use it for route planning and price comparison. French Ministry of Economy, Licence Ouverte 2.0.

## Output

A list of filling stations matching the query, each containing station name, full address, GPS coordinates, prices for all available fuel types (gazole, SP95, SP98, E10, E85, GPLc), last update timestamp, and shortage flags — sorted cheapest-first for the requested fuel type if specified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "city": {
       "type": "string",
       "pattern": "^[\\p{L} '-]{2,40}$",
       "description": "City name, e.g. Lyon."
      },
      "fuel": {
       "enum": [
        "gazole",
        "sp95",
        "sp98",
        "e10",
        "e85",
        "gplc"
       ],
       "type": "string",
       "description": "Sort by the price of this fuel (cheapest first)."
      },
      "limit": {
       "type": "string",
       "pattern": "^([1-9]|[1-4][0-9]|50)$",
       "description": "Max stations (default 20, max 50)."
      },
      "postcode": {
       "type": "string",
       "pattern": "^[0-9]{5}$",
       "description": "French postcode."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/opendata402-france-fuel-prices-f688d931/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opendata402.com](https://www.zero.xyz/host/opendata402.com/llms.txt)