clueless-community/fintech-api

An API that helps you to deal with your financial calculations

FinTech API v2

Welcome to FinTech API, our powerful API is designed to simplify your life by offering a wide range of financial calculations at your fingertips. From simple interest and compound interest to return on investment (ROI) and more, FinTech APIzap provides the tools you need to handle a variety of financial tasks effortlessly such as annual percentage rate (APR), FHA loans, debt-to-income ratio and income related calculations. Whether you're building a web app, mobile application, or even a chrome extension, integrating our API is a breeze. You can focus on the core aspects of your project while leaving the financial calculations to us.

✨ Features

• Modular structure: Not the API has a clean structure which benifits in improved code organizationqn and enhanced reusability of components

• Request validation: It improves security, prevents errors and vulnerabilities to the API

• API Docs: API documentation provides clear and comprehensive guidance to developers, simplifies integration and usage, promotes rapid adoption

• Authentication: And finally the API has authentication enabled, for endpoints with much latency calculation, we can provide authentication which will enhance security.

• User-Friendly Integration: Seamlessly integrate the FinTech APIzap into your web app, mobile application, or chrome extension with our user-friendly API.

• Fast and Reliable: Enjoy a fast and reliable API service, ensuring quick response times and minimal downtime.

• Scalability: Scale your projects effortlessly as FinTech APIzap supports high volumes of requests and can handle increased traffic.

• Customizable Options: Tailor the API's parameters and settings to suit your specific requirements and calculations.

• Developer Community: Join our thriving developer community for support, updates, and collaboration with like-minded professionals.

💻 Tech Stack

✨ How to use it?

To use FinTech API in your project, follow these steps:

• Sign up and obtain API credentials
• Install necessary dependencies - Python3.9x installed on your machine. - Install the package using pip: (by Copying requirements.txt ./)

  pip install --no-cache-dir -r requirements.txt

• Make API requests
• Handle API responses
• Test and debug
• Integrate into your project

✨ Contributing Roadmap

• Go through the CONTRIBUTING.md file, where all the guidelines have been mentioned that will guide you to make your contribution.
• Do checkout the project workflow section.

Join our growing community of developers who have already discovered the power of FinTech APIzap and contribute to the project's ambition to empower users with the ability to handle financial tasks efficiently.

✨ Open Source Participation

This project is a part of these Open Source Programs

• Diversion 2K23
• GSSoC 2K23

✨ Thank You for Your Contribution!

Thanks a lot for spending your time helping fintech-api grow. Thanks a lot! Keep rocking 🍻

🙏 Thank you for your interest in contributing to our project! We appreciate any contributions, whether it's bug fixes, new features, or documentation improvements.

🌟 We value the time and effort you put into contributing, and we look forward to reviewing and merging your contributions. Say goodbye to the hassle of manual calculations and hello to seamless financial integration.

✨ Once again, thank you for your contribution!

✨ License

The project is licensed under the MIT License.

---

fintech-api's Issues

Add an endpoint to calculate Duration With Convexity Adjustment

Note

• Duration is the average time until all cash flows from a bond are delivered. The convexity adjustment helps determine the change in price that is not explained by duration.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /convexity_adjustment in the main.py file with properly.

Create an endpoint to find Monthly EMI Calculation

What bug or feature you wants to report.

No response

Add Calculate Inventory Shrinkage Endpoint

Inventory shrinkage formula can be used if you want to figure out the percentage of inventory your business is losing.

Unmatched ' ) ' in functions.py

Extra ' ) ' in line 95 in functions.py

Add an endpoint to calculate Variance of a Two Asset Portfolio

Note

• Measures the fluctuation of the returns of a portfolio with two assets.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /asset_portfolio in the main.py file with properly.

Add an endpoint to calculate Jensen's Alpha

Note

• One way of measuring alpha, or the risk-adjusted return.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /jensens_alpha in the main.py file with properly.

Add an endpoint to calculate Put-Call Parity

Note

• Refers to the static price relationship between the prices of put and call options of an asset with the same strike price and expiration date.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /put-call-parity in the main.py file with properly.

Add an endpoint to calculate markup percentage

If you need help setting your products’ prices, you can try using the markup formula. The markup percentage shows you how much more you sell offerings for than what they cost.

Add an endpoint to calculate Price/Earning to ratio

Note

