API pública do Capital Agora

Endpoints

Cotação e indicadores de um papel

Devolve preço de fechamento, variações, faixa de 52 semanas, volume, valor de mercado, múltiplos e o período de referência do balanço usado.

GET https://capitalagora.com.br/api/ativo/PETR4

Lista de ações

Papéis com negociação regular, com fechamento, variação do dia e volume médio. Aceita limite (até 200) e setor.

GET https://capitalagora.com.br/api/acoes?limite=50

Lista de fundos imobiliários

FIIs com cotação, patrimônio, valor patrimonial da cota e segmento declarado à CVM.

GET https://capitalagora.com.br/api/fiis?limite=50

Indicador econômico

Último valor e série histórica. Slugs disponíveis: selic-meta, selic, cdi, ipca, ipca-12m, igp-m, inpc, dolar, euro, poupanca, tr, selic-mes, ibc-br, inadimplencia, endividamento.

GET https://capitalagora.com.br/api/indicador/selic-meta

Notícias

Manchetes do agregador com veículo, horário, tema e papéis citados. O campo url aponta para a matéria no site de origem.

GET https://capitalagora.com.br/api/noticias?tema=mercados&limite=20

Busca

Sugestão de papéis por código ou nome — é o endpoint que alimenta a caixa de busca do site.

GET https://capitalagora.com.br/api/sugerir?q=petr

Regras de uso

• Limite: 240 requisições por minuto por IP no site inteiro. Acima disso, a resposta é HTTP 429 até o minuto virar.
• Formato: JSON com Content-Type: application/json; charset=utf-8. Datas em ISO 8601 (AAAA-MM-DD). Valores monetários em reais, como número.
• Cache: as respostas trazem Cache-Control de 1 a 5 minutos. Respeite-o: os dados de origem só mudam uma vez por pregão ou por divulgação.
• Crédito: ao publicar os dados, cite o Capital Agora com link e a fonte primária — B3, CVM, Banco Central ou Tesouro Nacional, conforme o caso.
• Sem espelhamento: a API serve para consultar, não para reconstruir a base inteira. Para carga completa, baixe direto das fontes públicas, que são abertas.

O que há na base hoje

• Ações e units295
• Fundos imobiliários207
• Cotações diárias333.674
• Proventos4.444
• Séries econômicas15
• Último pregão28/08/2026

Exemplo de resposta

A consulta de um papel devolve um objeto com o preço, as variações calculadas, os múltiplos e a referência do balanço usado — os mesmos números exibidos na ficha:

{
  "ticker": "PETR4",
  "empresa": "PETROLEO BRASILEIRO S.A. PETROBRAS",
  "tipo": "acao",
  "data": "2026-08-26",
  "preco": 41.45,
  "variacoes": { "dia": 0.24, "mes": 1.8, "ano": 12.4, "doze_meses": 18.7 },
  "faixa52": { "minima": 32.1, "maxima": 44.9 },
  "indicadores": { "pl": 6.2, "pvp": 1.1, "roe": 17.8, "dy12m": 9.4 },
  "balanco_referencia": "2026-06-30",
  "fonte": ["B3 COTAHIST", "CVM DFP/ITR"]
}

Campos sem dado disponível voltam como null — nunca como zero, para que a ausência não seja confundida com valor real.

Para que costuma servir

• Planilha de carteira: puxar o preço de fechamento e o dividend yield de cada papel sem depender de raspagem de página.
• Painel interno: montar um quadro com Selic, CDI, IPCA e dólar atualizados para uso em reunião ou em sistema de gestão.
• Alerta simples: comparar o preço de fechamento com um limite definido e disparar aviso — lembrando que o dado é de fechamento, não intradiário.
• Estudo e ensino: baixar séries históricas de cotação e de indicadores para exercícios de análise, com fonte pública citável.

Boas práticas de integração

Respeite o cache. Cotação muda uma vez por pregão; indicador, uma vez por dia ou por mês. Consultar o mesmo endpoint a cada segundo não traz dado novo e queima o seu limite de requisições.

Trate o 429. Ao ultrapassar o limite por minuto, a resposta vem com status 429. O comportamento correto é esperar e repetir, com intervalo crescente entre as tentativas — não insistir em laço, que só prolonga o bloqueio.

Não confunda ausência com zero. Campos sem dado voltam null. Um P/L nulo significa que a empresa teve prejuízo ou que falta o número de ações na última demonstração; tratar isso como zero produz gráfico e ranking errados.

Guarde a data. Toda resposta traz a data de referência do dado. Ao exibir o número em outro lugar, leve a data junto: é o que permite ao seu usuário saber se está vendo o pregão de ontem ou o de uma semana atrás.

Prefira a fonte primária para carga histórica. Séries completas estão publicadas em arquivos abertos da B3, da CVM, do Banco Central e do Tesouro Nacional. A API daqui serve para consulta pontual e para os números já calculados.

Perguntas frequentes sobre a API