Startseite / API
API
Dieselben Zahlen wie auf den Seiten, für ein Programm lesbar. Die Antworten sind JSON, die Adressen und Feldnamen englisch.
Der Zugang ist heute offen: kein Schlüssel, kein Konto, kein Kontingent. Die Aufsichtsbehörden veröffentlichen diese Daten, diese Seite trägt sie zusammen und gibt sie in derselben Form an alle weiter. Die vollständige Datei beantwortet in einer Anfrage, wofür sonst Tausende von Seiten nötig wären, was den Server ebenso schont wie den Abfragenden.
| Adresse | Was sie zurückgibt |
|---|---|
/api/positions.jsonl.gz /api/positions.jsonl.gz | Alle offenen Positionen, eine je Zeile, komprimiert. Nach jeder Erhebung neu gebaut. |
/api/company/<slug> /api/company/klab-inc | Ein Unternehmen: wer es heute leer verkauft, und jede Meldung seit Beginn. |
/api/fund/<slug> /api/fund/citadel-advisors-llc | Ein Fonds: alle seine offenen Positionen, über alle Register hinweg. |
/api/moves /api/moves | Was sich in dreißig Tagen bewegt hat, benannt: opening, increase, reduction, below_threshold. |
/api/isins /api/isins | Eine Zeile je gemeldetem Unternehmen: seine ISIN und die Adresse seiner Seite. |
/api/openapi.json /api/openapi.json | Der Vertrag als OpenAPI-Dokument, um einen Client zu erzeugen statt diese Seite zu lesen. |
/action/<slug>/positions.csv /action/klab-inc/positions.csv | Ein Unternehmen oder ein Fonds: seine gesamte Meldehistorie als Tabelle. Spalten in der Sprache der Domain, Trennzeichen und Kodierung für Excel lesbar. |
/action/<slug>/movements.xml /action/klab-inc/movements.xml | Ein Unternehmen oder ein Fonds: seine Bewegungen als RSS-Feed. |
/mcp https://www.quivad.de/mcp | Der MCP-Server: ein Assistent verbindet sich damit und liest die Register selbst. Nur POST. |
Jeder Assistent, der das Model Context Protocol spricht, kann diese Register selbst lesen: fügen Sie ihm https://www.quivad.de/mcp hinzu. Fünf Werkzeuge, die ein Unternehmen oder einen Fonds finden, eines von beiden lesen, einen Markt ordnen und auflisten, was sich bewegt hat, und die wie der Rest dieser Oberfläche auf Englisch antworten, ohne Schlüssel und unter derselben Ratengrenze. Die aktuelle Revision des Protokolls und die drei davor werden unter dieser einen Adresse bedient; sie nimmt nur POST an, ein Aufruf im Browser antwortet also mit 405 und sagt es.
Eine lange Antwort wird durch limit (standardmäßig 1.000 Zeilen, höchstens 12.000) und offset geschnitten. Der page-Block der Antwort nennt die Gesamtzahl sowie die Adressen der nächsten und der vorigen Seite: nichts fällt weg, alles ist erreichbar, und ein unlesbarer Wert fällt auf den Standard zurück statt abzulehnen.
Ab 120 Anfragen pro Minute erhält eine Adresse eine 429 und die Wartezeit. Eine vom Cache bediente Antwort zählt nicht: die Grenze stoppt ein Absaugen, nie eine Nutzung.
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
Eine Ablehnung ist JSON wie eine Antwort, nie eine Seite: type, title, status und detail, in der Form, die RFC 9457 jeder HTTP-API gibt. Das Feld type zeigt auf einen der Anker unten.
company-not-found- Keine Gesellschaft antwortet unter dieser Adresse. Die Liste lebt unter /api/isins.
fund-not-found- Kein Fonds antwortet unter dieser Adresse.
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.
not-ready- Die Tagesdatei wird noch gebaut, mit der Wartezeit.
Die Daten stammen aus den amtlichen Veröffentlichungen der Aufsichtsbehörden und bleiben den Bedingungen unterworfen, die jede von ihnen setzt. Die bekannte Lizenz jedes Registers steht auf der Quellenseite. Zustand der Quellen ansehen