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

Obtener una instantánea de resultados

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

Financial Data

​

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

Financial Data Operaciones

Obtener una instantánea de resultados

​

Resultados reportados de una acción, datos reales frente a estimaciones. Cada entrada incluye report_period, fiscal_period, filing_date, filing_url y accession_number, un bloque quarterly con revenue, estimated_revenue, revenue_surprise y revenue_surprise_pct, el mismo trío para earnings_per_share, además de campos de variación interanual. También devuelve signals: indicadores calculados por el upstream, como EPS_BEAT, con un headline y los valores actual / estimate / surprise_pct que lo sustentan. ticker es obligatorio y es el único parámetro. Úsalo para lo que una empresa reportó realmente. Para el consenso prospectivo que aún no ha ocurrido, usa get_financial_analyst_estimates.

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
  • 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.

  • limit
    Tipo: integer
    mín.:  
    1
    máx.:  
    40

    Número de períodos de informe más recientes de presentaciones que se van a devolver, ordenados por (report_period DESC, filing_date ASC). El número de entradas devueltas puede superar limit cuando un período reciente tenga tanto un 8-K como un 10-Q / 10-K. Los valores superiores a 40 se limitan a 40. Los valores no positivos o no enteros devuelven 400. 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.

  • ticker
    Tipo: string
    obligatorio

    El símbolo del ticker (por ejemplo, AAPL).

