# Vextorium Spain Fuel Stations

> Vextorium Spain Fuel Stations is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-27).

Returns the cheapest fuel stations in a Spanish geographic zone with real-time prices, location details, and price statistics from the Spanish Ministry for the Ecological Transition.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/spain-fuel-stations?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-spain-fuel-stations-f2eab064
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o5cEpdiuw8eDZFIqHA2tO

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-stations-f2eab064 -d '<json body>'
```

Example prompt: Find the 5 cheapest gasoline95 stations within 8 km of latitude 40.4168, longitude -3.7038 in Madrid, Spain.

## When to prefer this

Use this endpoint when you need real-time Spanish fuel station prices from the official government open data source, filtered by geographic proximity (coordinates + radius) or administrative boundaries (province/municipality), and ranked by cheapest price. Prefer this over generic POI search APIs when official government pricing data and coverage of all Spanish fuel types (including LPG, CNG, hydrogen) is required.

## Known failure modes

- No stations found if coordinates or province/municipality filter returns empty results
- Invalid fuel type enum value causes request rejection
- radius outside 0.5–50 km range rejected
- limit outside 1–50 range rejected
- Missing required body fields causes validation error
- Stale data if Ministry Geoportal has not updated recently

## 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

A JSON object containing the fuel type queried, data source and update timestamp, a ranked list of cheapest stations (each with brand, address, zip, municipality, province, latitude, longitude, operating schedule, distance in km, and price in EUR/liter), plus zone-wide statistics: average, minimum, and maximum price per liter and total number of stations found in the zone.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fuel": {
   "enum": [
    "gasoline95",
    "gasoline98",
    "diesel",
    "diesel_premium",
    "lpg",
    "cng",
    "adblue",
    "hydrogen"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "description": "Stations (1-50, default 10)"
  },
  "length": {
   "type": "number"
  },
  "latitude": {
   "type": "number"
  },
  "province": {
   "type": "string"
  },
  "radio_km": {
   "type": "number",
   "description": "Search radius around coordinates (0.5-50, default 5)"
  },
  "municipality": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuel": "gasoline95",
  "source": "Spanish Ministry for the Ecological Transition (fuel Geoportal, open data)",
  "updated": "02/10/2026 17:00:33",
  "cheapest": [
   {
    "zip": "28005",
    "brand": "BALLENOIL",
    "length": -3.717528,
    "address": "RONDA SEGOVIA, 37",
    "latitude": 40.41025,
    "province": "MADRID",
    "schedule": "L-D: 24H",
    "distance_km": 1.37,
    "municipality": "Madrid",
    "price_eur_liter": 1.748
   },
   {
    "zip": "28045",
    "brand": "SHELL",
    "length": -3.702472,
    "address": "PASEO SANTA MARIA DE LA CABEZA, 90",
    "latitude": 40.397722,
    "province": "MADRID",
    "schedule": "L-D: 24H",
    "distance_km": 2.12,
    "municipality": "Madrid",
    "price_eur_liter": 1.769
   }
  ],
  "avg_price": 1.858,
  "max_price": 1.909,
  "min_price": 1.748,
  "stations_in_zone": 23
 }
}
```

## More

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