{
  "name": "Stock Averager API",
  "version": "1.0.0",
  "description": "Stateless investment and options calculations. No authentication, no market data, nothing stored — you supply the numbers, it returns the arithmetic.",
  "documentation": "https://www.stockaverager.com/docs",
  "openapi": "https://www.stockaverager.com/openapi.json",
  "operations": [
    {
      "operationId": "calculateAverageDown",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/average-down",
      "summary": "Shares needed to reach a target average price",
      "tag": "Position",
      "calculator": "https://www.stockaverager.com/tools/stock-averager",
      "exampleRequest": {
        "shares": 100,
        "originalPrice": 80,
        "currentPrice": 50,
        "targetAveragePrice": 65
      }
    },
    {
      "operationId": "calculateCostBasis",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/cost-basis",
      "summary": "Average cost basis across purchase lots",
      "tag": "Position",
      "calculator": "https://www.stockaverager.com/tools/stock-averager/cost-basis-calculator",
      "exampleRequest": {
        "lots": [
          {
            "shares": 100,
            "price": 50,
            "fees": 0
          },
          {
            "shares": 100,
            "price": 50,
            "fees": 0
          }
        ]
      }
    },
    {
      "operationId": "calculateSip",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/sip",
      "summary": "Future value of a monthly investment plan",
      "tag": "Projection",
      "calculator": "https://www.stockaverager.com/tools/sip-calculator",
      "exampleRequest": {
        "monthlyInvestment": 500,
        "expectedAnnualReturn": 12,
        "years": 10
      }
    },
    {
      "operationId": "calculateLumpsum",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/lumpsum",
      "summary": "Future value of a one-time investment",
      "tag": "Projection",
      "calculator": "https://www.stockaverager.com/tools/lumpsum-calculator",
      "exampleRequest": {
        "amount": 10000,
        "expectedAnnualReturn": 9,
        "years": 15
      }
    },
    {
      "operationId": "calculateSwp",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/swp",
      "summary": "How long a corpus survives fixed withdrawals",
      "tag": "Projection",
      "calculator": "https://www.stockaverager.com/tools/swp-calculator",
      "exampleRequest": {
        "initialInvestment": 500000,
        "monthlyWithdrawal": 3000,
        "expectedAnnualReturn": 8
      }
    },
    {
      "operationId": "calculateCagr",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/cagr",
      "summary": "Compound annual growth rate",
      "tag": "Return",
      "calculator": "https://www.stockaverager.com/tools/cagr-calculator",
      "exampleRequest": {
        "initialValue": 12000,
        "finalValue": 31000,
        "years": 7
      }
    },
    {
      "operationId": "calculateBreakEven",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/break-even",
      "summary": "Break-even price including fees",
      "tag": "Position",
      "calculator": "https://www.stockaverager.com/tools/break-even-calculator",
      "exampleRequest": {
        "shares": 100,
        "purchasePrice": 50,
        "buyFees": 10,
        "sellFees": 10
      }
    },
    {
      "operationId": "calculateOptionGreeks",
      "method": "POST",
      "url": "https://www.stockaverager.com/api/v1/options/greeks",
      "summary": "Black-Scholes price and Greeks for one option",
      "tag": "Options",
      "calculator": "https://www.stockaverager.com/tools/options-greeks-calculator",
      "exampleRequest": {
        "spotPrice": 147,
        "strikePrice": 150,
        "daysToExpiry": 30,
        "volatilityPercent": 28,
        "riskFreeRatePercent": 4,
        "optionType": "call"
      }
    }
  ]
}