Perguntas frequentes sobre as APIs de dados financeiros da Partnr

Central de ajuda com perguntas frequentes sobre as APIs da Partnr, integrações, planos e suporte técnico. Encontre respostas sobre dados fundamentalistas, cotações e market data da B3, FIIs e fundos listados, ETFs, notícias, dados macroeconômicos e o servidor MCP.

APIs

Quais soluções de dados a Partnr oferece?

A Partnr oferece APIs de dados financeiros para empresas que precisam integrar informações do mercado brasileiro aos seus sistemas, plataformas e aplicações. As soluções incluem dados fundamentalistas de empresas listadas na B3, cotações e market data pela API de cotações da B3, informações de FIIs e fundos listados pela API de FIIs, composição de ETFs pela API de ETFs, notícias financeiras processadas e indicadores macroeconômicos. Os dados são coletados de fontes oficiais, padronizados e disponibilizados por API REST. Para aplicações de inteligência artificial, a Partnr também oferece um servidor MCP.

Qual API da Partnr é mais indicada para cada caso de uso?

Qual é a diferença entre as APIs de Dados Fundamentalistas, Cotações, Fundos, ETFs, Notícias e Macroeconomia?

Qual é a diferença entre API de Cotações, API B3 e Market Data?

“API de Cotações” normalmente se refere à integração de preços, volumes, variações e histórico de ativos. “API B3” é um termo mais amplo usado para buscar dados da bolsa brasileira via API. “Market Data” é a categoria de dados de mercado, que pode incluir cotações, histórico, índices, ativos, volumes e variações.

Na Partnr, a API de Cotações e Market Data B3 é a solução voltada a dados de mercado da B3, com foco em cotações, histórico de preços, dados ajustados, ativos e índices para aplicações financeiras.

Qual é a diferença entre consumir dados diretamente da B3, CVM ou Banco Central e usar a Partnr?

Consumir dados diretamente da B3, CVM ou Banco Central exige que a empresa desenvolva e mantenha processos próprios de coleta, tratamento, padronização, atualização e monitoramento das fontes. A Partnr realiza essa camada de infraestrutura e disponibiliza os dados prontos para integração por API REST ou MCP. Assim, a equipe reduz o trabalho de processar arquivos, conciliar formatos e acompanhar mudanças nas fontes, podendo concentrar seus esforços na aplicação e na experiência do usuário.

Preço, planos e contratação

Como funciona a precificação das APIs da Partnr?

A precificação é personalizada de acordo com o escopo de cada projeto. A proposta considera o seu caso de uso, o conjunto de dados contratados, a complexidade da integração e as necessidades de suporte.

O preço varia conforme os dados ou produtos contratados?

Sim. O valor varia conforme os módulos de dados incluídos no contrato, como Dados Fundamentalistas, Cotações, Fundos, ETFs, Notícias e Macroeconomia. O cliente pode combinar diferentes produtos e montar um pacote de acordo com as necessidades da sua aplicação.

Existe limite de requisição?

Não. As APIs da Partnr funcionam sem limite de requisições. As condições são definidas exclusivamente de acordo com o escopo do seu projeto.

Existe um período gratuito de teste?

Sim. A Partnr disponibiliza um período de 7 dias para testes gratuitos, com possibilidade de prorrogação até 15 dias, caso seja necessário. Para solicitar um teste, basta preencher o formulário de contato.

É possível contratar apenas um tipo de dado?

Sim. Cada empresa pode contratar apenas o conjunto de dados de que precisa ou combinar diferentes APIs em um mesmo pacote. Não é necessário contratar todo o portfólio da Partnr para utilizar uma solução específica.

Existe contrato mínimo ou período de fidelidade?

Não há período obrigatório de fidelidade. As condições, o prazo e o formato do contrato são definidos de acordo com o escopo do projeto e com o modelo comercial escolhido pelo cliente.

A Partnr oferece contratos mensais e anuais?

Sim. A Partnr trabalha com contratos mensais e anuais. Para contratos anuais existe a aplicação de um desconto no valor total do pacote e a aplicação de melhores condições comerciais.

Como solicitar uma proposta comercial?

