Indicadores fundamentalistas

GET

/companies/[companyIdentifier]/ratios

Retorna os indicadores financeiros mais recentes (ratios) da empresa.

Apenas indicadores fundamentalistas

Este endpoint não inclui indicadores de preço/valuation, como P/L. Para isso, use Indicadores de preço.

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 dos indicadores (ver abaixo).	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. Formato: ISO 8601	Opcional
retrieval_date	Query	Filtra por retrieval_date maior que o valor informado. Formato: 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 disponíveis para a empresa na(s) frequência(s) solicitada(s).
Isso pode gerar um payload muito grande, impactando tempo de resposta, transferência e renderização (principalmente em apps e dashboards).
Para uso em produção, prefira sempre informar ids com os indicadores necessários.

Indicadores disponíveis

Frequência

• QUARTERLY: último trimestre
• ANNUAL: último ano
• TTM: últimos 12 meses
• YTD: ano corrente até a data

Se você usar ticker

Alguns indicadores são específicos por tipo de ação (ex.: ON/PN). Quando você consulta usando um ticker, o retorno é filtrado para o tipo correspondente e os IDs podem vir sem sufixo de tipo.

Ex.: DIVIDEND_YIELD_CS pode retornar como DIVIDEND_YIELD.

Resposta

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

informação

Valores null podem ocorrer por divisão por zero ou ausência de dados no relatório fonte.

Formato da resposta

A resposta é um objeto onde:

• cada chave de primeiro nível é o id do indicador (ex.: EBITDA_MARGIN)
• 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 e SCORE).
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.: EBITDA, NET_REVENUE).
value	number | null	Valor numérico da variável no ponto de cálculo.

Exemplo

{
  "EBITDA_MARGIN": {
    "ANNUAL": [
      {
        "value": 0.41610010818431675,
        "format": "PERCENTAGE",
        "reference_date": "2024-12-31T00:00:00.000Z",
        "publish_date": "2025-02-27T01:16:00.000Z",
        "retrieval_date": "2025-03-20T14:18:03.604Z",
        "calculation": "EBITDA / NET_REVENUE",
        "variables": [
          { "id": "EBITDA", "value": 204234000000 },
          { "id": "NET_REVENUE", "value": 490829000000 }
        ]
      }
    ],
    "QUARTERLY": [
      {
        "value": 0.5161915781902334,
        "format": "PERCENTAGE",
        "reference_date": "2025-09-30T00:00:00.000Z",
        "publish_date": "2025-11-06T23:18:00.000Z",
        "retrieval_date": "2025-11-07T14:07:45.742Z",
        "calculation": "EBITDA / NET_REVENUE",
        "variables": [
          { "id": "EBITDA", "value": 66024000000 },
          { "id": "NET_REVENUE", "value": 127906000000 }
        ]
      }
    ],
    "TTM": [
      {
        "value": 0.4275383256756592,
        "format": "PERCENTAGE",
        "reference_date": "2025-09-30T00:00:00.000Z",
        "publish_date": "2025-11-06T23:18:00.000Z",
        "retrieval_date": "2025-11-07T14:07:45.742Z",
        "calculation": "EBITDA / NET_REVENUE",
        "variables": [
          { "id": "EBITDA", "value": 210112000000 },
          { "id": "NET_REVENUE", "value": 491446000000 }
        ]
      }
    ],
    "YTD": [
      {
        "value": 0.4847938019007072,
        "format": "PERCENTAGE",
        "reference_date": "2025-09-30T00:00:00.000Z",
        "publish_date": "2025-11-06T23:18:00.000Z",
        "retrieval_date": "2025-11-07T14:07:45.742Z",
        "calculation": "EBITDA / NET_REVENUE",
        "variables": [
          { "id": "EBITDA", "value": 179460000000 },
          { "id": "NET_REVENUE", "value": 370178000000 }
        ]
      }
    ]
  }
}