Partnr API

Bem-vindo à documentação da Partnr API — API de dados financeiros do mercado brasileiro com foco em qualidade de dados, rastreabilidade e consistência de séries para aplicações institucionais.

Por que a Partnr?

• Integração em minutos — Quickstart com primeira chamada (cURL), SDKs oficiais e padrões previsíveis de autenticação, datas e erros para colocar em produção rápido.
• Rastreabilidade de dados — Respostas com metadados operacionais (ex.: data de atualização e identificador da requisição) para auditoria, reprodução de resultados e suporte mais ágil.
• Cobertura unificada — Empresas, fundos listados, cotações, notícias e macro em uma única API, com convenções consistentes entre endpoints (parâmetros, filtros e formatos).
• Metodologia científica — Pipeline orientado a validação: checagens de consistência, testes automatizados e monitoramento contínuo para reduzir divergências e garantir repetibilidade. Metodologia para cálculo de indicadores e ajustes documentada e construída por analistas de mercado e economistas, baseada no estado da arte da literatura financeira.
• Qualidade dos dados — Foco em consistência histórica, padronização de identificadores e tratamento de eventos que distorcem séries.

Visão Geral

A Partnr API oferece acesso a:

• Empresas — Dados fundamentalistas e indicadores, demonstrativos financeiros, proventos e transações internas/insider transactions
• Fundos Listados — FIIs, ETFs, FI-Infras, Fiagros e outros fundos listados em bolsa, com composição da carteira/ETF holdings, proventos, número de cotistas e indicadores como Dividend Yield e vacância
• Cotações — Históricas e variações com atualização diária ao fim do pregão
• Notícias do Mercado — Feed de notícias financeiras processadas em tempo real, com deduplicação, tags, ativos relacionados e análise de impacto e relevância
• Dados Macroeconômicos — Indicadores econômicos do Brasil e do mundo, com séries temporais, frequência, unidade e fonte rastreável
• Índices — Rankings de maiores altas e baixas por índice com cotações em D+0 (15 minutos de atraso)
• Screener — Filtros avançados para seleção de ativos (incluindo módulo de criptomoedas em breve)

Fontes dos Dados

Todos os dados distribuídos pela API são provenientes de fontes primárias de informação, com ênfase em reguladores de mercados. As fontes de dados incluem:

• CVM — Comissão de Valores Mobiliários, a reguladora do mercado de capitais brasileiro
• B3 — A Bolsa de Valores do Brasil
• BACEN — O Banco Central do Brasil, autoridade monetária brasileira e regulador do sistema financeiro e dos bancos
• IPEA — Instituto de Pesquisa Econômica Aplicada, fundação pública federal e bureau de pesquisa econômica
• IBGE — Instituto Brasileiro de Geografia e Estatística, principal provedor de dados estatísticos, responsável pelo cálculo do PIB e do IPCA

Base URL

Todas as requisições devem ser feitas para:

https://data.partnr.ai/v2/

Formato

• Protocolo: REST sobre HTTPS
• Formato de resposta: JSON
• Autenticação: Bearer token via header Authorization

Essenciais

Antes de integrar, aqui estão os padrões que você vai encontrar em toda a Partnr API:

• Versionamento — A API é versionada por URL (/v2). Mudanças incompatíveis são lançadas em uma nova versão.

• Autenticação — Bearer token no header Authorization em todas as requisições.
  Ver autenticação →

• Erros padronizados — Respostas de erro retornam JSON com error.code e error.message, usando códigos HTTP convencionais.
  Ver erros →

• Request-Id — Toda resposta inclui um identificador em Request-Id para depuração e suporte.
  Ver Request-Id →

• Datas e timezone — Datas seguem YYYY-MM-DD e, quando aplicável, timestamps em ISO 8601.
  Ver padrões →

Comece agora

Como começar?

Tudo que você precisa para começar: autenticação, padrões, erros e sua primeira chamada.

Ver guia completo →

SDKs

Bibliotecas oficiais para Python e JavaScript/TypeScript.

Ver SDKs →

MCP

Integre a Partnr API com agentes de IA via Model Context Protocol.

Ver MCP →

Endpoints

Empresas

Dados cadastrais, fundamentalistas e indicadores, demonstrativos financeiros, proventos e transações internas/insider transactions de Ações e BDRs Patrocinados.

Ver endpoints →

Fundos Listados

Dados cadastrais, composição da carteira/ETF holdings, proventos, número de cotistas e indicadores como Dividend Yield e vacância de ETFs, FIIs, Fiagros e FI-Infras.

Ver endpoints →

Cotações

Cotações históricas e variações com atualização diária ao fim do pregão.

Ver endpoints →

Índices

Rankings de maiores altas e maiores baixas por índice, com base em cotações com 15 minutos de atraso.

Ver endpoints →

Notícias

Feed de notícias financeiras processadas em tempo real, com deduplicação, tags, ativos relacionados e análise de impacto e relevância.

Ver endpoints →

Macroeconomia

Indicadores econômicos do Brasil e do mundo, com séries temporais, frequência, unidade e fonte rastreável.

Ver endpoints →

Screener

Filtros avançados para seleção e ranking de ativos, com documentação de Criptomoedas centralizada nesta seção.

Ver endpoints →

Widgets

Widgets embarcáveis para seu site ou app. Em breve.

Saiba mais →

Suporte

Suporte com business partner dedicado, por email e WhatsApp, SLA varia por contrato.

Ainda não é cliente? Fale com um especialista.