# Vextorium Spain Fuel Prices by Province

> Vextorium Spain 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-18).

Returns current fuel prices (average, min, max) per Spanish province and national average for a specified fuel type, sourced from the Spanish Ministry for the Ecological Transition.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/spain-fuel-prices-by-province?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-spain-fuel-prices-by-province-e9671a46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DxmdY5uUQTUongMtXp1-Q

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 vextorium-spain-fuel-prices-by-province-e9671a46 -d '<json body>'
```

Example prompt: What are the current diesel prices across all Spanish provinces, including the cheapest, most expensive, and national average?

## When to prefer this

Use this endpoint when you need official, government-sourced fuel price data broken down by Spanish province, including per-province min/max/average and a national benchmark. Prefer this over general web scraping when you need structured, reliable, up-to-date data directly from the Spanish Ministry. Ideal for logistics cost calculations, route planning in Spain, price monitoring dashboards, or consumer comparison tools focused on the Spanish fuel market.

## Known failure modes

- Invalid or unsupported fuel type enum value returns a validation error
- Ministry data source temporarily unavailable may result in stale or empty data
- Missing required 'fuel' field in request body causes a schema validation error
- Network timeout or upstream API downtime returns a 5xx error

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object containing the requested fuel type, the data source (Spanish Ministry for the Ecological Transition), last updated timestamp, a national average price, and an array of province-level entries each with province name, average price, minimum price, maximum price, and number of stations reporting.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fuel": {
   "enum": [
    "gasoline95",
    "gasoline98",
    "diesel",
    "diesel_premium",
    "lpg",
    "cng",
    "adblue",
    "hydrogen"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuel": "diesel",
  "source": "Spanish Ministry for the Ecological Transition (fuel Geoportal)",
  "updated": "02/10/2026 17:21:04",
  "provinces": [
   {
    "avg": 1.565,
    "max": 1.567,
    "min": 1.555,
    "province": "Melilla",
    "stations": 12
   },
   {
    "avg": 1.673,
    "max": 1.819,
    "min": 1.527,
    "province": "Palmas (Las)",
    "stations": 252
   }
  ],
  "national_avg": 1.915
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-spain-fuel-prices-by-province-e9671a46/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)