Financial Data
Company fundamentals, financial statements, market prices and economic data.
Obter itens de documento da SEC
O texto completo dos itens numerados dentro de um documento da SEC. ticker, filing_type (10-K, 10-Q ou 8-K) e year são todos obrigatórios; restrinja mais com quarter, item, accession_number ou include_exhibits. Retorna items — cada um com number, title e o text completo —, além de filing_url e accession_number. Atenção ao tamanho: um 10-K volta como cerca de 19 itens de prosa completa, então peça um item específico em vez de puxar tudo, a menos que você realmente precise do documento inteiro. Para descobrir qual documento abrir, use get_financial_filings.
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: stringaccession
_number O número de acesso do documento protocolado, se 8-K.
- Tipo: string enumfiling
_type obrigatórioO tipo de documento protocolado.
valores- 10
- K - 10
- Q - 8
- K
- Tipo: booleaninclude
_exhibits Se deve incluir o texto bruto dos anexos vinculados. Aplicável apenas a documentos 8-K. Quando true, os objetos de anexo incluirão o campo 'text' com o conteúdo completo do anexo.
- Tipo: string enumitem
O item a obter.
valores- Item
-1 - Item
-1 A - Item
-1 B - Item
-2 - Item
-3
- Tipo: integerquarter
O trimestre do documento protocolado, se 10-Q.
- Tipo: stringtickerobrigatório
O símbolo do ticker.
- Tipo: integeryearobrigatório
O ano do documento protocolado.
- Tipo: object · ResponseE40Feb4D3D6B_FilingItemsResponse200
Resposta de itens do documento da SEC
- Tipo: stringaccession
_number O número de acesso do documento.
- Tipo: stringcik
A Central Index Key (CIK) da empresa.
- Tipo: stringfiling
_type O tipo de documento protocolado.
- Tipo: array object[] · ResponseE40Feb4D3D6B_FilingItem[]items
- exhibitsTipo: array object[] · ResponseE40Feb4D3D6B_Exhibit[]
Uma matriz de anexos vinculados a este item. Presente apenas em documentos 8-K quando existem anexos.
- descriptionTipo: string
A descrição do anexo.
- numberTipo: string
O número do anexo (por exemplo, '99.1').
- textTipo: string
O conteúdo de texto bruto do anexo. Incluído apenas quando o parâmetro 'include_exhibits' é definido como true.
- urlTipo: string Formato: uri
A URL do documento do anexo no site da SEC.
- nameTipo: string
O nome do item.
- numberTipo: string
O número do item.
- textTipo: string
O texto do item.
- Tipo: integerquarter
O trimestre do documento.
- Tipo: stringresource
O identificador do tipo de recurso.
- Tipo: stringticker
O símbolo do ticker da empresa.
- Tipo: integeryear
O ano do documento protocolado.
application/json - Tipo: object · ResponseE40Feb4D3D6B_FilingItemsAccepted202
O documento ainda está sendo preparado. Consulte o result_url do corpo da resposta para obter o resultado. Você não é cobrado por esta resposta.
- Tipo: stringaccession
_number O número de acesso do documento em preparação.
- Tipo: string Formato: date-timeestimated
_ready _at Quando o documento deve estar pronto.
- Tipo: stringmessage
Descrição legível do que fazer em seguida.
- Tipo: string Formato: uuidrequest
_id Identificador desta requisição; útil ao contatar o suporte.
- Tipo: stringresult
_url A URL para consultar o resultado.
- enumstatusconst:processing
Sempre 'processing' em uma resposta 202.
valores- processing
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/filings/items?filing_type=10-K&ticker=&year=1' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"resource": "string",
"ticker": "string",
"cik": "string",
"filing_type": "string",
"accession_number": "string",
"year": 1,
"quarter": 1,
"items": [
{
"number": "string",
"name": "string",
"text": "string",
"exhibits": [
{
"number": "string",
"description": "string",
"url": "https://example.com",
"text": "string"
}
]
}
]
}