Indicadores de preço de empresas

GET

/companies/[companyIdentifier]/ratios/valuation

Retorna os indicadores de valuation mais recentes da empresa (ex.: múltiplos de preço), com suporte a filtros por frequência, datas e seleção de indicadores.

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
[companyIdentifier]	URL	Identificador da empresa.	Obrigatório
ids	Query	Lista de IDs separada por vírgula.	Opcional
frequency	Query	Frequência (QUARTERLY/ANNUAL/TTM/YTD).	Opcional
reference_date	Query	Data de referência. Formato: YYYY-MM-DD	Opcional
publish_date	Query	Filtra por publish_date maior que o valor informado (ISO 8601).	Opcional
retrieval_date	Query	Filtra por retrieval_date maior que o valor informado (ISO 8601).	Opcional
show_calculation	Query	Inclui fórmula e variáveis do cálculo (true/false).	Opcional
latest_by_reference_date	Query	Mantém apenas o último indicador publicado (por frequência) para cada reference_date (true/false).	Opcional

Sobre o parâmetro ids (recomendado)

Se ids não for informado, o endpoint pode retornar todos os indicadores de valuation disponíveis para a empresa na(s) frequência(s) solicitada(s).
Isso pode gerar um payload muito grande. Para uso em produção, prefira informar ids com os indicadores necessários.
Para reduzir ainda mais o retorno, use latest_by_reference_date=true, que mantém apenas a publicação mais recente de cada reference_date.

Indicadores disponíveis

Como funciona por classe de ação (ticker vs symbol/company_id)

Indicadores de valuation dependem de preço (ex.: P/L, EV/EBITDA). Por isso, o identificador usado muda como o retorno é entregue:

• Se você consultar usando ticker (ex.: PETR3), o endpoint retorna os indicadores de preço apenas daquela classe de ação.
  Nesse caso, os IDs normalmente vêm sem sufixo (ex.: PRICE_TO_EARNINGS).

• Se você consultar usando symbol (ex.: PETR) ou company_id, o endpoint pode retornar indicadores de preço para cada classe de ação disponível (ON/PN e variações).
  Para diferenciar, os IDs podem vir com um sufixo que identifica a classe.

Sufixos de classe

• _CS — ações ordinárias (common shares / ON)
• _PS — ações preferenciais (preferred shares / PN)
• _PSB — preferenciais tipo B
• _PSC — preferenciais tipo C
• _PSD — preferenciais tipo D
• _PSD — preferenciais tipo E
• _UNIT — units

Sufixo _UNIT (tratamento específico)

Quando o indicador vem com o sufixo _UNIT, o cálculo considera o fator de composição da unit (ex.: quantidade de ON/PN dentro da unit), para que o indicador de preço (valuation) fique condizente com a estrutura do ativo negociado como unit.

Regra prática

• Quer indicador de valuation de um papel específico (ex.: PETR3) → use ticker.
• Quer indicador de valuation por classe (ON/PN/UNIT e variações) no mesmo payload → use symbol ou company_id.

Se você usar ticker

Indicadores específicos por tipo de ação são filtrados para o tipo do ticker e podem vir sem sufixo.

Resposta

Código	Descrição
200	Retorna os indicadores de valuation.
404	Empresa não encontrada.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.

Formato da resposta

A resposta é um objeto onde:

• cada chave de primeiro nível é o id do indicador de valuation (ex.: PRICE_TO_EARNINGS)
• cada chave interna é a frequência (ex.: ANNUAL, QUARTERLY, TTM, YTD)
• o valor de cada frequência é uma lista de pontos com os campos abaixo

Campo	Tipo	Descrição
value	number | null	Valor do indicador para o ponto retornado. Pode vir null quando não há base de cálculo válida.
format	string	Formato de exibição/interpretação do valor (ex.: PERCENTAGE, MULTIPLE, BRL).
reference_date	string (ISO 8601)	Data de referência do período contábil/financeiro do indicador.
publish_date	string (ISO 8601)	Data/hora de publicação do dado fonte pela companhia.
retrieval_date	string (ISO 8601)	Data/hora em que o dado foi coletado/processado pela Partnr.
calculation	string	Fórmula utilizada no cálculo do indicador (quando show_calculation=true).
variables	array	Variáveis usadas na fórmula, quando show_calculation=true.

Estrutura de variables[]

Campo	Tipo	Descrição
id	string	Identificador da variável usada no cálculo (ex.: MARKET_CAP, NET_INCOME).
value	number | null	Valor numérico da variável no ponto de cálculo.

Exemplo

{
  "PRICE_TO_EARNINGS": {
    "TTM": [
      {
        "value": 6.167553617649955,
        "format": "MULTIPLE",
        "reference_date": "2025-09-30T00:00:00.000Z",
        "publish_date": "2026-02-09T22:00:00.000Z",
        "retrieval_date": "2026-02-10T07:21:07.787Z"
      },
      {
        "value": 6.056828512509937,
        "format": "MULTIPLE",
        "reference_date": "2025-09-30T00:00:00.000Z",
        "publish_date": "2026-02-06T22:00:00.000Z",
        "retrieval_date": "2026-02-07T06:45:52.083Z"
      }
    ]
  }
}