Histórico de número de ações

GET

/companies/[companyIdentifier]/shares-history

Retorna uma série temporal com alterações no número de ações da empresa (ordinárias, preferenciais e total).

Esse endpoint é útil para análises que dependem de share count ao longo do tempo, como:

• evolução de capital social e base acionária
• impactos de desdobramentos/grupamentos e outras mudanças estruturais
• consistência em cálculos históricos de métricas por ação (quando combinadas com preços e demonstrativos)

Quando usar

• Construir gráficos e séries de total_shares ao longo do tempo
• Auditar mudanças no número de ações antes/depois de eventos corporativos
• Validar insumos para modelos (ex.: market cap histórico, métricas por ação)

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
[companyIdentifier]	URL	Identificador da empresa (symbol, company_id ou ticker).	Obrigatório
start_date	Query	Data inicial. Formato: YYYY-MM-DD	Opcional
end_date	Query	Data final. Formato: YYYY-MM-DD	Opcional

Boas práticas

• Para análises por empresa, prefira symbol (ex.: PETR) ou company_id para evitar ambiguidade entre classes de ações.
• Use start_date e end_date para reduzir payload quando você só precisa de um recorte (ex.: últimos 5 anos).

Resposta

Código	Descrição
200	Retorna o histórico de ações.
400	Parâmetros inválidos.
401	Não autorizado.
404	Empresa não encontrada.

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).
common_shares	integer	Quantidade de ações ordinárias (ON).
preferred_shares	integer	Quantidade de ações preferenciais (PN), quando aplicável.
total_shares	integer	Soma de common_shares + preferred_shares no ponto no tempo.

Granularidade diária

Os dados de número de ações são validados e atualizados diariamente antes do pregão, se não houver mudanças no número de ações (seja preferenciais, ordinárias ou totais), não haverá um novo datapoint na rota.

Exemplo

[
  {
    "date": "2025-01-30T03:00:00.000Z",
    "common_shares": 7442231382,
    "preferred_shares": 5446501379,
    "total_shares": 12888732761
  },
  {
    "date": "2018-01-02T03:00:00.000Z",
    "common_shares": 7442454142,
    "preferred_shares": 5602042788,
    "total_shares": 13044496930
  }
]