Dividend Calculator API

POST https://api.findutils.com/api/tools/dividend-calculator/execute

Return a year-by-year projection of a dividend portfolio: dividends received, DRIP reinvestment, contributions, share count, share price, ending value, plus final yearly and monthly dividend income and yield on cost. All rates are yearly percentages; contributions and reinvested dividends buy shares at the mid-year average price.

Open the tool Try it

Request body

application/json

initial_investment

number required

Starting amount invested.
share_price

number required

Current share price. Must be > 0.
dividend_yield

number required

Starting dividend yield in percent (4 = 4%).
dividend_growth

number optional

Yearly dividend growth in percent. Default: 0.
share_price_growth

number optional

Yearly share price growth in percent. Default: 0.
monthly_contribution

number optional

Amount added every month. Default: 0.
years

integer required

Projection length in years.
reinvest_dividends

boolean optional

Reinvest dividends (DRIP). Default: true.

Example arguments

Verified

{
  "initial_investment": 10000,
  "share_price": 50,
  "dividend_yield": 4,
  "dividend_growth": 5,
  "share_price_growth": 7,
  "monthly_contribution": 500,
  "years": 20
}

curl -X POST https://api.findutils.com/api/tools/dividend-calculator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "initial_investment": 10000,
    "share_price": 50,
    "dividend_yield": 4,
    "dividend_growth": 5,
    "share_price_growth": 7,
    "monthly_contribution": 500,
    "years": 20
  }'

const response = await fetch('https://api.findutils.com/api/tools/dividend-calculator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"initial_investment":10000,"share_price":50,"dividend_yield":4,"dividend_growth":5,"share_price_growth":7,"monthly_contribution":500,"years":20}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/dividend-calculator/execute",
    json={"initial_investment":10000,"share_price":50,"dividend_yield":4,"dividend_growth":5,"share_price_growth":7,"monthly_contribution":500,"years":20},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/dividend-calculator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"initial_investment":10000,"share_price":50,"dividend_yield":4,"dividend_growth":5,"share_price_growth":7,"monthly_contribution":500,"years":20}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call dividend_calculator from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: dividend-calculator
MCP name: dividend_calculator
Category: Finance
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Finance tools

More to explore