API e MCP

Duas portas para os mesmos dados: REST para integração convencional e MCP (JSON-RPC 2.0) para que um agente de IA use o RadarFatos como ferramenta.

Autenticação

Envie a chave no cabeçalho Authorization: Bearer radar_.... A mesma chave vale para REST e MCP. Os dados servidos são públicos (CVM/FNET); a chave existe para limitar uso.

Criar conta para gerar chave

Endpoints REST

Método e caminho	O que faz
`GET /api/v1/fundos?q=&classe=&limite=`	Busca por ticker, CNPJ, código ou nome
`GET /api/v1/fundos/{code}`	Ficha completa: indicadores, série, carteira, reapresentações
`GET /api/v1/fundos/{code}/serie?limite=`	Série declarada por competência
`GET /api/v1/rankings/{classe}`	Maiores por patrimônio (fii, fidc, 555, cri, cra, fip)
`GET /api/v1/reapresentacoes?mes=&classe=`	Competências corrigidas e reentregues
`GET /api/v1/documentos?limite=`	Fatos relevantes com resumo por IA e impacto
`GET /api/v1/status`	Cobertura por classe
`POST /api/v1/validar-xml`	Diagnóstico do informe antes da entrega (5 MB)
`GET /api/v1/export/admin?admin=&classe=&formato=csv\|xlsx`	Base consolidada por administrador
`GET /api/v1/export/admin/manifest`	Metadados do export, sem baixar
`POST /api/mcp`	Servidor MCP (JSON-RPC 2.0)

Limites

Bucket	Limite
validar	30 chamadas / 60s
export	10 chamadas / 3600s
consulta	120 chamadas / 60s

Ao estourar, a resposta vem com 429 e o cabeçalho Retry-After.

Ferramentas MCP

Ferramenta	Descrição
`buscar_fundo`	Busca fundos, classes e emissões por ticker, CNPJ, código ou nome (FII, FIDC, 555, CRI, CRA, FIP).
`ficha_fundo`	Ficha completa: indicadores da última competência, série de 12 meses, carteira declarada e histórico de reapresentações.
`serie_historica`	Série declarada por competência (PL, cota, cotistas, DY, rentabilidade).
`reapresentacoes`	Competências corrigidas e reentregues à CVM, com lag e variação de PL.
`fatos_relevantes`	Fatos relevantes e comunicados de companhias abertas da B3 e FIIs, com resumo por IA, impacto estimado e link para o documento original.
`validar_informe_xml`	Valida o XML de um informe antes da entrega à CVM e devolve o diagnóstico em quatro níveis (erro, alerta, atenção, info).
`exportar_admin`	Exporta a base consolidada de fundos por administrador (CSV).

Exemplos

Ficha de um fundo

curl -H "Authorization: Bearer radar_SUA_CHAVE" \
  "https://radarfatos.com.br/api/v1/fundos/97521225000125"

Validar um informe antes de entregar

curl -X POST -H "Authorization: Bearer radar_SUA_CHAVE" \
  -F "arquivo=@informe.xml" \
  "https://radarfatos.com.br/api/v1/validar-xml"

Export por administrador em Excel

curl -H "Authorization: Bearer radar_SUA_CHAVE" \
  "https://radarfatos.com.br/api/v1/export/admin?admin=07253654000176&formato=xlsx" \
  -o fundos.xlsx

MCP — listar ferramentas

curl -X POST -H "Authorization: Bearer radar_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  "https://radarfatos.com.br/api/mcp"

MCP — chamar uma ferramenta

curl -X POST -H "Authorization: Bearer radar_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"buscar_fundo","arguments":{"consulta":"MXRF11"}}}' \
  "https://radarfatos.com.br/api/mcp"

Todo retorno traz o campo fonte e a competência de cada número. Dados de export vêm de fontes públicas (CVM/FNET), com schema versionado. O XML enviado à validação é analisado em memória e descartado.