Price/Earning ratio is the ratio between share price and the earing per share (EPS) .

Create a function in ./helpers/functions.py file for the calculation.
Map it with an endpoint GET /per in the main.py file with properly.

Endpoint to calculate Current liability coverage ratio

Add an end point to calculate DTI

Debt-to-income ratio (DTI) is all your monthly debt payments divided by your gross monthly income
Different company has different DTIs as their minimum limit
A person has to have a greater DTI than that limit in order to get a new loan

ROI function is returning fraction istead of percentage

This should be 20% instead of 0.2%

Also, here 120 should be the current value of the investment, not only gain

different function used to calculate dividend_payout_ratio

Add an endpoint to calculate Compound Interest.

Note

• The cost of using borrowed money, or more specifically, the compensation a lender receives for lending money to a borrower, is known as compound interest.

• Compound interest is calculated as
  

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /compound_interest in the main.py file with properly.

Endpoint to calculate and return Certificate of Deposit (CD)

Note

• A certificate of deposit is an agreement to make a fixed-term interest-bearing deposit of money.
• Formula to calculate Certificate of Deposit

• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /certificate_of_deposit in the main.py file with properly.

Add an endpoint to calculate Effective Annual Rate

Note

• Generally, an investment's annual rate of return is different from the nominal rate of return when compounding occurs more than once a year (quarterly, half-yearly).

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /effective_annual_rate in the main.py file properly.

Add endpoint to calculate discounted OPEX

Add an endpoint to calculate Weighted Average Cost of Capital (WACC)

Note

• The firm's overall cost of capital considering all of the components of the capital structure.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /wacc in the main.py file with properly.

Undefined variables in helpers/function.py and main.py files

Add an endpoint to calculate Free Cash Flow to Firm (FCFF)

Note

• FCFF represents the cash that is available with in the firm owners to pay off their investors.
• A +ve FCFF value indicates that the firm has cash remaining after expenses. A -ve value indicates that the firm has not generated enough revenue to cover its costs and investment activities.

Formulae

Where,
EBIT - Earnings Before Interest and Taxes
EBITDA - Earnings Before Interest, Taxes, Depreciation and Amortization
Dep - Depreciation
FcInv - Investment in fixed capital
WcInv - Working capital investment

• Add an endpoint to calculate Free Cash Flow to Firm.
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /bep in the main.py file with properly.

add calculate cost of equity

What bug or feature you wants to report.

Add an endpoint to calculate Rule of 72

Note

• The Rule of 72 helps you to estimate the number of years required to double your money at a given annual rate of return.
  
• Add an endpoint to calculate Rule of 72.
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /ruleof72 in the main.py file with properly.

Add an endpoint to calculate Inflation Adjusted Return

• Add an endpoint to calculate Inflation Adjusted Return.
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /inflation-adjusted-return in the main.py file with properly.

Create an endpoint to find Double Time Calculation

What bug or feature you wants to report.

Create an endpoint to find Double Time Calculation

Add an endpoint to calculate dividend yield ratio

Note

The Dividend Yield is a financial ratio that measures the annual value of dividends received relative to the market value per share of a security.

Create a function in ./helpers/functions.py file for the calculation.
Map it with an endpoint GET /dividend_yeild_ratio in the main.py file with properly.

Create an endpoint to find Weighted Average of a set of values

What bug or feature you wants to report.

Create an endpoint to find Weighted Average of a set of values

Create an endpoint to calculate Purchasing Power

What bug or feature you wants to report.

Create an endpoint to calculate Purchasing Power of an entity.

bug in doubling time function

no returning statement

Create an endpoint to calculate ROI (Return on Investment)

Note

• Return on Investment, sometimes referred to as ROI, is a popular term for assessing the expected profitability of various investments.

• Create a function in ./helpers/functions.py file.
• Map it with an endpoint GET /roi in the main.py file properly.

Add endpoint for calculate monthly payment

Add an endpoint to calculate Acid-Test Ratio

Note

• The acid-test ratio, commonly known as the quick ratio, uses a firm's balance sheet data as an indicator of whether it has sufficient short-term assets to cover its short-term liabilities.

• Add an endpoint to calculate Free Cash Flow to Firm.
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /acid-test-ratio in the main.py file with properly.

Add an endpoint to calculate Loan EMI

Note

