ETFs API

    API de ETFs da B3

    API de ETFs com composição de carteira (ETF holdings), ativos subjacentes e pesos por ativo, com dados oficiais da B3 e histórico completo. Integração pronta via REST (JSON) e compatível com IA.

    Ver documentação
    </>
    GET /v2/etfs/{TICKER}/...// Requisiçãocurl -X GET \"https://data.partnr.ai/v2/etfs/{TICKER}/..." \-H "Authorization: Bearer TOKEN"// Resposta{  "data": [    {      "ticker": "PLACEHOLDER",      "type": "...",      "value": 0.00    }  ]}

    Cobertura de ETFs da B3

    A API de ETFs da Partnr cobre mais de 220 ETFs listados na B3, de renda variável, renda fixa e cripto.

    • 131

      Renda variável

      ETFs de ações, nacionais e internacionais, e 2 ETFs de índice imobiliário

    • 69

      Renda fixa

      64 nacionais e 5 internacionais

    • 26

      Cripto

      ETFs de criptoativos

    Solicitar chave de teste

    Composição de carteira de ETFs

    Consulte a composição dos ETFs listados na B3, com os ativos da carteira e o peso de cada um, a partir da CDA mensal.

    • Ativos que compõem o ETF
    • Peso de cada ativo na carteira
    • Quantidade e valor de mercado de cada posição
    • Link para a CDA original
    Ver documentação de composição de carteira
    BOVA11

    Composição da carteira

    Composição
    • VALE39,69%
    • ITUB48,89%
    • PETR45,89%
    • AXIA34,34%
    • Outros71,19%
    Maiores posições na CDA de 30/09/2026. Fonte: API de ETFs da Partnr.
    BOVA11

    Histórico de cotação

    Cotação
    Fechamento mensal do BOVA11 em 2026, em R$
    MêsFechamento (R$)
    Jan178,20
    Fev185,16
    Mar184,28
    Abr184,09
    Mai170,75
    Jun169,05
    Jul175,02
    Ago174,78
    Set181,05
    Fechamento do último pregão de cada mês, jan a set/2026. Fonte: API de cotações da Partnr.
    ETF
    BOVA11
    CNPJ
    10.406.511/0001-61
    Gestora
    BlackRock Brasil
    Administradora
    BNP Paribas

    Histórico de cotação e informações cadastrais

    Consulte o histórico de cotação do ETF junto com os dados de identificação do fundo.

    • Histórico de preços do ETF
    • Série diária de cotação
    • Nome completo do fundo
    • CNPJ
    • Gestora e administradora
    Ver documentação de cotações

    Como a composição dos ETFs é atualizada na API

    A carteira dos ETFs é atualizada mensalmente, a partir da CDA que cada fundo publica no FNET.

    1. Data de referência

      A CDA (Composição e Diversificação das Aplicações) informa a carteira do ETF no fechamento do mês.

      reference_date
      30/09/2026
    2. Publicação no FNET

      O ETF publica a CDA no FNET, o sistema de documentos de fundos da B3.

      publish_date
      05/10/2026
    3. Coleta pela Partnr

      A Partnr coleta o documento, padroniza os campos e disponibiliza a carteira na API.

      retrieval_date
      06/10/2026
    4. Comparação entre meses

      Duas datas de referência mostram o que mudou. Entre 31/08 e 30/09/2026, RECV3 e SLCE3 foram zeradas no BOVA11 e o peso da VALE3 passou de 10,98% para 9,69%.

      reference_date
      31/08/2026 e 30/09/2026

    Exemplo: composição do BOVA11

    A composição do BOVA11 sai em uma chamada, com os ativos da carteira e a data de referência da CDA, o documento mensal de composição de carteira que o fundo publica.

    RequisiçãocURL
    curl -G "https://data.partnr.ai/v2/traded-funds/BOVA11/portfolio" \
      -H "Authorization: Bearer SEU_TOKEN" \
      -d reference_date=2026-09-30
    RequisiçãoPython
    import requests
    
    response = requests.get(
        "https://data.partnr.ai/v2/traded-funds/BOVA11/portfolio",
        headers={"Authorization": "Bearer SEU_TOKEN"},
        params={"reference_date": "2026-09-30"},
    )
    print(response.json())
    RespostaJSON (trecho)
    [
      {
        "report_type": "CDA",
        "reference_date": "2026-09-30T00:00:00.000Z",
        "publish_date": "2026-10-05T00:00:00.000Z",
        "net_asset_value": 15134227599.02,
        "holdings": [
          { "asset_code": "VALE3" },
          { "asset_code": "ITUB4" },
          { "asset_code": "PETR4" },
          ...
        ],
        "sources": [
          {
            "name": "Composição da Carteira (CDA)",
            "published_at": "2026-10-05T00:00:00.000Z"
          }
        ]
      }
    ]

    Profundidade que supera APIs convencionais

    Fluxo estruturado desde a extração até a disponibilização dos dados, garantindo consistência e confiabilidade.

    01

    Captura

    Coleta automatizada diretamente da B3 e fontes oficiais

    02

    Tratamento

    Padronização técnica e validações estruturais

    03

    Validação

    Compliance e checagem de integridade dos dados

    04

    Distribuição

    API REST (JSON) de alta disponibilidade

    Integração simplificada

    Infraestrutura projetada para reduzir o esforço de implementação e garantir estabilidade em ambientes de produção.

    API REST (JSON)

    Endpoints consistentes com respostas estruturadas e padronizadas

    Documentação técnica completa

    Referência detalhada com exemplos de requisição e resposta

    Suporte dedicado na integração

    Acompanhamento técnico durante a implementação

    SLA de alta disponibilidade

    Infraestrutura preparada para uso contínuo em produção

    Compatível com aplicações de Inteligência Artificial

    O servidor MCP da Partnr permite que modelos e agentes de IA acessem os dados de ETFs como tools estruturadas, eliminando camadas intermediárias de integração.

    Próximo passo

    Agende uma demonstração!

    Responda o formulário ao lado e receba um escopo personalizado para o seu caso de uso.

    Retorno em até 24h
    Trial gratuito para validação
    Proposta alinhada ao escopo
    Apoio técnico na implementação
    Perguntas frequentes

    Perguntas Frequentes sobre a API de ETFs

    A API de ETFs da Partnr disponibiliza dados estruturados sobre fundos de índice listados na B3. A solução reúne informações cadastrais, composição da carteira, ativos subjacentes, pesos por posição, índice de referência e histórico de cotação, permitindo integrar dados de ETFs a plataformas financeiras, dashboards, comparadores, carteiras e sistemas de análise.

    A API cobre ETFs de renda variável e ETFs de renda fixa listados na B3, conforme a disponibilidade no catálogo da Partnr. Os fundos podem ser consultados por ticker e outros identificadores disponíveis, permitindo construir listas de ETFs da B3, páginas individuais, mecanismos de busca e filtros por características do fundo.

    A API de ETFs entrega a composição da carteira com o peso de cada ativo, dados cadastrais, número de cotistas e proventos dos ETFs listados na B3. A lista completa está na seção Dados de ETFs disponíveis na API.

    Sim. A API permite consultar as holdings dos ETFs, identificando os ativos subjacentes e a participação relativa de cada posição na carteira. Os dados incluem a data de referência da composição e podem ser utilizados para analisar concentração, diversificação e exposição a empresas, setores ou classes de ativos.

    Sim. Dependendo da disponibilidade nas fontes oficiais, a API apresenta informações como nome do fundo, ticker, ISIN, gestora, classificação e índice de referência, como o Ibovespa ou outros benchmarks acompanhados pelo ETF.

    Sim. As composições possuem datas de referência e publicação, permitindo comparar diferentes versões da carteira e identificar entradas, saídas ou alterações no peso dos ativos.

    Sim. A solução disponibiliza histórico de cotação dos ETFs listados na B3. Esses dados podem ser combinados com a composição da carteira para construir gráficos, calcular retornos, comparar fundos e analisar a relação entre o desempenho do ETF e seus ativos subjacentes.

    Para aplicações que precisam de atualização durante o pregão, a API de ETFs também pode ser combinada com a API de cotações da B3 da Partnr, que oferece market data em tempo real, com atraso de 15 minutos ou no modelo D-1, conforme a modalidade contratada.

    Os dados são coletados de fontes oficiais, principalmente da B3 e dos documentos regulatórios publicados pelos próprios fundos. A Partnr processa, padroniza e organiza essas informações para disponibilizá-las por API REST.

    Quando aplicável, os registros incluem datas e referências aos documentos utilizados, facilitando a rastreabilidade e a verificação da origem das informações.

    Ao consumir os dados diretamente da B3 e dos documentos dos fundos, a empresa precisa desenvolver processos próprios de coleta, interpretação, padronização, armazenamento e acompanhamento das novas publicações.

    A Partnr realiza essa camada de infraestrutura e entrega os dados dos ETFs em uma API REST padronizada, com identificadores consistentes, composição consolidada, pesos por ativo, histórico organizado e referências às fontes oficiais. Isso reduz o trabalho necessário para transformar documentos e arquivos em dados prontos para uso no produto.

    A documentação está disponível no portal de desenvolvedores da Partnr — developers.partnr.ai/fundos-listados. Lá estão disponíveis endpoints, autenticação e exemplos de uso. Também é possível acessar a documentação pelo botão "Ver documentação" no início da página.

    Use o endpoint de composição do portfólio, GET /traded-funds/{ticker}/portfolio, informando o ticker do ETF (por exemplo, BOVA11). A resposta traz os ativos da carteira e o peso de cada um. Os detalhes estão na documentação de Composição do portfólio.

    Para solicitar acesso, chave de teste ou uma proposta comercial, preencha o formulário da página com as informações do seu caso de uso. A equipe da Partnr entrará em contato em até 24 horas para entender a necessidade, orientar a integração e indicar o melhor formato de contratação.

    Ecossistema

    Amplie sua cobertura com o ecossistema Partnr

    Expanda para outras camadas de dados financeiros brasileiros — tudo no mesmo provedor, mesma integração, mesma qualidade.

    API de Cotações e Market Data B3

    Cotações, histórico desde 1984, dados ajustados e snapshots do mercado à vista da B3.

    ATIVOS2.100+
    DESDE1984
    DATA POINTS500M+

    API Fundamentalista

    Balanços, indicadores e métricas financeiras para análise fundamentalista de empresas listadas na B3.

    EMPRESAS400+
    DESDE2010
    DATA POINTS94M+

    API de Fundos

    Dados estruturados de FIIs, FI-Infra, Fiagros e FIDCs — carteiras, proventos e indicadores.

    FUNDOS620+
    DESDE2016
    DATA POINTS118M+

    API Macroeconômica

    Séries históricas do Banco Central, IBGE e Tesouro — Selic, IPCA, câmbio e mais.

    SÉRIES500+
    DESDE1960
    DATA POINTS200M+