Para solicitar uma proposta, basta entrar em contato pelo formulário com a equipe da Partnr e informar quais dados serão utilizados e o caso de uso da aplicação. A partir dessas informações, um representante da equipe entrará em contato para estruturar um plano que se encaixe nas suas necessidades e passar a cotação.

A Partnr atende pessoas físicas ou projetos de uso estritamente pessoal?

Não. As soluções da Partnr são voltadas a empresas que utilizam dados financeiros em produtos, plataformas, análises, processos internos ou aplicações de inteligência artificial. A contratação para pessoa física acontece apenas para projetos que sejam futuramente comercializados; a Partnr não atende projetos destinados exclusivamente ao acompanhamento de investimentos pessoais.

Licenciamento e uso dos dados

Posso utilizar os dados da Partnr em um produto para meus clientes?

Sim. Os dados da Partnr podem ser integrados a produtos, plataformas e serviços oferecidos aos seus clientes, desde que o uso esteja previsto nas condições contratadas. Isso inclui sites/aplicações financeiras, ferramentas de análise, áreas logadas, relatórios e soluções de inteligência artificial.

É permitido exibir os dados em aplicativos, plataformas ou dashboards?

Sim. Os dados podem ser exibidos em aplicativos, plataformas digitais, dashboards, relatórios e outros produtos voltados a usuários finais. O formato de uso e a cobertura dos dados são definidos de acordo com os módulos contratados e com a finalidade da aplicação.

Posso redistribuir ou revender os dados recebidos pela API?

A redistribuição ou revenda dos dados não é permitida automaticamente. Esse tipo de uso depende de autorização prévia da Partnr e deve estar expressamente previsto no contrato.

É possível utilizar os dados em modelos e agentes de inteligência artificial?

Sim. Os dados da Partnr podem ser utilizados em modelos, agentes de IA, assistentes, copilotos e outros sistemas que dependem de informações financeiras estruturadas. O acesso pode ser feito por API REST ou pelo servidor MCP da Partnr.

As condições de licenciamento variam de acordo com a fonte dos dados?

Na maior parte dos produtos, as condições de uso seguem o licenciamento definido no contrato com a Partnr. A principal exceção envolve cotações em tempo real, que podem estar sujeitas a condições específicas de licenciamento, exibição e distribuição.

Implementação e suporte

Como funciona a integração com as APIs da Partnr?

As APIs da Partnr seguem o padrão REST e retornam dados estruturados em JSON, permitindo a integração com diferentes linguagens, sistemas, aplicativos e plataformas. Na documentação técnica você encontra orientações necessárias para autenticação, consulta e uso dos dados.

Quando usar API REST e quando usar MCP?

A API REST é indicada para integrações tradicionais, nas quais a aplicação consulta endpoints definidos e utiliza as respostas estruturadas dentro de seus próprios fluxos. O MCP é voltado principalmente a agentes e aplicações de inteligência artificial, permitindo que o modelo identifique e utilize as ferramentas disponíveis durante uma tarefa. As duas opções acessam a infraestrutura de dados da Partnr e podem ser utilizadas de forma complementar.

As APIs da Partnr podem ser integradas a aplicações de inteligência artificial?

Sim. Os dados da Partnr podem ser utilizados em agentes de IA, assistentes, copilotos e outras aplicações que dependem de informações financeiras estruturadas e atualizadas, incluindo soluções baseadas em modelos como ChatGPT, Claude, Gemini e outras IAs generativas. A integração pode ser realizada por API REST ou pelo servidor MCP da Partnr, conforme a arquitetura do projeto.

A Partnr oferece SDKs oficiais para integração?

Sim. A Partnr disponibiliza SDKs e recursos que facilitam a integração com suas APIs nas linguagens suportadas. As instruções de instalação, os exemplos de uso e a relação atualizada dos recursos disponíveis podem ser consultados na documentação técnica dos SDKs.

Onde encontro a documentação técnica das APIs da Partnr?

A documentação técnica reúne informações sobre autenticação, endpoints, parâmetros, formatos de resposta e exemplos de requisições. O conteúdo está disponível no portal de desenvolvedores da Partnr: developers.partnr.ai.

