Pesquisar métricas financeiras específicas
Financial Data
Company fundamentals, financial statements, market prices and economic data.
Pesquisar métricas financeiras específicas
Extrai itens financeiros nomeados de uma ou mais empresas em uma única chamada. O corpo recebe tickers e line_items (ambos obrigatórios, ambos arrays), além de period (annual, quarterly ou ttm) e limit. Retorna search_results com uma linha por ticker e período contendo apenas os campos solicitados, junto com report_period, period e currency. Use para montar uma tabela comparativa sem puxar três demonstrações completas por empresa. Os nomes dos itens são os mesmos nomes de campo que as ferramentas de demonstração retornam, então consulte lá primeiro se tiver dúvida. Para tudo sobre uma única empresa, use get_financial_financials.
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: array string[] 1…line
_items obrigatórioUm array de itens de linha a aplicar à pesquisa.
- Tipo: array string[] 1…tickersobrigatório
Um array de tickers a aplicar à pesquisa.
- Tipo: integerlimitmín:1
O número máximo de resultados a retornar.
- Tipo: string enumperiod
O período dos dados financeiros.
valores- annual
- quarterly
- ttm
- Tipo: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
Resposta de pesquisa bem-sucedida
- Tipo: array object[]search
_results - currencyTipo: string
A moeda dos dados financeiros.
- periodTipo: string enum
O período dos dados financeiros.
valores- annual
- quarterly
- ttm
- reportTipo: string Formato: date
_period O período de referência dos dados financeiros.
- tickerTipo: string
O símbolo do ticker da empresa.
- propertyTipo: string
Name Métricas financeiras adicionais com base nos critérios de pesquisa.
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/search/line-items \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"line_items": [
""
],
"tickers": [
""
],
"period": "ttm",
"limit": 1
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-10-26",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}