v0.2.0-beta

OpenAPI 3.1.0

Obtenir les métriques financières

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

Financial Data

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

Financial Data Opérations

get/v1/beta/financial/financial-metrics

Obtenir les métriques financières

Ratios calculés pour une société dans le temps, environ 49 par période : market_cap, enterprise_value, price_to_earnings_ratio, price_to_book_ratio, price_to_sales_ratio, enterprise_value_to_ebitda_ratio, free_cash_flow_yield, peg_ratio, gross_margin, operating_margin, net_margin, return_on_equity, return_on_assets, return_on_invested_capital, les ratios de rotation et de liquidité, chacun horodaté avec report_period et fiscal_period. period est obligatoire ; identifiez par ticker ou cik. Utilisez-le pour suivre la tendance d'un ratio entre périodes. Pour les valeurs actuelles uniquement, get_financial_financial_metrics_snapshot tient en une ligne et est bien plus petit.

Référence tarifaire

Mesure : base de coût fixe par requête réussie.
Estimation de référence par requête : USD 0.02.
Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de requête

cik
Type: string

La Central Index Key (CIK) de la société. Peut être utilisée à la place du ticker.
cursor
Type: string

Curseur de pagination opaque provenant du next_page_url d'une réponse précédente. Lorsqu'il est fourni, tous les autres paramètres de requête sont ignorés : le curseur transporte les filtres de la requête d'origine. Traitez-le comme opaque ; ne le construisez ni ne le modifiez.
filing_date
Type: string Format: date

Filtre par date exacte de dépôt auprès de la SEC au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.
filing_date_gt
Type: string Format: date

Filtre par date de dépôt auprès de la SEC postérieure à date, au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.
filing_date_gte
Type: string Format: date

Filtre par date de dépôt auprès de la SEC postérieure ou égale à date, au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.
filing_date_lt
Type: string Format: date

Filtre par date de dépôt auprès de la SEC antérieure à date, au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.
filing_date_lte
Type: string Format: date

Filtre par date de dépôt auprès de la SEC antérieure ou égale à date, au format YYYY-MM-DD. Utile pour les requêtes à un instant précis : ne renvoie que les données déjà déposées publiquement à la date indiquée. Les lignes sans date de dépôt connue sont exclues.
limit
Type: integer

Le nombre maximal de résultats à renvoyer. Il s'agit du total sur toutes les pages, et non de la taille d'une page : chaque page contient jusqu'à 10 enregistrements, reliés par next_page_url.
period
Type: string enum
obligatoire

La période des données financières.
valeurs
- annual
- quarterly
- ttm
report_period
Type: string Format: date

Filtre par date exacte de la période du rapport au format YYYY-MM-DD.
report_period_gt
Type: string Format: date

Filtrer par période de rapport supérieure à la date au format YYYY-MM-DD.
report_period_gte
Type: string Format: date

Filtrer par période de rapport supérieure ou égale à la date au format YYYY-MM-DD.
report_period_lt
Type: string Format: date

Filtrer par période de rapport inférieure à la date au format YYYY-MM-DD.
report_period_lte
Type: string Format: date

Filtrer par période de rapport inférieure ou égale à la date au format YYYY-MM-DD.
ticker
Type: string

Le symbole boursier de la société. Obligatoire si cik n'est pas fourni.

Réponses

200
Type: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

Les métriques et ratios financiers historiques d'un ticker
accession_number
Type: string | null

Le numéro d'accession SEC du document.

asset_turnover
Type: number

Chiffre d'affaires divisé par le total moyen de l'actif.

book_value_growth
Type: number

Croissance interannuelle de la valeur comptable.

book_value_per_share
Type: number

Capitaux propres divisés par les actions en circulation.

cash_ratio
Type: number

Trésorerie et équivalents de trésorerie divisés par le passif courant.

currency
Type: string

La devise dans laquelle les données financières sont présentées.

current_ratio
Type: number

Actifs courants divisés par le passif courant.

days_sales_outstanding
Type: number

Créances clients moyennes divisées par le chiffre d'affaires de la période.

debt_to_assets
Type: number

Dette totale divisée par le total de l'actif.

debt_to_equity
Type: number

Dette totale divisée par les capitaux propres.

earnings_growth
Type: number

Croissance interannuelle des bénéfices.

earnings_per_share
Type: number

Résultat net divisé par le nombre moyen pondéré d'actions en circulation.

earnings_per_share_growth
Type: number

Croissance du bénéfice par action sur la période.

ebitda_growth
Type: number

Croissance de l'EBITDA sur la période.

enterprise_value
Type: number

La valeur totale de la société (capitalisation boursière + dette - trésorerie).

enterprise_value_to_ebitda_ratio
Type: number

Ratio valeur d'entreprise / EBITDA.

enterprise_value_to_revenue_ratio
Type: number

Ratio valeur d'entreprise / chiffre d'affaires.

filing_date
Type: string | null Format: date

Jour calendaire auquel la SEC a accepté le document, heure de l'Est (fuseau horaire de fonctionnement de la SEC). Paire de jour calendaire avec filing_datetime. null lorsqu'aucun document SEC daté n'est associé à la ligne.

filing_datetime
Type: string | null Format: date-time

Horodatage à précision infra-journalière enregistrant le moment où la SEC a accepté le document, heure de l'Est. Issu du champ acceptanceDateTime de la SEC dans l'API de soumissions EDGAR. Fait la paire avec filing_date (précision au jour calendaire du même événement).

