Dokumentation der API

Fondsdurchschau

Ein Fonds im Depot A Ihrer Bank wird über seine Bestandteile überwacht. Sie laden die Bestandteile hoch, die die Kapitalverwaltungsgesellschaft des Fonds meldet, Stonewake ordnet jeden über die Register für ISIN und LEI seinem Unternehmen zu, und jedes zugeordnete Unternehmen kommt in den Bestand Ihres Teams und wird wie Ihre anderen Beteiligungen überwacht. Jeder Fonds zeigt dann seine Bestandteile, die schwächsten zuerst, mit Kreditstatus, Signalen und täglichem Pressetenor jedes Unternehmens. Im Dashboard liegen die Fonds auf der Portfolioseite unter Fonds, wo Fonds importieren auch eine Vorlage zum Herunterladen anbietet.

Zuordnen, nie raten

Jeder Bestandteil wird über seine ISIN oder seinen LEI mit demselben Verfahren für jede Zeile in fester Reihenfolge zugeordnet. Zuerst antwortet die Zuordnung von ISIN zu LEI von GLEIF und ANNA, dann ESMA FIRDS und FCA FIRDS, dann der LEI, den die Zeile nennt. Jede antwortende Quelle muss dasselbe Unternehmen nennen, sonst ist die Zeile ein Widerspruch und wird keinem von ihnen zugeordnet. Eine Zeile, die nur einen Namen nennt, wird nie zugeordnet, wie genau sie ein Unternehmen auch benennt, und sie sagt, wie viele Unternehmen diesen Namen tragen. Ein Bestandteil, den keine Quelle nennt, bleibt nicht zugeordnet. Eine nicht zugeordnete Zeile wird als nicht zugeordnet gezeigt, nennt kein Unternehmen und kommt nie in den Bestand. Jede zugeordnete Zeile behält den Nachweis, der sie belegt, die Quelle, das Nachgeschlagene und den Datensatz oder die Kennungszeile, die geantwortet hat.

Die Datei

Die erste Zeile ist die Kopfzeile. as_of und weight sind Pflicht, dazu fund_isin oder fund_lei für den Fonds und isin, lei oder name für den Bestandteil.

text

fund_isin,fund_lei,fund_name,as_of,isin,lei,name,weight
DE0008491051,,UniGlobal,2026-10-31,DE0007164600,,SAP SE,4.5
DE0008491051,,UniGlobal,2026-10-31,DE0007236101,,Siemens AG,3.25
DE0008491051,,UniGlobal,2026-10-31,DE0008404005,,Allianz SE,2.8

Jede Zeile nennt ihren Fonds über dessen ISIN oder LEI, und beide müssen ihre Prüfziffern bestehen (ISO 6166 und ISO 17442). Zeilen, die denselben Fonds nennen, bilden diesen Fonds, eine Datei kann also mehrere Fonds enthalten.
as_of ist der Tag, für den die Kapitalverwaltungsgesellschaft die Bestandteile angibt, geschrieben 2026-10-31 oder 31.10.2026, und nie nach heute. Alle Zeilen eines Fonds nennen dasselbe as_of und, wo sie eines angeben, denselben fund_lei und denselben fund_name.
weight ist der Anteil des Bestandteils am Fonds in Prozent, mehr als 0 und höchstens 100, mit höchstens sechs Nachkommastellen nach Punkt oder Komma, zum Beispiel 4.5, 4,5 oder 4.5%.
Die Datei ist durch Kommas getrennt, eine mit Semikolons geschriebene Kopfzeile wird mit Semikolons gelesen. Höchstens 2.000 Zeilen und 1.000.000 Zeichen je Datei. Eine als Unicode Text gespeicherte Datei oder eine Datei mit einem Steuerzeichen wird als Ganzes abgelehnt.
fund_name und name werden zu Ihrer Prüfung gezeigt und nie zur Zuordnung verwendet.

Was jeder Fonds und jede Zeile meldet

