Buscar métricas financieras específicas
Financial Data
Company fundamentals, financial statements, market prices and economic data.
Buscar métricas financieras específicas
Extrae partidas financieras con nombre de una o más empresas en una sola llamada. El cuerpo toma tickers y line_items (ambos obligatorios, ambos arrays), además de period (annual, quarterly o ttm) y limit. Devuelve search_results con una fila por ticker y período que contiene solo los campos solicitados, junto con report_period, period y currency. Úsalo para crear una tabla comparativa sin traer tres estados completos por empresa. Los nombres de partidas son los mismos nombres de campo que devuelven las herramientas de estados, así que búscalos allí primero si tienes dudas. Para todo sobre una sola empresa usa get_financial_financials.
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 string[] 1…line
_items obligatorioUn array de partidas que se aplicarán a la búsqueda.
- Tipo: array string[] 1…tickersobligatorio
Un array de tickers que se aplicarán a la búsqueda.
- Tipo: integerlimitmín.:1
El número máximo de resultados que se devolverán.
- Tipo: string enumperiod
El periodo de los datos financieros.
valores- annual
- quarterly
- ttm
- 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/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"
}
]
}