API do Faro
Os dados do Faro no seu código
Indicadores, proventos e fatos oficiais de mais de 2 mil ativos (ações, FIIs, ETFs, BDRs, cripto e Tesouro Direto), em JSON. Grátis durante o teste, até 1.000 chamadas por dia por chave.
Suas chaves
Entre na sua conta para criar uma chave. Leva 1 minuto e é grátis.
EntrarComo chamar
Mande a chave no cabeçalho Authorization. A resposta vem em { data }; um erro, em { error } com o status HTTP certo (400 parâmetro errado, 401 chave inválida, 404 ativo que não existe, 429 limite do dia). Os cabeçalhos X-RateLimit-Remaining dizem quantas chamadas ainda restam hoje (o limite volta à meia-noite de Brasília).
curl -H "Authorization: Bearer faro_SUA_CHAVE" \ https://faro-ecru.vercel.app/api/v1/ativos/PETR4
const res = await fetch("https://faro-ecru.vercel.app/api/v1/ativos/MXRF11/proventos", {
headers: { Authorization: "Bearer faro_SUA_CHAVE" },
});
const { data } = await res.json();Endereços
Procurar ativos
GET /api/v1/ativos?q=petroPelo código ou pelo nome, sem ligar para acento. Filtros: "tipo" (acao, fii, etf, bdr, cripto, tesouro) e "limite" (1 a 50, padrão 20).
Preço e indicadores
GET /api/v1/ativos/PETR4Preço, setor, data do balanço usado e todos os indicadores da Pesquisa (com nome, grupo e formato), mais os sinais nos balanços (red flags).
Proventos
GET /api/v1/ativos/MXRF11/proventosProventos pela data-com (B3), rendimento mês a mês dos FIIs (informe da CVM) e as próximas datas (data-com, pagamento, resultados).
Fatos oficiais
GET /api/v1/ativos/PETR4/fatos?dias=90Documentos da CVM, B3 e FNET com a leitura da IA, balanços lidos (ITR e DFP) e mudanças no Formulário de Referência. "dias": 1 a 365, padrão 90.
Só dados públicos: a API nunca mostra a carteira de ninguém nem notícias da imprensa. Indicadores calculados pelo Faro a partir da CVM, B3, Banco Central, CoinGecko e Tesouro Transparente; as leituras da IA podem errar. Nada aqui é recomendação de investimento.