Felo API PlatformFelo API Platform
Todos los endpoints de Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Obtener métricas financieras

Servidor:https://openapi.felo.ai
Bibliotecas cliente

Financial Data

​

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

Obtener métricas financieras

​

Ratios calculados de una empresa a lo largo del tiempo, unos 49 por período: 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, los ratios de rotación y liquidez, cada uno con report_period y fiscal_period. period es obligatorio; identifica por ticker o cik. Úsalo para ver la tendencia de un ratio entre períodos. Solo para los valores actuales, get_financial_financial_metrics_snapshot es una fila y mucho más pequeño.

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.

Parámetros de consulta
  • cik
    Tipo: string

    La Central Index Key (CIK) de la empresa. Se puede usar en lugar del ticker.

  • cursor
    Tipo: string

    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.

  • filing_date
    Tipo: string Formato: 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.

  • filing_date_gt
    Tipo: string Formato: date

    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.

  • filing_date_gte
    Tipo: string Formato: date

    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.

  • filing_date_lt
    Tipo: string Formato: date

    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.

  • filing_date_lte
    Tipo: string Formato: date

    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.

  • limit
    Tipo: integer

    El número máximo de resultados 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.

  • period
    Tipo: string enum
    obligatorio

    El periodo de los datos financieros.

    valores
    • annual
    • quarterly
    • ttm
  • report_period
    Tipo: string Formato: date

    Filtra por la fecha exacta del periodo del informe en formato YYYY-MM-DD.

  • report_period_gt
    Tipo: string Formato: date

    Filtrar por período de informe mayor que la fecha en formato YYYY-MM-DD.

  • report_period_gte
    Tipo: string Formato: date

    Filtrar por período de informe mayor o igual que la fecha en formato YYYY-MM-DD.

  • report_period_lt
    Tipo: string Formato: date

    Filtrar por período de informe menor que la fecha en formato YYYY-MM-DD.

  • report_period_lte
    Tipo: string Formato: date

    Filtrar por período de informe menor o igual que la fecha en formato YYYY-MM-DD.

  • ticker
    Tipo: string

    El símbolo del ticker de la empresa. Obligatorio si no se proporciona cik.

Respuestas
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    Las métricas y ratios financieros históricos de un ticker

    • accession_number
      Tipo: string | null

      El número de acceso de la SEC del documento.

    • asset_turnover
      Tipo: number

      Ingresos divididos por los activos totales medios.

    • book_value_growth
      Tipo: number

      Crecimiento interanual del valor contable.

    • book_value_per_share
      Tipo: number

      Patrimonio neto dividido por las acciones en circulación.

    • cash_ratio
      Tipo: number

      Efectivo y equivalentes de efectivo divididos por los pasivos corrientes.

    • currency
      Tipo: string

      La moneda en la que se presentan los datos financieros.

    • current_ratio
      Tipo: number

      Activos corrientes divididos por los pasivos corrientes.

    • days_sales_outstanding
      Tipo: number

      Cuentas por cobrar medias divididas por los ingresos del período.

    • debt_to_assets
      Tipo: number

      Deuda total dividida por los activos totales.

    • debt_to_equity
      Tipo: number

      Deuda total dividida por el patrimonio neto.

    • earnings_growth
      Tipo: number

      Crecimiento interanual de los beneficios.

    • earnings_per_share
      Tipo: number

      Beneficio neto dividido por la media ponderada de acciones en circulación.

    • earnings_per_share_growth
      Tipo: number

      Crecimiento del beneficio por acción durante el período.

    • ebitda_growth
      Tipo: number

      Crecimiento del EBITDA durante el período.

    • enterprise_value
      Tipo: number

      El valor total de la empresa (capitalización bursátil + deuda - efectivo).

    • enterprise_value_to_ebitda_ratio
      Tipo: number

      Relación entre valor de empresa y EBITDA.

    • enterprise_value_to_revenue_ratio
      Tipo: number

      Relación entre valor de empresa e ingresos.

    • filing_date
      Tipo: string | null Formato: 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.

    • filing_datetime
      Tipo: string | null Formato: date-time

      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 acceptanceDateTime de la SEC en la API de envíos de EDGAR. Forma pareja con filing_date (precisión de día calendario del mismo evento).

    • filing_url
      Tipo: string | null Formato: uri

      URL del documento de la SEC.

    • fiscal_period
      Tipo: string

      El período fiscal de las métricas financieras.

    • form_type
      Tipo: string | null

      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 cuando period es ttm: una ventana de doce meses móviles puede abarcar varios documentos, así que no la atribuimos a uno solo. Una fila quarterly puede llevar 10-K cuando el cuarto trimestre se deriva del documento del ejercicio fiscal.

    • free_cash_flow_growth
      Tipo: number

      Crecimiento del flujo de caja libre durante el período.

    • free_cash_flow_per_share
      Tipo: number

      Flujo de caja libre dividido por las acciones en circulación.

    • free_cash_flow_yield
      Tipo: number

      Rendimiento del flujo de caja libre.

    • gross_margin
      Tipo: number

      Beneficio bruto como porcentaje de los ingresos.

    • interest_coverage
      Tipo: number

      EBIT dividido por los gastos por intereses.

    • inventory_turnover
      Tipo: number

      Costo de los bienes vendidos dividido por el inventario medio.

    • net_margin
      Tipo: number

      Beneficio neto como porcentaje de los ingresos.

    • next_page_url
      Tipo: string

      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.

    • operating_cash_flow_ratio
      Tipo: number

      Flujo de efectivo operativo dividido por los pasivos corrientes.

    • operating_cycle
      Tipo: number

      Rotación de inventario + rotación de cuentas por cobrar.

    • operating_income_growth
      Tipo: number

      Crecimiento del beneficio operativo durante el período.

    • operating_margin
      Tipo: number

      Beneficio operativo como porcentaje de los ingresos.

    • payout_ratio
      Tipo: number

      Dividendos pagados como porcentaje del beneficio neto.

    • peg_ratio
      Tipo: number

      Relación entre precio y beneficio con crecimiento.

    • period
      Tipo: string enum

      El período de las métricas financieras.

      valores
      • quarterly
      • ttm
      • annual
    • price_to_book_ratio
      Tipo: number

      Relación entre precio y valor contable.

    • price_to_earnings_ratio
      Tipo: number

      Relación entre precio y beneficio.

    • price_to_sales_ratio
      Tipo: number

      Relación entre precio y ventas.

    • quick_ratio
      Tipo: number

      Activos líquidos divididos por los pasivos corrientes.

    • receivables_turnover
      Tipo: number

      Ingresos divididos por las cuentas por cobrar medias.

    • report_period
      Tipo: string Formato: date

      El período de referencia de las métricas financieras.

    • return_on_assets
      Tipo: number

      Beneficio neto como porcentaje de los activos totales.

    • return_on_equity
      Tipo: number

      Beneficio neto como porcentaje del patrimonio neto.

    • return_on_invested_capital
      Tipo: number

      Beneficio operativo neto después de impuestos como porcentaje del capital invertido.

    • revenue_growth
      Tipo: number

      Crecimiento interanual de los ingresos.

    • ticker
      Tipo: string

      El símbolo de ticker de la empresa.

    • working_capital_turnover
      Tipo: number

      Ingresos divididos por el capital circulante medio.

    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
Request Example for get/v1/beta/financial/financial-metrics
curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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"
}
Get financial metrics