Dados da B3: qual API ou servidor MCP usar

Se você procurou "api b3" esperando um botão de cadastro gratuito e uma chave de acesso em cinco minutos, provavelmente já percebeu que a coisa não é bem assim. O termo "API da B3" carrega dois significados diferentes, e confundir os dois é o que faz muita equipe perder tempo batendo na porta errada.

Este guia esclarece essa ambiguidade e mapeia, de forma direta, as formas reais de consumir dados da B3: a API oficial da bolsa, os distribuidores licenciados de market data, os agregadores que entregam dados públicos já prontos e a construção da sua própria ingestão. No fim, você ainda descobre mais sobre o servidor MCP, voltado a quem quer que um agente de IA consulte dados do mercado brasileiro em linguagem natural.

O que é a API da B3, e por que "API da B3" tem dois sentidos

Quando alguém fala em "API da B3", pode estar se referindo a uma de duas coisas bem distintas.

O primeiro sentido é a API oficial da própria B3, publicada no portal B3 for Developers. É a interface que a bolsa criou para compartilhar dados e serviços com instituições que contratam uma licença.

O segundo sentido é uma API de dados da B3 oferecida por um terceiro: um distribuidor de market data licenciado ou um agregador que consome as fontes públicas e as entrega já estruturadas. Nesse caso, o dado tem origem na B3, mas quem opera a API, define o modelo de acesso e cobra pelo serviço é outra empresa.

Essa distinção é importante porque as duas rotas têm regras de acesso e custo completamente diferentes.

A API oficial da B3 é paga? Como funciona o acesso

A API oficial da B3 é um produto B2B contratado sob licença. O ambiente de certificação é gratuito para testes, mas o uso em produção depende de contratação comercial.

A B3 descreve suas APIs como interface para viabilizar o compartilhamento de dados de mercado com fintechs e com instituições financeiras e não financeiras que contratam a licença. O acesso é declaradamente voltado a empresas. Não há cadastro self-service gratuito para pessoa física, e a contratação passa pelo gerente de relacionamento.

Na prática, o fluxo funciona assim.

• Você pode explorar a documentação e testar as APIs no ambiente de certificação por conta própria, sem custo.
• Para ir a produção, é preciso receber o pacote de acesso, enviado pela B3 após a contratação.
• A autenticação usa OAuth 2.0, com token que costuma valer 12 horas e deve ser reutilizado entre chamadas, e o consumo é sujeito a throttling, retornando erro 429 quando o limite de requisições é ultrapassado.

Vale um ajuste de expectativa sobre o que esse catálogo oferece. Boa parte das APIs do B3 for Developers cobre fluxos operacionais e de pós-negociação: área do investidor, custódia, registro de ativos, recebíveis de cartão, posições de Tesouro Direto, integrações de participantes.

Não é o mesmo que um feed simples de cotações e séries históricas para desenvolvedores.

Quem busca puramente preço e histórico costuma recorrer a distribuidores de market data ou a agregadores, e é aí que entram os outros caminhos.

As quatro formas de obter dados da B3

Existem quatro rotas para colocar dados da B3 dentro do seu produto ou análise. Cada uma serve a um perfil diferente.

• API oficial da B3. Contratação B2B sob licença, adequada a instituições e participantes que precisam dos serviços e dados que só a bolsa expõe diretamente. Exige integração e autenticação próprias e passa por um processo comercial.
• Distribuidor de market data. Empresas que firmam contrato de distribuição com a B3 e revendem cotações e sinais de mercado, inclusive em tempo real e com baixa latência. É o caminho de quem precisa de streaming intraday para telas de negociação e sistemas sensíveis a latência. Cedro Technologies e Fast Trade são exemplos desse tipo de provedor.
• Agregador de dados públicos. Provedores que consomem as fontes públicas da B3, da CVM e do Banco Central e as normalizam em endpoints REST autenticados. É a rota mais direta para quem quer dado pronto, com baixo esforço de engenharia, geralmente em regime de fim de dia e às vezes com opções de tempo real.
• Construir do zero. Você mesmo baixa e processa as fontes públicas. Dá controle total, custa pouco em licença, mas exige um time de dados e manutenção contínua.

A tabela abaixo resume os trade-offs.

Dado público não é dado pronto

Os dados de origem são públicos, mas isso não significa que venham prontos.

A B3 disponibiliza o histórico de negociações no arquivo COTAHIST. A CVM publica as demonstrações financeiras e os informes de todas as companhias abertas. O Banco Central abre séries macroeconômicas pelo sistema SGS. O IBGE publica indicadores oficiais. Tudo isso é acessível de graça.

O trabalho está entre o dado bruto e o dado utilizável. Baixar o COTAHIST, parsear o layout de posição fixa, tratar eventos corporativos, normalizar os arquivos da CVM em algo consultável e manter as séries do Banco Central atualizadas todo dia é engenharia de dados contínua, não um script que roda uma vez.

