{
  "name": "greek-fuel-prices",
  "title": "Greek fuel prices by prefecture, daily",
  "description": "Daily average pump prices for every Greek prefecture since March 2017, read from the Ministry of Development's daily bulletins, with Greek refinery prices, the EU Weekly Oil Bulletin for comparison, and a model of how pump prices follow them. Updated every day.",
  "homepage": "https://despotak.github.io/greek-fuel-prices/",
  "profile": "tabular-data-package",
  "keywords": [
    "fuel prices",
    "Greece",
    "heating oil",
    "diesel",
    "gasoline",
    "open data"
  ],
  "licenses": [
    {
      "name": "other-attribution",
      "title": "Each resource keeps the terms of its source; credit the source. Model outputs: CC BY 4.0."
    }
  ],
  "contributors": [
    {
      "title": "Christos Despotakis",
      "role": "author",
      "path": "https://github.com/despotak"
    }
  ],
  "resources": [
    {
      "name": "areas",
      "path": "data/areas.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "The 51 prefectures (νομοί) and the national average, with the label the bulletins print.",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "area_id",
            "type": "string",
            "description": "Stable identifier used across the data"
          },
          {
            "name": "name_el",
            "type": "string"
          },
          {
            "name": "name_en",
            "type": "string"
          },
          {
            "name": "bulletin_label",
            "type": "string"
          }
        ],
        "missingValues": [
          ""
        ],
        "primaryKey": "area_id"
      }
    },
    {
      "name": "pump_prices",
      "path": [
        "data/pump/2017.csv",
        "data/pump/2018.csv",
        "data/pump/2019.csv",
        "data/pump/2020.csv",
        "data/pump/2021.csv",
        "data/pump/2022.csv",
        "data/pump/2023.csv",
        "data/pump/2024.csv",
        "data/pump/2025.csv",
        "data/pump/2026.csv"
      ],
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Average retail price per litre by prefecture and day, in EUR including 24% VAT, as printed in each daily bulletin. One file per year.",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "area_id",
            "type": "string",
            "description": "See areas.csv"
          },
          {
            "name": "unleaded95",
            "type": "number",
            "description": "Unleaded 95 octane (Αμόλυβδη 95)"
          },
          {
            "name": "unleaded100",
            "type": "number",
            "description": "Unleaded 100 octane (Αμόλυβδη 100)"
          },
          {
            "name": "super",
            "type": "number",
            "description": "Super (until 2022; very few stations)"
          },
          {
            "name": "diesel",
            "type": "number",
            "description": "Road diesel (Diesel κίνησης)"
          },
          {
            "name": "autogas",
            "type": "number",
            "description": "Autogas, LPG (Υγραέριο κίνησης)"
          },
          {
            "name": "heating_oil",
            "type": "number",
            "description": "Heating oil delivered to the home (Diesel θέρμανσης κατ' οίκον); 15 Oct to 30 Apr only"
          }
        ],
        "missingValues": [
          ""
        ],
        "foreignKeys": [
          {
            "fields": "area_id",
            "reference": {
              "resource": "areas",
              "fields": "area_id"
            }
          }
        ]
      }
    },
    {
      "name": "missing_days",
      "path": "data/pump/missing_days.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Days between the first and last bulletin with no data, and why.",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "reason",
            "type": "string"
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "transcribed",
      "path": "data/pump/transcribed.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Days no parser can read, typed in by hand from the bulletin's page image: twelve scanned bulletins of July-August 2020 and one with a broken text layout (27 March 2017). Each was checked against a machine reading of the page (OCR, or for 2017-03-27 the PDF's own text layer, which it matches cell for cell), against the neighbouring days, and against the national average rebuilt from the prefecture prices for unleaded 95, 100 and diesel; the rows also appear in the yearly pump files.",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "area_id",
            "type": "string",
            "description": "See areas.csv"
          },
          {
            "name": "unleaded95",
            "type": "number",
            "description": "Unleaded 95 octane (Αμόλυβδη 95)"
          },
          {
            "name": "unleaded100",
            "type": "number",
            "description": "Unleaded 100 octane (Αμόλυβδη 100)"
          },
          {
            "name": "super",
            "type": "number",
            "description": "Super (until 2022; very few stations)"
          },
          {
            "name": "diesel",
            "type": "number",
            "description": "Road diesel (Diesel κίνησης)"
          },
          {
            "name": "autogas",
            "type": "number",
            "description": "Autogas, LPG (Υγραέριο κίνησης)"
          },
          {
            "name": "heating_oil",
            "type": "number",
            "description": "Heating oil delivered to the home (Diesel θέρμανσης κατ' οίκον); 15 Oct to 30 Apr only"
          }
        ],
        "missingValues": [
          ""
        ],
        "foreignKeys": [
          {
            "fields": "area_id",
            "reference": {
              "resource": "areas",
              "fields": "area_id"
            }
          }
        ]
      }
    },
    {
      "name": "day_notes",
      "path": "data/pump/day_notes.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Days whose data needed care to read, and how: a garbled font map aligned to the prefecture order, a column order borrowed from a neighbouring day, a mislabelled file filed under the day its body names, a bulletin without its national average (left blank, never rebuilt), or a bulletin with no date line accepted under its filename's day after cross-checks.",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "note",
            "type": "string"
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "accepted_anomalies",
      "path": "data/pump/accepted_anomalies.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Days whose large price jumps were checked against the bulletin and accepted as published.",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "note",
            "type": "string"
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "eu_weekly_oil_bulletin",
      "path": "data/eu/weekly_oil_bulletin.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Weekly consumer prices in every EU country with and without taxes, since January 2005, as published by the European Commission in its Weekly Oil Bulletin. Changes made here: prices converted from EUR per 1,000 litres to EUR per litre; four of the six fuels kept (Euro-super 95, road diesel, heating gas oil, LPG; the two fuel oil grades left out); reshaped to one row per week, country and fuel, leaving out weeks a country reported nothing for that fuel. The taxes are the difference between the two prices. As published, Greece's heating-oil price is carried unchanged from May to mid-October, when it is not sold at the reduced rate; the dashboard leaves those weeks out.",
      "sources": [
        {
          "title": "European Commission, DG Energy, Weekly Oil Bulletin, price history (© European Union, CC BY 4.0)",
          "path": "https://energy.ec.europa.eu/data-and-analysis/weekly-oil-bulletin_en"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "country",
            "type": "string",
            "description": "Two-letter country code; EU and EUR are the Commission's own EU and euro-area averages; UK only until it left the EU"
          },
          {
            "name": "fuel",
            "type": "string",
            "description": "euro95, diesel, heating_oil or lpg"
          },
          {
            "name": "price_with_taxes",
            "type": "number",
            "description": "EUR per litre, all duties and taxes included"
          },
          {
            "name": "price_without_taxes",
            "type": "number",
            "description": "EUR per litre, net of duties and taxes"
          }
        ],
        "missingValues": [
          ""
        ]
      },
      "licenses": [
        {
          "name": "CC-BY-4.0",
          "path": "https://creativecommons.org/licenses/by/4.0/",
          "title": "Creative Commons Attribution 4.0"
        }
      ]
    },
    {
      "name": "eu_tax_rates",
      "path": "data/eu/tax_rates.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Every change of VAT, excise duty and other indirect taxes on 95, road diesel, heating gas oil and LPG in each EU country, from the European Commission's Weekly Oil Bulletin, with the date it came into force. Changes made here: excise and other taxes converted from per 1,000 litres to per litre; four of the six fuels kept; reshaped to one row per change (the source leaves a fuel's cell blank when its rate did not change). Excise and other taxes are in the currency the country used when the Commission recorded them, so Croatia (euro from 2023) and Bulgaria (from 2026) switch currency partway through; the per-component (bio/fossil) excise sheet is not included.",
      "sources": [
        {
          "title": "European Commission, DG Energy, Weekly Oil Bulletin, price history (© European Union, CC BY 4.0)",
          "path": "https://energy.ec.europa.eu/data-and-analysis/weekly-oil-bulletin_en"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date",
            "description": "Date the rate came into force"
          },
          {
            "name": "country",
            "type": "string",
            "description": "Two-letter country code (UK only until it left the EU)"
          },
          {
            "name": "fuel",
            "type": "string",
            "description": "euro95, diesel, heating_oil or lpg"
          },
          {
            "name": "tax",
            "type": "string",
            "description": "vat, excise or other_indirect"
          },
          {
            "name": "value",
            "type": "number",
            "description": "The rate: percent for VAT, an amount per litre for the others"
          },
          {
            "name": "unit",
            "type": "string",
            "description": "percent, or national currency per litre"
          }
        ],
        "missingValues": [
          ""
        ]
      },
      "licenses": [
        {
          "name": "CC-BY-4.0",
          "path": "https://creativecommons.org/licenses/by/4.0/",
          "title": "Creative Commons Attribution 4.0"
        }
      ]
    },
    {
      "name": "refinery_prices",
      "path": "data/refinery/refinery_prices.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Daily ex-refinery prices of ELPE and Motor Oil per product. 'mean' and 'mean_incl_vat' as published; 'unit' and 'basis' are the source's Greek labels, and the last three columns say the same in plain terms.",
      "sources": [
        {
          "title": "Ministry price observatory, refinery prices (ELPE, Motor Oil)",
          "path": "https://oil.gge.gov.gr"
        },
        {
          "title": "read directly from the feed behind oil.gge.gov.gr (the last ten working days)",
          "path": "https://oil-be.tcloudapp.net/api/Posts/GetLastPosts"
        },
        {
          "title": "history and backup: greek-oil-refinery-prices (AGPL-3.0 code)",
          "path": "https://github.com/akosiaris/greek-oil-refinery-prices"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "category",
            "type": "string"
          },
          {
            "name": "product",
            "type": "string"
          },
          {
            "name": "elpe",
            "type": "number"
          },
          {
            "name": "motor_oil",
            "type": "number"
          },
          {
            "name": "mean",
            "type": "number"
          },
          {
            "name": "mean_incl_vat",
            "type": "number"
          },
          {
            "name": "unit",
            "type": "string"
          },
          {
            "name": "basis",
            "type": "string"
          },
          {
            "name": "unit_code",
            "type": "string",
            "description": "m3 (prices per cubic metre, 1,000 litres) or t (per tonne)"
          },
          {
            "name": "taxes_included",
            "type": "string",
            "description": "excise_not_vat: excise and levies included, VAT not; none: before all taxes"
          },
          {
            "name": "eur_per_litre_incl_vat",
            "type": "number",
            "description": "For per-cubic-metre products: the price per litre with excise and 24% VAT, comparable to the pump price. Blank for per-tonne products: the source gives no density to convert with."
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "ecb_eurusd",
      "path": "data/international/ecb_eurusd.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "ECB euro reference rate, US dollars per euro.",
      "sources": [
        {
          "title": "European Central Bank, euro reference exchange rate (USD)",
          "path": "https://data.ecb.europa.eu/data/datasets/EXR"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "usd_per_eur",
            "type": "number"
          }
        ],
        "missingValues": [
          ""
        ]
      }
    },
    {
      "name": "model_forecast",
      "path": "data/model/forecast.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Expected change of the pump price 7 and 14 days after the latest bulletin per area and fuel (EUR/L), with the model's backtest record since 2024: mean absolute error (mae_*), the error of assuming no change (mae_naive_*), and the share of days the direction was right (hit_*) and the share a 'same as last week' guess got right (hit_momentum_*).",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        },
        {
          "title": "Ministry price observatory, refinery prices (ELPE, Motor Oil)",
          "path": "https://oil.gge.gov.gr"
        },
        {
          "title": "read directly from the feed behind oil.gge.gov.gr (the last ten working days)",
          "path": "https://oil-be.tcloudapp.net/api/Posts/GetLastPosts"
        },
        {
          "title": "history and backup: greek-oil-refinery-prices (AGPL-3.0 code)",
          "path": "https://github.com/akosiaris/greek-oil-refinery-prices"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "area_id",
            "type": "string"
          },
          {
            "name": "area",
            "type": "string"
          },
          {
            "name": "fuel",
            "type": "string"
          },
          {
            "name": "date",
            "type": "date"
          },
          {
            "name": "pump",
            "type": "number"
          },
          {
            "name": "change_7",
            "type": "number"
          },
          {
            "name": "mae_7",
            "type": "number"
          },
          {
            "name": "mae_naive_7",
            "type": "number"
          },
          {
            "name": "hit_7",
            "type": "number"
          },
          {
            "name": "hit_momentum_7",
            "type": "number"
          },
          {
            "name": "n_7",
            "type": "integer"
          },
          {
            "name": "change_14",
            "type": "number"
          },
          {
            "name": "mae_14",
            "type": "number"
          },
          {
            "name": "mae_naive_14",
            "type": "number"
          },
          {
            "name": "hit_14",
            "type": "number"
          },
          {
            "name": "hit_momentum_14",
            "type": "number"
          },
          {
            "name": "n_14",
            "type": "integer"
          }
        ],
        "missingValues": [
          ""
        ]
      },
      "licenses": [
        {
          "name": "CC-BY-4.0",
          "path": "https://creativecommons.org/licenses/by/4.0/",
          "title": "Creative Commons Attribution 4.0"
        }
      ]
    },
    {
      "name": "model_passthrough_curve",
      "path": "data/model/passthrough_curve.csv",
      "profile": "tabular-data-resource",
      "format": "csv",
      "encoding": "utf-8",
      "description": "Cumulative share of a price change passed on after 0-28 days: refinery after an international (EIA NY Harbor) move, and pump after a refinery move. Distributed-lag regression on daily data since 2019, March-June 2022 excluded.",
      "sources": [
        {
          "title": "Ministry of Development, Fuel Price Observatory: daily price bulletins per prefecture",
          "path": "https://www.fuelprices.gr/deltia_dn.view"
        },
        {
          "title": "Ministry price observatory, refinery prices (ELPE, Motor Oil)",
          "path": "https://oil.gge.gov.gr"
        },
        {
          "title": "read directly from the feed behind oil.gge.gov.gr (the last ten working days)",
          "path": "https://oil-be.tcloudapp.net/api/Posts/GetLastPosts"
        },
        {
          "title": "history and backup: greek-oil-refinery-prices (AGPL-3.0 code)",
          "path": "https://github.com/akosiaris/greek-oil-refinery-prices"
        }
      ],
      "schema": {
        "fields": [
          {
            "name": "fuel",
            "type": "string"
          },
          {
            "name": "stage",
            "type": "string"
          },
          {
            "name": "day",
            "type": "integer"
          },
          {
            "name": "share",
            "type": "number"
          }
        ],
        "missingValues": [
          ""
        ]
      },
      "licenses": [
        {
          "name": "CC-BY-4.0",
          "path": "https://creativecommons.org/licenses/by/4.0/",
          "title": "Creative Commons Attribution 4.0"
        }
      ]
    }
  ]
}
