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

Obter métricas financeiras

Felo API Support
MIT
Servidor:https://openapi.felo.ai
Bibliotecas Cliente
Shell Curl

Financial Data

​

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

Financial Data Operações

Obter métricas financeiras

​

Índices calculados de uma empresa ao longo do tempo, cerca de 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, os índices de giro e de liquidez, cada um registrado com report_period e fiscal_period. period é obrigatório; identifique por ticker ou cik. Use para acompanhar a tendência de um índice entre períodos. Apenas para os valores atuais, get_financial_financial_metrics_snapshot é uma linha e bem menor.

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
  • cik
    Tipo: string

    A Central Index Key (CIK) da empresa. Pode ser usada em vez do ticker.

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

  • filing_date
    Tipo: string Formato: date

    Filtra pela data exata de registro na SEC no formato YYYY-MM-DD. Linhas sem data de registro conhecida são excluídas.

  • filing_date_gt
    Tipo: string Formato: date

    Filtra por data de registro na SEC posterior a date, no formato YYYY-MM-DD. Linhas sem data de registro conhecida são excluídas.

  • filing_date_gte
    Tipo: string Formato: date

    Filtra por data de registro na SEC posterior ou igual a date, no formato YYYY-MM-DD. Linhas sem data de registro conhecida são excluídas.

  • filing_date_lt
    Tipo: string Formato: date

    Filtra por data de registro na SEC anterior a date, no formato YYYY-MM-DD. Linhas sem data de registro conhecida são excluídas.

  • filing_date_lte
    Tipo: string Formato: date

    Filtra por data de registro na SEC anterior ou igual a date, no formato YYYY-MM-DD. Útil para consultas em um ponto específico no tempo: retorna apenas dados que já haviam sido registrados publicamente até a data informada. Linhas sem data de registro conhecida são excluídas.

  • limit
    Tipo: integer

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

  • period
    Tipo: string enum
    obrigatório

    O período dos dados financeiros.

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

    Filtra pela data exata do período do relatório no formato YYYY-MM-DD.

  • report_period_gt
    Tipo: string Formato: date

    Filtrar por período de relatório maior que a data no formato YYYY-MM-DD.

  • report_period_gte
    Tipo: string Formato: date

    Filtrar por período de relatório maior ou igual à data no formato YYYY-MM-DD.

  • report_period_lt
    Tipo: string Formato: date

    Filtrar por período de relatório menor que a data no formato YYYY-MM-DD.

  • report_period_lte
    Tipo: string Formato: date

    Filtrar por período de relatório menor ou igual à data no formato YYYY-MM-DD.

  • ticker
    Tipo: string

    O símbolo do ticker da empresa. Obrigatório se cik não for fornecido.

