BRbrapi-dev
Ações

Comparar receitas por atividade

Changed on

Todos os emissores com receita em uma atividade e nas atividades filhas, com o crescimento por exercício. A receita de vários segmentos do mesmo emissor é somada.

Para concessões, o crescimento não usa a receita de construção (basis = exConstruction) quando ela é conhecida em todos os segmentos. Nos demais casos, flags traz includes-construction.

Os valores ficam na moeda de cada emissor. Compare o crescimento, não os valores. Receitas que já aparecem em uma controlada listada ficam de fora.

Bancos e seguradoras não entram: suas receitas não se comparam. Pedir essas atividades retorna erro 400.

Planos Startup e Pro. FIIs, Fiagros e fundos só no plano Pro. PETR4, MGLU3, VALE3 e ITUB4 permitem testes gratuitos, sem token.

get/api/v2/revenue-sources/compare

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/revenue-sources/compare
  • Auth
    HTTP bearer

Query parameters

activitystring required

Código da atividade. Inclui as atividades filhas. Veja os códigos em /api/v2/revenue-sources/activities.

Example:energy.electricity.distribution
startYearinteger

Primeiro exercício social. Padrão: o mais antigo disponível.

Example:2024
endYearinteger

Último exercício social. Padrão: o mais recente disponível.

Example:2025

Response

Emissores do maior para o menor crescimento.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "activity": {
    "code": "energy.electricity.distribution",
    "label": "Distribuição de energia elétrica",
    "cnae": "35.14-0",
    "parent": "energy.electricity"
  },
  "issuers": [
    {
      "issuerCode": "ENGI",
      "name": "ENERGISA S.A.",
      "currency": "BRL",
      "latestYear": 2025,
      "latestValue": 31365577000,
      "latestGrowth": 0.0916,
      "years": [
        {
          "fiscalYear": 2025,
          "value": 31365577000,
          "valueExConstruction": 26358745000,
          "priorValue": 24146022000,
          "growth": 0.0916,
          "flags": [],
          "segments": [
            "Distribuição de energia elétrica"
          ],
          "source": {
            "form": "dfp",
            "documentId": "1486415",
            "page": 117
          }
        }
      ]
    }
  ],
  "requestedAt": "2025-01-24T17:32:38.000Z",
  "took": 45
}

Changes