{ "service": "ProofPrice", "purpose": "Real prices actually paid, from official records, in one place for AI agents.", "tools": [ { "name": "pricepaid_car_prices", "rest": "/api/v1/cars", "countries": [ "SG" ] }, { "name": "pricepaid_fuel_prices_now", "rest": "/api/v1/fuel", "countries": [ "ES", "FR", "IT" ] }, { "name": "pricepaid_home_sales", "rest": "/api/v1/home-sales", "countries": [ "FR", "GB (England & Wales)", "IE (Ireland)", "SG" ] } ], "sources": [ { "id": "es-fuel", "country": "ES", "category": "fuel (pump prices)", "name": "Precios de carburantes en las estaciones de servicio terrestres", "publisher": "Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de hidrocarburos), via datos.gob.es", "what_is_recorded": "Current pump price at each public filling station in Spain, by fuel type.", "price_type": "posted_pump_price", "freshness": "Several times a day", "licence": "Spanish public-sector information reuse terms (Ley 37/2007, RD 1495/2011): reuse allowed with the source and update date cited. Exact licence text to be confirmed.", "licence_url": "https://datos.gob.es/en/catalogo/e05068001-precio-de-carburantes-en-las-gasolineras-espanolas", "attribution": "Source: Ministerio para la Transición Ecológica y el Reto Demográfico – precios de carburantes (datos.gob.es).", "homepage": "https://geoportalgasolineras.es/", "limits": "Posted pump prices, not individual receipts. Restricted-sale stations are excluded." }, { "id": "fr-dvf", "country": "FR", "category": "home sales", "name": "Demandes de valeurs foncières (DVF), geo-dvf per-commune files", "publisher": "Direction générale des Finances publiques (DGFiP), files prepared by Etalab", "what_is_recorded": "Property sales recorded by French land registries: date, nature, price, type of property, built surface.", "price_type": "transaction", "freshness": "Twice a year, with a delay of several months", "licence": "Licence Ouverte / Etalab 2.0, plus the DVF reuse conditions (no re-identification of people; raw data not to be indexed by search engines)", "licence_url": "https://www.data.gouv.fr/fr/datasets/demandes-de-valeurs-foncieres/", "attribution": "Source: DGFiP, Demandes de valeurs foncières (DVF), via geo-dvf (Etalab), Licence Ouverte 2.0.", "homepage": "https://www.data.gouv.fr/fr/datasets/demandes-de-valeurs-foncieres-geolocalisees/", "limits": "We return aggregates only (median, range, count), never addresses or parcels. Alsace-Moselle and Mayotte are not covered by DVF." }, { "id": "fr-fuel", "country": "FR", "category": "fuel (pump prices)", "name": "Prix des carburants en France – flux instantané v2", "publisher": "Ministère de l'Économie via data.economie.gouv.fr", "what_is_recorded": "Current pump price per litre at each filling station, by fuel type, with last-update time.", "price_type": "posted_pump_price", "freshness": "About every 10 minutes", "licence": "Licence Ouverte / Etalab 2.0", "licence_url": "https://www.etalab.gouv.fr/licence-ouverte-open-licence/", "attribution": "Source: Ministère de l'Économie – prix des carburants (Licence Ouverte / Etalab 2.0).", "homepage": "https://data.economie.gouv.fr/explore/dataset/prix-des-carburants-en-france-flux-instantane-v2/", "limits": "Pump prices are what every customer pays at that station at that moment; they are posted prices, not individual receipts." }, { "id": "gb-hmlr-ppd", "country": "GB (England & Wales)", "category": "home sales", "name": "Price Paid Data", "publisher": "HM Land Registry", "what_is_recorded": "Residential property sales: price paid, completion date, property type, address.", "price_type": "transaction", "freshness": "Monthly", "licence": "Open Government Licence v3.0", "licence_url": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/", "attribution": "Contains HM Land Registry data © Crown copyright and database right. This data is licensed under the Open Government Licence v3.0.", "homepage": "https://www.gov.uk/government/statistical-data-sets/price-paid-data-downloads", "limits": "We return aggregates only (median, range, count), never individual addresses. Standard-price sales only (category A)." }, { "id": "ie-ppr", "country": "IE (Ireland)", "category": "home sales", "name": "Residential Property Price Register", "publisher": "Property Services Regulatory Authority (PSRA), Ireland", "what_is_recorded": "Residential property sales declared to Revenue for stamp duty: price paid, sale date, county, new or second-hand.", "price_type": "transaction", "freshness": "Updated about monthly; sales appear a few weeks after they happen", "licence": "Creative Commons Attribution 4.0 (PSRA open data; wording to be confirmed with the publisher)", "licence_url": "https://creativecommons.org/licenses/by/4.0/", "attribution": "Source: Property Services Regulatory Authority (PSRA), Residential Property Price Register. Licensed under CC BY 4.0.", "homepage": "https://www.propertypriceregister.ie/", "limits": "Aggregates only, by county or Dublin postal district and rolling window; never individual addresses. Excludes sales flagged 'not full market price' and records above EUR 10 million (bulk sales). New homes are usually recorded without VAT." }, { "id": "it-fuel", "country": "IT", "category": "fuel (pump prices)", "name": "Carburanti – Prezzi praticati e anagrafica degli impianti", "publisher": "Ministero delle Imprese e del Made in Italy (MIMIT), Osservaprezzi carburanti", "what_is_recorded": "Pump prices in force at 08:00 each day at every station in Italy, by fuel and service type (self or attended).", "price_type": "posted_pump_price", "freshness": "Daily (prices at 08:00 of the extraction day)", "licence": "Italian Open Data Licence v2.0 (IODL 2.0)", "licence_url": "https://www.dati.gov.it/content/italian-open-data-license-v20", "attribution": "Fonte: Ministero delle Imprese e del Made in Italy – Osservaprezzi carburanti (IODL 2.0).", "homepage": "https://www.mimit.gov.it/it/open-data/elenco-dataset/carburanti-prezzi-praticati-e-anagrafica-degli-impianti", "limits": "Posted pump prices, not individual receipts. Prices not updated in 30 days are left out." }, { "id": "sg-coe", "country": "SG", "category": "cars (Certificate of Entitlement)", "name": "COE bidding results and prices", "publisher": "Land Transport Authority via data.gov.sg", "what_is_recorded": "Result of each COE bidding exercise by vehicle category: quota, successful bids, bids received and the premium (the price every successful bidder paid).", "price_type": "transaction", "freshness": "Two bidding rounds a month; updated after each round", "licence": "Singapore Open Data Licence v1.0", "licence_url": "https://data.gov.sg/open-data-licence", "attribution": "Contains information from COE Bidding Results and Prices accessed from data.gov.sg, made available under the terms of the Singapore Open Data Licence version 1.0.", "homepage": "https://data.gov.sg/datasets/d_69b3380ad7e51aff3a7dcc84eba52b8a/view", "limits": "The COE is the legal right to own a car in Singapore for 10 years, not the car itself. One premium per bidding round and category; all successful bidders pay the same premium." }, { "id": "sg-hdb-resale", "country": "SG", "category": "home sales (public housing resale)", "name": "Resale flat prices (from Jan 2017)", "publisher": "Housing & Development Board via data.gov.sg", "what_is_recorded": "HDB resale transactions: month, town, flat type, floor area, lease, resale price.", "price_type": "transaction", "freshness": "Daily updates of registered resales", "licence": "Singapore Open Data Licence v1.0", "licence_url": "https://data.gov.sg/open-data-licence", "attribution": "Contains information from Resale flat prices accessed from data.gov.sg, made available under the terms of the Singapore Open Data Licence version 1.0.", "homepage": "https://data.gov.sg/datasets/d_8b84c4ee58e3cfc0ece0d773c8ca6abc/view", "limits": "Public housing (HDB) only; private condominium sales are a separate source (not yet included)." } ], "examples": [ "/api/v1/fuel?country=ES&area=42&fuel=diesel", "/api/v1/fuel?country=ES&postcode=28001&fuel=petrol95", "/api/v1/home-sales?country=FR&postcode=69003&property_type=apartment", "/api/v1/fuel?country=FR&postcode=75015&fuel=diesel", "/api/v1/home-sales?country=GB&town=Bristol&property_type=terraced", "/api/v1/home-sales?country=IE&town=Dublin&property_type=second-hand", "/api/v1/home-sales?country=IE&town=Dublin+6&months=24", "/api/v1/fuel?country=IT&area=MI&fuel=diesel", "/api/v1/cars?country=SG&product=coe&vehicle_class=A", "/api/v1/cars?country=SG&product=coe&vehicle_class=D&months=24", "/api/v1/home-sales?country=SG&town=Tampines", "/api/v1/home-sales?country=SG&town=Tampines&flat_type=4+ROOM" ], "rules": [ "Every answer is a range with its sample size, period, confidence, source and licence.", "No figure is published from fewer than 5 records.", "Aggregates only: no individual addresses or personal data are returned for home sales.", "Information, not a valuation or offer." ], "coming_next": [ "Verified used-phone receipts", "More countries: Taiwan, South Korea, Japan, NSW (Australia)", "Daily price history (fuel) from the ProofPrice price library" ] }