@fin.cx/opendata 4.1.0 → 4.2.0

package/.smartconfig.json

@@ -5,7 +5,7 @@
       "githost": "gitlab.com",
       "gitscope": "fin.cx",
       "gitrepo": "opendata",
-      "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, and stock and crypto prices and fundamentals from several providers.",
+      "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, and stock and crypto prices and fundamentals from several providers.",
       "npmPackagename": "@fin.cx/opendata",
       "license": "MIT",
       "projectDomain": "fin.cx",
@@ -25,7 +25,9 @@
         "fundamentals",
         "public holidays",
         "Feiertage",
-        "working days"
+        "working days",
+        "Basiszinssatz",
+        "base rate"
       ]
     },
     "release": {

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@fin.cx/opendata',
-    version: '4.1.0',
-    description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, and stock and crypto prices and fundamentals from several providers.'
+    version: '4.2.0',
+    description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, and stock and crypto prices and fundamentals from several providers.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHdRQUF3UTtDQUN0UixDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLG9TQUFvUztDQUNsVCxDQUFBIn0=

package/dist_ts/baserate/baserate.d.ts

@@ -0,0 +1,9 @@
+import type { IBaseRatePeriod, IBaseRateSpan, TIsoDate } from './interfaces.js';
+/** The base rate in force on a day: the published period that contains it. */
+export declare const getBaseRate: (dateArg: TIsoDate) => IBaseRatePeriod;
+/**
+ * A span of days, both inclusive, split where the base rate changes: one piece per published
+ * period it touches, oldest first. Interest under § 288 BGB is computed per piece, since the rate
+ * of each half-year applies to the days in it.
+ */
+export declare const splitByBaseRate: (fromArg: TIsoDate, toArg: TIsoDate) => IBaseRateSpan[];

package/dist_ts/baserate/baserate.js

@@ -0,0 +1,49 @@
+import { BaseRateError } from './classes.baserateerror.js';
+import { baseRateFirstDay, baseRatePeriods, baseRatesReadOn } from './data.baserate.js';
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const checkDate = (dateArg) => {
+    const match = typeof dateArg === 'string' ? ISO_DATE.exec(dateArg) : null;
+    const utc = match ? new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]))) : null;
+    if (!match || !utc || utc.toISOString().slice(0, 10) !== dateArg) {
+        throw new BaseRateError('invalid_date', `${JSON.stringify(dateArg)} is not a calendar date written YYYY-MM-DD.`);
+    }
+};
+const addDay = (dateArg) => {
+    const utc = new Date(`${dateArg}T00:00:00Z`);
+    utc.setUTCDate(utc.getUTCDate() + 1);
+    return utc.toISOString().slice(0, 10);
+};
+/** The base rate in force on a day: the published period that contains it. */
+export const getBaseRate = (dateArg) => {
+    checkDate(dateArg);
+    if (dateArg < baseRateFirstDay) {
+        throw new BaseRateError('before_first_period', `${dateArg} lies before ${baseRateFirstDay}, the first day of the Bundesbank's table.`);
+    }
+    const period = baseRatePeriods.find((periodArg) => periodArg.validFrom <= dateArg && dateArg <= periodArg.validTo);
+    if (!period) {
+        throw new BaseRateError('not_published', `${dateArg} lies after ${baseRatePeriods[baseRatePeriods.length - 1].validTo}; the base rate of its half-year was not published when the table was read on ${baseRatesReadOn}.`);
+    }
+    return period;
+};
+/**
+ * A span of days, both inclusive, split where the base rate changes: one piece per published
+ * period it touches, oldest first. Interest under § 288 BGB is computed per piece, since the rate
+ * of each half-year applies to the days in it.
+ */
+export const splitByBaseRate = (fromArg, toArg) => {
+    checkDate(fromArg);
+    checkDate(toArg);
+    if (toArg < fromArg) {
+        throw new BaseRateError('invalid_range', `${toArg} lies before ${fromArg}.`);
+    }
+    const spans = [];
+    let day = fromArg;
+    while (day <= toArg) {
+        const period = getBaseRate(day);
+        const to = period.validTo < toArg ? period.validTo : toArg;
+        spans.push({ from: day, to, ratePercent: period.ratePercent });
+        day = addDay(to);
+    }
+    return spans;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZXJhdGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9iYXNlcmF0ZS9iYXNlcmF0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDM0QsT0FBTyxFQUFFLGdCQUFnQixFQUFFLGVBQWUsRUFBRSxlQUFlLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUd4RixNQUFNLFFBQVEsR0FBRywyQkFBMkIsQ0FBQztBQUU3QyxNQUFNLFNBQVMsR0FBRyxDQUFDLE9BQWlCLEVBQVEsRUFBRTtJQUM1QyxNQUFNLEtBQUssR0FBRyxPQUFPLE9BQU8sS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQztJQUMxRSxNQUFNLEdBQUcsR0FBRyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEVBQUUsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO0lBQ3hHLElBQUksQ0FBQyxLQUFLLElBQUksQ0FBQyxHQUFHLElBQUksR0FBRyxDQUFDLFdBQVcsRUFBRSxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLEtBQUssT0FBTyxFQUFFLENBQUM7UUFDakUsTUFBTSxJQUFJLGFBQWEsQ0FBQyxjQUFjLEVBQUUsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFDO0lBQ25ILENBQUM7QUFDSCxDQUFDLENBQUM7QUFFRixNQUFNLE1BQU0sR0FBRyxDQUFDLE9BQWlCLEVBQVksRUFBRTtJQUM3QyxNQUFNLEdBQUcsR0FBRyxJQUFJLElBQUksQ0FBQyxHQUFHLE9BQU8sWUFBWSxDQUFDLENBQUM7SUFDN0MsR0FBRyxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsVUFBVSxFQUFFLEdBQUcsQ0FBQyxDQUFDLENBQUM7SUFDckMsT0FBTyxHQUFHLENBQUMsV0FBVyxFQUFFLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQztBQUN4QyxDQUFDLENBQUM7QUFFRiw4RUFBOEU7QUFDOUUsTUFBTSxDQUFDLE1BQU0sV0FBVyxHQUFHLENBQUMsT0FBaUIsRUFBbUIsRUFBRTtJQUNoRSxTQUFTLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDbkIsSUFBSSxPQUFPLEdBQUcsZ0JBQWdCLEVBQUUsQ0FBQztRQUMvQixNQUFNLElBQUksYUFBYSxDQUFDLHFCQUFxQixFQUFFLEdBQUcsT0FBTyxnQkFBZ0IsZ0JBQWdCLDRDQUE0QyxDQUFDLENBQUM7SUFDekksQ0FBQztJQUNELE1BQU0sTUFBTSxHQUFHLGVBQWUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDLFNBQVMsQ0FBQyxTQUFTLElBQUksT0FBTyxJQUFJLE9BQU8sSUFBSSxTQUFTLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDbkgsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQ1osTUFBTSxJQUFJLGFBQWEsQ0FDckIsZUFBZSxFQUNmLEdBQUcsT0FBTyxlQUFlLGVBQWUsQ0FBQyxlQUFlLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLE9BQU8saUZBQWlGLGVBQWUsR0FBRyxDQUNoTCxDQUFDO0lBQ0osQ0FBQztJQUNELE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUMsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsQ0FBQyxPQUFpQixFQUFFLEtBQWUsRUFBbUIsRUFBRTtJQUNyRixTQUFTLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDbkIsU0FBUyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ2pCLElBQUksS0FBSyxHQUFHLE9BQU8sRUFBRSxDQUFDO1FBQ3BCLE1BQU0sSUFBSSxhQUFhLENBQUMsZUFBZSxFQUFFLEdBQUcsS0FBSyxnQkFBZ0IsT0FBTyxHQUFHLENBQUMsQ0FBQztJQUMvRSxDQUFDO0lBQ0QsTUFBTSxLQUFLLEdBQW9CLEVBQUUsQ0FBQztJQUNsQyxJQUFJLEdBQUcsR0FBRyxPQUFPLENBQUM7SUFDbEIsT0FBTyxHQUFHLElBQUksS0FBSyxFQUFFLENBQUM7UUFDcEIsTUFBTSxNQUFNLEdBQUcsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ2hDLE1BQU0sRUFBRSxHQUFHLE1BQU0sQ0FBQyxPQUFPLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUM7UUFDM0QsS0FBSyxDQUFDLElBQUksQ0FBQyxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUUsRUFBRSxFQUFFLFdBQVcsRUFBRSxNQUFNLENBQUMsV0FBVyxFQUFFLENBQUMsQ0FBQztRQUMvRCxHQUFHLEdBQUcsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ25CLENBQUM7SUFDRCxPQUFPLEtBQUssQ0FBQztBQUNmLENBQUMsQ0FBQyJ9

package/dist_ts/baserate/classes.baserateerror.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Why a question to the base-rate table was refused:
+ * - `invalid_date`: the value is not a calendar date written `YYYY-MM-DD`;
+ * - `invalid_range`: a span ends before it begins;
+ * - `before_first_period`: the day lies before the first period the table holds (1 July 2002);
+ * - `not_published`: the day lies after the half-year of the last period the table holds, whose
+ *   rate the Bundesbank had not published when the table was read (`baseRatesReadOn`).
+ */
+export type TBaseRateErrorCode = 'invalid_date' | 'invalid_range' | 'before_first_period' | 'not_published';
+/** The typed error of the base-rate table. */
+export declare class BaseRateError extends Error {
+    readonly code: TBaseRateErrorCode;
+    constructor(code: TBaseRateErrorCode, message: string);
+}

package/dist_ts/baserate/classes.baserateerror.js

@@ -0,0 +1,10 @@
+/** The typed error of the base-rate table. */
+export class BaseRateError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'BaseRateError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5iYXNlcmF0ZWVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvYmFzZXJhdGUvY2xhc3Nlcy5iYXNlcmF0ZWVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQVVBLDhDQUE4QztBQUM5QyxNQUFNLE9BQU8sYUFBYyxTQUFRLEtBQUs7SUFDdEIsSUFBSSxDQUFxQjtJQUV6QyxZQUFZLElBQXdCLEVBQUUsT0FBZTtRQUNuRCxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDZixJQUFJLENBQUMsSUFBSSxHQUFHLGVBQWUsQ0FBQztRQUM1QixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztJQUNuQixDQUFDO0NBQ0YifQ==

package/dist_ts/baserate/data.baserate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The base rate (Basiszinssatz) of § 247 BGB, as the Deutsche Bundesbank publishes it: "Gemäß
+ * § 247 Abs. 2 BGB ist die Deutsche Bundesbank verpflichtet, den aktuellen Stand des
+ * Basiszinssatzes im Bundesanzeiger zu veröffentlichen." It changes on 1 January and 1 July
+ * (§ 247 Abs. 1 Satz 2 BGB). The table below is the Bundesbank's table "Basiszinssatz nach § 247
+ * BGB" (https://www.bundesbank.de/de/bundesbank/organisation/agb-und-regelungen/basiszinssatz-607820),
+ * read on 2026-09-27, unaltered: every row from 1 July 2002, the first one it lists, to the
+ * current one. A later half-year needs a new release.
+ */
+import type { IBaseRatePeriod } from './interfaces.js';
+/** the first day the table answers for */
+export declare const baseRateFirstDay = "2002-07-01";
+/** the day the Bundesbank's table was read; later half-years need a new release */
+export declare const baseRatesReadOn = "2026-09-27";
+/** the page the table was read from */
+export declare const baseRateSource = "https://www.bundesbank.de/de/bundesbank/organisation/agb-und-regelungen/basiszinssatz-607820";
+/** every published period, oldest first */
+export declare const baseRatePeriods: readonly IBaseRatePeriod[];

package/dist_ts/baserate/data.baserate.js

@@ -0,0 +1,63 @@
+/** the first day the table answers for */
+export const baseRateFirstDay = '2002-07-01';
+/** the day the Bundesbank's table was read; later half-years need a new release */
+export const baseRatesReadOn = '2026-09-27';
+/** the page the table was read from */
+export const baseRateSource = 'https://www.bundesbank.de/de/bundesbank/organisation/agb-und-regelungen/basiszinssatz-607820';
+const rows = [
+    // gültig ab, Basiszinssatz in Prozent, as the table of the Deutsche Bundesbank states them
+    ['2002-07-01', 2.47],
+    ['2003-01-01', 1.97],
+    ['2003-07-01', 1.22],
+    ['2004-01-01', 1.14],
+    ['2004-07-01', 1.13],
+    ['2005-01-01', 1.21],
+    ['2005-07-01', 1.17],
+    ['2006-01-01', 1.37],
+    ['2006-07-01', 1.95],
+    ['2007-01-01', 2.70],
+    ['2007-07-01', 3.19],
+    ['2008-01-01', 3.32],
+    ['2008-07-01', 3.19],
+    ['2009-01-01', 1.62],
+    ['2009-07-01', 0.12],
+    ['2010-01-01', 0.12],
+    ['2010-07-01', 0.12],
+    ['2011-01-01', 0.12],
+    ['2011-07-01', 0.37],
+    ['2012-01-01', 0.12],
+    ['2012-07-01', 0.12],
+    ['2013-01-01', -0.13],
+    ['2013-07-01', -0.38],
+    ['2014-01-01', -0.63],
+    ['2014-07-01', -0.73],
+    ['2015-01-01', -0.83],
+    ['2015-07-01', -0.83],
+    ['2016-01-01', -0.83],
+    ['2016-07-01', -0.88],
+    ['2017-01-01', -0.88],
+    ['2017-07-01', -0.88],
+    ['2018-01-01', -0.88],
+    ['2018-07-01', -0.88],
+    ['2019-01-01', -0.88],
+    ['2019-07-01', -0.88],
+    ['2020-01-01', -0.88],
+    ['2020-07-01', -0.88],
+    ['2021-01-01', -0.88],
+    ['2021-07-01', -0.88],
+    ['2022-01-01', -0.88],
+    ['2022-07-01', -0.88],
+    ['2023-01-01', 1.62],
+    ['2023-07-01', 3.12],
+    ['2024-01-01', 3.62],
+    ['2024-07-01', 3.37],
+    ['2025-01-01', 2.27],
+    ['2025-07-01', 1.27],
+    ['2026-01-01', 1.27],
+    ['2026-07-01', 1.52],
+];
+/** the last day of the half-year a period begins in */
+const halfYearEndOf = (validFromArg) => `${validFromArg.slice(0, 4)}-${validFromArg.slice(5, 7) === '01' ? '06-30' : '12-31'}`;
+/** every published period, oldest first */
+export const baseRatePeriods = Object.freeze(rows.map(([validFrom, ratePercent]) => Object.freeze({ validFrom, validTo: halfYearEndOf(validFrom), ratePercent })));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YS5iYXNlcmF0ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Jhc2VyYXRlL2RhdGEuYmFzZXJhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBV0EsMENBQTBDO0FBQzFDLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLFlBQVksQ0FBQztBQUU3QyxtRkFBbUY7QUFDbkYsTUFBTSxDQUFDLE1BQU0sZUFBZSxHQUFHLFlBQVksQ0FBQztBQUU1Qyx1Q0FBdUM7QUFDdkMsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLDhGQUE4RixDQUFDO0FBRTdILE1BQU0sSUFBSSxHQUE2QztJQUNyRCwyRkFBMkY7SUFDM0YsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLENBQUM7SUFDckIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztJQUNwQixDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7SUFDcEIsQ0FBQyxZQUFZLEVBQUUsSUFBSSxDQUFDO0lBQ3BCLENBQUMsWUFBWSxFQUFFLElBQUksQ0FBQztDQUNyQixDQUFDO0FBRUYsdURBQXVEO0FBQ3ZELE1BQU0sYUFBYSxHQUFHLENBQUMsWUFBb0IsRUFBVSxFQUFFLENBQ3JELEdBQUcsWUFBWSxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLElBQUksWUFBWSxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEtBQUssSUFBSSxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDO0FBRXpGLDJDQUEyQztBQUMzQyxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQStCLE1BQU0sQ0FBQyxNQUFNLENBQ3RFLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLFNBQVMsRUFBRSxXQUFXLENBQUMsRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLFNBQVMsRUFBRSxPQUFPLEVBQUUsYUFBYSxDQUFDLFNBQVMsQ0FBQyxFQUFFLFdBQVcsRUFBRSxDQUFDLENBQUMsQ0FDckgsQ0FBQyJ9

package/dist_ts/baserate/index.d.ts

@@ -0,0 +1,4 @@
+export * from './interfaces.js';
+export { BaseRateError, type TBaseRateErrorCode } from './classes.baserateerror.js';
+export { baseRateFirstDay, baseRatePeriods, baseRateSource, baseRatesReadOn } from './data.baserate.js';
+export { getBaseRate, splitByBaseRate } from './baserate.js';

package/dist_ts/baserate/index.js

@@ -0,0 +1,7 @@
+// This entry point stands alone: it imports nothing from the rest of the package, has no
+// dependencies and needs no storage or network.
+export * from './interfaces.js';
+export { BaseRateError } from './classes.baserateerror.js';
+export { baseRateFirstDay, baseRatePeriods, baseRateSource, baseRatesReadOn } from './data.baserate.js';
+export { getBaseRate, splitByBaseRate } from './baserate.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9iYXNlcmF0ZS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx5RkFBeUY7QUFDekYsZ0RBQWdEO0FBQ2hELGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsT0FBTyxFQUFFLGFBQWEsRUFBMkIsTUFBTSw0QkFBNEIsQ0FBQztBQUNwRixPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsZUFBZSxFQUFFLGNBQWMsRUFBRSxlQUFlLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUN4RyxPQUFPLEVBQUUsV0FBVyxFQUFFLGVBQWUsRUFBRSxNQUFNLGVBQWUsQ0FBQyJ9

package/dist_ts/baserate/interfaces.d.ts

@@ -0,0 +1,19 @@
+/** A plain calendar date, `YYYY-MM-DD`. */
+export type TIsoDate = string;
+/**
+ * One half-year's base rate (Basiszinssatz, § 247 BGB) as the Deutsche
+ * Bundesbank publishes it: valid from 1 January or 1 July to the last day of
+ * that half-year, both inclusive.
+ */
+export interface IBaseRatePeriod {
+    validFrom: TIsoDate;
+    validTo: TIsoDate;
+    /** percent a year; it can be negative (2013 to 2022) */
+    ratePercent: number;
+}
+/** A span of days within one base-rate period, both days inclusive. */
+export interface IBaseRateSpan {
+    from: TIsoDate;
+    to: TIsoDate;
+    ratePercent: number;
+}

package/dist_ts/baserate/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Jhc2VyYXRlL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@fin.cx/opendata",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "private": false,
-  "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, and stock and crypto prices and fundamentals from several providers.",
+  "description": "Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, and stock and crypto prices and fundamentals from several providers.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
   "exports": {
@@ -18,6 +18,10 @@
       "types": "./dist_ts/holidays/index.d.ts",
       "import": "./dist_ts/holidays/index.js"
     },
+    "./baserate": {
+      "types": "./dist_ts/baserate/index.d.ts",
+      "import": "./dist_ts/baserate/index.js"
+    },
     "./package.json": "./package.json"
   },
   "type": "module",
