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

Obter snapshot de resultados

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

Financial Data

​

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

Financial Data Operações

Obter snapshot de resultados

​

Resultados reportados de uma ação, valores reais contra estimativas. Cada entrada traz report_period, fiscal_period, filing_date, filing_url e accession_number, um bloco quarterly com revenue, estimated_revenue, revenue_surprise e revenue_surprise_pct, o mesmo trio para earnings_per_share, além de campos de variação ano a ano. Também retorna signals: sinalizações calculadas pelo upstream, como EPS_BEAT, com um headline e os valores actual / estimate / surprise_pct por trás. ticker é obrigatório e é o único parâmetro. Use para o que uma empresa realmente reportou. Para o consenso prospectivo que ainda não aconteceu, use get_financial_analyst_estimates.

Referência de preços

  • Medição: base de custo fixa por requisição bem-sucedida.
  • Estimativa de referência por requisição: USD 0.02.
  • Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Parâmetros de Consulta
  • cursor
    Tipo: string

    Cursor de paginação opaco do next_page_url de uma resposta anterior. Quando fornecido, todos os outros parâmetros de consulta são ignorados: o cursor carrega os filtros da requisição original. Trate-o como opaco; não o construa nem o modifique.

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

    Número de períodos de relatório mais recentes de documentos protocolados a retornar, ordenados por (report_period DESC, filing_date ASC). O número de entradas retornadas pode exceder limit quando um período recente tiver tanto um 8-K quanto um 10-Q / 10-K. Valores acima de 40 são limitados a 40. Valores não positivos ou não inteiros retornam 400. Este é o total de todas as páginas, não o tamanho de uma página: cada página contém até 10 registros, vinculados por next_page_url.

  • ticker
    Tipo: string
    obrigatório

    O símbolo do ticker (por exemplo, AAPL).