A Partnr oferece suporte durante a implementação?

Sim. A equipe da Partnr oferece suporte individual e personalizado durante todo o processo de integração. O nível de acompanhamento é definido de acordo com o escopo contratado. Para clientes Enterprise, uma equipe de especialistas em finanças e tecnologia acompanha todo o processo de ponta a ponta.

Quanto tempo leva para integrar uma API da Partnr?

O prazo varia de acordo com a complexidade do projeto, os conjuntos de dados utilizados e a arquitetura da aplicação. Como os dados são entregues de forma padronizada por API REST ou MCP, a empresa não precisa desenvolver internamente toda a camada de coleta, tratamento e atualização das fontes.

Quais canais de suporte estão disponíveis?

Temos como canais de atendimento o e-mail e o WhatsApp. Clientes Enterprise contam com um representante dedicado para apoiar no esclarecimento de dúvidas e na resolução de problemas.

A Partnr oferece SLA de atendimento e disponibilidade?

As condições de SLA variam de acordo com o contrato firmado. Quando aplicável, os níveis de disponibilidade, atendimento e suporte são definidos na proposta comercial. A Partnr opera com nível de disponibilidade de 99%.

Fontes, qualidade e segurança

Quais são as fontes dos dados disponibilizados pela Partnr?

A Partnr utiliza apenas fontes primárias e oficiais do mercado financeiro e da economia, como B3, Comissão de Valores Mobiliários (CVM), Banco Central do Brasil (BACEN) e IBGE. As fontes variam conforme o tipo de dado.

A Partnr é a fonte original dos dados financeiros?

Não. A Partnr funciona como uma camada de infraestrutura entre as fontes originais e as aplicações dos clientes. Os dados são coletados nas instituições responsáveis, processados, padronizados e disponibilizados em formatos adequados para integração por API REST ou MCP.

Qual é a diferença entre os dados brutos das fontes oficiais e os dados entregues pela Partnr?

As fontes oficiais frequentemente disponibilizam informações em arquivos, documentos, tabelas e estruturas diferentes entre si. A Partnr realiza o trabalho de coleta, armazenamento, padronização e organização desses dados, transformando-os em respostas estruturadas e consistentes. Dessa forma, o cliente não precisa construir e manter internamente toda a infraestrutura necessária para processar cada fonte.

Como a Partnr garante a qualidade dos dados?

A Partnr aplica rotinas manuais e automatizadas de validação durante a coleta e o processamento das informações. Isso inclui verificações de formato, consistência, duplicidade, integridade e compatibilidade entre períodos.

Com que frequência os dados são atualizados?

A frequência de atualização varia de acordo com a natureza de cada informação. Cotações, notícias, demonstrações financeiras, carteiras de fundos e indicadores macroeconômicos possuem ciclos de publicação diferentes. A informação referente à atualização você encontra nos FAQs individuais dos produtos em suas respectivas páginas: Dados Fundamentalistas, API de cotações da B3, API de FIIs, API de ETFs, Notícias e Macroeconomia.

Como a Partnr trata correções ou revisões feitas pelas fontes oficiais?

Quando uma fonte oficial corrige, substitui ou republica uma informação, a Partnr processa a nova versão e atualiza sua base de acordo com o ciclo de ingestão de cada produto. Esse processo reduz o risco de aplicações permanecerem utilizando dados antigos depois de uma revisão da fonte original.

Os dados da Partnr possuem rastreabilidade até a fonte original?

Sim. A infraestrutura da Partnr é estruturada para preservar a origem e o contexto das informações processadas. Todas as requests contam com referências diretas aos dados na fonte oficial e, no caso de indicadores fundamentalistas, as fórmulas utilizadas no cálculo estão disponíveis para conferência.

Como a Partnr trata dados ausentes ou inconsistentes?

A Partnr não cria informações para preencher valores que não foram publicados ou que não puderam ser validados. Dados ausentes podem ser retornados como indisponíveis ou nulos, de acordo com a estrutura de cada API. Quando existem inconsistências relevantes na fonte, elas são tratadas conforme as regras do respectivo conjunto de dados.