interest-rate-decisions 1.0.0__tar.gz

interest_rate_decisions-1.0.0/.gitignore

@@ -0,0 +1,17 @@
+node_modules/
+dist/
+.astro/
+.env
+.env.*
+*.log
+.DS_Store
+dist-*/
+!.env.example
+
+__pycache__/
+*.pyc
+integrations/pypi/dist/
+network/**/node_modules/
+network/**/dist/
+*.ex5
+*.ex4

interest_rate_decisions-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 InterestRateDecision.com
+
+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.

interest_rate_decisions-1.0.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.5
+Name: interest-rate-decisions
+Version: 1.0.0
+Summary: Central bank interest rates and decisions (Fed, ECB, BoE, BoJ, BoC, RBA, RBNZ, SNB, Norges Bank, Riksbank): today's rates, the next meetings and every decision since 2008.
+Project-URL: Homepage, https://interestratedecision.com/central-bank-data/
+Project-URL: Source, https://github.com/Interest-Rate-Decision/interest-rate-decisions/tree/main/python
+Author: InterestRateDecision.com
+License-Expression: MIT
+License-File: LICENSE
+Keywords: central bank,ecb,economic calendar,fed,fomc,forex,interest rates,monetary policy
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.9
+Provides-Extra: pandas
+Requires-Dist: pandas; extra == 'pandas'
+Description-Content-Type: text/markdown
+
+# interest-rate-decisions
+
+Central bank interest rates and decisions, from [InterestRateDecision.com](https://interestratedecision.com/): today's policy rates, the next meetings and every decision since 2008, for the Fed, ECB, Bank of England, Bank of Japan, Bank of Canada, RBA, RBNZ, SNB, Norges Bank and the Riksbank.
+
+Standard library only. pandas is optional.
+
+```sh
+pip install interest-rate-decisions
+interest-rate-decisions          # the next decisions and every rate
+interest-rate-decisions fed      # one bank
+```
+
+```python
+import interest_rate_decisions as ird
+
+ird.get_rate("fed")          # {'bank': 'fed', 'rate': 4.0, 'rangeLow': 3.75, 'nextDecision': ...}
+ird.get_next()               # the next decision of any bank
+ird.get_upcoming("ecb")      # the ECB's meetings to come
+ird.get_decisions("boe")     # every Bank of England decision since 2008
+
+df = ird.decisions_frame("fed")              # pip install "interest-rate-decisions[pandas]"
+df.rate.plot(drawstyle="steps-post")
+```
+
+Banks: `fed`, `ecb`, `boe`, `boj`, `boc`, `rba`, `rbnz`, `snb`, `norges`, `riksbank`. Rates are per cent; the Fed's `rate` is the top of its target range. Times are UTC. The ECB's `rate` is None before March 2015, where the source gives only its refinancing rate's change.
+
+The data updates within minutes of each decision. For the odds of the next move, charts and what each decision did to the currency, see [interestratedecision.com](https://interestratedecision.com/).
+
+## Data terms
+
+The code is MIT. The data is free to use in anything, including commercial work, **with a visible link to [InterestRateDecision.com](https://interestratedecision.com/)** ([terms](https://interestratedecision.com/central-bank-data/#licence)).

interest_rate_decisions-1.0.0/README.md

@@ -0,0 +1,31 @@
+# interest-rate-decisions
+
+Central bank interest rates and decisions, from [InterestRateDecision.com](https://interestratedecision.com/): today's policy rates, the next meetings and every decision since 2008, for the Fed, ECB, Bank of England, Bank of Japan, Bank of Canada, RBA, RBNZ, SNB, Norges Bank and the Riksbank.
+
+Standard library only. pandas is optional.
+
+```sh
+pip install interest-rate-decisions
+interest-rate-decisions          # the next decisions and every rate
+interest-rate-decisions fed      # one bank
+```
+
+```python
+import interest_rate_decisions as ird
+
+ird.get_rate("fed")          # {'bank': 'fed', 'rate': 4.0, 'rangeLow': 3.75, 'nextDecision': ...}
+ird.get_next()               # the next decision of any bank
+ird.get_upcoming("ecb")      # the ECB's meetings to come
+ird.get_decisions("boe")     # every Bank of England decision since 2008
+
+df = ird.decisions_frame("fed")              # pip install "interest-rate-decisions[pandas]"
+df.rate.plot(drawstyle="steps-post")
+```
+
+Banks: `fed`, `ecb`, `boe`, `boj`, `boc`, `rba`, `rbnz`, `snb`, `norges`, `riksbank`. Rates are per cent; the Fed's `rate` is the top of its target range. Times are UTC. The ECB's `rate` is None before March 2015, where the source gives only its refinancing rate's change.
+
+The data updates within minutes of each decision. For the odds of the next move, charts and what each decision did to the currency, see [interestratedecision.com](https://interestratedecision.com/).
+
+## Data terms
+
+The code is MIT. The data is free to use in anything, including commercial work, **with a visible link to [InterestRateDecision.com](https://interestratedecision.com/)** ([terms](https://interestratedecision.com/central-bank-data/#licence)).

interest_rate_decisions-1.0.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "interest-rate-decisions"
+version = "1.0.0"
+description = "Central bank interest rates and decisions (Fed, ECB, BoE, BoJ, BoC, RBA, RBNZ, SNB, Norges Bank, Riksbank): today's rates, the next meetings and every decision since 2008."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "InterestRateDecision.com" }]
+keywords = ["interest rates", "central bank", "fed", "fomc", "ecb", "forex", "monetary policy", "economic calendar"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Office/Business :: Financial",
+  "Topic :: Office/Business :: Financial :: Investment",
+  "Intended Audience :: Financial and Insurance Industry",
+  "Intended Audience :: Science/Research",
+]
+dependencies = []
+
+[project.optional-dependencies]
+pandas = ["pandas"]
+
+[project.scripts]
+interest-rate-decisions = "interest_rate_decisions.__main__:main"
+
+[project.urls]
+Homepage = "https://interestratedecision.com/central-bank-data/"
+Source = "https://github.com/Interest-Rate-Decision/interest-rate-decisions/tree/main/python"

interest_rate_decisions-1.0.0/src/interest_rate_decisions/__init__.py

@@ -0,0 +1,94 @@
+"""Central bank interest rates and decisions from InterestRateDecision.com.
+
+Today's policy rates, the next meetings and every decision since 2008 for the
+Fed, ECB, Bank of England, Bank of Japan, Bank of Canada, RBA, RBNZ, SNB,
+Norges Bank and the Riksbank. Standard library only; pandas is optional.
+
+Data terms: free to reuse with a visible link to https://interestratedecision.com
+"""
+
+from __future__ import annotations
+
+import csv
+import io
+import json
+import time
+import urllib.request
+from datetime import datetime, timezone
+from typing import Any, Callable, Optional
+
+__version__ = "1.0.0"
+__all__ = ["BASE", "BANKS", "get_rates", "get_rate", "get_upcoming", "get_next", "get_decisions", "parse_decisions", "decisions_frame"]
+
+BASE = "https://interestratedecision.com"
+BANKS = ("fed", "ecb", "boe", "boj", "boc", "rba", "rbnz", "snb", "norges", "riksbank")
+
+Fetch = Callable[[str], str]
+
+
+def _fetch(url: str) -> str:
+    req = urllib.request.Request(url, headers={"User-Agent": f"interest-rate-decisions-python/{__version__}"})
+    with urllib.request.urlopen(req, timeout=20) as res:
+        return res.read().decode("utf-8")
+
+
+def _get(path: str, fetch: Optional[Fetch] = None, base: str = BASE) -> str:
+    return (fetch or _fetch)(f"{base}{path}")
+
+
+def _ts(iso: str) -> float:
+    return datetime.fromisoformat(iso.replace("Z", "+00:00")).timestamp()
+
+
+def get_rates(fetch: Optional[Fetch] = None) -> list[dict[str, Any]]:
+    """Every bank's rate today (per cent; the Fed's is the top of its range, ``rangeLow`` the bottom), its last change and next decision."""
+    return json.loads(_get("/data/rates.json", fetch))["rates"]
+
+
+def get_rate(bank: str, fetch: Optional[Fetch] = None) -> dict[str, Any]:
+    """One bank's rate today."""
+    for r in get_rates(fetch):
+        if r["bank"] == bank:
+            return r
+    raise ValueError(f'unknown bank "{bank}" (one of {", ".join(BANKS)})')
+
+
+def get_upcoming(bank: Optional[str] = None, fetch: Optional[Fetch] = None) -> list[dict[str, Any]]:
+    """The decisions to come, soonest first; times (``t``) are ISO UTC."""
+    ds = json.loads(_get("/data/next.json", fetch))["decisions"]
+    ds = [d for d in ds if bank is None or d["bank"] == bank]
+    return sorted(ds, key=lambda d: _ts(d["t"]))
+
+
+def get_next(bank: Optional[str] = None, fetch: Optional[Fetch] = None) -> Optional[dict[str, Any]]:
+    """The next decision, of one bank or of any; None when none is listed."""
+    now = time.time()
+    return next((d for d in get_upcoming(bank, fetch) if _ts(d["t"]) > now - 3600), None)
+
+
+def parse_decisions(text: str) -> list[dict[str, Any]]:
+    """Rows of the decisions CSV, with ``rate`` and ``change_bp`` as numbers (None where blank)."""
+    out = []
+    for row in csv.DictReader(io.StringIO(text)):
+        out.append({
+            "bank": row["bank"],
+            "bank_name": row["bank_name"],
+            "time_utc": datetime.fromisoformat(row["time_utc"].replace("Z", "+00:00")).astimezone(timezone.utc),
+            "date": row["date"],
+            "rate": float(row["rate"]) if row["rate"] != "" else None,
+            "change_bp": int(row["change_bp"]) if row["change_bp"] != "" else None,
+        })
+    return out
+
+
+def get_decisions(bank: Optional[str] = None, fetch: Optional[Fetch] = None) -> list[dict[str, Any]]:
+    """Every decision since 2008, oldest first. The ECB's ``rate`` is None before March 2015."""
+    rows = parse_decisions(_get("/data/decisions.csv", fetch))
+    return [r for r in rows if bank is None or r["bank"] == bank]
+
+
+def decisions_frame(bank: Optional[str] = None, fetch: Optional[Fetch] = None):
+    """The decisions as a pandas DataFrame indexed by time (needs pandas)."""
+    import pandas as pd  # optional
+
+    return pd.DataFrame(get_decisions(bank, fetch)).set_index("time_utc")

interest_rate_decisions-1.0.0/src/interest_rate_decisions/__main__.py

@@ -0,0 +1,39 @@
+"""python -m interest_rate_decisions [bank] [--json]: the next decisions and every rate."""
+
+import json
+import sys
+import time
+from datetime import datetime
+
+from . import BANKS, get_rates, get_upcoming, _ts
+
+
+def _until(t: str) -> str:
+    s = _ts(t) - time.time()
+    if s <= 0:
+        return "now"
+    d, h, m = int(s // 86400), int(s % 86400 // 3600), int(s % 3600 // 60)
+    return f"{d}d {h}h" if d else f"{h}h {m}m" if h else f"{m}m"
+
+
+def main() -> None:
+    args = sys.argv[1:]
+    bank = next((a for a in args if a in BANKS), None)
+    rates = [r for r in get_rates() if bank is None or r["bank"] == bank]
+    upcoming = [d for d in get_upcoming(bank) if _ts(d["t"]) > time.time() - 3600]
+    if "--json" in args:
+        print(json.dumps({"rates": rates, "next": upcoming[:10]}, indent=2))
+        return
+    print("\nNext central bank decisions  (your time)")
+    for d in upcoming[: 4 if bank else 6]:
+        local = datetime.fromtimestamp(_ts(d["t"])).strftime("%a %d %b, %H:%M")
+        print(f"  {d['short']:<12} {local:<20}{' est.' if d['tentative'] else '     '} in {_until(d['t'])}")
+    print("\nPolicy rates")
+    for r in rates:
+        v = f"{r['rangeLow']:.2f}-{r['rate']:.2f}%" if r.get("rangeLow") is not None else f"{r['rate']:.2f}%"
+        print(f"  {r['bank']:<12} {v:<13} {r['name']}")
+    print(f"\nOdds, history and what each decision did to the currency: https://interestratedecision.com{'/' + bank + '/' if bank else ''}\n")
+
+
+if __name__ == "__main__":
+    main()

interest_rate_decisions-1.0.0/tests/test_client.py

@@ -0,0 +1,35 @@
+import json
+import unittest
+
+import interest_rate_decisions as ird
+
+FILES = {
+    "/data/rates.json": json.dumps({"rates": [{"bank": "fed", "name": "Federal Reserve", "rate": 4, "rangeLow": 3.75}]}),
+    "/data/next.json": json.dumps({"decisions": [{"bank": "ecb", "t": "2999-02-01T12:00:00Z"}, {"bank": "fed", "t": "2999-01-01T19:00:00Z"}, {"bank": "boe", "t": "2000-01-01T12:00:00Z"}]}),
+    "/data/decisions.csv": "bank,bank_name,time_utc,date,rate,change_bp\necb,European Central Bank,2008-01-10T12:45:00.000Z,2008-01-10,,\nfed,Federal Reserve,2008-01-22T13:20:00.000Z,2008-01-22,3.5,-75\n",
+}
+
+
+def fetch(url: str) -> str:
+    return FILES[url.replace(ird.BASE, "")]
+
+
+class Client(unittest.TestCase):
+    def test_rate(self):
+        self.assertEqual(ird.get_rate("fed", fetch)["rangeLow"], 3.75)
+        with self.assertRaises(ValueError):
+            ird.get_rate("xyz", fetch)
+
+    def test_next(self):
+        self.assertEqual(ird.get_next(fetch=fetch)["bank"], "fed")
+        self.assertIsNone(ird.get_next("boe", fetch))
+
+    def test_decisions(self):
+        rows = ird.get_decisions(fetch=fetch)
+        self.assertIsNone(rows[0]["rate"])
+        self.assertEqual(rows[1]["change_bp"], -75)
+        self.assertEqual(rows[1]["time_utc"].year, 2008)
+
+
+if __name__ == "__main__":
+    unittest.main()