Obter todas as demonstrações financeiras
Financial Data
Company fundamentals, financial statements, market prices and economic data.
Obter todas as demonstrações financeiras
As três demonstrações de uma empresa em uma única chamada. Retorna um objeto financials com income_statements, balance_sheets e cash_flow_statements, cada um com o mesmo formato que as ferramentas dedicadas retornam. period é obrigatório (annual, quarterly ou ttm); identifique a empresa por ticker ou cik e limite com limit. Use quando precisar do quadro completo e, de outra forma, faria três chamadas. Quando precisar de apenas uma demonstração, get_financial_financials_income_statements, get_financial_financials_balance_sheets ou get_financial_financials_cash_flow_statements retornam muito menos dados; quando precisar de alguns campos nomeados em várias empresas, post_financial_financials_search_line_items é ainda mais restrito.
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.
- Tipo: stringcik
A Central Index Key (CIK) da empresa.
- Tipo: stringcursor
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.
- Tipo: string Formato: datefiling
_date Filtra pela data exata de registro na SEC no formato YYYY-MM-DD. Linhas sem data de registro conhecida são excluídas.
- Tipo: string Formato: datefiling
_date _gt 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.
- Tipo: string Formato: datefiling
_date _gte 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.
- Tipo: string Formato: datefiling
_date _lt 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.
- Tipo: string Formato: datefiling
_date _lte 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.
- Tipo: integer Formato: int32limit
O número máximo de demonstrações financeiras 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. - Tipo: string enumperiodobrigatório
O período das demonstrações financeiras.
valores- annual
- quarterly
- ttm
- Tipo: string Formato: datereport
_period Filtra pela data exata do período do relatório no formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _gt Filtrar por período de relatório maior que a data no formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _gte Filtrar por período de relatório maior ou igual à data no formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _lt Filtrar por período de relatório menor que a data no formato YYYY-MM-DD.
- Tipo: string Formato: datereport
_period _lte Filtrar por período de relatório menor ou igual à data no formato YYYY-MM-DD.
- Tipo: stringticker
O símbolo do ticker. Obrigatório se cik não for fornecido.
- Tipo: object · ResponseE40Feb4D3D6B_FinancialsResponse200
Resposta de demonstrações financeiras
- Tipo: objectfinancials
- balanceTipo: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
_sheets - accessionTipo: string | null
_number O número de acesso SEC do documento.
- accumulatedTipo: number
_other _comprehensive _income Os outros resultados abrangentes acumulados da empresa.
- cashTipo: number
_and _equivalents O caixa e equivalentes de caixa da empresa.
- currencyTipo: string
A moeda na qual os dados financeiros são reportados.
- currentTipo: number
_assets Os ativos circulantes da empresa.
- currentTipo: number
_debt A dívida circulante da empresa.
- currentTipo: number
_investments Os investimentos circulantes da empresa.
- currentTipo: number
_liabilities O passivo circulante da empresa.
- deferredTipo: number
_revenue A receita diferida da empresa.
- depositTipo: number
_liabilities O passivo de depósitos da empresa.
- filingTipo: string | null Formato: date
_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. - filingTipo: string | null Formato: date-time
_datetime 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
acceptanceDateTimeda SEC na API de submissões do EDGAR. Faz par comfiling_date(precisão de dia civil do mesmo evento). - filingTipo: string | null Formato: uri
_url URL do documento na SEC.
- fiscalTipo: string
_period O período fiscal do balanço patrimonial.
- formTipo: string | null
_type 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 quandoperiodéttm: uma janela de doze meses móveis pode abranger vários documentos, então não a atribuímos a um único. Uma linhaquarterlypode trazer10-Kquando o quarto trimestre é derivado do documento do ano fiscal. - goodwillTipo: number
_and _intangible _assets O goodwill e os ativos intangíveis da empresa.
- inventoryTipo: number
O estoque da empresa.
- investmentsTipo: number
Os investimentos da empresa.
- nonTipo: number
_current _assets Os ativos não circulantes da empresa.
- nonTipo: number
_current _debt A dívida não circulante da empresa.
- nonTipo: number
_current _investments Os investimentos não circulantes da empresa.
- nonTipo: number
_current _liabilities O passivo não circulante da empresa.
- outstandingTipo: number
_shares As ações em circulação da empresa.
- periodTipo: string enum
O período do balanço patrimonial.
valores- quarterly
- ttm
- annual
- propertyTipo: number
_plant _and _equipment O imobilizado da empresa.
- reportTipo: string Formato: date
_period O período de referência do balanço patrimonial.
- retainedTipo: number
_earnings Os lucros acumulados da empresa.
- shareholdersTipo: number
_equity O patrimônio líquido da empresa.
- taxTipo: number
_assets Os ativos fiscais da empresa.
- taxTipo: number
_liabilities O passivo fiscal da empresa.
- tickerTipo: string
O símbolo do ticker.
- totalTipo: number
_assets O ativo total da empresa.
- totalTipo: number
_debt A dívida total da empresa.
- totalTipo: number
_liabilities O passivo total da empresa.
- tradeTipo: number
_and _non _trade _payables As contas a pagar comerciais e não comerciais da empresa.
- tradeTipo: number
_and _non _trade _receivables As contas a receber comerciais e não comerciais da empresa.
- cashTipo: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
_flow _statements - accessionTipo: string | null
_number O número de acesso SEC do documento.
- businessTipo: number
_acquisitions _and _disposals As aquisições e alienações de negócios da empresa.
- capitalTipo: number
_expenditure As despesas de capital da empresa.
- changeTipo: number
_in _cash _and _equivalents A variação de caixa e equivalentes da empresa.
- currencyTipo: string
A moeda na qual os dados financeiros são reportados.
- depreciationTipo: number
_and _amortization A depreciação e amortização da empresa.
- dividendsTipo: number
_and _other _cash _distributions Os dividendos e outras distribuições de caixa da empresa.
- effectTipo: number
_of _exchange _rate _changes O efeito das variações cambiais da empresa.
- endingTipo: number
_cash _balance O saldo final de caixa da empresa.
- filingTipo: string | null Formato: date
_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. - filingTipo: string | null Formato: date-time
_datetime 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
acceptanceDateTimeda SEC na API de submissões do EDGAR. Faz par comfiling_date(precisão de dia civil do mesmo evento). - filingTipo: string | null Formato: uri
_url URL do documento na SEC.
- fiscalTipo: string
_period O período fiscal da demonstração de fluxo de caixa.
- formTipo: string | null
_type 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 quandoperiodéttm: uma janela de doze meses móveis pode abranger vários documentos, então não a atribuímos a um único. Uma linhaquarterlypode trazer10-Kquando o quarto trimestre é derivado do documento do ano fiscal. - freeTipo: number
_cash _flow O fluxo de caixa livre da empresa.
- investmentTipo: number
_acquisitions _and _disposals As aquisições e alienações de investimentos da empresa.
- issuanceTipo: number
_or _purchase _of _equity _shares A emissão ou compra de ações da empresa.
- issuanceTipo: number
_or _repayment _of _debt _securities A emissão ou o pagamento de títulos de dívida da empresa.
- netTipo: number
_cash _flow _from _financing O fluxo de caixa líquido de financiamento da empresa.
- netTipo: number
_cash _flow _from _investing O fluxo de caixa líquido de investimento da empresa.
- netTipo: number
_cash _flow _from _operations O fluxo de caixa líquido das atividades operacionais da empresa.
- netTipo: number
_income O lucro líquido da empresa.
- periodTipo: string enum
O período da demonstração de fluxo de caixa.
valores- quarterly
- ttm
- annual
- reportTipo: string Formato: date
_period O período de referência da demonstração de fluxo de caixa.
- shareTipo: number
_based _compensation A remuneração baseada em ações da empresa.
- tickerTipo: string
O símbolo do ticker.
- incomeTipo: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
_statements - accessionTipo: string | null
_number O número de acesso SEC do documento.
- consolidatedTipo: number
_income O lucro consolidado da empresa.
- costTipo: number
_of _revenue O custo da receita da empresa.
- currencyTipo: string
A moeda na qual os dados financeiros são reportados.
- dividendsTipo: number
_per _common _share Os dividendos por ação ordinária da empresa.
- earningsTipo: number
_per _share O lucro por ação da empresa.
- earningsTipo: number
_per _share _diluted O lucro por ação diluído da empresa.
- ebitTipo: number
O lucro antes de juros e impostos da empresa.
- filingTipo: string | null Formato: date
_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. - filingTipo: string | null Formato: date-time
_datetime 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
acceptanceDateTimeda SEC na API de submissões do EDGAR. Faz par comfiling_date(precisão de dia civil do mesmo evento). - filingTipo: string | null Formato: uri
_url URL do documento na SEC.
- fiscalTipo: string
_period O período fiscal da demonstração de resultado.
- formTipo: string | null
_type 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 quandoperiodéttm: uma janela de doze meses móveis pode abranger vários documentos, então não a atribuímos a um único. Uma linhaquarterlypode trazer10-Kquando o quarto trimestre é derivado do documento do ano fiscal. - grossTipo: number
_profit O lucro bruto da empresa.
- incomeTipo: number
_tax _expense As despesas com imposto de renda da empresa.
- interestTipo: number
_expense As despesas com juros da empresa.
- netTipo: number
_income O lucro líquido da empresa.
- netTipo: number
_income _common _stock O lucro líquido disponível para os acionistas ordinários da empresa.
- netTipo: number
_income _discontinued _operations O lucro líquido de operações descontinuadas da empresa.
- netTipo: number
_income _non _controlling _interests O lucro líquido de participações não controladoras da empresa.
- operatingTipo: number
_expense As despesas operacionais da empresa.
- operatingTipo: number
_income O lucro operacional da empresa.
- periodTipo: string enum
O período da demonstração de resultado.
valores- quarterly
- ttm
- annual
- preferredTipo: number
_dividends _impact O impacto dos dividendos preferenciais no lucro líquido da empresa.
- reportTipo: string Formato: date
_period O período de referência da demonstração de resultado.
- researchTipo: number
_and _development As despesas de pesquisa e desenvolvimento da empresa.
- revenueTipo: number
A receita total da empresa.
- sellingTipo: number
_general _and _administrative _expenses As despesas de vendas, gerais e administrativas da empresa.
- tickerTipo: string
O símbolo do ticker.
- weightedTipo: number
_average _shares A média ponderada de ações da empresa.
- weightedTipo: number
_average _shares _diluted A média ponderada diluída de ações da empresa.
- Tipo: stringnext
_page _url 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
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"
}