timeprice 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8b1b427948a0943958a53ce1820f72eb27b7dc41de61c9e216194aae9c03183d
+  data.tar.gz: 5daac2f9428564420379cc33db7893a8b9dbf0f0344355c1439636e8abf647a7
+SHA512:
+  metadata.gz: 14ec61a1a5cc71b33fb0de18bbbfc19ec152697d4f8ddcd2f14cf2d739e80571512ccb067d939f60207c0b2abc2971a03f32272cd2468d273782a1022d9d0dbb
+  data.tar.gz: 5d7fae9eb6583d38f2245830aa66a0ce61fec10aa02cdec600005aea185635d0312c80a7d3bec62f0067a42651839a2af4de4d3c67335b1eb2a649dfe35b2419

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-05-11
+
+### Added
+- Initial gem release.
+- Library API: `Timeprice.inflation`, `Timeprice.exchange`, `Timeprice.compare`, returning `Data.define` value objects.
+- CLI (`timeprice`): `inflation`, `fx`, `compare`, `sources`, `version`, all with `--json`.
+- Bundled offline data for US, UK, Eurozone, Japan, Vietnam CPI and USD-base FX (EUR/GBP/JPY/VND).
+- ECB reference rates via Frankfurter; VND via World Bank annual broadcast.
+- Monthly GitHub Actions workflow that refreshes bundled data and opens a PR.
+- Golden snapshot tests against real bundled data; property-style round-trip tests for inflation and FX.
+- Attribution surfaces: `DATA_LICENSES.md`, `NOTICE`, `timeprice sources` CLI command.

data/DATA_LICENSES.md

@@ -0,0 +1,31 @@
+# Data Licenses & Attribution
+
+`timeprice` redistributes data from several public statistical agencies. The
+gem's own **code** is MIT-licensed (see `LICENSE.txt`); the **data** under
+`data/` is governed by the licenses below. If you redistribute results derived
+from this gem in a product or publication, reproduce the relevant attribution
+string.
+
+| Source | Series | License / Terms | License URL | Attribution string |
+|--------|--------|----------------|-------------|--------------------|
+| U.S. Bureau of Labor Statistics | CPI-U `CUUR0000SA0` (US CPI) | U.S. Government work — public domain. BLS asks (does not require) that BLS be cited as the source. | https://www.bls.gov/bls/linksite.htm | Data: U.S. Bureau of Labor Statistics |
+| UK Office for National Statistics | `D7BT` (UK CPI all-items) | Open Government Licence v3.0 | https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/ | Contains public sector information licensed under the Open Government Licence v3.0 |
+| Eurostat | `prc_hicp_midx` (Euro area HICP) | Eurostat reuse policy — free reuse with source attribution | https://ec.europa.eu/eurostat/about-us/policies/copyright | Source: Eurostat |
+| World Bank | `FP.CPI.TOTL` (JP CPI fallback) | Creative Commons Attribution 4.0 International (CC BY 4.0) | https://datacatalog.worldbank.org/public-licenses#cc-by | Source: World Bank, FP.CPI.TOTL |
+| World Bank | `FP.CPI.TOTL` (VN CPI) | Creative Commons Attribution 4.0 International (CC BY 4.0) | https://datacatalog.worldbank.org/public-licenses#cc-by | Source: World Bank, FP.CPI.TOTL |
+| European Central Bank (via Frankfurter) | Daily reference rates, USD base, EUR/GBP/JPY | ECB reference rates — free reuse; Frankfurter is a non-commercial republisher with no separate license | https://www.ecb.europa.eu/services/disclaimer/html/index.en.html | FX data: European Central Bank reference rates via Frankfurter |
+| World Bank | `PA.NUS.FCRF` (VND annual average FX, broadcast daily) | Creative Commons Attribution 4.0 International (CC BY 4.0) | https://datacatalog.worldbank.org/public-licenses#cc-by | VND FX: World Bank, PA.NUS.FCRF |
+
+## Notes
+
+- License URLs were last reviewed against published text at the time of v0.1.0.
+  Terms drift; if you have a stricter compliance requirement, re-check directly
+  with the publisher.
+- The Vietnam VND FX series is the **annual average** broadcast to every day in
+  the year — it is intentionally not a daily market rate. Do not use it for
+  intraday or trade-execution purposes.
+- Eurostat HICP is harmonized across the Eurozone and is **not** the same as
+  any national CPI. We use it for the `EU` country code; national CPIs are out
+  of scope for v0.1.
+- `timeprice sources` (CLI) prints these attribution strings plus the current
+  bundled coverage at runtime — useful for downstream-product compliance.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 patrick204nqh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/NOTICE

