Stock Average Calculator API

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

Return the average cost per share (dollar cost averaging) across several buys, the total shares, total invested, break-even price, and, when a current price is given, the position value and unrealized profit or loss in money and percent.

Needs an API key. Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

Open the tool Try it

Request body

application/json

transactions

array required

Buys as { shares, price }. 1-500 items; both values must be > 0.
current_price

number optional

Current market price per share. Optional.

Example arguments

Verified

{
  "transactions": [
    {
      "shares": 10,
      "price": 100
    },
    {
      "shares": 15,
      "price": 85
    }
  ],
  "current_price": 90
}

curl -X POST https://api.findutils.com/api/tools/stock-average-calculator/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transactions": [
      {
        "shares": 10,
        "price": 100
      },
      {
        "shares": 15,
        "price": 85
      }
    ],
    "current_price": 90
  }'

const response = await fetch('https://api.findutils.com/api/tools/stock-average-calculator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
  body: JSON.stringify({"transactions":[{"shares":10,"price":100},{"shares":15,"price":85}],"current_price":90}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/stock-average-calculator/execute",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"transactions":[{"shares":10,"price":100},{"shares":15,"price":85}],"current_price":90},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/stock-average-calculator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => '{"transactions":[{"shares":10,"price":100},{"shares":15,"price":85}],"current_price":90}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call stock_average_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: API key
REST id: stock-average-calculator
MCP name: stock_average_calculator
Category: Calculators
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Calculators tools

More to explore