Financial Planning API

Tired of financial guesswork?

😤 "Someday" isn't a plan

You know you want to buy a house, but when will you actually have enough saved? Next year? In three years? Your spreadsheet is a mess and you're just hoping for the best.

📊 Budget apps show the past

Mint and YNAB are great for tracking where your money went. But they don't tell you when you'll reach your goals. You need to know the future, not just the past.

🤯 Life is complicated

Your income changes. Loans get paid off. You get bonuses. Kids need braces. Simple calculators can't handle real life scenarios.

Input your real situation

Handle complex financial scenarios that simple calculators can't manage:

Regular income: $5,200 salary + $800 freelance work

Changing expenses: $2,100 rent + $400 car payment (ends Dec 2026)

Irregular events: $3,000 tax refund in April + $500 quarterly insurance

Current savings: $8,500 to start with

Get detailed month-by-month predictions

See exactly when you'll hit your goals and how your finances evolve:

Jan 2025:$11,700

+$3,200 saved

Apr 2025:$23,400

← Tax refund boost

Dec 2026:$48,900

← Car payment ends

Jun 2027:$65,300

← House down payment ready!

Open source financial planning API

🚀

Production ready prototype

Core features working, tested, and documented

⚖️

MIT License

Free to use, modify, and distribute

🤝

Looking for contributors

Help build the future of financial planning tools

Who uses financial predictions?

🏠 Home Buyers

"When will I have enough for a down payment?"

Instead of guessing, get exact dates. Factor in your salary, current savings, monthly expenses, and even irregular bonuses to see your real timeline.

💼 Career Changers

"Can I afford to take that lower-paying job I love?"

Model your new salary against current expenses. See how much longer it takes to reach goals, or if you need to adjust your lifestyle first.

🎓 Students with Loans

"When will I finally be debt-free?"

Track multiple loan payments with different end dates. Watch your cash flow improve as each debt disappears and plan for life after loans.

🚀 Entrepreneurs

"How long can my savings last while building this business?"

Model irregular income and varying expenses. See if you can survive the first year, or if you need more runway before quitting your day job.

👨‍👩‍👧‍👦 Growing Families

"How will childcare costs affect our house-buying plans?"

Add new expenses like daycare and see the real impact on your timeline. Plan for when expenses end (kids start school) and cash flow improves.

💰 Emergency Planners

"When will I have 6 months of expenses saved?"

Set a concrete savings goal and see exactly when you'll reach it. Account for irregular income and unexpected expenses along the way.

Prototype, but solid foundation

REST API with OpenAPI documentation
Handles complex scenarios (loans, irregular income)
Input validation and error handling
Docker support
Test coverage for core functionality
Ready for integration and experimentation

Try the API Help improve it

POST /api/v1/predictions

{
  "predictionMonths": 24,
  "initialBudget": 8500,
  "incomes": [
    {
      "name": "Salary",
      "value": 5200,
      "frequency": "Monthly"
    }
  ],
  "expenses": [
    {
      "name": "Rent",
      "value": 2100,
      "frequency": "Monthly"
    }
  ]
}

Try it now

Get Predictor running locally in under 2 minutes. Requires .NET 8 or Docker.

With .NET 8

$git clone https://github.com/Marcin99b/Predictor.git

$cd Predictor/src && dotnet run --project Predictor.Web

With Docker

$docker run -p 8080:8080 predictor:latest

Then visit: localhost:7176/swagger for interactive API docs

What you get

REST API with comprehensive documentation
Interactive Swagger interface
Example data to test with immediately
Support for complex financial scenarios
JSON responses with detailed breakdowns

Read the Docs View on GitHub