About The Project

Easy Equities is a low-cost investment platform available in South Africa. Many beginner and experienced investors use the platform because of its simple interface and low barrier to begin investing. However, Easy Equities has not made a documented API available to the public to access account data programatically. This Node.js implements a combination of web scraping and calls to the Easy Equities backend to enable developers to access their account data programatically.

With this package, you can implement automated balance checking, portfolio tracking, custom notification, backtesting, etc. Eventually many of these features will form part of the package but currently, the functionality exists for you to create these features on your own.

Built With

• Node.js
• Axios
• Cheerio
• JQuery

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

• Node v18.13.0

Installation

1. Set up an account on Easy Equities and save your username and password.
2. Clone the repo

   git clone https://github.com/Samuel-Sendzul/easy-equities.git

3. Install NPM packages

   npm install --legacy-peer-deps

Usage

Here is an example of how to fetch all investment accounts associated with an Easy Equities account:

var easyequities = require('easyequities')

async function getMyHoldings(username, password) {
  // Login to EasyEquities. This will store the session token returned from EasyEquities in the auth module
  const token = await easyequities.auth.login(username, password)

  // Query holdings by account ID
  const holdings = await easyequities.accounts.holdings()

  console.log(holdings)

}

getMyHoldings("someUsername", "s3cr3tPassword")

Roadmap

• [ ] Make it possible to query accounts by name OR by account ID.
• [ ] Add features to track the historic value of a portfolio. This should be done through wallet snapshots daily.
• [ ] Add a feature to perform a simple backtest on a long-only portfolio strategy.

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.

Contact

Samuel Sendzul - @samuel_sendzul - [email protected]

Project Link: https://github.com/Samuel-Sendzul/easy-equities