@@ -0,0 +1,12 @@
+timeprice
+Copyright (c) 2026 patrick204nqh
+
+This product redistributes public statistical data from the following sources.
+Each source retains its own license; see DATA_LICENSES.md for details and URLs.
+
+Data: U.S. Bureau of Labor Statistics
+Contains public sector information licensed under the Open Government Licence v3.0
+Source: Eurostat
+Source: World Bank, FP.CPI.TOTL
+FX data: European Central Bank reference rates via Frankfurter
+VND FX: World Bank, PA.NUS.FCRF

data/README.md

@@ -0,0 +1,187 @@
+# timeprice
+
+Offline historical inflation & FX for Ruby — bundled data, no API keys, monthly auto-refresh.
+
+[![CI](https://github.com/patrick204nqh/timeprice/actions/workflows/ci.yml/badge.svg)](https://github.com/patrick204nqh/timeprice/actions/workflows/ci.yml)
+[![Gem Version](https://img.shields.io/gem/v/timeprice.svg)](https://rubygems.org/gems/timeprice)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.2-ruby.svg)](https://www.ruby-lang.org/)
+
+## Why this exists
+
+Every other "historical inflation / FX" library wants you to wire up an API key, eat a rate
+limit, and trust that someone else's server stays up forever. `timeprice` ships the data
+in the gem. Once you `gem install timeprice`, you can answer "what was 100 USD in 1990
+worth in 2024?" with zero network calls, deterministic results, and no surprise outages.
+A monthly GitHub Action keeps the bundled data fresh; users just pin a gem version.
+
+## Install
+
+```bash
+gem install timeprice
+```
+
+Or in a `Gemfile`:
+
+```ruby
+gem "timeprice", "~> 0.1"
+```
+
+Requires Ruby >= 3.2.
+
+## CLI examples
+
+```bash
+$ timeprice inflation 100 --from 1990-01 --to 2024-01 --country US
+100.00 USD in 1990-01 is 242.09 USD in 2024-01 (US, granularity: monthly)
+
+$ timeprice fx 100 USD JPY --date 2010-06-15
+100.00 USD on 2010-06-15 = 9118.00 JPY (rate: 91.1800)
+
+$ timeprice compare 100 --from "2010 USD" --to "2024 VND"
+100.00 USD in 2010 -> 3530920.58 VND in 2024
+  steps: convert at 2010 (fx rate 18612.920000) -> 1861292.0000 VND, then inflate in VN (cpi ratio 1.897027, granularity: annual)
+```
+
+Every command supports `--json` for machine-readable output:
+
+```bash
+$ timeprice inflation 100 --from 1990-01 --to 2024-01 --country US --json
+{"amount":242.08555729984302,"original_amount":100.0,"from":"1990-01","to":"2024-01","country":"US","from_index":127.4,"to_index":308.417,"granularity":"monthly"}
+```
+
+`timeprice sources` lists every bundled data source with its license, attribution string,
+and current coverage range — derived dynamically from the bundled files.
+
+## Library examples
+
+```ruby
+require "timeprice"
+
+# Inflation adjustment
+r = Timeprice.inflation(amount: 100, from: "1990-01", to: "2024-01", country: "US")
+r.amount        # => 242.0855572998...
+r.granularity   # => :monthly
+r.to_h          # => { amount: ..., original_amount: ..., from: ..., country: ..., ... }
+
+# Historical FX
+r = Timeprice.exchange(amount: 100, from: "USD", to: "JPY", date: "2010-06-15")
+r.amount         # => 9118.0
+r.rate           # => 91.18
+r.effective_date # => "2010-06-15" (or the nearest prior trading day on weekends/holidays)
+
+# Combined: convert at source date, then inflate in destination currency
+r = Timeprice.compare(amount: 100, from: ["USD", "2010"], to: ["VND", "2024"])
+r.amount     # => 3530920.5840411717
+r.fx_rate    # => 18612.92
+r.cpi_ratio  # => 1.897026680414...
+```
+
+All result objects are `Data.define` value objects — they support `.to_h`, `==`, and
+pattern matching, so you can hand them to JSON, RSpec, or `case/in` without ceremony.
+
+## Supported countries, currencies, and data ranges
+
+Coverage is derived from the bundled `data/` files. Re-check with `timeprice sources`.
+
+| Country / Region | Currency | CPI source | Granularity | Coverage |
+|------------------|----------|------------|-------------|----------|
+| United States | USD | BLS CPI-U (`CUUR0000SA0`) | Monthly + annual | 1990-01 → present |
+| United Kingdom | GBP | ONS CPI all-items (`D7BT`) | Monthly + annual | 1988-01 → present |
+| Eurozone (EA) | EUR | Eurostat HICP (`prc_hicp_midx`) | Monthly + annual | 1996-01 → present |
+| Japan | JPY | World Bank `FP.CPI.TOTL` (fallback) | Annual | 1960 → 2024 |
+| Vietnam | VND | World Bank `FP.CPI.TOTL` | Annual | 1995 → 2024 |
+
+**FX (USD base):** ECB reference rates via Frankfurter for **EUR / GBP / JPY**, daily
+1999 → present. **VND** uses the World Bank annual average (`PA.NUS.FCRF`) broadcast to
+every day in the year, from 1983 → present.
+
+Triangulated cross-rates (e.g. GBP → JPY) go through USD on the same effective date.
+Weekend/holiday dates fall back up to 7 days to the nearest prior trading day.
+
+## Compare semantics — important
+
+This is the most important conceptual piece of the library, so it's worth reading.
+
+`Timeprice.compare(amount:, from:, to:)` follows one specific convention:
+
+> **Convert at the source date first, then inflate in the destination currency.**
+
+Concretely, for `compare(amount: 100, from: ["USD", "2010"], to: ["VND", "2024"])`:
+
+1. Convert 100 USD → VND at the **2010** FX rate (18,612.92), giving 1,861,292 VND.
+2. Inflate that VND amount from 2010 → 2024 using **Vietnam's** CPI ratio
+   (189.70 / 100.0 ≈ 1.897), giving **3,530,920.58 VND**.
+
+### Why not the other direction?
+
+The naive alternative ("inflate the 100 USD in US CPI to 2024, then convert at the 2024
+FX rate") looks reasonable but is **wrong for any high-inflation pair**. Here's why:
+
+Nominal FX rates already absorb relative inflation between the two currencies. If
+Vietnam's CPI rises 90% over a period while US CPI rises 40%, the VND will tend to
+weaken against the USD by roughly the inflation differential — that's already priced
+into the 2024 USD→VND rate. So if you inflate the USD amount in US CPI **and then**
+convert at a depreciated future VND rate, you double-count US inflation and produce a
+number that overstates the equivalent purchasing power in Vietnam.
+
+The convention used here — convert first, then inflate in the destination currency —
+preserves **purchasing-power equivalence in the destination economy**. "100 USD in 2010
+buys what 3,530,920 VND buys in 2024 in Vietnam."
+
+### Worked example with numbers
+
+Bundled data:
+- USD→VND on 2010-06-30: `18612.92`
+- VN CPI: 2010 = `100.0`, 2024 ≈ `189.70`
+- US CPI: 2010-06 ≈ `217.97`, 2024 ≈ `308.42` (US ratio ≈ 1.415)
+- USD→VND on 2024-06-30 (approx, broadcast annual): `~25,000`
+
+| Approach | Calculation | Result |
+|----------|-------------|--------|
+| **timeprice (convert → inflate)** | 100 × 18,612.92 × 1.897 | **3,530,921 VND** |
+| Naive (inflate → convert) | 100 × 1.415 × ~25,000 | ~3,537,500 VND |
+
+These happen to land near each other for the USD/VND pair, but only because the FX
+movement and inflation differential are roughly consistent here. For pairs where the
+nominal rate has moved **out of step** with inflation (currency crises, pegs, controls),
+the two approaches diverge by tens of percent. The "convert then inflate" answer is the
+one that meaningfully tracks purchasing power.
+
+If you specifically want the mechanical "inflate then convert" answer for some reason,
+do it yourself — it's two library calls:
+
+```ruby
+inflated = Timeprice.inflation(amount: 100, from: "2010", to: "2024", country: "US").amount
+converted = Timeprice.exchange(amount: inflated, from: "USD", to: "VND", date: "2024-06-30").amount
+```
+
+## Data sources & attribution
+
+`timeprice` redistributes data from several public sources. Each is governed by its own
+license — see `DATA_LICENSES.md` and `NOTICE` for the full table and license URLs.
+
+- **U.S. CPI:** Data: U.S. Bureau of Labor Statistics (public domain).
+- **UK CPI:** Contains public sector information licensed under the Open Government Licence v3.0.
+- **Eurozone HICP:** Source: Eurostat (reuse permitted with attribution).
+- **Japan CPI (fallback):** Source: World Bank, FP.CPI.TOTL (CC BY 4.0).
+- **Vietnam CPI:** Source: World Bank, FP.CPI.TOTL (CC BY 4.0).
+- **FX rates:** European Central Bank reference rates via Frankfurter.
+- **VND FX (annual broadcast):** World Bank, PA.NUS.FCRF (CC BY 4.0).
+
+If you redistribute results derived from this gem, reproduce the relevant attribution
+strings. `timeprice sources` prints them in plain text and as JSON.
+
+## Author
+
+Built by [Patrick](https://github.com/patrick204nqh).
+
+---
+
+This is a maintained-on-best-effort open source project. Bug reports and
+data-correctness issues are welcome; new-country requests will be evaluated
+case-by-case based on source availability and maintainer bandwidth. No SLA.
+
+## License
+
+Code: MIT (see `LICENSE.txt`). Data: see `DATA_LICENSES.md` — each upstream source
+retains its own license.

data/data/cpi/eu.json

@@ -0,0 +1,401 @@
+{
+  "annual": {
+    "1996": 71.742,
+    "1997": 72.867,
+    "1998": 73.671,
+    "1999": 74.482,
+    "2000": 76.048,
+    "2001": 77.829,
+    "2002": 79.581,
+    "2003": 81.237,
+    "2004": 82.979,
+    "2005": 84.788,
+    "2006": 86.638,
+    "2007": 88.488,
+    "2008": 91.383,
+    "2009": 91.649,
+    "2010": 93.135,
+    "2011": 95.663,
+    "2012": 98.053,
+    "2013": 99.378,
+    "2014": 99.807,
+    "2015": 99.999,
+    "2016": 100.234,
+    "2017": 101.776,
+    "2018": 103.562,
+    "2019": 104.8,
+    "2020": 105.064,
+    "2021": 107.783,
+    "2022": 116.82,
+    "2023": 123.154,
+    "2024": 126.066,
+    "2025": 128.752
+  },
+  "base_year": "2015=100",
+  "country": "EU",
+  "monthly": {
+    "1996-01": 70.97,
+    "1996-02": 71.29,
+    "1996-03": 71.54,
+    "1996-04": 71.66,
+    "1996-05": 71.83,
+    "1996-06": 71.84,
+    "1996-07": 71.84,
+    "1996-08": 71.8,
+    "1996-09": 71.93,
+    "1996-10": 72.0,
+    "1996-11": 72.01,
+    "1996-12": 72.19,
+    "1997-01": 72.42,
+    "1997-02": 72.59,
+    "1997-03": 72.65,
+    "1997-04": 72.6,
+    "1997-05": 72.8,
+    "1997-06": 72.83,
+    "1997-07": 72.9,
+    "1997-08": 73.02,
+    "1997-09": 73.07,
+    "1997-10": 73.09,
+    "1997-11": 73.18,
+    "1997-12": 73.26,
+    "1998-01": 73.2,
+    "1998-02": 73.4,
+    "1998-03": 73.46,
+    "1998-04": 73.61,
+    "1998-05": 73.76,
+    "1998-06": 73.8,
+    "1998-07": 73.83,
+    "1998-08": 73.85,
+    "1998-09": 73.79,
+    "1998-10": 73.77,
+    "1998-11": 73.77,
+    "1998-12": 73.81,
+    "1999-01": 73.76,
+    "1999-02": 73.94,
+    "1999-03": 74.15,
+    "1999-04": 74.4,
+    "1999-05": 74.45,
+    "1999-06": 74.45,
+    "1999-07": 74.58,
+    "1999-08": 74.67,
+    "1999-09": 74.71,
+    "1999-10": 74.74,
+    "1999-11": 74.84,
+    "1999-12": 75.09,
+    "2000-01": 75.13,
+    "2000-02": 75.37,
+    "2000-03": 75.6,
+    "2000-04": 75.67,
+    "2000-05": 75.76,
+    "2000-06": 76.04,
+    "2000-07": 76.14,
+    "2000-08": 76.2,
+    "2000-09": 76.5,
+    "2000-10": 76.52,
+    "2000-11": 76.68,
+    "2000-12": 76.96,
+    "2001-01": 76.63,
+    "2001-02": 76.86,
+    "2001-03": 77.27,
+    "2001-04": 77.73,
+    "2001-05": 78.1,
+    "2001-06": 78.21,
+    "2001-07": 78.03,
+    "2001-08": 77.97,
+    "2001-09": 78.18,
+    "2001-10": 78.24,
+    "2001-11": 78.19,
+    "2001-12": 78.54,
+    "2002-01": 78.63,
+    "2002-02": 78.76,
+    "2002-03": 79.21,
+    "2002-04": 79.56,
+    "2002-05": 79.71,
+    "2002-06": 79.67,
+    "2002-07": 79.59,
+    "2002-08": 79.64,
+    "2002-09": 79.84,
+    "2002-10": 80.03,
+    "2002-11": 79.97,
+    "2002-12": 80.36,
+    "2003-01": 80.3,
+    "2003-02": 80.62,
+    "2003-03": 81.08,
+    "2003-04": 81.21,
+    "2003-05": 81.15,
+    "2003-06": 81.25,
+    "2003-07": 81.13,
+    "2003-08": 81.25,
+    "2003-09": 81.54,
+    "2003-10": 81.66,
+    "2003-11": 81.7,
+    "2003-12": 81.95,
+    "2004-01": 81.75,
+    "2004-02": 81.94,
+    "2004-03": 82.46,
+    "2004-04": 82.88,
+    "2004-05": 83.14,
+    "2004-06": 83.18,
+    "2004-07": 83.0,
+    "2004-08": 83.17,
+    "2004-09": 83.26,
+    "2004-10": 83.59,
+    "2004-11": 83.53,
+    "2004-12": 83.85,
+    "2005-01": 83.32,
+    "2005-02": 83.62,
+    "2005-03": 84.25,
+    "2005-04": 84.6,
+    "2005-05": 84.78,
+    "2005-06": 84.87,
+    "2005-07": 84.78,
+    "2005-08": 84.98,
+    "2005-09": 85.42,
+    "2005-10": 85.64,
+    "2005-11": 85.45,
+    "2005-12": 85.74,
+    "2006-01": 85.35,
+    "2006-02": 85.59,
+    "2006-03": 86.09,
+    "2006-04": 86.66,
+    "2006-05": 86.89,
+    "2006-06": 86.96,
+    "2006-07": 86.85,
+    "2006-08": 86.93,
+    "2006-09": 86.93,
+    "2006-10": 87.0,
+    "2006-11": 87.03,
+    "2006-12": 87.37,
+    "2007-01": 86.92,
+    "2007-02": 87.17,
+    "2007-03": 87.75,
+    "2007-04": 88.31,
+    "2007-05": 88.52,
+    "2007-06": 88.61,
+    "2007-07": 88.39,
+    "2007-08": 88.45,
+    "2007-09": 88.78,
+    "2007-10": 89.21,
+    "2007-11": 89.69,
+    "2007-12": 90.05,
+    "2008-01": 89.7,
+    "2008-02": 90.02,
+    "2008-03": 90.9,
+    "2008-04": 91.19,
+    "2008-05": 91.76,
+    "2008-06": 92.11,
+    "2008-07": 91.97,
+    "2008-08": 91.84,
+    "2008-09": 92.01,
+    "2008-10": 92.04,
+    "2008-11": 91.59,
+    "2008-12": 91.47,
+    "2009-01": 90.71,
+    "2009-02": 91.08,
+    "2009-03": 91.42,
+    "2009-04": 91.75,
+    "2009-05": 91.8,
+    "2009-06": 91.98,
+    "2009-07": 91.38,
+    "2009-08": 91.69,
+    "2009-09": 91.71,
+    "2009-10": 91.92,
+    "2009-11": 92.03,
+    "2009-12": 92.32,
+    "2010-01": 91.57,
+    "2010-02": 91.85,
+    "2010-03": 92.87,
+    "2010-04": 93.25,
+    "2010-05": 93.35,
+    "2010-06": 93.35,
+    "2010-07": 92.95,
+    "2010-08": 93.14,
+    "2010-09": 93.43,
+    "2010-10": 93.71,
+    "2010-11": 93.79,
+    "2010-12": 94.36,
+    "2011-01": 93.68,
+    "2011-02": 94.08,
+    "2011-03": 95.35,
+    "2011-04": 95.88,
+    "2011-05": 95.89,
+    "2011-06": 95.88,
+    "2011-07": 95.33,
+    "2011-08": 95.51,
+    "2011-09": 96.21,
+    "2011-10": 96.55,
+    "2011-11": 96.63,
+    "2011-12": 96.96,
+    "2012-01": 96.17,
+    "2012-02": 96.65,
+    "2012-03": 97.9,
+    "2012-04": 98.36,
+    "2012-05": 98.22,
+    "2012-06": 98.15,
+    "2012-07": 97.63,
+    "2012-08": 98.01,
+    "2012-09": 98.72,
+    "2012-10": 98.95,
+    "2012-11": 98.76,
+    "2012-12": 99.11,
+    "2013-01": 98.08,
+    "2013-02": 98.44,
+    "2013-03": 99.6,
+    "2013-04": 99.51,
+    "2013-05": 99.62,
+    "2013-06": 99.73,
+    "2013-07": 99.2,
+    "2013-08": 99.32,
+    "2013-09": 99.8,
+    "2013-10": 99.68,
+    "2013-11": 99.6,
+    "2013-12": 99.95,
+    "2014-01": 98.83,
+    "2014-02": 99.14,
+    "2014-03": 100.07,
+    "2014-04": 100.22,
+    "2014-05": 100.11,
+    "2014-06": 100.22,
+    "2014-07": 99.57,
+    "2014-08": 99.68,
+    "2014-09": 100.12,
+    "2014-10": 100.06,
+    "2014-11": 99.88,
+    "2014-12": 99.78,
+    "2015-01": 98.24,
+    "2015-02": 98.85,
+    "2015-03": 100.0,
+    "2015-04": 100.43,
+    "2015-05": 100.71,
+    "2015-06": 100.72,
+    "2015-07": 100.11,
+    "2015-08": 100.12,
+    "2015-09": 100.32,
+    "2015-10": 100.45,
+    "2015-11": 100.01,
+    "2015-12": 100.03,
+    "2016-01": 98.56,
+    "2016-02": 98.73,
+    "2016-03": 99.96,
+    "2016-04": 100.17,
+    "2016-05": 100.59,
+    "2016-06": 100.77,
+    "2016-07": 100.28,
+    "2016-08": 100.34,
+    "2016-09": 100.72,
+    "2016-10": 100.96,
+    "2016-11": 100.6,
+    "2016-12": 101.13,
+    "2017-01": 100.26,
+    "2017-02": 100.66,
+    "2017-03": 101.49,
+    "2017-04": 102.07,
+    "2017-05": 101.98,
+    "2017-06": 102.08,
+    "2017-07": 101.62,
+    "2017-08": 101.89,
+    "2017-09": 102.29,
+    "2017-10": 102.34,
+    "2017-11": 102.14,
+    "2017-12": 102.49,
+    "2018-01": 101.56,
+    "2018-02": 101.78,
+    "2018-03": 102.91,
+    "2018-04": 103.32,
+    "2018-05": 103.97,
+    "2018-06": 104.09,
+    "2018-07": 103.85,
+    "2018-08": 104.01,
+    "2018-09": 104.42,
+    "2018-10": 104.68,
+    "2018-11": 104.1,
+    "2018-12": 104.05,
+    "2019-01": 102.97,
+    "2019-02": 103.3,
+    "2019-03": 104.35,
+    "2019-04": 105.1,
+    "2019-05": 105.24,
+    "2019-06": 105.41,
+    "2019-07": 104.91,
+    "2019-08": 105.06,
+    "2019-09": 105.29,
+    "2019-10": 105.44,
+    "2019-11": 105.1,
+    "2019-12": 105.43,
+    "2020-01": 104.37,
+    "2020-02": 104.56,
+    "2020-03": 105.13,
+    "2020-04": 105.43,
+    "2020-05": 105.33,
+    "2020-06": 105.69,
+    "2020-07": 105.32,
+    "2020-08": 104.88,
+    "2020-09": 104.96,
+    "2020-10": 105.15,
+    "2020-11": 104.8,
+    "2020-12": 105.15,
+    "2021-01": 105.32,
+    "2021-02": 105.54,
+    "2021-03": 106.53,
+    "2021-04": 107.14,
+    "2021-05": 107.42,
+    "2021-06": 107.7,
+    "2021-07": 107.6,
+    "2021-08": 107.98,
+    "2021-09": 108.49,
+    "2021-10": 109.41,
+    "2021-11": 109.9,
+    "2021-12": 110.37,
+    "2022-01": 110.7,
+    "2022-02": 111.74,
+    "2022-03": 114.46,
+    "2022-04": 115.11,
+    "2022-05": 116.07,
+    "2022-06": 117.01,
+    "2022-07": 117.14,
+    "2022-08": 117.85,
+    "2022-09": 119.26,
+    "2022-10": 121.03,
+    "2022-11": 120.95,
+    "2022-12": 120.52,
+    "2023-01": 120.27,
+    "2023-02": 121.24,
+    "2023-03": 122.34,
+    "2023-04": 123.12,
+    "2023-05": 123.15,
+    "2023-06": 123.47,
+    "2023-07": 123.36,
+    "2023-08": 124.03,
+    "2023-09": 124.43,
+    "2023-10": 124.54,
+    "2023-11": 123.85,
+    "2023-12": 124.05,
+    "2024-01": 123.6,
+    "2024-02": 124.37,
+    "2024-03": 125.31,
+    "2024-04": 126.04,
+    "2024-05": 126.31,
+    "2024-06": 126.58,
+    "2024-07": 126.54,
+    "2024-08": 126.72,
+    "2024-09": 126.6,
+    "2024-10": 127.03,
+    "2024-11": 126.62,
+    "2024-12": 127.07,
+    "2025-01": 126.72,
+    "2025-02": 127.26,
+    "2025-03": 128.04,
+    "2025-04": 128.77,
+    "2025-05": 128.7,
+    "2025-06": 129.09,
+    "2025-07": 129.12,
+    "2025-08": 129.31,
+    "2025-09": 129.42,
+    "2025-10": 129.7,
+    "2025-11": 129.33,
+    "2025-12": 129.56
+  },
+  "schema_version": 1,
+  "source": "Eurostat prc_hicp_midx (HICP, EA all current members, CP00, 2015=100)",
+  "updated_at": "2026-05-11"
+}