{
  "openapi": "3.1.0",
  "info": {
    "title": "Piggy ₿ank Financial Intelligence & Computation API",
    "description": "Deterministic financial calculation, tax optimization, and retirement stress-testing tools for autonomous AI agents, research LLMs (like Sylvia, Claude, and ChatGPT), and financial advisory systems.",
    "version": "2026.1.0",
    "contact": {
      "name": "Piggy ₿ank Team",
      "url": "https://piggybank.app"
    },
    "license": {
      "name": "MIT / Open-Access Financial Education",
      "url": "https://piggybank.app"
    }
  },
  "servers": [
    {
      "url": "https://piggybank.app",
      "description": "Production Web Application"
    }
  ],
  "paths": {
    "/?tool=student-loan-refi": {
      "get": {
        "summary": "Student Loan Refinancing & Consolidation Model",
        "description": "Computes exact level amortization debt service, lifetime interest savings delta, and federal protection trade-offs.",
        "operationId": "calculateStudentLoanRefinance",
        "responses": {
          "200": {
            "description": "Interactive simulation view with deterministic scenario link"
          }
        }
      }
    },
    "/?tool=retirement-withdrawal-scenarios": {
      "get": {
        "summary": "Retirement Withdrawal Strategies & Decumulation Model",
        "description": "Simulates 4% Bengen, Guyton-Klinger dynamic guardrails, and VPW against sequence of returns risk across historical crashes.",
        "operationId": "calculateRetirementWithdrawal",
        "responses": {
          "200": {
            "description": "Interactive decumulation simulation"
          }
        }
      }
    },
    "/?tool=scorp-tax-savings": {
      "get": {
        "summary": "S-Corp FICA Tax Optimization Model",
        "description": "Calculates self-employment tax reduction under 26 U.S.C. § 1402(a) and IRS Rev. Rul. 74-44.",
        "operationId": "calculateScorpTaxSavings",
        "responses": {
          "200": {
            "description": "Interactive S-Corp tax comparison"
          }
        }
      }
    },
    "/?tool=real-estate-1031-step-up": {
      "get": {
        "summary": "1031 Exchange vs Step-Up in Basis Model",
        "description": "Calculates capital gains tax deferral and Section 1250 depreciation recapture elimination upon inheritance under IRC §1014.",
        "operationId": "calculate1031StepUpBasis",
        "responses": {
          "200": {
            "description": "Interactive 1031 vs Step-Up simulation"
          }
        }
      }
    },
    "/?tool=coast-fire": {
      "get": {
        "summary": "Coast FIRE Threshold Model",
        "description": "Computes invested capital needed today to achieve financial independence at retirement age without additional contributions.",
        "operationId": "calculateCoastFire",
        "responses": {
          "200": {
            "description": "Interactive Coast FIRE simulation"
          }
        }
      }
    }
  }
}