Skip to main content

A package to aggregate fixed income products available to Singapore residents to earn yield on singapore dollars

Project description

sgfixedincome_pkg

codecov

A python package to aggregate and analyse data on SGD-denominated retail fixed income products in Singapore.

Are you a non-technical user? Use the app here.

Introduction

This python package contains:

  • scraper.py: A generalized web scraper to extract data on fixed deposit rates from bank websites that display this data in a suitable table format.
  • mas_api_client.py: An API client that interacts with several Monetary Authority of Singapore (MAS) bonds and bills API endpoints. In particular, we provide functions to extract data on Singapore Savings Bonds (SSB) and Treasury bills (T-bills).
  • consolidate.py: Functions to format, merge, and consolidate data obtained from scraping bank websites and from the MAS API.
  • analysis.py: Functions to analyse and visualise extracted fixed income product data.
  • streamlit_app/app.py: code for streamlit web interface

Installation

The package can be installed using:

$ pip install sgfixedincome_pkg

Documentation and Usage

Detailed documentation can be found on Read the Docs.

You can also explore detailed vignettes demonstrating the package's functionality:

  • Main vignette: fetch, analyze, and visualize retail fixed income product data.
  • MAS vignette: how to use the MAS bonds and bills API client and related functions
  • Scraper vignette: how to use functions that scrape bank fixed deposit websites

Or simply explore the streamlit app.

Running the Web Interface

After installation, find the installation location with:

$ pip show sgfixedincome_pkg

Then run:

$ streamlit run "C:\Path\To\site-packages\sgfixedincome_pkg\streamlit_app\app.py"

For example:

$ streamlit run "C:\Users\John\Desktop\Folder\test_env\Lib\site-packages\sgfixedincome_pkg\streamlit_app\app.py"

This will open a browser window with an interactive dashboard.

Note: The web interface requires an active internet connection to fetch current rates and product information.

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License

sgfixedincome_pkg was created by Gideon Tay. It is licensed under the terms of the MIT license.

Contact

Reach out to me on LinkedIn if you have any questions or suggestions.

Credits

sgfixedincome_pkg was created with cookiecutter and the py-pkgs-cookiecutter template.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sgfixedincome_pkg-0.1.9.tar.gz (24.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sgfixedincome_pkg-0.1.9-py3-none-any.whl (27.0 kB view details)

Uploaded Python 3

File details

Details for the file sgfixedincome_pkg-0.1.9.tar.gz.

File metadata

  • Download URL: sgfixedincome_pkg-0.1.9.tar.gz
  • Upload date:
  • Size: 24.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.5 Windows/11

File hashes

Hashes for sgfixedincome_pkg-0.1.9.tar.gz
Algorithm Hash digest
SHA256 295bea69c87505291231fa7c5a98d3cb9ea0e6a43f789b7378a7fe4cc64ccbaf
MD5 cb3b12dfdd4b19b937e2cbe5f0b9b9f4
BLAKE2b-256 0b6851ec0ba9f9751d4ab21b0530a0c198cfbd2c618d9d9ebcbc0f4e46488cd6

See more details on using hashes here.

File details

Details for the file sgfixedincome_pkg-0.1.9-py3-none-any.whl.

File metadata

  • Download URL: sgfixedincome_pkg-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 27.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.12.5 Windows/11

File hashes

Hashes for sgfixedincome_pkg-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 4a15f3db9c9c550ff52f1f279435b62e07846aa2f857006e44d1f229e2f91394
MD5 bdb755982c8d1d18aba86819a5ee990d
BLAKE2b-256 aacd3c9241c6176901c9c998b429448942f9ec8868d75d6c02fb52eef48f48f3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page