filing_url
Type: string | null Format: uri

URL du document SEC.

fiscal_period
Type: string

La période fiscale des métriques financières.

form_type
Type: string | null

Le formulaire SEC dont provient cette ligne (10-K, 10-Q/A, 20-F, S-1, ...). Le formulaire exact tel que déposé, de sorte que les amendements conservent leur suffixe /A. null lorsque period vaut ttm : une fenêtre de douze mois glissants peut couvrir plusieurs documents, nous ne l'attribuons donc pas à un seul. Une ligne quarterly peut porter 10-K lorsque le quatrième trimestre est dérivé du document de l'exercice fiscal.

free_cash_flow_growth
Type: number

Croissance du flux de trésorerie disponible sur la période.

free_cash_flow_per_share
Type: number

Flux de trésorerie disponible divisé par les actions en circulation.

free_cash_flow_yield
Type: number

Rendement du flux de trésorerie disponible.

gross_margin
Type: number

Bénéfice brut en pourcentage du chiffre d'affaires.

interest_coverage
Type: number

EBIT divisé par les charges d'intérêts.

inventory_turnover
Type: number

Coût des marchandises vendues divisé par le stock moyen.

net_margin
Type: number

Résultat net en pourcentage du chiffre d'affaires.

next_page_url
Type: string

URL absolue de la page de résultats suivante. Présente uniquement lorsqu'il reste des résultats ; demandez-la telle quelle pour continuer. Chaque page contient jusqu'à 10 enregistrements.

operating_cash_flow_ratio
Type: number

Flux de trésorerie d'exploitation divisé par le passif courant.

operating_cycle
Type: number

Rotation des stocks + rotation des créances clients.

operating_income_growth
Type: number

Croissance du résultat opérationnel sur la période.

operating_margin
Type: number

Résultat opérationnel en pourcentage du chiffre d'affaires.

payout_ratio
Type: number

Dividendes versés en pourcentage du résultat net.

peg_ratio
Type: number

Ratio cours/bénéfice avec croissance.

period
Type: string enum

La période des métriques financières.

valeurs
quarterly
ttm
annual
price_to_book_ratio
Type: number

Ratio cours/valeur comptable.

price_to_earnings_ratio
Type: number

Ratio cours/bénéfice.

price_to_sales_ratio
Type: number

Ratio cours/chiffre d'affaires.

quick_ratio
Type: number

Actifs liquides divisés par le passif courant.

receivables_turnover
Type: number

Chiffre d'affaires divisé par les créances clients moyennes.

report_period
Type: string Format: date

La période de référence des métriques financières.

return_on_assets
Type: number

Résultat net en pourcentage du total de l'actif.

return_on_equity
Type: number

Résultat net en pourcentage des capitaux propres.

return_on_invested_capital
Type: number

Résultat opérationnel net après impôts en pourcentage du capital investi.

revenue_growth
Type: number

Croissance interannuelle du chiffre d'affaires.

ticker
Type: string

Le symbole ticker de la société.

working_capital_turnover
Type: number

Chiffre d'affaires divisé par le fonds de roulement moyen.
application/json
400

La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
401

Une clé API Felo valide est requise.
402

La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
403

Le compte n'est pas autorisé à effectuer cette opération.
429

Une limite de requêtes ou de dépenses a été atteinte.
502

Le service n'a pas pu terminer la requête.
503

L'API ou le service de facturation est temporairement indisponible.
504

Le service a expiré lors du traitement de la requête.
default

Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

application/json

get/v1/beta/financial/financial-metrics

curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Afficher le schéma

{
  "ticker": "string",
  "report_period": "2026-10-26",
  "fiscal_period": "string",
  "period": "quarterly",
  "currency": "string",
  "accession_number": null,
  "form_type": null,
  "filing_url": null,
  "filing_date": null,
  "filing_datetime": null,
  "enterprise_value": 1,
  "price_to_earnings_ratio": 1,
  "price_to_book_ratio": 1,
  "price_to_sales_ratio": 1,
  "enterprise_value_to_ebitda_ratio": 1,
  "enterprise_value_to_revenue_ratio": 1,
  "free_cash_flow_yield": 1,
  "peg_ratio": 1,
  "gross_margin": 1,
  "operating_margin": 1,
  "net_margin": 1,
  "return_on_equity": 1,
  "return_on_assets": 1,
  "return_on_invested_capital": 1,
  "asset_turnover": 1,
  "inventory_turnover": 1,
  "receivables_turnover": 1,
  "days_sales_outstanding": 1,
  "operating_cycle": 1,
  "working_capital_turnover": 1,
  "current_ratio": 1,
  "quick_ratio": 1,
  "cash_ratio": 1,
  "operating_cash_flow_ratio": 1,
  "debt_to_equity": 1,
  "debt_to_assets": 1,
  "interest_coverage": 1,
  "revenue_growth": 1,
  "earnings_growth": 1,
  "book_value_growth": 1,
  "earnings_per_share_growth": 1,
  "free_cash_flow_growth": 1,
  "operating_income_growth": 1,
  "ebitda_growth": 1,
  "payout_ratio": 1,
  "earnings_per_share": 1,
  "book_value_per_share": 1,
  "free_cash_flow_per_share": 1,
  "next_page_url": "string"
}

Les métriques et ratios financiers historiques d'un ticker

Obtenir les métriques financières

AuthentificationRequired

Financial Data

Obtenir les métriques financières

Référence tarifaire