Respostas
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_EarningsResponse

    Resposta de resultados

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

      Lista simples de documentos da SEC para o ticker, ordenada por (report_period DESC, filing_date ASC). Com limit=N, são retornados documentos equivalentes a até N report_periods; a contagem de entradas pode exceder N quando um período recente tem tanto um 8-K quanto um 10-Q/10-K.

      • accession_number
        Tipo: string
        obrigatório

        Número de acesso da SEC que identifica o documento.

      • filing_date
        Tipo: string Formato: date
        obrigatório

        Dia civil em que a SEC aceitou o documento, no horário do Leste dos EUA (o fuso horário de operação da SEC). Par de dia civil de filing_datetime.

      • filing_url
        Tipo: string Formato: uri
        obrigatório

        URL do documento na SEC.

      • report_period
        Tipo: string Formato: date
        obrigatório

        Período de referência coberto por este documento.

      • source_type
        Tipo: string enum
        obrigatório

        O tipo de formulário da SEC que embasa este documento.

        valores
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Tipo: string
        obrigatório

        O símbolo do ticker solicitado.

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

          Variação percentual das despesas de capital em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • capital_expenditure_yoy_chg
          Tipo: number

          Variação ano a ano das despesas de capital em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • 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

          Variação percentual do EPS em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • earnings_per_share_yoy_chg
          Tipo: number

          Variação ano a ano do EPS em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa livre em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • free_cash_flow_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa livre em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • gross_margin
          Tipo: number

          Margem bruta como decimal (gross_profit / revenue). Retornado apenas quando calculável.

        • gross_margin_chg_bps
          Tipo: number

          Variação absoluta da margem bruta em relação ao período anterior, em pontos-base (por exemplo, 200.0 = margem ampliada em 200 bps). Retornado apenas quando calculável.

        • gross_margin_chg_pct
          Tipo: number

          Variação percentual da margem bruta em relação ao período anterior, como decimal. Retornado apenas quando calculável.

        • gross_margin_yoy_chg_bps
          Tipo: number

          Variação ano a ano da margem bruta em relação ao mesmo trimestre fiscal do ano anterior, em pontos-base. Apenas no payload trimestral. Retornado apenas quando calculável.

        • gross_margin_yoy_chg_pct
          Tipo: number

          Variação percentual ano a ano da margem bruta em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do lucro bruto em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • gross_profit_yoy_chg
          Tipo: number

          Variação ano a ano do lucro bruto em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa líquido de financiamento em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_cash_flow_from_financing_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa líquido de financiamento em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa líquido de investimento em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_cash_flow_from_investing_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa líquido de investimento em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa líquido das atividades operacionais em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_cash_flow_from_operations_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa líquido das atividades operacionais em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do lucro líquido em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_income_yoy_chg
          Tipo: number

          Variação ano a ano do lucro líquido em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • net_margin
          Tipo: number

          Margem líquida como decimal (net_income / revenue). Retornado apenas quando calculável.

        • net_margin_chg_bps
          Tipo: number

          Variação absoluta da margem líquida em relação ao período anterior, em pontos-base. Retornado apenas quando calculável.

        • net_margin_chg_pct
          Tipo: number

          Variação percentual da margem líquida em relação ao período anterior, como decimal. Retornado apenas quando calculável.

        • net_margin_yoy_chg_bps
          Tipo: number

          Variação ano a ano da margem líquida em relação ao mesmo trimestre fiscal do ano anterior, em pontos-base. Apenas no payload trimestral. Retornado apenas quando calculável.

        • net_margin_yoy_chg_pct
          Tipo: number

          Variação percentual ano a ano da margem líquida em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do lucro operacional em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • operating_income_yoy_chg
          Tipo: number

          Variação ano a ano do lucro operacional em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • operating_margin
          Tipo: number

          Margem operacional como decimal (operating_income / revenue). Retornado apenas quando calculável.

        • operating_margin_chg_bps
          Tipo: number

          Variação absoluta da margem operacional em relação ao período anterior, em pontos-base. Retornado apenas quando calculável.

        • operating_margin_chg_pct
          Tipo: number

          Variação percentual da margem operacional em relação ao período anterior, como decimal. Retornado apenas quando calculável.

        • operating_margin_yoy_chg_bps
          Tipo: number

          Variação ano a ano da margem operacional em relação ao mesmo trimestre fiscal do ano anterior, em pontos-base. Apenas no payload trimestral. Retornado apenas quando calculável.

        • operating_margin_yoy_chg_pct
          Tipo: number

          Variação percentual ano a ano da margem operacional em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual da receita em relação ao período anterior, como decimal (por exemplo, 0.10 = +10%). Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • revenue_yoy_chg
          Tipo: number

          Variação ano a ano da receita em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • 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 moeda ISO (por exemplo, USD).

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

        Timestamp com precisão inferior a um dia que registra quando a SEC aceitou o documento, no horário do Leste dos EUA. Originado do campo acceptanceDateTime da SEC na API de submissões do EDGAR. Faz par com filing_date (precisão de dia civil do mesmo evento).

      • filing_window
        Tipo: string | null enum

        Sessão de mercado no momento em que a SEC aceitou o documento, avaliada no horário do Leste dos EUA. PRE_MARKET = dia útil, 04:00–09:30 ET. DURING_MARKET = dia útil, 09:30–16:00 ET. AFTER_HOURS = dia útil fora do horário regular de negociação. WEEKEND = sábado ou domingo. null quando filing_datetime não está disponível.

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

        Rótulo do período fiscal (por exemplo, 2026-Q1 ou 2025-FY).

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

          Variação percentual das despesas de capital em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • capital_expenditure_yoy_chg
          Tipo: number

          Variação ano a ano das despesas de capital em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • 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

          Variação percentual do EPS em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • earnings_per_share_yoy_chg
          Tipo: number

          Variação ano a ano do EPS em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa livre em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • free_cash_flow_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa livre em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • gross_margin
          Tipo: number

          Margem bruta como decimal (gross_profit / revenue). Retornado apenas quando calculável.

        • gross_margin_chg_bps
          Tipo: number

          Variação absoluta da margem bruta em relação ao período anterior, em pontos-base (por exemplo, 200.0 = margem ampliada em 200 bps). Retornado apenas quando calculável.

        • gross_margin_chg_pct
          Tipo: number

          Variação percentual da margem bruta em relação ao período anterior, como decimal. Retornado apenas quando calculável.

        • gross_margin_yoy_chg_bps
          Tipo: number

          Variação ano a ano da margem bruta em relação ao mesmo trimestre fiscal do ano anterior, em pontos-base. Apenas no payload trimestral. Retornado apenas quando calculável.

        • gross_margin_yoy_chg_pct
          Tipo: number

          Variação percentual ano a ano da margem bruta em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do lucro bruto em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • gross_profit_yoy_chg
          Tipo: number

          Variação ano a ano do lucro bruto em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa líquido de financiamento em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_cash_flow_from_financing_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa líquido de financiamento em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa líquido de investimento em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_cash_flow_from_investing_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa líquido de investimento em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do fluxo de caixa líquido das atividades operacionais em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_cash_flow_from_operations_yoy_chg
          Tipo: number

          Variação ano a ano do fluxo de caixa líquido das atividades operacionais em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do lucro líquido em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • net_income_yoy_chg
          Tipo: number

          Variação ano a ano do lucro líquido em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • net_margin
          Tipo: number

          Margem líquida como decimal (net_income / revenue). Retornado apenas quando calculável.

        • net_margin_chg_bps
          Tipo: number

          Variação absoluta da margem líquida em relação ao período anterior, em pontos-base. Retornado apenas quando calculável.

        • net_margin_chg_pct
          Tipo: number

          Variação percentual da margem líquida em relação ao período anterior, como decimal. Retornado apenas quando calculável.

        • net_margin_yoy_chg_bps
          Tipo: number

          Variação ano a ano da margem líquida em relação ao mesmo trimestre fiscal do ano anterior, em pontos-base. Apenas no payload trimestral. Retornado apenas quando calculável.

        • net_margin_yoy_chg_pct
          Tipo: number

          Variação percentual ano a ano da margem líquida em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual do lucro operacional em relação ao período anterior, como decimal. Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • operating_income_yoy_chg
          Tipo: number

          Variação ano a ano do lucro operacional em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • operating_margin
          Tipo: number

          Margem operacional como decimal (operating_income / revenue). Retornado apenas quando calculável.

        • operating_margin_chg_bps
          Tipo: number

          Variação absoluta da margem operacional em relação ao período anterior, em pontos-base. Retornado apenas quando calculável.

        • operating_margin_chg_pct
          Tipo: number

          Variação percentual da margem operacional em relação ao período anterior, como decimal. Retornado apenas quando calculável.

        • operating_margin_yoy_chg_bps
          Tipo: number

          Variação ano a ano da margem operacional em relação ao mesmo trimestre fiscal do ano anterior, em pontos-base. Apenas no payload trimestral. Retornado apenas quando calculável.

        • operating_margin_yoy_chg_pct
          Tipo: number

          Variação percentual ano a ano da margem operacional em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

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

          Variação percentual da receita em relação ao período anterior, como decimal (por exemplo, 0.10 = +10%). Sequencial no payload trimestral e ano a ano no payload anual. Retornado apenas quando calculável.

        • revenue_yoy_chg
          Tipo: number

          Variação ano a ano da receita em relação ao mesmo trimestre fiscal do ano anterior, como decimal. Apenas no payload trimestral. Retornado apenas quando calculável.

        • 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[]

        Insights curados e relevantes para o mercado, extraídos deste documento. Cada item tem um headline pré-renderizado, details estruturados e uma classificação de importance. Retornado apenas quando ao menos um sinal é disparado para esta entrada; o campo é omitido caso contrário. Limitado a 8 por entrada, ordenados HIGH → MEDIUM → LOW.

        Um insight curado e relevante para o mercado, derivado deste documento. O headline pré-renderizado é adequado para exibição direta; details traz campos estruturados para filtragem e uso programático. Os sinais são retornados em ordem de prioridade (o mais relevante primeiro); o próprio type codifica a magnitude (por exemplo, STRONG_REVENUE_INCREASE vs REVENUE_INCREASE).

        • headline
          Tipo: string
          obrigatório

          Resumo pré-renderizado e legível, adequado para exibição direta.

        • type
          Tipo: string enum
          obrigatório

          Categoria do sinal. MARGIN_EXPANSION/MARGIN_CONTRACTION: qualquer uma das margens bruta, operacional ou líquida variou ano a ano em ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: mudança de guidance prospectivo reportada no documento. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: segmento reportável de melhor ou pior desempenho por crescimento de receita orgânica. NON_GAAP_DIVERGENCE: uma métrica ajustada/non-GAAP difere materialmente da métrica GAAP equivalente no mesmo período. BACKLOG_SURGE/BACKLOG_DECLINE: backlog ou obrigações de desempenho remanescentes variaram ano a ano em ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE e variantes DECLINE: variação ano a ano da receita por faixas (magnitude ≥10% / ≥20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE e variantes DECLINE: variação ano a ano do lucro líquido por faixas (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE e variantes DECLINE: variação ano a ano do EPS por faixas (≥15% / ≥30%); independente do lucro líquido, porque recompras de ações podem ampliar o movimento do EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE e variantes DECLINE: variação ano a ano das despesas de capital em magnitude de gasto (≥15% / ≥30%).

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

          Campos estruturados específicos do tipo de sinal. O conteúdo varia: sinais de guidance trazem low, high, point_estimate, prior_value, revision_pct; sinais de segmento trazem best, worst, spread_pp; sinais non-GAAP trazem gaap_field, non_gaap_value, gaap_value, divergence_pct; sinais de crescimento trazem current, yoy_chg. Valores null são omitidos. Consulte os exemplos específicos de cada tipo.

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

          A métrica à qual este sinal se refere, quando aplicável (por exemplo, revenue, earnings_per_share, operating_margin ou o nome de uma métrica de guidance/KPI).

        • period
          Tipo: string | null

          O período fiscal ao qual o sinal se refere (por exemplo, 2026-Q1, FY 2026). Sinais de guidance prospectivo referem-se ao período projetado; sinais financeiros referem-se ao período de referência deste documento.

    • next_page_url
      Tipo: string

      URL absoluta da próxima página de resultados. Presente apenas quando restam mais resultados; solicite-a como está para continuar. Cada página contém até 10 registros.

    application/json
  • 400

    Não foi possível processar a requisição. Verifique os parâmetros da requisição.

  • 401

    É necessária uma chave de API da Felo válida.

  • 402

    A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

  • 403

    A conta não tem permissão para realizar esta operação.

  • 429

    Um limite de requisições ou de gastos foi atingido.

  • 502

    O serviço não pôde concluir a requisição.

  • 503

    A API ou o serviço de cobrança está temporariamente indisponível.

  • 504

    O serviço atingiu o tempo limite ao processar a requisição.

  • default

    Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

    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