Weighted average cost of capital (WACC) calculator of listed and unlisted companies based on an input-based API calculation engine. The weighted average cost of capital (WACC) represents a company's blended average cost of capital across all financing sources, including common shares, preferred shares, and debt. The WACC is commonly used in a discounted cash flow (DCF) analysis to find the net present value (NPV) of an investment and reflects the rate at which a company’s future free cash flows (FCFs) is discounted.
Documentation, Examples, FAQ, Terms & Conditions and License: https://www.qumundo.com/docs/weighted-average-cost-of-capital-api.
If you see a feature that is missing or not correctly enforced, please open an issue.
You can find example request and response schema in the JSON file here: example.json
🇩🇪 Crafted in Frankfurt am Main, Germany.
Last changes and the version history can be found in the CHANGELOG.md file.
As this library is SemVer-compatible, any breaking change would be released as a MAJOR version only. Non-breaking changes and features are released as MINOR. Feature updates and bug fixes are released as PATCH (note that feature updates may as well be bundled under a MINOR release, if it comes with new settings or minor changes).
Include wacc
in your package.json
dependencies:
npm install --save @qumundo/wacc
This module may be used to calculate, determine and retrieve weighted average cost of capital (WACC) parameters and metrics. You may self-define the required input parameter to calculate current, historical, future and/or scenario-based parameters and metrics based on your own data and assumptions. Weighted average cost of capital (WACC) parameters and metrics can be calculated in various ways; this module gives you the option to calculate, determine and retrieve weighted average cost of capital (WACC) parameters and metrics through various methods.
Import the module in your code:
const WACC = require("@qumundo/wacc")
let wacc_item =
{
"id": "",
"id_type": "",
"legal_entity": "Company X",
"fiscal_year": 2020,
"date": "2020-12-31",
"currency": "EUR",
"cost_debt": 0.016072,
"weight_debt": 0.007758,
"cost_equity": 0.043090,
"weight_equity": 0.992241
}
let wacc_request = { data: [] };
wacc_request.data.push(wacc_item); // Up to 5 items/calculation per request
let wacc = await WACC.getWACC(wacc_request);
/*
wacc.data[0] ===
{
"success": true,
"message": "",
"id": "",
"id_type": "",
"legal_entity": "Company X",
"fiscal_year": 2020,
"date": "2020-12-31",
"currency": "EUR",
"wacc_debt": 0.000125,
"wacc_equity": 0.042756,
"wacc": 0.04288
},
*/
let wacc_request = await WACC.getExample(true, false); // (request, response)
let wacc_response = await WACC.getExample(false, true); // (request, response)
Various methods and options are available to calculate weighted average cost of capital (WACC) parameters and metrics:
... More details to follow ...
➡️ Example: Consider interest expense, historical debts, tax rate, risk free rate, leveraged beta and risk premiums
... More details to follow ...
let wacc_item =
{
"interest_expense": 135,
"total_debts": [ 15032, 4554, 4012 ],
"tax_rate": 0.140857,
"weight_debt": 0.007758,
"risk_free_rate": -0.00269,
"levered_beta": 0.969907,
"equity_risk_premium": 0.0472,
"other_premium": 0,
"weight_equity": 0.992241
}
➡️ Example: Consider interest expense, historical debts, tax rate, dividend expected, historical dividends, dividend rate and share price
... More details to follow ...
let wacc_item =
{
"interest_expense": 135,
"total_debts": [ 15032, 4554, 4012 ],
"tax_rate": 0.140857,
"weight_debt": 0.007758,
"dividend_expected": 3.24,
"dividends": [ 3.24, 3.24, 3.24 ],
"dividend_rate": 0,
"share_price": 75.25,
"weight_equity": 0.992241
}
➡️ Example: Consider interest expense, historical debts, tax rate, preferred dividend, preferred share price, common dividend expected, common historical dividends, common dividend rate and common share price
... More details to follow ...
let wacc_item =
{
"interest_expense": 135,
"total_debts": [ 15032, 4554, 4012 ],
"tax_rate": 0.140857,
"weight_debt": 0.007758,
"preferred_dividend": 3.24,
"preferred_share_price": 75.25,
"weight_preferred_equity": 0.1,
"common_dividend_expected": 3.24,
"common_dividends": [ 3.24, 3.24, 3.24 ],
"common_dividend_rate": 0,
"common_share_price": 75.25,
"weight_common_equity": 0.892241
}
... More details to follow ...
let wacc_item =
{
"cost_debt": 0.016072,
"total_debt": 7758000,
"cost_equity": 0.043090,
"diluted_shares": 13185927,
"share_price": 75.25
}
... More details to follow ...
let wacc_item =
{
"cost_debt": 0.016072,
"total_debt": 7758000,
"cost_preferred_equity": 0.043090,
"preferred_shares": 132890,
"preferred_share_price": 75.25,
"cost_common_equity": 0.043090,
"common_shares": 13053037,
"common_share_price": 75.25
}
... More details to follow ...
let wacc_item =
{
"cost_debt": 0.016072,
"total_debt": 7758000,
"cost_preferred_equity": 0.043090,
"total_preferred_equity": 10000000,
"cost_common_equity": 0.043090,
"total_common_equity": 982241000
}
Choose between various subscription options for your use case: https://www.qumundo.com/api/weighted-average-cost-of-capital-api.
Once subscribed and enabled, login to our platform and provide authentication along your request.
let credentials = { email: config.YOUR_EMAIL, password: config.YOUR_PASSWORD }; // Keep your login credentials secure and secret
let login = await WACC.getLogin(credentials);
let token = login.token;
let wacc = await WACC.getWACC(value_request, token);
If you need additional features, changes or notice any discrepancies, feel free to submit a Pull Request.
Consider supporting the development by making a donation.