Fintech Status · Production

Fintech Calculator Platform

Financial calculator logic, structured API responses, scenario handling, validation, and maintainable business rules — exposed as an API the rest of the product can trust.

Role
Design · Backend · API
Timeline
~6 weeks
Stack
FastAPI · PostgreSQL · REST
product screenshot — calculator API console · 1600×800
01 · Problem

The math lived in spreadsheets.

Loan and financial scenarios were recalculated by hand for every client. Results drifted between analysts, nothing was auditable, and the logic couldn't be reused anywhere else in the product. Every change risked breaking an opaque chain of cells.

02 · System

One engine, one source of truth, one API.

Swimstream built a calculator engine that holds the business rules in versioned, testable code. Scenarios are first-class objects; inputs are validated server-side; and every result returns through a structured API with predictable result codes and metadata.

POST /api/loans/amortize
"result_code": 200, "result_token": "OK", "data": { "monthly_payment": 1342.05, "total_interest": 83138.00, "schedule_url": "/api/loans/req_f10/schedule" }, "meta": { "schema": "loan.amortize.v2" }
03 · Result

Consistent figures the product can build on.

Numbers stopped drifting. The rule set became auditable and safe to evolve. Other features now call the calculator instead of re-implementing it — the logic exists in exactly one place.

1source of truth for all calculations
v2versioned, schema-stamped responses
100%inputs validated server-side
04 · Stack

What it runs on.

Python FastAPI PostgreSQL REST JSON Schema pytest