@@ -27,8 +31,8 @@
     "@git.zone/tsbuild": "^5.0.0",
     "@git.zone/tsbundle": "^2.15.0",
     "@git.zone/tsrun": "^3.0.0",
-    "@git.zone/tstest": "^6.2.0",
-    "@types/node": "^26.6.1"
+    "@git.zone/tstest": "^6.3.1",
+    "@types/node": "^26.6.2"
   },
   "dependencies": {
     "@push.rocks/qenv": "^6.1.3",
@@ -77,7 +81,9 @@
     "fundamentals",
     "public holidays",
     "Feiertage",
-    "working days"
+    "working days",
+    "Basiszinssatz",
+    "base rate"
   ],
   "scripts": {
     "test": "(tstest test/ --verbose)",

package/readme.md

@@ -1,13 +1,14 @@
 # @fin.cx/opendata
 
-`@fin.cx/opendata` is a TypeScript toolbox for open business and market data: stock and crypto prices, SEC fundamentals, lookups in the German registers through the register portal of the federal states, and the statutory public holidays of the German federal states. It is built for programmers who want scriptable APIs and real workflows instead of a thin wrapper around one remote endpoint.
+`@fin.cx/opendata` is a TypeScript toolbox for open business and market data: stock and crypto prices, SEC fundamentals, lookups in the German registers through the register portal of the federal states, the statutory public holidays of the German federal states, and the base rate of § 247 BGB. It is built for programmers who want scriptable APIs and real workflows instead of a thin wrapper around one remote endpoint.
 
-It gives you four practical lanes in one package:
+It gives you five practical lanes in one package:
 
 - `StockPriceService` for stock and crypto prices with caching, retries, failover, historical ranges, and intraday support
 - `FundamentalsService` and `StockDataService` for SEC fundamentals and combined price + fundamentals payloads
 - `HandelsregisterClient`, from `@fin.cx/opendata/handelsregister`, for single lookups in the commercial, cooperative, partnership, association and civil-law partnership registers over plain HTTP, without any storage
 - the holiday calendar, from `@fin.cx/opendata/holidays`, for the statutory public holidays of each German federal state and the working days of § 193 BGB, computed per year without data files or requests
+- the base rate, from `@fin.cx/opendata/baserate`, for the Basiszinssatz of § 247 BGB per half-year as the Deutsche Bundesbank publishes it, for default interest under § 288 BGB
 
 ## Issue Reporting and Security
 
@@ -59,6 +60,16 @@ Everything here comes from `@fin.cx/opendata/holidays`. That entry point imports
   Holidays and working days in the sense of § 193 BGB: neither a Saturday, nor a Sunday, nor a statutory public holiday.
 - `easterSunday(year)`, `germanStates`, `findGermanState()`
 
+### The Base Rate Of § 247 BGB
+
+Everything here comes from `@fin.cx/opendata/baserate`. That entry point imports nothing else of the package, has no dependencies, and makes no request.
+
+- `getBaseRate(date)`
+  The base rate in force on a day: its half-year period with the rate in percent a year.
+- `splitByBaseRate(from, to)`
+  A span of days split where the rate changes, as interest under § 288 BGB is computed.
+- `baseRatePeriods`, `baseRateFirstDay`, `baseRatesReadOn`, `baseRateSource`
+
 ## Before You Start
 
 - No stock or fundamentals providers are pre-registered. You must register them before calling the services.
@@ -450,6 +461,13 @@ Four holidays apply only in part of a state:
 - `holidayCalendarFirstYear`, `holidayLawsReadOn`
 - `HolidayCalendarError` with the codes `invalid_date`, `unsupported_year`, `unknown_state` and `invalid_options`
 
+### Base rate (`@fin.cx/opendata/baserate`)
+
+- `getBaseRate(date)`
+- `splitByBaseRate(from, to)`
+- `baseRatePeriods`, `baseRateFirstDay`, `baseRatesReadOn`, `baseRateSource`
+- `BaseRateError` with the codes `invalid_date`, `invalid_range`, `before_first_period` and `not_published`
+
 ## Data Sources
 
 The package ships no market or register data. Prices and fundamentals come at run time from the providers you register (Marketstack, CoinGecko, SEC EDGAR), and register entries come at run time from the register portal of the federal states (handelsregister.de), one lookup at a time.
@@ -497,6 +515,8 @@ The holiday calendar is derived from the holiday laws of the federal states, rea
 | Thüringen | [Thüringer Feier- und Gedenktagsgesetz (ThürFGtG)](https://landesrecht.thueringen.de/perma?j=FeiertG_TH_!_2) | § 2, § 10 Abs. 1 |
 | all | [Bürgerliches Gesetzbuch](https://www.gesetze-im-internet.de/bgb/__193.html) | § 193 (Sonntag, Feiertag, Sonnabend) |
 
+The base rate of `@fin.cx/opendata/baserate` (`ts/baserate/data.baserate.ts`) is the table "Basiszinssatz nach § 247 BGB" of the Deutsche Bundesbank (https://www.bundesbank.de/de/bundesbank/organisation/agb-und-regelungen/basiszinssatz-607820), which the Bundesbank publishes under § 247 Abs. 2 BGB, read on 2026-09-27 and reproduced unaltered: every half-year from 1 July 2002, the first row it lists, to the half-year from 1 July 2026 (1,52 %). The rate changes on 1 January and 1 July (§ 247 Abs. 1 Satz 2 BGB); a day after 31 December 2026 answers `not_published` until a release carries the next row.
+
 ## Behavior And Caveats
 
 - Historical market data is cached aggressively because it is treated as immutable.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@fin.cx/opendata',
-  version: '4.1.0',
-  description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, and stock and crypto prices and fundamentals from several providers.'
+  version: '4.2.0',
+  description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, and stock and crypto prices and fundamentals from several providers.'
 }

package/ts/baserate/baserate.ts

@@ -0,0 +1,57 @@
+import { BaseRateError } from './classes.baserateerror.js';
+import { baseRateFirstDay, baseRatePeriods, baseRatesReadOn } from './data.baserate.js';
+import type { IBaseRatePeriod, IBaseRateSpan, TIsoDate } from './interfaces.js';
+
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+
+const checkDate = (dateArg: TIsoDate): void => {
+  const match = typeof dateArg === 'string' ? ISO_DATE.exec(dateArg) : null;
+  const utc = match ? new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]))) : null;
+  if (!match || !utc || utc.toISOString().slice(0, 10) !== dateArg) {
+    throw new BaseRateError('invalid_date', `${JSON.stringify(dateArg)} is not a calendar date written YYYY-MM-DD.`);
+  }
+};
+
+const addDay = (dateArg: TIsoDate): TIsoDate => {
+  const utc = new Date(`${dateArg}T00:00:00Z`);
+  utc.setUTCDate(utc.getUTCDate() + 1);
+  return utc.toISOString().slice(0, 10);
+};
+
+/** The base rate in force on a day: the published period that contains it. */
+export const getBaseRate = (dateArg: TIsoDate): IBaseRatePeriod => {
+  checkDate(dateArg);
+  if (dateArg < baseRateFirstDay) {
+    throw new BaseRateError('before_first_period', `${dateArg} lies before ${baseRateFirstDay}, the first day of the Bundesbank's table.`);
+  }
+  const period = baseRatePeriods.find((periodArg) => periodArg.validFrom <= dateArg && dateArg <= periodArg.validTo);
+  if (!period) {
+    throw new BaseRateError(
+      'not_published',
+      `${dateArg} lies after ${baseRatePeriods[baseRatePeriods.length - 1].validTo}; the base rate of its half-year was not published when the table was read on ${baseRatesReadOn}.`,
+    );
+  }
+  return period;
+};
+
+/**
+ * A span of days, both inclusive, split where the base rate changes: one piece per published
+ * period it touches, oldest first. Interest under § 288 BGB is computed per piece, since the rate
+ * of each half-year applies to the days in it.
+ */
+export const splitByBaseRate = (fromArg: TIsoDate, toArg: TIsoDate): IBaseRateSpan[] => {
+  checkDate(fromArg);
+  checkDate(toArg);
+  if (toArg < fromArg) {
+    throw new BaseRateError('invalid_range', `${toArg} lies before ${fromArg}.`);
+  }
+  const spans: IBaseRateSpan[] = [];
+  let day = fromArg;
+  while (day <= toArg) {
+    const period = getBaseRate(day);
+    const to = period.validTo < toArg ? period.validTo : toArg;
+    spans.push({ from: day, to, ratePercent: period.ratePercent });
+    day = addDay(to);
+  }
+  return spans;
+};

