API
Jede Tabelle der Website antwortet auch in JSON, ohne Schlüssel, ohne Konto und ohne Kontingent.
Die Zahlen gehören den Fonds, die sie melden, und den Aufsichtsbehörden, die sie veröffentlichen. Wer sie weiterverwendet, nennt die ursprüngliche Quelle.
| Adresse | Was sie liefert |
|---|---|
/api/company/<isin> Ausprobieren | Die Fonds, die eine Gesellschaft halten, mit Stückzahl, Anteil am jeweiligen Fonds und Kapitalanteil, sofern bekannt. |
/api/fund/<id> Ausprobieren | Was ein Fonds hält, Position für Position, zum Stichtag seiner Meldung. |
/api/isins Ausprobieren | Alle erfassten Gesellschaften, je Zeile eine ISIN und ihre Adresse. |
/de/feed.xml Ausprobieren | Jeder Fonds, dessen Zusammensetzung hier neu erscheint oder aktualisiert wird, gelesen aus dem Bericht, den der Fonds selbst veröffentlicht. |
/api/fund/<id>.csv Ausprobieren | Dieselbe Tabelle als Datei, für die Tabellenkalkulation. |
/api/company/<isin>.csv Ausprobieren | Dieselbe Tabelle als Datei, für die Tabellenkalkulation. |
/api/openapi.json Ausprobieren | Der OpenAPI-Vertrag, erzeugt aus den Konstanten, die der Code bedient. |
Alle diese Adressen akzeptieren limit (standardmäßig 1.000 Zeilen, höchstens 12.000) und offset; der page-Block der Antwort nennt die Gesamtzahl sowie die Adressen der nächsten und der vorigen Seite. Die Dateien akzeptieren zusätzlich lang, das die Spalten in einer der drei Sprachen der Website schreibt. Ab 120 Anfragen pro Minute erhält eine Adresse eine 429 und die Wartezeit.
Keine Version in den Adressen, weil nichts brechen wird: ein Feld kann hinzukommen, keines verschwindet oder ändert seine Bedeutung, und eine Adresse zieht nicht um.
Ablehnungen
Ein Fehler antwortet als application/problem+json (RFC 9457): sein Feld type zeigt auf einen der Anker unten, status und detail sagen den Rest.
company-not-found- Keine Gesellschaft antwortet auf diese Kennung. Die Liste lebt unter /api/isins.
fund-not-found- Kein Fonds antwortet auf diese Kennung.
not-found- Die angefragte Ressource existiert nicht.
no-such-endpoint- Keine API-Adresse antwortet hier.
method-not-allowed- Diese Adressen sind nur lesbar: GET, HEAD und OPTIONS.
rate-limit-exceeded- Zu viele Anfragen innerhalb der Minute. retry-after sagt, wie lange zu warten ist.
server-error- Die Website konnte nicht antworten. Etwas später erneut versuchen.