Ergebnis des Fonds	Bedeutung
`new`	Der Fonds wird gespeichert, und seine zugeordneten Unternehmen kommen in den Bestand.
`replaces`	Der Fonds war mit anderen Zeilen gespeichert, oder eine Zeile wird jetzt einem anderen oder keinem Unternehmen zugeordnet. Der neue Upload wird gespeichert, der frühere bleibt als Verlauf erhalten.
`unchanged`	Der gespeicherte Fonds nennt genau dasselbe, jede Zeile wie zuvor zugeordnet. Es wird nichts geschrieben.
`invalid`	Vom Fonds wird nichts gespeichert und keines seiner Unternehmen kommt in den Bestand, weil eine seiner Zeilen nicht lesbar ist (`fund_has_invalid_lines`), seine Zeilen verschiedene Tage `as_of` nennen (`as_of_differs`) oder einen anderen LEI oder einen anderen Namen des Fonds (`fund_lines_disagree`).

Status der Zeile	Bedeutung
`resolved`	Jede antwortende Quelle nennt ein Unternehmen.
`conflict`	Zwei Quellen nennen verschiedene Unternehmen. Keinem zugeordnet.
`ambiguous`	Die Zeile nennt nur einen Namen. Keinem zugeordnet.
`unresolved`	Keine Quelle nennt ein Unternehmen, oder eine Kennung besteht ihre Prüfziffern nicht.
`invalid`	Die Zeile verletzt die Regeln der Datei und wurde nie nachgeschlagen, etwa ein Gewicht, das keine Zahl zwischen 0 und 100 ist, oder ein `as_of` nach heute.

Ein zugeordnetes Unternehmen zeigt dann, was der Import im Bestand tut, add, reactivate, in_book oder duplicate, wie beim Bestandsimport. Eine Zeile, deren Fonds gar nicht lesbar ist, etwa eine ohne Kennung des Fonds, wird gesondert mit ihrem Grund aufgeführt.

Die schwächsten zuerst

Die Bestandteile eines Fonds sind nach ihrer Einstufung im Bestand Ihres Teams geordnet. Rot steht zuerst, dann Gelb, dann nicht zugeordnet, weil ein Bestandteil, den niemand benennen kann, nie als unauffällig gilt, dann unzureichend, dann die noch nicht bewerteten oder nicht mehr im Bestand geführten Unternehmen und Grün zuletzt. Innerhalb einer Einstufung steht der negativere tägliche Pressetenor zuerst, dann das größere Gewicht. Jeder Fonds zählt außerdem seine Zeilen und summiert ihre Gewichte je Einstufung, und die Liste der Fonds stellt den schwächsten Fonds an den Anfang.

Der Pressetenor ist die jüngste tägliche Messung der Nachrichtenbeobachtung, der mittlere Ton der Berichterstattung über ihr Zeitfenster. Er ist Kontext neben dem Kreditstatus und nie Teil des Scores.

Über API und MCP

GET /v1/portfolio/funds listet die Fonds Ihres Teams, den schwächsten zuerst, mit den Zahlen je Einstufung.
GET /v1/portfolio/funds/{fund_id} liefert einen Fonds mit seinen Bestandteilen, die schwächsten zuerst, seitenweise über limit (Standard und Höchstwert 100) und offset, jeden mit Zuordnung, Grund, Nachweis, Einstufung, Score, wichtigsten Signalen und Pressetenor.
POST /v1/portfolio/funds/import zeigt die Vorschau einer Fondsdatei. Senden Sie {"csv": "..."}. dry_run ist bei /v1 immer true, die API bleibt also lesend, und übernommen wird ein Import im Dashboard. Die Zeilen kommen seitenweise in der Reihenfolge der Datei, jede mit ihrem Fonds, während funds, counts und total die ganze Datei abdecken.
Die Werkzeuge für MCP portfolio_funds und portfolio_fund_import_preview lesen dasselbe.