Financial Data
Company fundamentals, financial statements, market prices and economic data.
Rechercher des états financiers
Trouve les tickers qui correspondent à des conditions numériques. Le corps prend filters — chacun avec un field, un operator et une value —, plus limit. Renvoie results avec ticker, currency, sector, industry et le champ filtré qui a correspondu. C'est le seul outil ici qui fonctionne sans connaître un ticker à l'avance ; tous les autres en prennent un en entrée. Les champs filtrables sont les noms de métriques renvoyés par get_financial_financial_metrics. Utilisez-le pour constituer une liste de candidats, puis récupérez le détail de chaque nom avec les outils d'états financiers ou de métriques.
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.
- Type: array object[] 1…filtersobligatoire
Tableau d'objets de filtre à appliquer à la recherche.
- fieldType: stringobligatoire
Critères de filtrage. Pour les champs de métrique financière, utilisez les opérateurs 'gt', 'lt', 'gte', 'lte' et 'eq'. Pour les champs 'ticker' et 'cik', utilisez l'opérateur 'in' pour filtrer plusieurs valeurs.
- operatorType: string enumobligatoire
L'opérateur de comparaison. L'opérateur 'in' ne peut être utilisé qu'avec une valeur de champ 'ticker' ou 'cik' et permet de filtrer plusieurs valeurs.
valeurs- gt
- lt
- gte
- lte
- eq
- in
- valueobligatoire
- Type: number
La valeur à comparer pour les opérateurs à valeur unique (gt, lt, gte, lte, eq)
- Type: integerlimitmin.:1
Nombre maximal de résultats à renvoyer.
- Type: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
Réponse de recherche réussie
- Type: array object[]search
_results - currencyType: string
La devise des données financières.
- periodType: string enum
La période des données financières.
valeurs- annual
- quarterly
- ttm
- reportType: string Format: date
_period La période de référence des données financières.
- tickerType: string
Le symbole ticker de la société.
- propertyType: string
Name Métriques financières supplémentaires selon les critères de recherche.
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
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"
}
]
}