Respostas
  • 200
    Tipo: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    As métricas e índices financeiros históricos de um ticker

    • accession_number
      Tipo: string | null

      O número de acesso SEC do documento.

    • asset_turnover
      Tipo: number

      Receita dividida pelo ativo médio total.

    • book_value_growth
      Tipo: number

      Crescimento ano a ano do valor patrimonial.

    • book_value_per_share
      Tipo: number

      Patrimônio líquido dividido pelas ações em circulação.

    • cash_ratio
      Tipo: number

      Caixa e equivalentes de caixa divididos pelo passivo circulante.

    • currency
      Tipo: string

      A moeda na qual os dados financeiros são reportados.

    • current_ratio
      Tipo: number

      Ativos circulantes divididos pelo passivo circulante.

    • days_sales_outstanding
      Tipo: number

      Contas a receber médias divididas pela receita do período.

    • debt_to_assets
      Tipo: number

      Dívida total dividida pelo ativo total.

    • debt_to_equity
      Tipo: number

      Dívida total dividida pelo patrimônio líquido.

    • earnings_growth
      Tipo: number

      Crescimento ano a ano dos lucros.

    • earnings_per_share
      Tipo: number

      Lucro líquido dividido pela média ponderada das ações em circulação.

    • earnings_per_share_growth
      Tipo: number

      Crescimento do lucro por ação no período.

    • ebitda_growth
      Tipo: number

      Crescimento do EBITDA no período.

    • enterprise_value
      Tipo: number

      O valor total da empresa (valor de mercado + dívida - caixa).

    • enterprise_value_to_ebitda_ratio
      Tipo: number

      Relação entre valor da empresa e EBITDA.

    • enterprise_value_to_revenue_ratio
      Tipo: number

      Relação entre valor da empresa e receita.

    • filing_date
      Tipo: string | null Formato: date

      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. null quando nenhum documento datado da SEC está vinculado à linha.

    • 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_url
      Tipo: string | null Formato: uri

      URL do documento na SEC.

    • fiscal_period
      Tipo: string

      O período fiscal das métricas financeiras.

    • form_type
      Tipo: string | null

      O formulário da SEC de origem desta linha (10-K, 10-Q/A, 20-F, S-1, ...). O formulário exato conforme arquivado, portanto as emendas mantêm o sufixo /A. null quando period é ttm: uma janela de doze meses móveis pode abranger vários documentos, então não a atribuímos a um único. Uma linha quarterly pode trazer 10-K quando o quarto trimestre é derivado do documento do ano fiscal.

    • free_cash_flow_growth
      Tipo: number

      Crescimento do fluxo de caixa livre no período.

    • free_cash_flow_per_share
      Tipo: number

      Fluxo de caixa livre dividido pelas ações em circulação.

    • free_cash_flow_yield
      Tipo: number

      Rendimento do fluxo de caixa livre.

    • gross_margin
      Tipo: number

      Lucro bruto como percentual da receita.

    • interest_coverage
      Tipo: number

      EBIT dividido pelas despesas com juros.

    • inventory_turnover
      Tipo: number

      Custo dos produtos vendidos dividido pelo estoque médio.

    • net_margin
      Tipo: number

      Lucro líquido como percentual da receita.

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

    • operating_cash_flow_ratio
      Tipo: number

      Fluxo de caixa operacional dividido pelo passivo circulante.

    • operating_cycle
      Tipo: number

      Giro do estoque + giro das contas a receber.

    • operating_income_growth
      Tipo: number

      Crescimento do lucro operacional no período.

    • operating_margin
      Tipo: number

      Lucro operacional como percentual da receita.

    • payout_ratio
      Tipo: number

      Dividendos pagos como percentual do lucro líquido.

    • peg_ratio
      Tipo: number

      Relação entre preço e lucro com crescimento.

    • period
      Tipo: string enum

      O período das métricas financeiras.

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

      Relação entre preço e valor patrimonial.

    • price_to_earnings_ratio
      Tipo: number

      Relação entre preço e lucro.

    • price_to_sales_ratio
      Tipo: number

      Relação entre preço e receita.

    • quick_ratio
      Tipo: number

      Ativos de liquidez imediata divididos pelo passivo circulante.

    • receivables_turnover
      Tipo: number

      Receita dividida pelas contas a receber médias.

    • report_period
      Tipo: string Formato: date

      O período de referência das métricas financeiras.

    • return_on_assets
      Tipo: number

      Lucro líquido como percentual do ativo total.

    • return_on_equity
      Tipo: number

      Lucro líquido como percentual do patrimônio líquido.

    • return_on_invested_capital
      Tipo: number

      Lucro operacional líquido após impostos como percentual do capital investido.

    • revenue_growth
      Tipo: number

      Crescimento ano a ano da receita.

    • ticker
      Tipo: string

      O símbolo do ticker da empresa.

    • working_capital_turnover
      Tipo: number

      Receita dividida pelo capital de giro médio.

    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/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"
}

As métricas e índices financeiros históricos de um ticker

Get financial metrics