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.

Entrar

Como 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://faroinvest.com.br/api/v1/ativos/PETR4
const res = await fetch("https://faroinvest.com.br/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=petro

Pelo 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/PETR4

Preç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/proventos

Proventos 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=90

Documentos 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.