package/ts/baserate/classes.baserateerror.ts

@@ -0,0 +1,20 @@
+/**
+ * Why a question to the base-rate table was refused:
+ * - `invalid_date`: the value is not a calendar date written `YYYY-MM-DD`;
+ * - `invalid_range`: a span ends before it begins;
+ * - `before_first_period`: the day lies before the first period the table holds (1 July 2002);
+ * - `not_published`: the day lies after the half-year of the last period the table holds, whose
+ *   rate the Bundesbank had not published when the table was read (`baseRatesReadOn`).
+ */
+export type TBaseRateErrorCode = 'invalid_date' | 'invalid_range' | 'before_first_period' | 'not_published';
+
+/** The typed error of the base-rate table. */
+export class BaseRateError extends Error {
+  public readonly code: TBaseRateErrorCode;
+
+  constructor(code: TBaseRateErrorCode, message: string) {
+    super(message);
+    this.name = 'BaseRateError';
+    this.code = code;
+  }
+}

package/ts/baserate/data.baserate.ts

@@ -0,0 +1,81 @@
+/**
+ * The base rate (Basiszinssatz) of § 247 BGB, as the Deutsche Bundesbank publishes it: "Gemäß
+ * § 247 Abs. 2 BGB ist die Deutsche Bundesbank verpflichtet, den aktuellen Stand des
+ * Basiszinssatzes im Bundesanzeiger zu veröffentlichen." It changes on 1 January and 1 July
+ * (§ 247 Abs. 1 Satz 2 BGB). The table below is the Bundesbank's table "Basiszinssatz nach § 247
+ * BGB" (https://www.bundesbank.de/de/bundesbank/organisation/agb-und-regelungen/basiszinssatz-607820),
+ * read on 2026-09-27, unaltered: every row from 1 July 2002, the first one it lists, to the
+ * current one. A later half-year needs a new release.
+ */
+import type { IBaseRatePeriod } from './interfaces.js';
+
+/** the first day the table answers for */
+export const baseRateFirstDay = '2002-07-01';
+
+/** the day the Bundesbank's table was read; later half-years need a new release */
+export const baseRatesReadOn = '2026-09-27';
+
+/** the page the table was read from */
+export const baseRateSource = 'https://www.bundesbank.de/de/bundesbank/organisation/agb-und-regelungen/basiszinssatz-607820';
+
+const rows: ReadonlyArray<readonly [string, number]> = [
+  // gültig ab, Basiszinssatz in Prozent, as the table of the Deutsche Bundesbank states them
+  ['2002-07-01', 2.47],
+  ['2003-01-01', 1.97],
+  ['2003-07-01', 1.22],
+  ['2004-01-01', 1.14],
+  ['2004-07-01', 1.13],
+  ['2005-01-01', 1.21],
+  ['2005-07-01', 1.17],
+  ['2006-01-01', 1.37],
+  ['2006-07-01', 1.95],
+  ['2007-01-01', 2.70],
+  ['2007-07-01', 3.19],
+  ['2008-01-01', 3.32],
+  ['2008-07-01', 3.19],
+  ['2009-01-01', 1.62],
+  ['2009-07-01', 0.12],
+  ['2010-01-01', 0.12],
+  ['2010-07-01', 0.12],
+  ['2011-01-01', 0.12],
+  ['2011-07-01', 0.37],
+  ['2012-01-01', 0.12],
+  ['2012-07-01', 0.12],
+  ['2013-01-01', -0.13],
+  ['2013-07-01', -0.38],
+  ['2014-01-01', -0.63],
+  ['2014-07-01', -0.73],
+  ['2015-01-01', -0.83],
+  ['2015-07-01', -0.83],
+  ['2016-01-01', -0.83],
+  ['2016-07-01', -0.88],
+  ['2017-01-01', -0.88],
+  ['2017-07-01', -0.88],
+  ['2018-01-01', -0.88],
+  ['2018-07-01', -0.88],
+  ['2019-01-01', -0.88],
+  ['2019-07-01', -0.88],
+  ['2020-01-01', -0.88],
+  ['2020-07-01', -0.88],
+  ['2021-01-01', -0.88],
+  ['2021-07-01', -0.88],
+  ['2022-01-01', -0.88],
+  ['2022-07-01', -0.88],
+  ['2023-01-01', 1.62],
+  ['2023-07-01', 3.12],
+  ['2024-01-01', 3.62],
+  ['2024-07-01', 3.37],
+  ['2025-01-01', 2.27],
+  ['2025-07-01', 1.27],
+  ['2026-01-01', 1.27],
+  ['2026-07-01', 1.52],
+];
+
+/** the last day of the half-year a period begins in */
+const halfYearEndOf = (validFromArg: string): string =>
+  `${validFromArg.slice(0, 4)}-${validFromArg.slice(5, 7) === '01' ? '06-30' : '12-31'}`;
+
+/** every published period, oldest first */
+export const baseRatePeriods: readonly IBaseRatePeriod[] = Object.freeze(
+  rows.map(([validFrom, ratePercent]) => Object.freeze({ validFrom, validTo: halfYearEndOf(validFrom), ratePercent })),
+);

