Tool 18

Stock market calculators · Price change and aggregate cash dividends

Stock Return Calculator

Created by Arunangshu DasReviewed Nov 6, 2026

Calculate gross holding-period return from price change and total cash dividends. See the monetary components and their contributions on one common purchase basis.

One unchanged holding, one major currency and dividends held as cash. Before fees and tax; no reinvestment, annualisation, corporate-action processing or personalized investment advice.

Preparing calculator…

One unchanged long-only holding

Gross price change plus cash dividends held without reinvestment or interest. No fees, tax, interim funding, corporate-action processing or annualisation.

Display market and currency

Formatting only. GBP means pounds, not GBX/pence. Values are never converted.

Unchanged shares held

Positive quantity, including fractional shares, held throughout the assessment interval.

Initial price per share (USD)

Positive major-currency price; no dividend total-return adjustment.

Ending price per share (USD)

Current valuation or sale price; zero allowed. Same share units, no dividend total-return adjustment.

Total cash dividends for this holding (USD)

Aggregate gross cash for ALL entered shares over the ENTIRE interval, before withholding. Not per share or annual yield; enter 0 explicitly if none.

I confirm unchanged share units and one major currency, aggregate dividends held as cash, and prices without dividend total-return adjustments.

Gross holding-period return

Enter all four values and confirm the basis, or load the verified worked example.

Inputs stay in browser memory. Up to 12 fractional places; quantity and initial price 0.000000000001–1000000000000, other amounts 0–1000000000000. Isolated 120-digit decimal arithmetic; half-even display rounding. Small nonzero amounts remain visible. Educational use, not personalized investment advice.

Understand price return and cash income

Learn which dividend amount to enter, why adjusted prices can double-count income, and why gross holding-period return differs from trade profit, dividend yield and an annualised rate.

Read the complete Stock Return guide

Formula and methodology

C = q×b; V = q×e; P = q×(e−b).
G = P+D; W = V+D; total return = 100G/C.
Contributions: price = 100P/C; cash income = 100D/C.

C=q×b; V=q×e; P=q×(e−b); G=P+D; W=V+D. Price contribution=100P/C; cash-income contribution=100D/C; total holding-period return=100G/C. All percentages use the same positive denominator C. Compute P directly from the price difference, then add cash dividends once. Do not multiply D by q again. Price and income contributions reconcile before rounding. Dividends remain cash with no interest or reinvestment, and there is no annualisation or dated-flow adjustment.

Verified worked examples

Hold 10 shares initially priced at 50, ending at 55, and receive 20 total cash dividends. Initial consideration is 500, ending shares are worth 550, price gain is 50 and gross gain including income is 70. Price contribution is 10%, cash-income contribution is 4%, and total return is 14%. Ending shares plus cash total 570. If the ending price is 49 instead, price gain is −10, income offsets that loss, and gross gain is 10: a 2% total return despite a −2% price contribution.

Inputs and interpretation

Choose the display market and keep all amounts in that same actual currency. Enter the unchanged quantity and initial/ending per-share prices in consistent units. Sum gross cash dividends for the whole holding and interval, before withholding, and enter that total once; enter 0 explicitly when none. Confirm no dividend-adjusted price double counting or reinvestment. Calculate and inspect initial consideration, ending value, price gain, cash income and the common-denominator contributions. Reconcile against statements rather than assuming every account display uses this convention.

Assumptions and limitations

One unchanged long-only holding, one security, consistent share units and one major currency throughout the assessment interval. Prices must not already incorporate a dividend total-return adjustment when cash dividends are added. No automatic split or corporate-action adjustment occurs. No annual rate basis, compounding, recurring deposit, beginning/end contribution timing, date convention or leap-year accrual applies; the interval is not converted into years. Confirmation is your assertion, not verification of account records.

Supported domain and common mistakes

Trimmed ungrouped numeric strings have at most 48 characters and 12 fractional places. Quantity and initial price are 1e-12 through 1e12; ending price and aggregate dividends are 0 through 1e12. Monetary outputs have absolute bounds of 2e24 and percentage outputs 2e38; unsupported results reject without clipping. Isolated 120-digit half-even arithmetic is checked against independent exact rational ledgers at absolute plus relative 1e-100 tolerances on deterministic vectors, not a uniform all-input certification. Currency rounds to two places with tiny nonzero markers, rates to six places with tiny scientific notation, and extra gain detail to eight significant figures. Rounded contributions can differ from the rounded total by a rounding unit.

Do not enter 2 when you mean a dividend yield of 2%, and do not enter a per-share dividend in a box labeled total cash dividends. Do not mix a dividend-adjusted historical price with separately added dividends. A tax credit or franking credit is not cash received for this model. A net deposit after withholding is not automatically gross income. Do not infer tax gross-ups, add reinvested shares without revising the entire model, or treat a current quote as guaranteed sale proceeds.

Frequently asked questions

How does this stock return calculator include dividends?

It adds aggregate cash dividends once to the price gain for your unchanged share quantity, then divides by the initial purchase consideration. The result is a gross holding-period return before fees and taxes.

Are dividends entered per share or for the whole holding?

Enter total gross cash dividends for ALL entered shares over the ENTIRE interval, before withholding. They are not multiplied by share quantity again. Enter 0 explicitly if there were none.

Can dividends offset a falling share price?

Yes. Ten shares bought at 50 and valued at 49 lose 10 in price, but 20 total cash dividends give a gross gain of 10 on initial consideration 500: a 2% total return.

Does this calculate dividend reinvestment or an annual return?

No. Dividends are held as cash without interest, and no holding duration is entered. The result is neither annualised nor a DRIP simulation or money-weighted dated-flow return.

Can I use a current price rather than a sale price?

Yes, as a user-supplied ending valuation in consistent units. The price component then includes unrealised change. It is not necessarily realised profit, executable proceeds or a tax-reportable gain.

Why must I avoid dividend-adjusted total-return prices?

Those prices may already incorporate dividends. Adding cash dividends again would count the same income twice. Use a reconciled price basis with consistent share units; the calculator cannot inspect or repair price-provider adjustments.

Does country selection calculate tax or currency conversion?

No. USA, UK, Canada, Australia and India selections change formatting only. GBP means pounds, not GBX/pence. Fees, taxes, withholding gross-ups and tax credits are not inferred.

Sources and educational scope

Educational gross-return calculator, not personalized investment advice, tax reporting, a forecast or an execution recommendation. No fees, withholding/tax calculations, tax credits, DRIP, interest on cash, interim investments/withdrawals, shorts, leverage, FX, live prices or corporate-action processing. Use an appropriate separate model and qualified guidance when those features matter.

Reviewed 2026-11-06. AI-assisted content under operator editorial responsibility; no independent expert financial review is claimed.