bankproductsBlog

Blog · · DE

bankproducts.json — 4 Monate später

Was wir gelernt haben, warum null Banken das Format publiziert haben, und wie eine v2-Spec aussehen müsste.

TL;DR Ende März 2026 haben wir /.well-known/bankproducts.json vorgeschlagen: eine JSON-Datei pro Bank an einer bekannten URL, wie security.txt, aber für Preise. Vier Monate später hat null Banken eine solche Datei publiziert — aber unser eigenes Schema ist von 6 Banken/128 Produkten/349 Gebühren auf 421 Banken, 2'929 Produkte, 6'719 Gebühren und 2'376 Zinssätze gewachsen. Was das Schema uns dabei über sich selbst gelehrt hat: Preise sind eine Sache, Zinsen eine andere. Quellenangaben gehören an jede Zeile, nicht ans File. Claims brauchen ein verifiable-Flag. Und die wichtigste Regel für jede LLM-generierte Datenspec heisst — schmerzhaft gelernt an drei realen Beinahe-Katastrophen — NULL > plausible Erfindung.

Recap: was der März-Post gesagt hat

Am 31. März 2026 haben wir ein Wochenende lang sechs Schweizer Bank-Preisverzeichnisse geparst (108 PDF-Seiten, 128 Produkte, 349 Gebühren) und daraus einen Vorschlag abgeleitet: /.well-known/bankproducts.json. Jede Bank publiziert an einer bekannten URL eine maschinenlesbare Datei mit ihrem Produktkatalog. Eine Datei. Eine URL. Kein API, kein Vertrag, kein Scraping. Präzedenzfälle: security.txt, openid-configuration, robots.txt. Das JSON-Schema lag bei v1.0.

Der Post schloss mit einem klaren Ask: „One bank publishing this file would prove the concept. Two would make it a pattern. Ten would make it a standard."

Vier Monate später: die Realität

März 2026August 2026
Banken in der DB6421
Produkte1282'929
Gebühren3496'719
Zinsen02'376
Narrative Claims01'160
Source-Dokumente≈10931
Schema-Versionv1.0v3
Banken mit LEI?410 (97 %)
Banken, die eine /.well-known/bankproducts.json publiziert haben00

Die letzte Zeile ist die ehrliche. Das Format wurde von keiner Bank aufgegriffen. Der DB-Bestand wurde von uns aufgebaut — durch einen Crawler, den ein externer Contractor pflegt, und durch Loader-Sessions in denen jede Bank ein eigenes SQL-File bekommt. Genau das Gegenteil des „jede Bank publiziert selbst"-Versprechens.

Trotzdem war die Übung nicht umsonst — das Schema hat sich unter dem Druck von 420 realen Banken massiv weiterentwickelt. Und diese Evolution ist die eigentliche Ausbeute: ein v2-Vorschlag, der weiss, wo das v1-Schema falsch lag.

Was das Schema selbst uns gelehrt hat

1. Zinsen sind nicht Gebühren

Die März-Version hatte einen fees-Array pro Produkt. Zinsen tauchten nirgends auf. Nach 4 Monaten haben wir 2'376 Zinssätze in einer eigenen Tabelle interest_rate — mit tenor_months, tier_floor/tier_ceiling, currency und einem rate_type-Enum (savings, mortgage_rate, term_deposit, …). Ein Sparkonto ist kein Fee-Träger, sondern ein Zins-Träger.

v2-Konsequenz: entweder ein zweiter Array rates pro Produkt, oder ein zweites File /.well-known/bankrates.json. Beides ist sauberer als „alles ist eine Fee mit unterschiedlichen Semantiken".

2. Die Quellenangabe gehört an die Zeile, nicht ans File

Der März-Post hatte ein einziges source-Objekt am File-Anfang. In der Realität will jede einzelne Gebühr eine source_page-Referenz (bei PDFs) oder eine source_url (bei HTML-Preisen). Warum: eine Sparkasse hat oft drei gültige Preisdokumente parallel — Basisgebühren, Karten-Konditionen, Zinsen — und ein LLM oder Compliance-Auditor braucht die Page-Ebene, nicht die File-Ebene.

