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_unitsao 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_unitscom 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 |
latest_by_reference_date | Query | true ou false. Com true, ignora as quantidades que o fundo corrigiu depois (current = false). Padrão: false. | Opcional |
Boas práticas
- Use
start_dateeend_datepara 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 mesmareference_datepode ter mais de uma linha quando o fundo reapresentou o informe; uselatest_by_reference_date=trueou filtre porcurrentpara ficar com uma só.
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) | 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_date | string (ISO 8601) | Data a que a quantidade se refere (fim do mês do informe, ou o pregão). |
publish_date | string (ISO 8601) | Data e hora em que o fundo entregou o informe. |
total_units | integer | Número total de cotas emitidas do fundo. |
version | integer | Número da entrega do informe para a mesma reference_date: 1 na primeira, 2 na primeira reapresentação, e assim por diante. |
current | boolean | true 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
}
]