Felo API PlatformFelo API Platform
Alle endpoints van Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Specifieke financiële metrics zoeken

Server:https://openapi.felo.ai
Clientbibliotheken

Financial Data

​

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

Specifieke financiële metrics zoeken

​

Haalt benoemde financiële posten over één of meer bedrijven in één aanroep op. De body neemt tickers en line_items (beide vereist, beide arrays), plus period (annual, quarterly of ttm) en limit. Retourneert search_results met één rij per ticker en periode, met alleen de velden die je hebt opgevraagd, naast report_period, period en currency. Gebruik het om een vergelijkingstabel te bouwen zonder drie volledige overzichten per bedrijf op te halen. De itemnamen zijn dezelfde veldnamen die de overzichtstools retourneren, dus zoek daar eerst op als je twijfelt. Voor alles over één bedrijf gebruik je get_financial_financials.

Prijsreferentie

  • Metering: Vaste kostenbasis per geslaagd verzoek.
  • Referentieschatting per verzoek: USD 0.02.
  • Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body
verplicht
application/json
  • line_items
    Type: array string[] 1…
    verplicht

    Een array met posten die op de zoekopdracht worden toegepast.

  • tickers
    Type: array string[] 1…
    verplicht

    Een array met tickers die op de zoekopdracht worden toegepast.

  • limit
    Type: integer
    min.:  
    1

    Het maximale aantal resultaten dat moet worden geretourneerd.

  • period
    Type: string enum

    De periode voor de financiële gegevens.

    waarden
    • annual
    • quarterly
    • ttm
Responsen
  • 200
    Type: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse

    Geslaagde zoekrespons

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

        De valuta van de financiële gegevens.

      • period
        Type: string enum

        De periode van de financiële gegevens.

        waarden
        • annual
        • quarterly
        • ttm
      • report_period
        Type: string Formaat: date

        De verslagperiode van de financiële gegevens.

      • ticker
        Type: string

        Het tickersymbool van het bedrijf.

      • propertyName
        Type: string

        Aanvullende financiële metrieken op basis van de zoekcriteria.

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

    application/json
Request Example for post/v1/beta/financial/financials/search/line-items
curl https://openapi.felo.ai/v1/beta/financial/financials/search/line-items \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "line_items": [
    ""
  ],
  "tickers": [
    ""
  ],
  "period": "ttm",
  "limit": 1
}'
{
  "search_results": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "period": "annual",
      "currency": "string",
      "additionalProperty": "string"
    }
  ]
}
Search specific financial metrics