Respuestas
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_EarningsResponse

    Respuesta de resultados

    • earnings
      Tipo: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      Lista plana de documentos de la SEC para el ticker, ordenada por (report_period DESC, filing_date ASC). Con limit=N, se devuelven documentos equivalentes a hasta N report_periods; el número de entradas puede superar N cuando un período reciente tiene tanto un 8-K como un 10-Q/10-K.

      • accession_number
        Tipo: string
        obligatorio

        Número de acceso de la SEC que identifica el documento.

      • filing_date
        Tipo: string Formato: date
        obligatorio

        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.

      • filing_url
        Tipo: string Formato: uri
        obligatorio

        URL del documento de la SEC.

      • report_period
        Tipo: string Formato: date
        obligatorio

        Período de referencia que cubre este documento.

      • source_type
        Tipo: string enum
        obligatorio

        El tipo de formulario de la SEC en el que se basa este documento.

        valores
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Tipo: string
        obligatorio

        El símbolo de ticker solicitado.

      • annual
        Tipo: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Tipo: number | null
        • capital_expenditure_chg
          Tipo: number

          Cambio porcentual del gasto de capital con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • capital_expenditure_yoy_chg
          Tipo: number

          Cambio interanual del gasto de capital con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • cash_and_equivalents
          Tipo: number | null
        • change_in_cash_and_equivalents
          Tipo: number | null
        • earnings_per_share
          Tipo: number | null
        • earnings_per_share_chg
          Tipo: number

          Cambio porcentual del EPS con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • earnings_per_share_yoy_chg
          Tipo: number

          Cambio interanual del EPS con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • free_cash_flow
          Tipo: number | null
        • free_cash_flow_chg
          Tipo: number

          Cambio porcentual del flujo de caja libre con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • free_cash_flow_yoy_chg
          Tipo: number

          Cambio interanual del flujo de caja libre con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • gross_margin
          Tipo: number

          Margen bruta como decimal (gross_profit / revenue). Se devuelve solo cuando es calculable.

        • gross_margin_chg_bps
          Tipo: number

          Cambio absoluto de la margen bruta con respecto al período anterior, en puntos básicos (por ejemplo, 200.0 = margen ampliada en 200 bps). Se devuelve solo cuando es calculable.

        • gross_margin_chg_pct
          Tipo: number

          Cambio porcentual de la margen bruta con respecto al período anterior, como decimal. Se devuelve solo cuando es calculable.

        • gross_margin_yoy_chg_bps
          Tipo: number

          Cambio interanual de la margen bruta con respecto al mismo trimestre fiscal del año anterior, en puntos básicos. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • gross_margin_yoy_chg_pct
          Tipo: number

          Cambio porcentual interanual de la margen bruta con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • gross_profit
          Tipo: number | null
        • gross_profit_chg
          Tipo: number

          Cambio porcentual del beneficio bruto con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • gross_profit_yoy_chg
          Tipo: number

          Cambio interanual del beneficio bruto con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_financing
          Tipo: number | null
        • net_cash_flow_from_financing_chg
          Tipo: number

          Cambio porcentual del flujo de efectivo neto de financiación con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_financing_yoy_chg
          Tipo: number

          Cambio interanual del flujo de efectivo neto de financiación con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_investing
          Tipo: number | null
        • net_cash_flow_from_investing_chg
          Tipo: number

          Cambio porcentual del flujo de efectivo neto de inversión con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_investing_yoy_chg
          Tipo: number

          Cambio interanual del flujo de efectivo neto de inversión con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_operations
          Tipo: number | null
        • net_cash_flow_from_operations_chg
          Tipo: number

          Cambio porcentual del flujo de efectivo neto de las actividades de explotación con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_operations_yoy_chg
          Tipo: number

          Cambio interanual del flujo de efectivo neto de las actividades de explotación con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_income
          Tipo: number | null
        • net_income_chg
          Tipo: number

          Cambio porcentual del beneficio neto con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_income_yoy_chg
          Tipo: number

          Cambio interanual del beneficio neto con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_margin
          Tipo: number

          Margen neta como decimal (net_income / revenue). Se devuelve solo cuando es calculable.

        • net_margin_chg_bps
          Tipo: number

          Cambio absoluto de la margen neta con respecto al período anterior, en puntos básicos. Se devuelve solo cuando es calculable.

        • net_margin_chg_pct
          Tipo: number

          Cambio porcentual de la margen neta con respecto al período anterior, como decimal. Se devuelve solo cuando es calculable.

        • net_margin_yoy_chg_bps
          Tipo: number

          Cambio interanual de la margen neta con respecto al mismo trimestre fiscal del año anterior, en puntos básicos. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_margin_yoy_chg_pct
          Tipo: number

          Cambio porcentual interanual de la margen neta con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • operating_income
          Tipo: number | null
        • operating_income_chg
          Tipo: number

          Cambio porcentual del beneficio operativo con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • operating_income_yoy_chg
          Tipo: number

          Cambio interanual del beneficio operativo con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • operating_margin
          Tipo: number

          Margen operativa como decimal (operating_income / revenue). Se devuelve solo cuando es calculable.

        • operating_margin_chg_bps
          Tipo: number

          Cambio absoluto de la margen operativa con respecto al período anterior, en puntos básicos. Se devuelve solo cuando es calculable.

        • operating_margin_chg_pct
          Tipo: number

          Cambio porcentual de la margen operativa con respecto al período anterior, como decimal. Se devuelve solo cuando es calculable.

        • operating_margin_yoy_chg_bps
          Tipo: number

          Cambio interanual de la margen operativa con respecto al mismo trimestre fiscal del año anterior, en puntos básicos. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • operating_margin_yoy_chg_pct
          Tipo: number

          Cambio porcentual interanual de la margen operativa con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • revenue
          Tipo: number | null
        • revenue_chg
          Tipo: number

          Cambio porcentual de los ingresos con respecto al período anterior, como decimal (por ejemplo, 0.10 = +10%). Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • revenue_yoy_chg
          Tipo: number

          Cambio interanual de los ingresos con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • shareholders_equity
          Tipo: number | null
        • total_assets
          Tipo: number | null
        • total_debt
          Tipo: number | null
        • total_liabilities
          Tipo: number | null
        • weighted_average_shares
          Tipo: number | null
        • weighted_average_shares_diluted
          Tipo: number | null
      • currency
        Tipo: string

        Código de moneda ISO (por ejemplo, USD).

      • 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_window
        Tipo: string | null enum

        Sesión de mercado en el momento en que la SEC aceptó el documento, evaluada en hora del Este. PRE_MARKET = día laborable, 04:00–09:30 ET. DURING_MARKET = día laborable, 09:30–16:00 ET. AFTER_HOURS = día laborable fuera del horario regular de negociación. WEEKEND = sábado o domingo. null cuando filing_datetime no está disponible.

        valores
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Tipo: string

        Etiqueta del período fiscal (por ejemplo, 2026-Q1 o 2025-FY).

      • quarterly
        Tipo: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Tipo: number | null
        • capital_expenditure_chg
          Tipo: number

          Cambio porcentual del gasto de capital con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • capital_expenditure_yoy_chg
          Tipo: number

          Cambio interanual del gasto de capital con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • cash_and_equivalents
          Tipo: number | null
        • change_in_cash_and_equivalents
          Tipo: number | null
        • earnings_per_share
          Tipo: number | null
        • earnings_per_share_chg
          Tipo: number

          Cambio porcentual del EPS con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • earnings_per_share_yoy_chg
          Tipo: number

          Cambio interanual del EPS con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • free_cash_flow
          Tipo: number | null
        • free_cash_flow_chg
          Tipo: number

          Cambio porcentual del flujo de caja libre con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • free_cash_flow_yoy_chg
          Tipo: number

          Cambio interanual del flujo de caja libre con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • gross_margin
          Tipo: number

          Margen bruta como decimal (gross_profit / revenue). Se devuelve solo cuando es calculable.

        • gross_margin_chg_bps
          Tipo: number

          Cambio absoluto de la margen bruta con respecto al período anterior, en puntos básicos (por ejemplo, 200.0 = margen ampliada en 200 bps). Se devuelve solo cuando es calculable.

        • gross_margin_chg_pct
          Tipo: number

          Cambio porcentual de la margen bruta con respecto al período anterior, como decimal. Se devuelve solo cuando es calculable.

        • gross_margin_yoy_chg_bps
          Tipo: number

          Cambio interanual de la margen bruta con respecto al mismo trimestre fiscal del año anterior, en puntos básicos. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • gross_margin_yoy_chg_pct
          Tipo: number

          Cambio porcentual interanual de la margen bruta con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • gross_profit
          Tipo: number | null
        • gross_profit_chg
          Tipo: number

          Cambio porcentual del beneficio bruto con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • gross_profit_yoy_chg
          Tipo: number

          Cambio interanual del beneficio bruto con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_financing
          Tipo: number | null
        • net_cash_flow_from_financing_chg
          Tipo: number

          Cambio porcentual del flujo de efectivo neto de financiación con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_financing_yoy_chg
          Tipo: number

          Cambio interanual del flujo de efectivo neto de financiación con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_investing
          Tipo: number | null
        • net_cash_flow_from_investing_chg
          Tipo: number

          Cambio porcentual del flujo de efectivo neto de inversión con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_investing_yoy_chg
          Tipo: number

          Cambio interanual del flujo de efectivo neto de inversión con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_operations
          Tipo: number | null
        • net_cash_flow_from_operations_chg
          Tipo: number

          Cambio porcentual del flujo de efectivo neto de las actividades de explotación con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_cash_flow_from_operations_yoy_chg
          Tipo: number

          Cambio interanual del flujo de efectivo neto de las actividades de explotación con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_income
          Tipo: number | null
        • net_income_chg
          Tipo: number

          Cambio porcentual del beneficio neto con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • net_income_yoy_chg
          Tipo: number

          Cambio interanual del beneficio neto con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_margin
          Tipo: number

          Margen neta como decimal (net_income / revenue). Se devuelve solo cuando es calculable.

        • net_margin_chg_bps
          Tipo: number

          Cambio absoluto de la margen neta con respecto al período anterior, en puntos básicos. Se devuelve solo cuando es calculable.

        • net_margin_chg_pct
          Tipo: number

          Cambio porcentual de la margen neta con respecto al período anterior, como decimal. Se devuelve solo cuando es calculable.

        • net_margin_yoy_chg_bps
          Tipo: number

          Cambio interanual de la margen neta con respecto al mismo trimestre fiscal del año anterior, en puntos básicos. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • net_margin_yoy_chg_pct
          Tipo: number

          Cambio porcentual interanual de la margen neta con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • operating_income
          Tipo: number | null
        • operating_income_chg
          Tipo: number

          Cambio porcentual del beneficio operativo con respecto al período anterior, como decimal. Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • operating_income_yoy_chg
          Tipo: number

          Cambio interanual del beneficio operativo con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • operating_margin
          Tipo: number

          Margen operativa como decimal (operating_income / revenue). Se devuelve solo cuando es calculable.

        • operating_margin_chg_bps
          Tipo: number

          Cambio absoluto de la margen operativa con respecto al período anterior, en puntos básicos. Se devuelve solo cuando es calculable.

        • operating_margin_chg_pct
          Tipo: number

          Cambio porcentual de la margen operativa con respecto al período anterior, como decimal. Se devuelve solo cuando es calculable.

        • operating_margin_yoy_chg_bps
          Tipo: number

          Cambio interanual de la margen operativa con respecto al mismo trimestre fiscal del año anterior, en puntos básicos. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • operating_margin_yoy_chg_pct
          Tipo: number

          Cambio porcentual interanual de la margen operativa con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • revenue
          Tipo: number | null
        • revenue_chg
          Tipo: number

          Cambio porcentual de los ingresos con respecto al período anterior, como decimal (por ejemplo, 0.10 = +10%). Secuencial en la carga útil trimestral e interanual en la carga útil anual. Se devuelve solo cuando es calculable.

        • revenue_yoy_chg
          Tipo: number

          Cambio interanual de los ingresos con respecto al mismo trimestre fiscal del año anterior, como decimal. Solo en la carga útil trimestral. Se devuelve solo cuando es calculable.

        • shareholders_equity
          Tipo: number | null
        • total_assets
          Tipo: number | null
        • total_debt
          Tipo: number | null
        • total_liabilities
          Tipo: number | null
        • weighted_average_shares
          Tipo: number | null
        • weighted_average_shares_diluted
          Tipo: number | null
      • signals
        Tipo: array object[] · ResponseE40Feb4D3D6B_Signal[]

        Información clave seleccionada por su impacto en el mercado, extraída de este documento. Cada elemento tiene un headline pregenerado, details estructurados y una clasificación de importance. Se devuelve solo cuando se activa al menos una señal para esta entrada; de lo contrario, el campo se omite. Limitado a 8 por entrada, ordenados HIGH → MEDIUM → LOW.

        Una conclusión clave seleccionada por su impacto en el mercado, derivada de este documento. El headline pregenerado es apto para mostrarse directamente; details contiene campos estructurados para filtrado y uso programático. Las señales se devuelven en orden de prioridad (primero la más relevante); el propio type codifica la magnitud (por ejemplo, STRONG_REVENUE_INCREASE frente a REVENUE_INCREASE).

        • headline
          Tipo: string
          obligatorio

          Resumen pregenerado y legible, apto para mostrarse directamente.

        • type
          Tipo: string enum
          obligatorio

          Categoría de la señal. MARGIN_EXPANSION/MARGIN_CONTRACTION: cualquiera de las márgenes bruta, operativa o neta se movió interanualmente en ≥100 bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: cambio de guidance prospectivo declarado en el documento. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: segmento susceptible de información con mejor o peor desempeño por crecimiento de ingresos orgánicos. NON_GAAP_DIVERGENCE: una cifra ajustada/non-GAAP difiere materialmente de su equivalente GAAP en el mismo período. BACKLOG_SURGE/BACKLOG_DECLINE: la cartera de pedidos u obligaciones de desempeño pendientes se movió interanualmente en ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE y variantes DECLINE: cambio interanual de ingresos por tramos (magnitud ≥10% / ≥20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE y variantes DECLINE: cambio interanual del beneficio neto por tramos (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE y variantes DECLINE: cambio interanual del EPS por tramos (≥15% / ≥30%); independiente del beneficio neto porque las recompras de acciones pueden amplificar el movimiento del EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE y variantes DECLINE: cambio interanual del gasto de capital en magnitud de gasto (≥15% / ≥30%).

          valores
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Tipo: object

          Campos estructurados específicos del tipo de señal. El contenido varía: las señales de guidance llevan low, high, point_estimate, prior_value, revision_pct; las señales de segmento llevan best, worst, spread_pp; las señales non-GAAP llevan gaap_field, non_gaap_value, gaap_value, divergence_pct; las señales de crecimiento llevan current, yoy_chg. Los valores null se omiten. Consulta los ejemplos específicos de cada tipo.

          • propertyName
            Tipo: anything
        • metric
          Tipo: string | null

          La métrica a la que hace referencia esta señal, cuando corresponde (por ejemplo, revenue, earnings_per_share, operating_margin o el nombre de una métrica de guidance/KPI).

        • period
          Tipo: string | null

          El período fiscal al que hace referencia la señal (por ejemplo, 2026-Q1, FY 2026). Las señales de guidance prospectivo se refieren al período guiado; las señales financieras se refieren al período de referencia de este documento.

    • 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.

    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/earnings
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "earnings": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "currency": "string",
      "source_type": "8-K",
      "filing_date": "2026-10-26",
      "filing_datetime": null,
      "filing_window": "PRE_MARKET",
      "signals": [
        {
          "type": "MARGIN_EXPANSION",
          "metric": null,
          "period": null,
          "headline": "string",
          "details": {
            "additionalProperty": "anything"
          }
        }
      ],
      "filing_url": "https://example.com",
      "accession_number": "string",
      "quarterly": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      },
      "annual": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      }
    }
  ],
  "next_page_url": "string"
}
Get earnings snapshot