Das ist das eigentliche „Trust-Killer-Feature". Ohne per-item-Zitat ist die Datei bloss eine schöne Behauptungs-Sammlung. Mit per-item-Zitat wird sie überprüfbar.

3. Claims brauchen ein verifiable-Flag

Vier LLMs haben unabhängig bestätigt (siehe llm-validation/2026-05-31.md): der grösste Unterschied zwischen einer Preisliste und einer Preisliste-mit-Story ist die Unterscheidung Fakt vs. Marketing. Beispiel:

  • verifiable=1: „ZKB hat ein AAA-Kreditrating von S&P" (nachschlagbar bei S&P Global)
  • verifiable=0: „Wir sind die kundenfreundlichste Bank der Schweiz" (Selbstauskunft aus dem Marketing)

Der Flag ändert die Sprache, in der ein AI-Agent die Aussage zitiert. Beides gehört in die Datei, aber unterschiedlich etikettiert. Unser claim-Table hat heute 1'160 Zeilen, 82 % davon mit verifiable=1. In der v1-Spec kam dieses Konzept nicht vor.

4. Pakete brauchen Content, nicht nur einen Namen

Die März-Version listete package als Produkt-Kategorie — ohne zu sagen, was drin ist. Reality-Check: „ZKB inklusiv Silber CHF 6/Monat" ist wertlos, wenn nicht klar ist dass Privatkonto + Sparkonto + Visa Debit + Standard-Kreditkarte + E-Banking drinstecken. Wir haben 109 packages im DB, jedes mit package_item-Zeilen die auf die enthaltenen product-IDs zeigen.

v2: package-Produkte tragen ein included: [product_id, product_id, …]-Feld.

5. „Auf Anfrage" ist eine legitime Antwort

Ein grosser Unterschied zwischen Wunsch-Welt und Realität: viele Banken publizieren ihre Zinsen bewusst nicht. In unserer Q3-Bestandsaufnahme fanden wir 240 leere Zellen in 64 Banken — davon 165 mit einer expliziten „auf Anfrage"-Markierung (siehe Was Schweizer Banken nicht publizieren). Bei 31 Banken ist der 3a-Zinssatz gar nie öffentlich.

v2 muss das kanonisch abbilden: amount: null mit einem note-Feld ist erlaubt und heisst „die Bank publiziert das nicht" — nicht „wir haben's noch nicht geparst". Das ist ein wichtiger semantischer Unterschied für einen AI-Agenten, der zwischen „nicht wissen" und „wissen dass es nicht öffentlich ist" unterscheiden muss.

6. ACTUS-Contract-Type als Brücke zur Finanzindustrie

Zwischen März und heute haben wir 30 Produkt-Kategorien auf 11 ACTUS-Kontrakttypen gemappt (UMP, PAM, ANN, CSH, STK, …). Das ist der internationale ISO-nahe Standard für Finanzkontrakte. Ein Sparkonto ist ein UMP, eine Festhypothek eine ANN. Diese Brücke macht unsere Daten mit jeder ACTUS-basierten Analyse (Cashflow-Modellierung, ALM, Bilanzsimulation) direkt kompatibel.

v2: optionales actus_type-Feld pro Produkt. Kein Muss, aber eine Öffnung zur Institutional-Welt.

7. Identität ist mehrschichtig

März hatte bank.id: "zkb". Realität heute: eine Bank trägt fünf Identifikatoren, und jeder hat einen Zweck:

  • LEI (GLEIF, international) — für Cross-System-Joins
  • UID (Zefix, CH-national) — für Handelsregister-Verweise
  • BIC (SWIFT) — für Zahlungen
  • SIC-IID (SIX, CH-Clearing) — für Interbank-Clearing
  • BPG (unser interner Opaque-Code, FIGI-inspiriert, mit Prüfziffer) — überlebt Umbenennungen, Fusionen, Rebrands

