--- title: "Fontes de receita" method: GET path: "/api/v2/revenue-sources" tags: ["Ações"] --- # Fontes de receita `GET /api/v2/revenue-sources` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/revenue-sources` - Auth: HTTP bearer Receita por segmento de empresas da B3, BDRs, FIIs e Fiagros, por exercício social, a partir das demonstrações anuais. Cada segmento tem uma atividade padrão, para comparar empresas. `segments` traz os segmentos como a empresa publica, com o crescimento sobre o ano anterior e o link do documento. `activities` soma os segmentos por atividade, com a parte de cada uma na soma dos segmentos. Para ETFs e outros fundos, `lookThrough` mostra a exposição às atividades pela carteira mais recente: o peso de cada ação, BDR ou FII na carteira vezes a parte de cada atividade na receita da empresa. Concessões de energia, saneamento, gás e rodovias registram o investimento na rede como receita de construção. Use `growthExConstruction` para comparar o crescimento sem ela. Planos Startup e Pro. FIIs, Fiagros e fundos só no plano Pro. PETR4, MGLU3, VALE3 e ITUB4 permitem testes gratuitos, sem token. ## Query parameters - `symbols` string: Tickers separados por vírgula: ações, BDRs, FIIs, Fiagros ou ETFs. Máximo de 20. PETR3 e PETR4 retornam a mesma empresa. - `cnpjs` string: CNPJs de fundos separados por vírgula, com ou sem pontuação. Use para fundos sem ticker. - `startYear` integer: Primeiro exercício social. Padrão: o mais antigo disponível. - `endYear` integer: Último exercício social. Padrão: o mais recente disponível. ## Response `200` Um resultado por ticker ou CNPJ, na ordem pedida. - RevenueSourcesResponse - `results` RevenueSourcesResult[], required - `requestedSymbol` string, required - `symbol` string, required: Ticker atual, ou o CNPJ quando o fundo não tem ticker. - `changed` boolean, required: true quando o ticker pedido mudou de nome. - `type` 'company' | 'bdr' | 'fii' | 'fiagro' | 'fund', nullable, required: `company` (empresa da B3), `bdr`, `fii`, `fiagro` ou `fund` (ETF ou outro fundo, com a exposição pela carteira). null quando não há dados. - `issuerCode` string, nullable, required: Código do emissor na B3. - `cnpj` string, nullable, required: CNPJ do fundo. null para empresas. - `name` string, nullable, required - `years` RevenueYear[], required: Exercícios do mais recente para o mais antigo. Vazio para fundos. - `fiscalYear` integer, required: Exercício social. Empresas com exercício fora do ano civil usam o ano em que o exercício termina. - `periodEnd` string, required - `currency` string, required - `segmentsTotal` number, required: Soma dos segmentos. Pode passar da receita total quando os segmentos vendem entre si. - `status` 'ok' | 'no-segments' | 'review', required: `ok`: segmentos lidos. `no-segments`: a empresa não divulga segmentos, e a lista traz a receita total. `review`: há segmentos com alerta de leitura. - `totalCheck` object, nullable, required: Conferência dos segmentos com a receita total. - `total` number, nullable, required: Receita total publicada. - `sum` number, required: Soma dos segmentos lidos, com as eliminações entre segmentos. - `diff` number, nullable, required: Diferença entre `sum` e `total`. - `verified` boolean, required: true quando a soma confere com a receita total. - `segments` RevenueSegment[], required: Segmentos do maior para o menor. - `member` string, required: Nome do segmento como a empresa publica. - `axis` string, required: Tipo de divisão: `business` (segmento de negócio), `product` (linha de produto ou serviço), `whole` (empresa sem segmentos: receita líquida total) ou `fii-income` (receitas de FIIs e Fiagros). - `activity` string, required: Código da atividade do segmento. - `activityLabel` string, required - `scope` 'exact' | 'mixed', required: `exact` quando o segmento tem só esta atividade. `mixed` quando ele junta atividades e esta é a principal. - `currency` string, required - `value` number, required: Receita do exercício, na moeda `currency`. - `priorValue` number, nullable, required: Receita do exercício anterior. - `priorFrom` 'same-filing' | 'previous-filing', nullable, required: `same-filing` quando o valor anterior vem do mesmo documento. `previous-filing` quando vem do documento do ano anterior. - `growth` number, nullable, required: Crescimento sobre o ano anterior, em fração (0.06 = 6%). - `valueExConstruction` number, nullable, required: Receita sem a receita de construção de concessões, quando a atividade tem essa receita. - `priorExConstruction` number, nullable, required: Receita do ano anterior sem a receita de construção. - `growthExConstruction` number, nullable, required: Crescimento sem a receita de construção, em fração (0.06 = 6%). - `flags` string[], required: Alertas sobre o valor. `unchecked`: a soma dos segmentos não confere com a receita total. `relabeled`: uma conferência moveu o valor para outro segmento. `reviewed`: uma pessoa conferiu o segmento. `label-disputed`: duas leituras deram nomes diferentes ao segmento. `duplicate`: a mesma receita aparece em uma controlada listada. `includes-construction`: o valor inclui receita de construção. - `source` RevenueSourceLink, required - `form` string, required: Documento de origem: `dfp` (demonstrações anuais na CVM), `10-K`, `20-F` ou `40-F` (relatório anual na SEC) ou `fii-quarterly` (informes trimestrais de FIIs na CVM). - `documentId` string, required: Protocolo ou número do documento na origem. - `url` string, nullable, required: Link do documento. - `page` integer, nullable, required: Página do valor no documento, quando conhecida. - `priorPage` integer, nullable, required: Página do valor do ano anterior, quando conhecida. - `activities` RevenueActivityShare[], required: Soma por atividade, da maior para a menor. - `activity` string, required - `activityLabel` string, required - `value` number, required: Soma dos segmentos desta atividade. - `share` number, required: Parte da soma de todos os segmentos, em fração (0.06 = 6%). - `growth` number, nullable, required: Crescimento da atividade, em fração. null quando falta o valor anterior de algum segmento. - `segments` integer, required: Número de segmentos somados. - `lookThrough` RevenueLookThrough, nullable, required: Só para fundos: exposição da carteira às atividades das empresas, FIIs e BDRs que o fundo tem. - `referenceDate` string, required: Data da carteira usada. - `portfolioValue` number, required: Valor das posições da carteira, em reais. - `coveredValue` number, required: Valor das posições com fontes de receita, em reais. - `coverage` number, required: Parte da carteira com fontes de receita, em fração (0.06 = 6%). A soma de `weight` das atividades é igual a `coverage`. - `activities` object[], required: Atividades da maior para a menor. - `activity` string, required - `activityLabel` string, required - `weight` number, required: Exposição da carteira à atividade, em fração (0.06 = 6%). - `holdings` RevenueLookThroughHolding[], required: Até 5 posições que mais pesam na atividade. - `symbol` string, required - `issuerCode` string, required - `fiscalYear` integer, required: Exercício das receitas usadas para esta posição. - `portfolioWeight` number, required: Peso da posição na carteira, em fração (0.06 = 6%). - `weight` number, required: Peso da atividade que vem desta posição, em fração da carteira. - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `404`: Nenhum dado encontrado para o pedido. - `429`: Limite de requisições excedido. - `500`: Erro interno do servidor. - `503`: Serviço temporariamente indisponível. Tente de novo em alguns minutos. ## Changes - **2026-11-02** `7c732d79148a`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/revenue-sources/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)