Financial Data
Company fundamentals, financial statements, market prices and economic data.
Buscar estados financieros
Encuentra tickers que cumplen condiciones numéricas. El cuerpo toma filters — cada uno con field, operator y value —, además de limit. Devuelve results con ticker, currency, sector, industry y el campo filtrado que coincidió. Esta es la única herramienta que funciona sin conocer un ticker de antemano; todas las demás toman uno como entrada. Los campos filtrables son los nombres de métricas que devuelve get_financial_financial_metrics. Úsala para crear una lista de candidatos y luego consulta el detalle de cada nombre con las herramientas de estados o de métricas.
Referencia de precios
- Medición: base de costo fija por solicitud exitosa.
- Estimación de referencia por solicitud: USD 0.02.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: array object[] 1…filtersobligatorio
Un array de objetos de filtro que se aplicarán a la búsqueda.
- fieldTipo: stringobligatorio
Los criterios de filtrado. Para los campos de métricas financieras, usa los operadores 'gt', 'lt', 'gte', 'lte' y 'eq'. Para los campos 'ticker' y 'cik', usa el operador 'in' para filtrar varios valores.
- operatorTipo: string enumobligatorio
El operador de comparación. El operador 'in' solo puede usarse con un valor de campo 'ticker' o 'cik' y permite filtrar varios valores.
valores- gt
- lt
- gte
- lte
- eq
- in
- valueobligatorio
- Tipo: number
El valor con el que comparar para operadores de valor único (gt, lt, gte, lte, eq)
- Tipo: integerlimitmín.:1
El número máximo de resultados que se devolverán.
- Tipo: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
Respuesta de búsqueda correcta
- Tipo: array object[]search
_results - currencyTipo: string
La moneda de los datos financieros.
- periodTipo: string enum
El período de los datos financieros.
valores- annual
- quarterly
- ttm
- reportTipo: string Formato: date
_period El período de referencia de los datos financieros.
- tickerTipo: string
El símbolo de ticker de la empresa.
- propertyTipo: string
Name Métricas financieras adicionales según los criterios de búsqueda.
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
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"
}
]
}