Financial Data
Company fundamentals, financial statements, market prices and economic data.
Obtener todos los estados financieros
Los tres estados financieros de una empresa en una sola llamada. Devuelve un objeto financials con income_statements, balance_sheets y cash_flow_statements, cada uno con la misma forma que devuelven las herramientas dedicadas. period es obligatorio (annual, quarterly o ttm); identifica la empresa por ticker o cik y limita con limit. Úsalo cuando necesites el panorama completo y de otro modo harías tres llamadas. Cuando solo necesites un estado, get_financial_financials_income_statements, get_financial_financials_balance_sheets o get_financial_financials_cash_flow_statements devuelven muchos menos datos; cuando necesites unos pocos campos con nombre en varias empresas, post_financial_financials_search_line_items es aún más limitado.
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: stringcik
La Central Index Key (CIK) de la empresa.
- Tipo: stringcursor
Cursor de paginación opaco procedente del next_page_url de una respuesta anterior. Cuando se proporciona, se ignoran todos los demás parámetros de consulta: el cursor transporta los filtros de la solicitud original. Trátalo como opaco; no lo construyas ni lo modifiques.
- Tipo: string Formato: datefiling
_date Filtra por la fecha exacta de presentación ante la SEC en formato YYYY-MM-DD. Se excluyen las filas sin una fecha de presentación conocida.
- Tipo: string Formato: datefiling
_date _gt Filtra por fecha de presentación ante la SEC posterior a date, en formato YYYY-MM-DD. Se excluyen las filas sin una fecha de presentación conocida.
- Tipo: string Formato: datefiling
_date _gte Filtra por fecha de presentación ante la SEC posterior o igual a date, en formato YYYY-MM-DD. Se excluyen las filas sin una fecha de presentación conocida.
- Tipo: string Formato: datefiling
_date _lt Filtra por fecha de presentación ante la SEC anterior a date, en formato YYYY-MM-DD. Se excluyen las filas sin una fecha de presentación conocida.
- Tipo: string Formato: datefiling
_date _lte Filtra por fecha de presentación ante la SEC anterior o igual a date, en formato YYYY-MM-DD. Útil para consultas en un punto concreto en el tiempo: devuelve solo los datos que ya se habían presentado públicamente en la fecha indicada. Se excluyen las filas sin una fecha de presentación conocida.
- Tipo: integer Formato: int32limit
El número máximo de estados financieros que se van a devolver. Este es el total de todas las páginas, no el tamaño de una página: cada página contiene hasta 10 registros, enlazados por
next_page_url. - Tipo: string enumperiodobligatorio
El período de los estados financieros.
valores- annual
- quarterly
- ttm
- Tipo: string Formato: datereport
_period Filtra por la fecha exacta del periodo del informe en formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _gt Filtrar por período de informe mayor que la fecha en formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _gte Filtrar por período de informe mayor o igual que la fecha en formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _lt Filtrar por período de informe menor que la fecha en formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _lte Filtrar por período de informe menor o igual que la fecha en formato YYYY-MM-DD.
- Tipo: stringticker
El símbolo del ticker. Obligatorio si no se proporciona cik.
- Tipo: object · ResponseE40Feb4D3D6B_FinancialsResponse200
Respuesta de estados financieros
- Tipo: objectfinancials
- balanceTipo: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
_sheets - accessionTipo: string | null
_number El número de acceso de la SEC del documento.
- accumulatedTipo: number
_other _comprehensive _income Los otros resultados integrales acumulados de la empresa.
- cashTipo: number
_and _equivalents El efectivo y equivalentes de efectivo de la empresa.
- currencyTipo: string
La moneda en la que se presentan los datos financieros.
- currentTipo: number
_assets Los activos corrientes de la empresa.
- currentTipo: number
_debt La deuda corriente de la empresa.
- currentTipo: number
_investments Las inversiones corrientes de la empresa.
- currentTipo: number
_liabilities Los pasivos corrientes de la empresa.
- deferredTipo: number
_revenue Los ingresos diferidos de la empresa.
- depositTipo: number
_liabilities Los pasivos por depósitos de la empresa.
- filingTipo: string | null Formato: date
_date Día calendario en que la SEC aceptó el documento, en hora del Este (la zona horaria de operación de la SEC). Pareja de día calendario de
filing_datetime. null cuando no hay ningún documento fechado de la SEC vinculado a la fila. - filingTipo: string | null Formato: date-time
_datetime Marca temporal con precisión inferior al día que registra cuándo aceptó la SEC el documento, en hora del Este. Proviene del campo
acceptanceDateTimede la SEC en la API de envíos de EDGAR. Forma pareja confiling_date(precisión de día calendario del mismo evento). - filingTipo: string | null Formato: uri
_url URL del documento de la SEC.
- fiscalTipo: string
_period El período fiscal del balance general.
- formTipo: string | null
_type El formulario de la SEC del que procede esta fila (
10-K,10-Q/A,20-F,S-1, ...). El formulario exacto tal como se presentó, por lo que las enmiendas conservan su sufijo/A. null cuandoperiodesttm: una ventana de doce meses móviles puede abarcar varios documentos, así que no la atribuimos a uno solo. Una filaquarterlypuede llevar10-Kcuando el cuarto trimestre se deriva del documento del ejercicio fiscal. - goodwillTipo: number
_and _intangible _assets El fondo de comercio y los activos intangibles de la empresa.
- inventoryTipo: number
El inventario de la empresa.
- investmentsTipo: number
Las inversiones de la empresa.
- nonTipo: number
_current _assets Los activos no corrientes de la empresa.
- nonTipo: number
_current _debt La deuda no corriente de la empresa.
- nonTipo: number
_current _investments Las inversiones no corrientes de la empresa.
- nonTipo: number
_current _liabilities Los pasivos no corrientes de la empresa.
- outstandingTipo: number
_shares Las acciones en circulación de la empresa.
- periodTipo: string enum
El período del balance general.
valores- quarterly
- ttm
- annual
- propertyTipo: number
_plant _and _equipment Las propiedades, planta y equipo de la empresa.
- reportTipo: string Formato: date
_period El período de referencia del balance general.
- retainedTipo: number
_earnings Las ganancias retenidas de la empresa.
- shareholdersTipo: number
_equity El patrimonio neto de la empresa.
- taxTipo: number
_assets Los activos fiscales de la empresa.
- taxTipo: number
_liabilities Los pasivos fiscales de la empresa.
- tickerTipo: string
El símbolo del ticker.
- totalTipo: number
_assets Los activos totales de la empresa.
- totalTipo: number
_debt La deuda total de la empresa.
- totalTipo: number
_liabilities Los pasivos totales de la empresa.
- tradeTipo: number
_and _non _trade _payables Las cuentas por pagar comerciales y no comerciales de la empresa.
- tradeTipo: number
_and _non _trade _receivables Las cuentas por cobrar comerciales y no comerciales de la empresa.
- cashTipo: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
_flow _statements - accessionTipo: string | null
_number El número de acceso de la SEC del documento.
- businessTipo: number
_acquisitions _and _disposals Las adquisiciones y enajenaciones de negocios de la empresa.
- capitalTipo: number
_expenditure El gasto de capital de la empresa.
- changeTipo: number
_in _cash _and _equivalents La variación del efectivo y equivalentes de la empresa.
- currencyTipo: string
La moneda en la que se presentan los datos financieros.
- depreciationTipo: number
_and _amortization La depreciación y amortización de la empresa.
- dividendsTipo: number
_and _other _cash _distributions Los dividendos y otras distribuciones en efectivo de la empresa.
- effectTipo: number
_of _exchange _rate _changes El efecto de las variaciones del tipo de cambio de la empresa.
- endingTipo: number
_cash _balance El saldo final de efectivo de la empresa.
- filingTipo: string | null Formato: date
_date Día calendario en que la SEC aceptó el documento, en hora del Este (la zona horaria de operación de la SEC). Pareja de día calendario de
filing_datetime. null cuando no hay ningún documento fechado de la SEC vinculado a la fila. - filingTipo: string | null Formato: date-time
_datetime Marca temporal con precisión inferior al día que registra cuándo aceptó la SEC el documento, en hora del Este. Proviene del campo
acceptanceDateTimede la SEC en la API de envíos de EDGAR. Forma pareja confiling_date(precisión de día calendario del mismo evento). - filingTipo: string | null Formato: uri
_url URL del documento de la SEC.
- fiscalTipo: string
_period El período fiscal del estado de flujo de efectivo.
- formTipo: string | null
_type El formulario de la SEC del que procede esta fila (
10-K,10-Q/A,20-F,S-1, ...). El formulario exacto tal como se presentó, por lo que las enmiendas conservan su sufijo/A. null cuandoperiodesttm: una ventana de doce meses móviles puede abarcar varios documentos, así que no la atribuimos a uno solo. Una filaquarterlypuede llevar10-Kcuando el cuarto trimestre se deriva del documento del ejercicio fiscal. - freeTipo: number
_cash _flow El flujo de caja libre de la empresa.
- investmentTipo: number
_acquisitions _and _disposals Las adquisiciones y enajenaciones de inversiones de la empresa.
- issuanceTipo: number
_or _purchase _of _equity _shares La emisión o compra de acciones de la empresa.
- issuanceTipo: number
_or _repayment _of _debt _securities La emisión o amortización de títulos de deuda de la empresa.
- netTipo: number
_cash _flow _from _financing El flujo de efectivo neto de financiación de la empresa.
- netTipo: number
_cash _flow _from _investing El flujo de efectivo neto de inversión de la empresa.
- netTipo: number
_cash _flow _from _operations El flujo de efectivo neto de las actividades de explotación de la empresa.
- netTipo: number
_income El beneficio neto de la empresa.
- periodTipo: string enum
El período del estado de flujo de efectivo.
valores- quarterly
- ttm
- annual
- reportTipo: string Formato: date
_period El período de referencia del estado de flujo de efectivo.
- shareTipo: number
_based _compensation La remuneración basada en acciones de la empresa.
- tickerTipo: string
El símbolo del ticker.
- incomeTipo: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
_statements - accessionTipo: string | null
_number El número de acceso de la SEC del documento.
- consolidatedTipo: number
_income El beneficio consolidado de la empresa.
- costTipo: number
_of _revenue El costo de los ingresos de la empresa.
- currencyTipo: string
La moneda en la que se presentan los datos financieros.
- dividendsTipo: number
_per _common _share Los dividendos por acción ordinaria de la empresa.
- earningsTipo: number
_per _share El beneficio por acción de la empresa.
- earningsTipo: number
_per _share _diluted El beneficio por acción diluido de la empresa.
- ebitTipo: number
El beneficio antes de intereses e impuestos de la empresa.
- filingTipo: string | null Formato: date
_date Día calendario en que la SEC aceptó el documento, en hora del Este (la zona horaria de operación de la SEC). Pareja de día calendario de
filing_datetime. null cuando no hay ningún documento fechado de la SEC vinculado a la fila. - filingTipo: string | null Formato: date-time
_datetime Marca temporal con precisión inferior al día que registra cuándo aceptó la SEC el documento, en hora del Este. Proviene del campo
acceptanceDateTimede la SEC en la API de envíos de EDGAR. Forma pareja confiling_date(precisión de día calendario del mismo evento). - filingTipo: string | null Formato: uri
_url URL del documento de la SEC.
- fiscalTipo: string
_period El período fiscal de la cuenta de resultados.
- formTipo: string | null
_type El formulario de la SEC del que procede esta fila (
10-K,10-Q/A,20-F,S-1, ...). El formulario exacto tal como se presentó, por lo que las enmiendas conservan su sufijo/A. null cuandoperiodesttm: una ventana de doce meses móviles puede abarcar varios documentos, así que no la atribuimos a uno solo. Una filaquarterlypuede llevar10-Kcuando el cuarto trimestre se deriva del documento del ejercicio fiscal. - grossTipo: number
_profit El beneficio bruto de la empresa.
- incomeTipo: number
_tax _expense Los gastos por impuesto sobre la renta de la empresa.
- interestTipo: number
_expense Los gastos por intereses de la empresa.
- netTipo: number
_income El beneficio neto de la empresa.
- netTipo: number
_income _common _stock El beneficio neto disponible para los accionistas ordinarios de la empresa.
- netTipo: number
_income _discontinued _operations El beneficio neto de operaciones discontinuadas de la empresa.
- netTipo: number
_income _non _controlling _interests El beneficio neto de participaciones no controladoras de la empresa.
- operatingTipo: number
_expense Los gastos operativos de la empresa.
- operatingTipo: number
_income El beneficio operativo de la empresa.
- periodTipo: string enum
El período de la cuenta de resultados.
valores- quarterly
- ttm
- annual
- preferredTipo: number
_dividends _impact El impacto de los dividendos preferentes en el beneficio neto de la empresa.
- reportTipo: string Formato: date
_period El período de referencia de la cuenta de resultados.
- researchTipo: number
_and _development Los gastos de investigación y desarrollo de la empresa.
- revenueTipo: number
Los ingresos totales de la empresa.
- sellingTipo: number
_general _and _administrative _expenses Los gastos de ventas, generales y administrativos de la empresa.
- tickerTipo: string
El símbolo del ticker.
- weightedTipo: number
_average _shares La media ponderada de acciones de la empresa.
- weightedTipo: number
_average _shares _diluted La media ponderada diluida de acciones de la empresa.
- Tipo: stringnext
_page _url URL absoluta de la siguiente página de resultados. Presente solo cuando quedan más resultados; solicítala tal cual para continuar. Cada página contiene hasta 10 registros.
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?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"financials": {
"income_statements": [
{
"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,
"revenue": 1,
"cost_of_revenue": 1,
"gross_profit": 1,
"operating_expense": 1,
"selling_general_and_administrative_expenses": 1,
"research_and_development": 1,
"operating_income": 1,
"interest_expense": 1,
"ebit": 1,
"income_tax_expense": 1,
"net_income_discontinued_operations": 1,
"net_income_non_controlling_interests": 1,
"net_income": 1,
"net_income_common_stock": 1,
"preferred_dividends_impact": 1,
"consolidated_income": 1,
"earnings_per_share": 1,
"earnings_per_share_diluted": 1,
"dividends_per_common_share": 1,
"weighted_average_shares": 1,
"weighted_average_shares_diluted": 1
}
],
"balance_sheets": [
{
"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,
"total_assets": 1,
"current_assets": 1,
"cash_and_equivalents": 1,
"inventory": 1,
"current_investments": 1,
"trade_and_non_trade_receivables": 1,
"non_current_assets": 1,
"property_plant_and_equipment": 1,
"goodwill_and_intangible_assets": 1,
"investments": 1,
"non_current_investments": 1,
"outstanding_shares": 1,
"tax_assets": 1,
"total_liabilities": 1,
"current_liabilities": 1,
"current_debt": 1,
"trade_and_non_trade_payables": 1,
"deferred_revenue": 1,
"deposit_liabilities": 1,
"non_current_liabilities": 1,
"non_current_debt": 1,
"tax_liabilities": 1,
"shareholders_equity": 1,
"retained_earnings": 1,
"accumulated_other_comprehensive_income": 1,
"total_debt": 1
}
],
"cash_flow_statements": [
{
"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,
"net_income": 1,
"depreciation_and_amortization": 1,
"share_based_compensation": 1,
"net_cash_flow_from_operations": 1,
"capital_expenditure": 1,
"business_acquisitions_and_disposals": 1,
"investment_acquisitions_and_disposals": 1,
"net_cash_flow_from_investing": 1,
"issuance_or_repayment_of_debt_securities": 1,
"issuance_or_purchase_of_equity_shares": 1,
"dividends_and_other_cash_distributions": 1,
"net_cash_flow_from_financing": 1,
"change_in_cash_and_equivalents": 1,
"effect_of_exchange_rate_changes": 1,
"ending_cash_balance": 1,
"free_cash_flow": 1
}
]
},
"next_page_url": "string"
}