Update für den Search-Endpoint: Assets per Ticker-Array abrufen

Überblick über den neuen Request-Parameter im Search-Endpoint, der den direkten Abruf von Assets über ein Ticker-Array ermöglicht.

• • 3 Min. Lesezeit

Der Search-Endpoint in der FinImpulse API wurde aktualisiert und enthält jetzt einen neuen Request-Parameter: „symbols“.

Bisher erforderte das Abrufen von Daten für eine bekannte Menge von Tickern entweder eine Textsuche oder einen Filterausdruck – beides ist nicht für den direkten, listenbasierten Abruf ausgelegt.

Der Parameter „symbols“ akzeptiert ein explizites Array von Ticker-Symbolen und gibt für jedes übereinstimmende Asset Daten zurück. Er erweitert die vorhandene Funktionspalette und führt – neben der textbasierten und der filterbasierten Suche, die der Endpoint bereits unterstützt – einen direkten Lookup-Modus ein.

So funktioniert der Parameter „symbols“

„symbols“ ist ein optionaler Array-Parameter. Jedes Element ist ein String, der ein Ticker-Symbol darstellt (z. B. „AAPL“, „SPY“, „VFIAX“).

"symbols": ["VTI", "VFIAX", "FXAIX"]

Wenn „symbols“ in der Anfrage enthalten ist, gibt der Endpoint Daten nur für die angegebenen Ticker zurück. Die Struktur der Antwort bleibt unverändert – dasselbe einheitliche, assetübergreifende Format mit Feldern zu Kurs, Liquidität, Performance, Klassifizierung und Fundamentaldaten.

Beachten Sie das folgende Verhalten des Parameters:

  • Wenn ein Ticker im Array nicht existiert, wird er ohne Fehlermeldung aus den Ergebnissen ausgeschlossen. Zurückgegeben werden nur übereinstimmende Symbole.
  • Wenn keines der angegebenen Symbole gefunden wird, gibt der Endpoint ein leeres Ergebnis zurück.

Symbols mit anderen Parametern kombinieren

Der Parameter „symbols“ kann mit allen anderen optionalen Parametern des Endpoints kombiniert werden. So sind Filterung, Sortierung und Pagination für eine definierte Menge von Tickern möglich.

Wenn symbols jedoch als primäre Auswahlmethode verwendet wird, stellen Sie sicher, dass alle zusätzlichen Parameter mit den Asset-Typen und -Namen der angeforderten Ticker konsistent sind.

Die folgenden Fälle veranschaulichen die Wechselwirkungen zwischen den Parametern.

search_text & symbols

Wenn search_text mit keinem der angegebenen Ticker übereinstimmt, ist das Ergebnis leer.

So liefert beispielsweise die Kombination von symbols: [„AAPL“, „MSFT“] mit search_text: „fund“ keine Ergebnisse. Wenn „symbols“ gesetzt ist, werden nur die angegebenen Ticker berücksichtigt, und weder AAPL noch MSFT entspricht der Textsuche „fund“.

quote_types & symbols

Ebenso erscheinen Ticker nicht in der Antwort, wenn quote_types den Asset-Typ der angegebenen Ticker nicht enthält.

Die Kombination von symbols: [„AAPL“] mit quote_types: [„mutualfund“] liefert keine Ergebnisse, da AAPL eine Aktie ist.

Die vollständige Liste der unterstützten Parameter finden Sie in der Dokumentation des Search-Endpoints.

Beispielanfrage

Die folgende Anfrage ruft Daten für drei bestimmte Ticker ab, sortiert nach dem in USD normierten Marktwert in absteigender Reihenfolge:

{
    "symbols": ["VTI", "VFIAX", "FXAIX"],
    "offset": 0,
    "limit": 10,
    "sort_by": [
        {
            "selector": "amount_usd",
            "desc": true
        }
    ]
}

Die Antwort enthält Pagination-Metadaten und das vollständige Item-Array. Jedes Element enthält alle verfügbaren Felder: Identifikation, Börsendaten, Kursdaten, Volumen, technische Indikatoren, Performance, Dividenden und Fundamentaldaten.

Endpoint testen

Neue Konten erhalten bei der Registrierung API-Guthaben in Höhe von 1 $.