v2 muss LEI als Erst-Identifikator vorsehen (97 % Coverage in unserer DB, ist global-eindeutig). Der Rest ist Zusatz.

Das Kernprinzip — schmerzhaft gelernt

NULL ist besser als eine plausibel klingende Erfindung.

Diese eine Regel hätte den Wert eines eigenen Blog-Posts. Sie ist der wichtigste Lernwert der letzten vier Monate. Drei reale Beinahe-Katastrophen, alle aus LLM-generierten Loader-Sessions:

  1. „Frankly Technologie AG" — ein plausibel klingender Rechtsträger für die ZKB-Marke Frankly. Existiert nicht. Zefix kennt ihn nicht. Ein LLM hatte ihn während einer Loader-Session halluziniert, weil die Frage „was ist der Rechtsträger von Frankly?" keine leere Antwort erlaubt. Er landete beinahe in der DB. Journal-Atom #354.
  2. 11 fabrizierte Kantonalbank-UIDs — hand-geladene Kantonalbank-Files enthielten UIDs im Format CHE-105.939.310, die nach Zefix-Check nicht existierten. Alle 11 waren LLM-Signatur-Nummern („sieht aus wie eine UID"). Journal-Atom #357.
  3. LEI-Fallback auf Parent-Cooperative — für Raiffeisen-Mitgliedsbanken ohne eigene LEI hatte ein früherer Enrichment-Lauf die Raiffeisen-Schweiz-LEI eingesetzt. Die nachgelagerte GLEIF-Abfrage brachte dann die falsche UID zurück. Journal-Atom #367.

Der Gemeinsame Nenner: ein LLM ist darauf trainiert, die Frage zu beantworten, nicht sie offen zu lassen. Wenn eine Datenspec keine explizite Regel enthält, dass null die richtige Antwort ist wenn die Wahrheit unbekannt ist, wird ein LLM sie in 100 % der Fälle mit etwas Plausibles füllen. Und plausibel ist schlimmer als falsch, weil es Downstream-Validatoren nicht triggert.

Die v1-Spec hatte diese Regel nicht. Die v2-Spec muss sie normativ tragen, in Grossbuchstaben, am File-Anfang. Sie gilt für jedes Feld: name, uid, lei, amount, rate, alles.

Wie eine v2 aussehen könnte

Skelett — nicht vollständig, aber die neuen Elemente sind sichtbar:

{
  "$schema": "https://bankproducts.info/schema/v2.json",
  "version": "2.0",
  "generated_at": "2026-08-05",

  "bank": {
    "id": "zkb",
    "lei": "165GRDQ39W63PHVONY02",         // NEU: LEI als Primär-ID
    "uid": "CHE-105.887.640",
    "name": "Zürcher Kantonalbank",
    "country": "CH",
    "bank_type": "cantonal_bank"
  },

  "products": [
    {
      "id": "visa_debit",
      "category": "debit_card",
      "actus_type": "SVC",                   // NEU: ACTUS-Bridge (optional)
      "name": "ZKB Visa Debit Card",
      "fees": [
        {
          "type": "fx_markup",
          "amount": 1.25, "currency": "percent", "frequency": "per_txn",
          "note": "Max CHF 1.50 pro Transaktion",
          "source": {                        // NEU: Quelle PRO Zeile
            "url": "https://www.zkb.ch/...preise.pdf",
            "page": 13
          }
        },
        {
          "type": "atm_abroad",
          "amount": null,                    // NEU: null ist erlaubt
          "note": "auf Anfrage — Konditionen abhängig vom Paket",
          "source": { "url": "https://www.zkb.ch/...paket-info" }
        }
      ]
    },
    {
      "id": "sparkonto",
      "category": "savings_account",
      "actus_type": "UMP",
      "rates": [                             // NEU: rates neben fees
        { "rate_type": "savings", "rate": 0.10, "currency": "CHF",
          "tier_floor": 0, "tier_ceiling": 50000,
          "valid_from": "2026-07-01",
          "source": { "url": "...", "page": 8 } }
      ]
    },
    {
      "id": "inklusiv_silber",
      "category": "package",
      "fees": [ { "type": "base_fee", "amount": 6.0, "currency": "CHF",
                  "frequency": "monthly" } ],
      "included": [                          // NEU: Package-Content
        "privatkonto", "sparkonto", "visa_debit",
        "credit_standard", "ebanking"
      ]
    }
  ],

  "claims": [                                // NEU: verifiable Aussagen
    {
      "category": "safety",
      "key": "credit_rating",
      "value": "AAA",
      "verifiable": true,
      "source_url": "https://www.spglobal.com/ratings/en/..."
    },
    {
      "category": "digital",
      "key": "app_rating_apple",
      "value": "4.7",
      "verifiable": true,
      "source_url": "https://apps.apple.com/ch/app/..."
    }
  ]
}

Warum null Banken adoptiert haben — und was das bedeutet

Vier ehrliche Gründe:

  1. Kein Business-Case. Eine Bank publiziert Preise heute in einer PDF, weil FINMA es implizit erwartet. Kein zusätzlicher Kunde entsteht durch eine JSON-Datei. Solange niemand ein Buch-Wert-Aggregat-Volumen darauf aufbaut, gibt es keine wirtschaftliche Traktion.
  2. Kein Push. PSD3 ist in der EU im Werden, aber die Detail-Anforderungen an das Publikationsformat sind noch nicht verabschiedet. Wenn PSD3 explizit JSON in einer normierten Struktur mandatiert (statt „auf der Website publiziert"), ändert sich das schlagartig.
  3. Wir sind die Interim-Lösung geworden. Unsere api.bankproducts.info aggregiert 421 Banken. Ein AI-Agent oder eine Compliance-Abfrage hat heute keinen operativen Grund, auf pro-Bank-Publikation zu warten — die Aggregation existiert schon. Das schwächt paradoxerweise den Push zu Selbstpublikation.
  4. Interner Reibungswiderstand. Für eine Bank bedeutet die Publikation einer bankproducts.json: interne Freigabe, Legal-Sign-off, ein Deployment-Pfad. Kosten sind reell (auch wenn klein), Nutzen ist diffus.

Der Weg nach vorne ist realistisch dreiteilig:

  • Ein Frontrunner. Eine Kantonalbank oder eine Neobank, die aus ESG-Transparenz- oder Marketing-Motiven publiziert. Ein einziger reicht — dann wird es referenzierbar in RFPs.
  • Ein regulatorischer Trigger. PSD3 explizit oder eine FINMA-Empfehlung zur maschinenlesbaren Fee-Publikation. Das ist der wahrscheinlichste Beschleuniger.
  • Ein LLM-Traffic-Threshold. Wenn 5–10 % des Retail-Bankproduct-Discovery-Traffics via LLM läuft, wird Selbstpublikation ein SEO-Äquivalent. Wir sind vermutlich noch 12–18 Monate davon entfernt.

Was bleibt

Der März-Vorschlag war naiv in den Details und richtig im Prinzip. Die Details haben wir nachträglich korrigiert — durch 421 reale Banken, drei Beinahe-Katastrophen und ein Schema, das sich unter dem Druck der Realität in einer Weise entwickelt hat, wie wir sie am Schreibtisch nicht hätten vorhersehen können.

Das Prinzip bleibt: Die Daten existieren. Sie sind öffentlich. Der Zugriffsweg dorthin ist der Skandal. Was in unserem Post fehlte — und was diese vier Monate klar gemacht haben — ist die Anti-Fabrikationsregel als normativer Kern. Jede Datenspec, die von LLMs befüllt wird, muss null als richtige Antwort explizit erlauben und normativ empfehlen. Sonst füllt das LLM die Lücke mit einer plausiblen Erfindung, und plausibel ist schlimmer als falsch.

Wenn eine Bank ihre /.well-known/bankproducts.json nach v2-Skelett publiziert, sagen wir sofort Bescheid: roman@bankproducts.info. Bis dahin läuft der Crawler.