package/ts/baserate/index.ts

@@ -0,0 +1,6 @@
+// This entry point stands alone: it imports nothing from the rest of the package, has no
+// dependencies and needs no storage or network.
+export * from './interfaces.js';
+export { BaseRateError, type TBaseRateErrorCode } from './classes.baserateerror.js';
+export { baseRateFirstDay, baseRatePeriods, baseRateSource, baseRatesReadOn } from './data.baserate.js';
+export { getBaseRate, splitByBaseRate } from './baserate.js';

package/ts/baserate/interfaces.ts

@@ -0,0 +1,21 @@
+/** A plain calendar date, `YYYY-MM-DD`. */
+export type TIsoDate = string;
+
+/**
+ * One half-year's base rate (Basiszinssatz, § 247 BGB) as the Deutsche
+ * Bundesbank publishes it: valid from 1 January or 1 July to the last day of
+ * that half-year, both inclusive.
+ */
+export interface IBaseRatePeriod {
+  validFrom: TIsoDate;
+  validTo: TIsoDate;
+  /** percent a year; it can be negative (2013 to 2022) */
+  ratePercent: number;
+}
+
+/** A span of days within one base-rate period, both days inclusive. */
+export interface IBaseRateSpan {
+  from: TIsoDate;
+  to: TIsoDate;
+  ratePercent: number;
+}