Felo API PlatformFelo API Platform
Alle Endpoints von Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Finanzabschlüsse durchsuchen

Server:https://openapi.felo.ai
Client-Bibliotheken

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Finanzabschlüsse durchsuchen

​

Findet Ticker, die numerische Bedingungen erfüllen. Der Body nimmt filters – jeweils ein field, ein operator und ein value – plus limit. Liefert results mit ticker, currency, sector, industry und dem jeweils gefilterten Feld, das übereinstimmte. Dies ist das einzige Tool hier, das ohne vorherige Kenntnis eines Tickers funktioniert; alle anderen erwarten einen als Eingabe. Filterbare Felder sind die Kennzahlen, die get_financial_financial_metrics zurückgibt. Nutzen Sie es, um eine Kandidatenliste zu erstellen, und rufen Sie dann Details zu jedem Namen mit den Abschluss- oder Kennzahlen-Tools ab.

Preisreferenz

  • Abrechnung: Feste Kostenbasis pro erfolgreicher Anfrage.
  • Referenzschätzung pro Anfrage: USD 0.02.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body
erforderlich
application/json
  • filters
    Typ: array object[] 1…
    erforderlich

    Ein Array von Filterobjekten, die auf die Suche angewendet werden.

    • field
      Typ: string
      erforderlich

      Die Kriterien, nach denen gefiltert wird. Für Felder mit Finanzkennzahlen verwenden Sie die Operatoren 'gt', 'lt', 'gte', 'lte' und 'eq'. Für die Felder 'ticker' und 'cik' verwenden Sie den Operator 'in', um gegen mehrere Werte zu filtern.

    • operator
      Typ: string enum
      erforderlich

      Der Vergleichsoperator. Der Operator 'in' kann nur mit dem Feldwert 'ticker' oder 'cik' verwendet werden und ermöglicht das Filtern gegen mehrere Werte.

      Werte
      • gt
      • lt
      • gte
      • lte
      • eq
      • in
    • value
      erforderlich
      • Typ: number

        Der Wert, mit dem bei Operatoren für Einzelwerte (gt, lt, gte, lte, eq) verglichen wird

  • limit
    Typ: integer
    min.:  
    1

    Die maximale Anzahl der zurückzugebenden Ergebnisse.

Antworten
  • 200
    Typ: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse

    Erfolgreiche Suchantwort

    • search_results
      Typ: array object[]
      • currency
        Typ: string

        Die Währung der Finanzdaten.

      • period
        Typ: string enum

        Der Zeitraum der Finanzdaten.

        Werte
        • annual
        • quarterly
        • ttm
      • report_period
        Typ: string Format: date

        Der Berichtszeitraum der Finanzdaten.

      • ticker
        Typ: string

        Das Tickersymbol des Unternehmens.

      • propertyName
        Typ: string

        Zusätzliche Finanzkennzahlen basierend auf den Suchkriterien.

    application/json
  • 400

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

    application/json
Request Example for post/v1/beta/financial/financials/search/screener
curl https://openapi.felo.ai/v1/beta/financial/financials/search/screener \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "limit": 10,
  "filters": [
    {
      "field": "",
      "operator": "gt",
      "value": 1
    }
  ]
}'
{
  "search_results": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "period": "annual",
      "currency": "string",
      "additionalProperty": "string"
    }
  ]
}
Search financial statements