É exatamente esse trabalho que um agregador vai te entregar. Quando você contrata um agregador, não está pagando pelo dado em si, que é público, mas pela normalização, pela padronização e pela manutenção.

Essa é a pergunta prática por trás da decisão de "acessar" versus "consumir": você quer resolver a engenharia de dados internamente ou quer o dado já estruturado, pronto para a sua aplicação?

O que é um servidor MCP e por que ele importa para dados financeiros

Um servidor MCP é um servidor que implementa o Model Context Protocol, um padrão aberto criado pela Anthropic em novembro de 2024 para conectar modelos e agentes de IA a fontes de dados e ferramentas externas de forma padronizada.

A analogia que ficou é a de um "USB-C para IA". Antes do MCP, cada integração entre um modelo e uma ferramenta pedia um conector customizado. Com o protocolo, uma ferramenta implementa um servidor MCP uma vez e passa a funcionar com qualquer cliente compatível, como Claude, ChatGPT, Cursor ou VS Code.

Aplicado a dados financeiros, isso muda a forma de consumo. Em vez de escrever código para chamar uma API REST, tratar a resposta e alimentar o modelo, você conecta um servidor MCP ao agente e ele consulta cotações, indicadores e fundamentos em linguagem natural.

Para quem está construindo agentes de IA sobre o mercado brasileiro, um servidor MCP nativo elimina a etapa de escrever e manter um conector próprio sobre a API de dados.

O protocolo tem mais camadas do que cabe aqui, incluindo a arquitetura de hosts, clients e servers e as opções de transporte local e remoto. Para entender o MCP em profundidade, vale uma leitura dedicada ao tema. Para a decisão deste artigo, basta reter que o MCP é a rota pensada para consumo por agente de IA, e não por código de aplicação tradicional.

REST ou MCP: qual usar para o seu caso

A escolha entre uma API REST e um servidor MCP não é sobre qual é mais moderna. É sobre quem vai consumir o dado.

Se o consumidor é código de aplicação, um backend, um dashboard, uma pipeline de dados, a API REST é o caminho natural. Você tem controle total sobre as chamadas e integra o dado direto na sua stack.

Se o consumidor é um agente ou modelo de IA que precisa consultar o dado de forma autônoma e em linguagem natural, o servidor MCP resolve a integração de um jeito que a REST sozinha não resolve, com descoberta de capacidades padronizada pelo protocolo.

Na prática, os dois não são excludentes. Um mesmo provedor pode oferecer API REST para as integrações tradicionais e um servidor MCP para os casos de uso com IA.

A Partnr, por exemplo, disponibiliza uma API REST em JSON e um servidor MCP nativo sobre a mesma camada de dados de mercado, fundamentalistas e macroeconômicos brasileiros, com fontes na CVM, na B3, no Banco Central e no IBGE.

É um dos caminhos de agregador para quem quer atender aos dois modos de consumo sem construir a ingestão do zero, ao lado de outras opções no mercado.

API REST ou MCP: qual devo escolher?

Três perguntas resolvem a maior parte das decisões.

Você precisa de tempo real ou fim de dia serve?

Se o caso é tela de negociação ou qualquer coisa sensível a latência de segundos, o caminho é a API oficial ou um distribuidor de market data com streaming. Se é análise de carteira, monitoramento, pesquisa fundamentalista ou alimentação de IA, o dado de fim de dia costuma atender bem e sai bem mais barato, já que o intraday em tempo real da B3 carrega custo de redistribuição elevado.

Qual é o seu orçamento e o seu apetite por engenharia?

Construir do zero é a rota de menor custo de licença e maior custo de manutenção. Faz sentido para quem tem time de dados dedicado e quer controle total. Se você prefere previsibilidade e velocidade de entrega, um agregador troca esse esforço por uma assinatura.

Quem vai consumir o dado?

Se é código, priorize uma boa API REST. Se é um agente de IA, priorize quem oferece um servidor MCP. Se o roadmap tem os dois, escolha um provedor que cubra ambos.

Cruzando essas três respostas, o caminho quase sempre se torna óbvio. O erro mais comum não é escolher a rota errada, é começar pela pergunta errada, olhando primeiro o preço em vez de olhar primeiro a forma de consumo e a latência que o caso realmente exige.

Conclusão

"API da B3" não é uma coisa só, e é por isso que primeiro você deve decidir qual caminho é mais adequado ao seu caso. A API oficial atende instituições sob licença. Os distribuidores entregam tempo real para quem precisa de latência baixa. Os agregadores transformam dado público bruto em dado pronto para quem quer velocidade sem montar engenharia de dados. E o servidor MCP abre a rota para agentes de IA consumirem o mercado brasileiro em linguagem natural.

Comece pela forma de consumo e pela latência, deixe o preço como consequência, e a decisão se resolve. Se o seu próximo passo é alimentar um agente de IA ou uma aplicação com dados do mercado brasileiro, vale avaliar os provedores que oferecem tanto API REST quanto servidor MCP sobre a mesma base, porque é essa combinação que evita ter de escolher agora e refazer a integração depois.