• Equated monthly instalments (EMIs) are common in our day-to-day life. At the time of taking a loan, we are shown a neat A4 size paper explaining the EMI structure in a simplified manner. It is generally an unequal combination of principal and interest payments.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /loan_emi in the main.py file with properly.

Create issues and pull request template.

Note

• Create an issue and pull request template for this project.
• In the issue template, the user is to answer which endpoint he/she wants to add or which endpoint they found a bug.
• In the PR template, ask them to link the corresponding issue, and ask questions like have you tested the output and if it is correct or not, and upload some screenshots if needed.

Add an endpoint to calculate Inflation.

Note

• Inflation lowers purchasing power of the rupee. As a result, whenever a saving plan is being chalked out, inflation is one of the factors that has to be taken into account.

• Inflation is calculated as - Future amount = Present amount * (1+inflation rate) ^number of years

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /inflation in the main.py file with properly.

Add an endpoint to calculate Sharpe ratio

Sharpe ratio measures the performance of an investment compared to a risk-free asset, after adjusting for its risk.
formula
Sharpe Ratio = (Average fund returns – Risk-free Rate) / Standard Deviation of fund returns

Add an endpoint to calculate Cost of Goods Sold

Note

• Add an endpoint to calculate Free Cash Flow to Firm.
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /cogs in the main.py file with properly.

Add an endpoint to calculate Break Even Point

Note

• Break even point is the point where a company's revenue equals it's costs.
  
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /bep in the main.py file with properly.

Add an endpoint to calculate Compounded Annual Growth Rate (CAGR)

Note
Formula: CAGR=((FV/PV)^(1/n)) - 1

• Where
  FV is the investment's ending/maturity value
  PV is the investment's beginning/opening value
  n is the duration in years
• Add an endpoint to calculate Compounded Annual Growth Rate (CAGR).
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /cagr in the main.py file with properly.

Add calculate dividend payout ratio

Note

The Dividend Payout Ratio (DPR) is the amount of dividends paid to shareholders in relation to the total amount of net income the company generates.

Create a function in ./helpers/functions.py file for the calculation.
Map it with an endpoint GET /dividend_payout_ratio in the main.py file with properly.

Add an endpoint to calculate Payback Period.

Note

• Payback period, which is used most often in capital budgeting, is the period of time required to reach the break-even point (the point at which positive cash flows and negative cash flows equal each other, resulting in zero) of an investment based on cash flow.

• Payback period is calculated as
  

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /payback_period in the main.py file with properly.

Add a endpoint for fixed charge coverage ratio

Errors in main.py

The parenthesis don't match and the try-except blocks have not been completed in main.py for future_sip and compound_interest.

The errors can be found after these lines:

fintech-api/main.py

Line 73 in a43e18f

"Future Value": f"{value}%",

fintech-api/main.py

Line 105 in a43e18f

"Amount after intrest":f"{amount}",

Add an endpoint to calculate Future Value of SIP

Note

• We all save small amounts at fixed intervals for a goal. It may be in a mutual fund SIP or PPF. But, how can we know the possible savings ten years down the line? That is where the future value of the SIP formula comes into the picture.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /future_sip in the main.py file with properly.

add an endpoint to calculate Capital Asset Pricing Model (CAPM)

What bug or feature you wants to report.

It helps to explain the relationship between excess market risk and expected return

extra % symbol in future sip calculation returning value

future sip function returns the exact value, not percentage

Add an endpoint to calculate Compounded Annual Growth Rate (CAGR)

Note

• This is used to indicate the return on an investment over a period. It is also the best tool to compare returns of two different asset classes - for instance gold/equity or equity/real estate.

• Create a function in ./helpers/functions.py file for the calculation.

• Map it with an endpoint GET /cagr in the main.py file with properly.

Add an endpoint to calculate Simple Interest.

• Simple interest is interest that is only calculated on the initial sum (the "principal") borrowed or deposited.
• The basic simple interest formula looks like this
• Create a function in ./helpers/functions.py file for the calculation.
• Map it with an endpoint GET /simple_interest in the main.py file properly.

Add an endpoint to calculate Inflation rate

Add endpoint for calculate Levered Beta .

Often referred to as the “equity beta”, levered beta is the beta of a firm inclusive of the effects of the capital structure.

Wrong inflation future value formula

formula wtitten is FV=PV*(1+rate)^n

correct formula is FV=PV*(1+rate/100)^n