GCS-Scores je Aktie per API abrufen

TL;DR — GET /api/v1/scores liefert den aggregierten GCS-Score je Aktie als Stärke-Band (kein Kauf-/Verkaufssignal), zusammen mit den einzelnen Komponenten, einer Exit-/Timing-Achse und der Klassifikation nach Sektor, Marktkapitalisierung und Handelsvolumen — für einzelne CIKs oder als paginierte Rangliste.

Was die Antwort enthält

# Bis zu 100 CIKs auf einmal
curl -H "Authorization: Bearer <TOKEN>" \
  "https://inside-filings.com/api/v1/scores?cik=789019,320193"

# Rangliste, paginiert, als XLSX
curl -H "Authorization: Bearer <TOKEN>" \
  "https://inside-filings.com/api/v1/scores?limit=100&offset=0&format=xlsx" -o scores.xlsx

Ohne ?cik= liefert der Endpunkt die volle, paginierte Rangliste (?limit=, Default 100, Max 1000; ?offset=; meta.total/meta.limit/meta.offset). meta trägt zusätzlich disclaimer und methodology_url — bei jedem Aufruf, mit oder ohne ?cik=.

Beispiel-Antwort (gekürzt, illustrative Werte)

{
  "meta": {
    "disclaimer": "Allgemeine, modellbasierte Finanzanalyse (Glück Conviction Score™) — Informationsdienst, keine Anlageberatung und keine individuelle Anlageempfehlung i. S. v. Art. 3 Abs. 1 Nr. 35 MAR / DelVO (EU) 2016/958.",
    "methodology_url": "https://inside-filings.com/methodik",
    "generated_at": "2026-08-16T14:02:00Z"
  },
  "data": [
    {
      "cik": 789019,
      "ticker": "MSFT",
      "stock_name": "MICROSOFT CORP",
      "composite_score": 71.4,
      "recommendation": "strong",
      "band_label": "Stark",
      "segment": 4,
      "insider_score": 0.58,
      "inst_score": 0.61,
      "activist_score": 0.0,
      "momentum_score": 0.52,
      "fundamental_score": 0.74,
      "exit_state": "hold",
      "exit_score": 0.31,
      "exit_threshold": 0.65,
      "entry_coverage": 0.83,
      "timing_state": "neutral",
      "timing_score": 0.12,
      "sector_label": "Technology",
      "market_cap": 3120000000000,
      "market_cap_class": 5,
      "is_adr": false,
      "reliable": true
    }
  ]
}

Beispiel-Antwort als CSV (?format=csv)

CIK,Ticker,Name,GCS Score,Band,Band-Label,Liquidity Tier,Insider,Institutional,Activist,Momentum,Fundamental,Exit State,Exit Score,Exit Threshold,Coverage,Timing State,Timing Score,Sector,Market Cap (USD),Cap Class,ADR,Reliable
789019,MSFT,MICROSOFT CORP,71.4,strong,Stark,4,0.58,0.61,0.0,0.52,0.74,hold,0.31,0.65,0.83,neutral,0.12,Technology,3120000000000,5,false,true

Die CSV-Spaltenköpfe sind die deutschen Labels aus der Endpunkt-Definition (GCS Score, Band, …), nicht die JSON-Keys — für Tools, die auf feste JSON-Keys angewiesen sind, ist ?format=json die verlässlichere Wahl.

Stärke-Band statt Kaufempfehlung

Inside-Filings ist ein Informationsdienst, kein Wertpapierinstitut. Der Score ist deshalb konsequent als Stärke-Band ausgezeichnet — „sehr stark" bis „sehr schwach" — statt als Kauf-/Verkaufsempfehlung. Die äußeren Bänder setzen eine kalibrierte Schwelle der jeweiligen Signal-Variante voraus; ist eine Variante noch nicht kalibriert, treten nur die drei mittleren Bänder auf. Die Antwort verweist zusätzlich über meta.methodology_url auf die Methodik-Erklärung.

Häufige Fragen (FAQ)

Ist der Score eine Kaufempfehlung?

Nein. Inside-Filings ist ein reiner Informationsdienst. Der Score wird bewusst als Stärke-Band ausgegeben, nicht als Handlungsanweisung — die Gewichtung und Kalibrierung dahinter ist zudem nicht Teil der Antwort.

Welche Aktien deckt der Endpunkt ab?

Alle Aktien, für die ein Score berechnet wurde. Das Feld reliable zeigt an, ob die Datenbasis für einen belastbaren Score ausreicht — bei „false" ist der Score mit Vorsicht zu lesen.

Kann ich mehrere Aktien auf einmal abfragen?

Ja, bis zu 100 CIKs kommagetrennt über ?cik=. Für mehr eignet sich die paginierte Rangliste ohne ?cik=.

Warum steht bei manchen Titeln keine Exit-/Timing-Achse?

Diese Achse ist nur für Marktsegmente mit aktiver Exit-Konfiguration berechnet — für andere Segmente bleiben die entsprechenden Felder leer.

Verwandte Endpunkte: Emittenten-Stammdaten unter issuer-master, Konzerndaten unter issuer-relationships. Hintergrund zu einer der Signalkomponenten liefert unser Artikel zu Holder Breadth. Zugang erklärt das Onboarding.