Pular para o conteúdo principal
Cole no ChatGPT/Claude e peça para resumir/gerar SDK.

Histórico de cotas emitidas

GET
/traded-funds/[fundIdentifier]/units-history

Retorna uma série temporal com o número total de cotas emitidas de um fundo listado específico (FII, Fiagro, FIDC, ETF etc.). Os resultados são ordenados da data mais recente para a mais antiga. Uma mesma reference_date pode ter mais de uma linha, uma para cada entrega do informe que mudou a quantidade de cotas.

Quando usar​

  • Construir gráficos e séries de total_units ao longo do tempo
  • Acompanhar emissões e a entrada de novas cotas na base do fundo
  • Validar séries de valor patrimonial por cota (patrimônio líquido ÷ número de cotas)
  • Calcular market cap histórico combinando total_units com preços de fechamento

Parâmetros de requisição​

ParâmetroLocalDescriçãoObrigatório
[fundIdentifier]URLIdentificador do fundo: ticker (ex.: HGLG11), symbol (ex.: HGLG) ou company_id numérico.Obrigatório
start_dateQueryISO 8601. Filtra a partir desta data (inclusiva).Opcional
end_dateQueryISO 8601. Filtra até esta data (inclusiva).Opcional
latest_by_reference_dateQuerytrue ou false. Com true, ignora as quantidades que o fundo corrigiu depois (current = false). Padrão: false.Opcional
Boas práticas
  • Use start_date e end_date para reduzir payload quando você só precisa de um recorte (ex.: últimos 12 meses).
  • A série pode não conter um ponto para todos os dias; para reconstruir uma série diária contínua, propague o último valor conhecido (forward fill) entre os datapoints.
  • Para cruzar com outras séries (preço, patrimônio líquido), alinhe pelo campo date. Uma mesma reference_date pode ter mais de uma linha quando o fundo reapresentou o informe; use latest_by_reference_date=true ou filtre por current para ficar com uma só.

Resposta​

CódigoDescrição
200Retorna o histórico de número de cotas.
400Parâmetros ausentes ou inválidos.
401Não autorizado.
404Fundo não encontrado ou nenhum histórico de cotas encontrado.

Formato da resposta​

A resposta é uma lista de objetos com os campos abaixo:

CampoTipoDescrição
datestring (ISO 8601)Momento em que o mercado passou a conhecer a quantidade: a publicação do informe, ou a data ex de um desdobramento ou grupamento. Para ETF, o dia do pregão.
reference_datestring (ISO 8601)Data a que a quantidade se refere (fim do mês do informe, ou o pregão).
publish_datestring (ISO 8601)Data e hora em que o fundo entregou o informe.
total_unitsintegerNúmero total de cotas emitidas do fundo.
versionintegerNúmero da entrega do informe para a mesma reference_date: 1 na primeira, 2 na primeira reapresentação, e assim por diante.
currentbooleantrue quando a linha é a versão em vigor para a sua reference_date; false quando o fundo a corrigiu depois.

Cada reapresentação que muda a quantidade de cotas aparece como uma linha própria, na sua publish_date. Com latest_by_reference_date=true, as quantidades corrigidas depois ficam de fora.

Exemplo​

GET /traded-funds/HGLG11/units-history

[
{
"date": "2026-11-13T19:55:00.000Z",
"reference_date": "2026-10-31T00:00:00.000Z",
"publish_date": "2026-11-13T19:55:00.000Z",
"total_units": 46398492,
"version": 1,
"current": true
},
{
"date": "2026-10-15T18:19:00.000Z",
"reference_date": "2026-09-30T00:00:00.000Z",
"publish_date": "2026-10-15T18:19:00.000Z",
"total_units": 45601713,
"version": 1,
"current": true
}
]