v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Ações

DVA v2

Retorna histórico anual ou trimestral de demonstração de valor adicionado. Use period=quarterly para dados trimestrais; startDate/endDate filtram por endDate.

get/api/v2/stocks/value-added

Query parameters

symbolsstring required

Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.

Example:PETR4,VALE3

period'annual' | 'quarterly'

Período dos dados históricos.

Example:annual

startDatestring

Data inicial em YYYY-MM-DD. Filtra linhas por date/endDate.

Example:2024-01-01

endDatestring

Data final em YYYY-MM-DD. Filtra linhas por date/endDate.

Example:2024-12-31

Response

Dados fundamentalistas recuperados com sucesso.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "results": [
    {
      "requestedSymbol": "PETR4",
      "symbol": "PETR4",
      "changed": false,
      "data": [
        {
          "type": "yearly",
          "endDate": "2025-12-31",
          "revenue": 749557000000,
          "productSales": 641818000000,
          "otherRevenues": 14692000000,
          "constructionOfOwnAssets": 93487000000,
          "provisionOrReversalOfDoubtfulAccounts": -440000000,
          "suppliesPurchasedFromThirdParties": -292210000000,
          "costsWithProductsSold": -97253000000,
          "thirdPartyMaterialsAndServices": -140304000000,
          "lossOrRecoveryOfAssets": -8347000000,
          "otherSupplies": -46306000000,
          "grossAddedValue": 457347000000,
          "retentions": -84388000000,
          "depreciationAndAmortization": -84388000000,
          "otherRetentions": 0,
          "netAddedValue": 372959000000,
          "netAddedValueProduced": null,
          "addedValueReceivedOnTransfer": 12695000000,
          "addedValueReceivedByTransfer": null,
          "equityIncomeResult": -242000000,
          "financialIncome": 8286000000,
          "otherValuesReceivedOnTransfer": 4651000000,
          "otherValuesReceivedByTransfer": null,
          "addedValueToDistribute": 385654000000,
          "totalAddedValueToDistribute": null,
          "distributionOfAddedValue": 385654000000,
          "teamRemuneration": 46406000000,
          "taxes": 207791000000,
          "federalTaxes": 142628000000,
          "stateTaxes": 64329000000,
          "municipalTaxes": 834000000,
          "remunerationOfThirdPartyCapitals": 20852000000,
          "equityRemuneration": null,
          "ownEquityRemuneration": 110605000000,
          "interestOnOwnEquity": 30682000000,
          "dividends": 10554000000,
          "retainedEarningsOrLoss": 68893000000,
          "nonControllingShareOfRetainedEarnings": 476000000,
          "otherDistributions": 0,
          "financialIntermediationRevenue": null,
          "revenueFromTheProvisionOfServices": null,
          "provisionOrReversalOfExpectedCreditRiskLosses": null,
          "financialIntermediationExpenses": null,
          "materialsEnergyAndOthers": null,
          "services": null,
          "lossOrRecoveryOfAssetValues": null,
          "thirdPartyEquityRemuneration": null,
          "insuranceOperationsRevenue": null,
          "complementaryPensionOperationsRevenue": null,
          "feesRevenue": null,
          "variationsOfTechnicalProvisions": null,
          "insuranceOperationsVariations": null,
          "pensionOperationsVariations": null,
          "otherVariations": null,
          "netOperatingRevenue": null,
          "claimsAndBenefits": null,
          "variationInDeferredSellingExpenses": null,
          "resultsOfCededReinsuranceOperations": null,
          "resultOfCoinsuranceOperationsAssigned": null
        }
      ]
    }
  ],
  "requestedAt": "2026-06-14T05:03:16.000Z",
  "took": 30
}