Histórico de número de cotas

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 deduplicados por data e ordenados da data mais recente para a mais antiga.

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âmetro	Local	Descrição	Obrigatório
[fundIdentifier]	URL	Identificador do fundo: ticker (ex.: HGLG11), symbol (ex.: HGLG) ou company_id numérico.	Obrigatório
start_date	Query	ISO 8601. Filtra a partir desta data (inclusiva).	Opcional
end_date	Query	ISO 8601. Filtra até esta data (inclusiva).	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 — a lista já vem deduplicada por data.

Resposta

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

Formato da resposta

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

Campo	Tipo	Descrição
date	string (ISO 8601)	Data de referência do snapshot (ponto na série temporal).
total_units	integer	Número total de cotas emitidas do fundo na data.

Exemplo

[
  {
    "date": "2024-06-30T00:00:00.000Z",
    "total_units": 15000000
  },
  {
    "date": "2024-05-31T00:00:00.000Z",
    "total_units": 14500000
  }
]