{"uid":"cap_k4z7XUupy8pdbg9C2NGuO","slug":"spain-live-fuel-prices-by-province-0fb603e5","name":"Spain Live Fuel Prices by Province","description":"Live fuel prices at every filling station in Spain (Ministry for the Ecological Transition, updated every 30 minutes): diesel, petrol 95/98, LPG, CNG, renewable diesel and AdBlue per station, by province (INE code 01-52) and optional town, with brand, address, coordinates and opening hours. Sort by price for one fuel. Spanish government open data, reuse with source and update date.","url":"https://opendata402.com/v1/fuel/es?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","required":["province"],"properties":{"fuel":{"enum":["diesel","diesel_premium","e5_95","e10_95","e5_98","lpg","cng","hvo","adblue"],"type":"string","description":"Sort by the price of this fuel (cheapest first)."},"town":{"type":"string","pattern":"^[\\p{L} '-]{2,40}$","description":"Town or municipality (part of the name)."},"limit":{"type":"string","pattern":"^([1-9]|[1-4][0-9]|50)$","description":"Max stations (default 20, max 50)."},"province":{"type":"string","pattern":"^(0[1-9]|[1-4][0-9]|5[0-2])$","description":"Spanish province INE code, e.g. 28 = Madrid, 08 = Barcelona."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P9Aqyf46JN1pPWG7m9dhq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live fuel prices (updated every 30 min) for all filling stations in a Spanish province, filterable by town and fuel type, from the official Ministry for the Ecological Transition.","exampleAgentPrompt":"What are the cheapest diesel stations in Madrid province right now — show me up to 20 results sorted by diesel price?","exampleUseCases":[{"title":"Find cheapest petrol before a road trip","prompt":"I'm driving from Seville tomorrow — can you find the cheapest petrol 95 stations in Seville province and show me the top 10 with their addresses and prices?"},{"title":"Locate CNG stations in a specific town","prompt":"Find all CNG stations in Zaragoza province, ideally in the town of Zaragoza itself — I need to know which ones carry compressed natural gas."},{"title":"Monitor LPG prices across a province","prompt":"What are the current LPG prices at filling stations in Valencia province (INE code 46)? Sort by cheapest first and show up to 50 results."}],"resultDescription":"A list of filling stations in the requested Spanish province, each including station name, brand, full address, GPS coordinates, opening hours, and prices for all available fuel types (diesel, premium diesel, E5 95, E10 95, E5 98, LPG, CNG, HVO, AdBlue). Results can be sorted by the price of a selected fuel type, cheapest first. Data is sourced from the Spanish government and updated every 30 minutes.","failureModes":["Invalid or out-of-range province INE code (must be 01–52) returns a validation error","Town name not found or too short (under 2 characters) returns no results or validation error","Unsupported fuel enum value returns a schema validation error","Limit value outside 1–50 range returns an error","Temporary unavailability of upstream Ministry data source may cause stale or empty responses"],"whenToPreferThis":"Use this endpoint when you need real-time, station-level fuel prices across Spain, queried by official province code (INE). It provides the most granular and up-to-date data sourced directly from the Spanish government, updated every 30 minutes. Prefer this over EU-wide fuel price endpoints (which give only country/region averages) when you need individual station addresses, coordinates, and opening hours for navigation or comparison. Best for Spanish-specific use cases requiring precise local pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:38:47.460Z","isFirstParty":false,"canonicalSlug":"spain-live-fuel-prices-by-province-0fb603e5"}