# Spanish Fuel Prices by Province

> Spanish Fuel Prices by Province is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-10).

Returns average, minimum, and maximum fuel prices for every Spanish province, sorted cheapest to most expensive, plus the national average — updated every 30 minutes from official Ministry data.

## Facts

- Endpoint: POST https://api.vextorium.com/carburantes-provincias-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spanish-fuel-prices-by-province-072225d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IHLHOoRPtoVA0ZeB773dr

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 spanish-fuel-prices-by-province-072225d4 -d '<json body>'
```

Example prompt: What are the current diesel prices across all Spanish provinces right now — show me the average, minimum, and maximum for each one, sorted from cheapest to most expensive?

## When to prefer this

Use this endpoint when you need official, near-real-time (30-minute refresh) fuel price data for all Spanish provinces simultaneously, covering all major fuel types including GLP, GNC, and hydrogen. Prefer this over general search or scraping when you need structured, comparable province-level statistics (avg/min/max) sourced directly from the Spanish Ministry.

## Known failure modes

- Invalid or unsupported fuel type enum value returns an error
- Ministry data source temporarily unavailable may cause stale or missing data
- Missing required 'carburante' field in body causes a validation error
- Network timeout if upstream Ministry API is slow to respond

## How this service works

Average, minimum and maximum price of a fuel in every Spanish province right now, from cheapest to most expensive, with the national average. Official Ministry data updated every 30 minutes.

## Output

A JSON object containing the fuel type queried, the data source (Ministry), the last update timestamp, the national average price, and an array of all Spanish provinces each with their average, minimum, and maximum price for that fuel and the number of stations sampled — sorted from cheapest to most expensive average.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {
      "carburante": {
       "enum": [
        "gasolina95",
        "gasolina98",
        "diesel",
        "diesel_premium",
        "glp",
        "gnc",
        "adblue",
        "hidrogeno"
       ],
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "carburante": {
       "type": [
        "string",
        "null"
       ]
      },
      "provincias": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "media": {
          "type": [
           "null",
           "number"
          ]
         },
         "maximo": {
          "type": [
           "null",
           "number"
          ]
         },
         "minimo": {
          "type": [
           "null",
           "number"
          ]
         },
         "provincia": {
          "type": [
           "null",
           "string"
          ]
         },
         "estaciones": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "actualizado": {
       "type": [
        "string",
        "null"
       ]
      },
      "media_nacional": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuente": "Ministerio para la Transición Ecológica (Geoportal de carburantes)",
  "carburante": "diesel",
  "provincias": [
   {
    "media": 1.565,
    "maximo": 1.567,
    "minimo": 1.555,
    "provincia": "Melilla",
    "estaciones": 12
   },
   {
    "media": 1.673,
    "maximo": 1.819,
    "minimo": 1.527,
    "provincia": "Palmas (Las)",
    "estaciones": 252
   }
  ],
  "actualizado": "02/10/2026 17:21:04",
  "media_nacional": 1.915
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spanish-fuel-prices-by-province-072225d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)