Indicadores de preço

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

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.

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"
      }
    ]
  }
}