Financial Data
Company fundamentals, financial statements, market prices and economic data.
Taxas de juros (histórico)
A taxa de política de um banco central ao longo do tempo, como um array interest_rates de bank, name, date e rate. bank é obrigatório e delimitado por start_date e end_date. Armadilha que vale conhecer: o código diferencia maiúsculas de minúsculas e deve ser maiúsculo — FED funciona, fed retorna HTTP 404 com "No data found", o que parece um resultado vazio em vez de um argumento inválido. Os códigos válidos são FED, ECB, BOJ, BOE, BOC, RBA, PBOC, SNB, RBI e BOK; get_financial_macro_interest_rates_snapshot sem argumentos lista todos.
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: stringbankobrigatório
O código do banco central, por exemplo FED, ECB, BOJ. Use o endpoint /macro/interest-rates/banks para obter a lista de bancos disponíveis.
- 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: stringend
_date A última data a retornar, inclusive, no formato YYYY-MM-DD. O padrão é hoje.
- Tipo: stringstart
_date A primeira data a retornar, inclusive, no formato YYYY-MM-DD. O padrão é cinco anos antes de end_date quando ambas as datas são omitidas; omita-a junto com um end_date para obter todo o histórico disponível até essa data.
- Tipo: object · ResponseE40Feb4D3D6B_InterestRatesResponse200
Resposta de taxas de juros
- Tipo: array object[] · ResponseE40Feb4D3D6B_InterestRate[]interest
_rates - bankTipo: string
O símbolo do banco central.
- dateTipo: string
O dia civil em que a taxa está em vigor, no formato YYYY-MM-DD.
- nameTipo: string
O nome do banco central.
- rateTipo: number
A taxa de política monetária em percentual naquele dia. Para o Federal Reserve, o ponto médio da faixa meta.
- Tipo: stringnext
_page _url Apenas histórico. URL absoluta da próxima página de resultados. Presente apenas quando restam mais linhas; solicite-a como está para continuar. Cada página contém até 10 linhas.
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/macro/interest-rates?bank=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"interest_rates": [
{
"bank": "string",
"name": "string",
"rate": 1,
"date": "string"
}
],
"next_page_url": "string"
}