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 } ]}A API de ETFs da Partnr cobre mais de 220 ETFs listados na B3, de renda variável, renda fixa e cripto.
ETFs de ações, nacionais e internacionais, e 2 ETFs de índice imobiliário
64 nacionais e 5 internacionais
ETFs de criptoativos
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.
Composição da carteira
Histórico de cotação
| Mês | Fechamento (R$) |
|---|---|
| Jan | 178,20 |
| Fev | 185,16 |
| Mar | 184,28 |
| Abr | 184,09 |
| Mai | 170,75 |
| Jun | 169,05 |
| Jul | 175,02 |
| Ago | 174,78 |
| Set | 181,05 |
Consulte o histórico de cotação do ETF junto com os dados de identificação do fundo.
A API de ETFs entrega a composição da carteira com o peso de cada ativo, dados cadastrais, cotistas e proventos dos mais de 220 ETFs listados na B3. O histórico de cotação vem da API de cotações da B3.
GET/traded-funds/{ticker}/portfolioAtivos da carteira com peso, quantidade e valor de mercado de cada posição, a partir da CDA mensal do fundo, com link para o documento original.
Documentação(abre a documentação em nova aba)GET/traded-funds/{ticker}Ticker, nome, tipo, classificação, gestora e administradora, com valor de mercado e valor patrimonial opcionais.
Documentação(abre a documentação em nova aba)GET/traded-funds?type=ETFOs ETFs listados na B3, filtrados pelo tipo: ETF para renda variável, ETF-RF para renda fixa e ETF-CRIPTO para criptomoedas.
Documentação(abre a documentação em nova aba)GET/traded-funds/{ticker}/cash-corporate-actionsRendimentos distribuídos, com data-com e data de pagamento, nos ETFs que distribuem.
Documentação(abre a documentação em nova aba)GET/traded-funds/{ticker}/unitholdersNúmero de cotistas ao longo do tempo, a partir do informe diário do fundo.
Documentação(abre a documentação em nova aba)GET/quotes/{ticker}Abertura, fechamento, máxima, mínima e volume de cada ETF, pela API de cotações.
Documentação(abre a documentação em nova aba)A carteira dos ETFs é atualizada mensalmente, a partir da CDA que cada fundo publica no FNET.
A CDA (Composição e Diversificação das Aplicações) informa a carteira do ETF no fechamento do mês.
reference_dateO ETF publica a CDA no FNET, o sistema de documentos de fundos da B3.
publish_dateA Partnr coleta o documento, padroniza os campos e disponibiliza a carteira na API.
retrieval_dateDuas 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_dateA 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.
curl -G "https://data.partnr.ai/v2/traded-funds/BOVA11/portfolio" \
-H "Authorization: Bearer SEU_TOKEN" \
-d reference_date=2026-09-30import 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())[
{
"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"
}
]
}
]Fluxo estruturado desde a extração até a disponibilização dos dados, garantindo consistência e confiabilidade.
Coleta automatizada diretamente da B3 e fontes oficiais
Padronização técnica e validações estruturais
Compliance e checagem de integridade dos dados
API REST (JSON) de alta disponibilidade
Infraestrutura projetada para reduzir o esforço de implementação e garantir estabilidade em ambientes de produção.
Endpoints consistentes com respostas estruturadas e padronizadas
Referência detalhada com exemplos de requisição e resposta
Acompanhamento técnico durante a implementação
Infraestrutura preparada para uso contínuo em produção
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.
Responda o formulário ao lado e receba um escopo personalizado para o seu caso de uso.
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.
Expanda para outras camadas de dados financeiros brasileiros — tudo no mesmo provedor, mesma integração, mesma qualidade.
Cotações, histórico desde 1984, dados ajustados e snapshots do mercado à vista da B3.
Balanços, indicadores e métricas financeiras para análise fundamentalista de empresas listadas na B3.
Dados estruturados de FIIs, FI-Infra, Fiagros e FIDCs — carteiras, proventos e indicadores.
Séries históricas do Banco Central, IBGE e Tesouro — Selic, IPCA, câmbio e mais.