⚙️ Auto Stock Trader 💵

An awesome repository containing scripts and projects for automating stock orders across multiple brokerages.

<img src="https://github.com/Prem-ium/Auto-StockTrader/blob/main/.github/assets/Auto-StockTrader-Banner.jpeg?raw=true" alt="Auto Stock Trader Banner">

---

⚠️ Public Version Support Notice

Effective immediately, the public version of Auto Stock Trader will no longer receive updates, maintenance, or support.

• This repository is now considered final and “as-is”.
• No further fixes will be made for UI changes, broken selectors, or brokerage updates.
• Compatibility may degrade over time as brokerages update their platforms.

🔒 Ongoing Development

All active development has moved to the private Gold Sponsor version, which includes:

• ✅ Continuous updates to support the latest brokerage UI changes
• ✅ Bug fixes and performance improvements
• ✅ New features and automation enhancements

If you require a maintained, up-to-date version, you must use the Gold Sponsor release.

👉 Become a Gold Sponsor to access the latest version

---

Features 🚀

• Multi-Ticker Support: Trade multiple stock tickers like NVDA, TSLA, AAPL all in one swift test run! 📈
• Multi-Account Login: Effortlessly manage and trade across multiple accounts with seamless login automation 🔑
• Smart Error Handling: Dynamic error checking & handling with XPATHs ensures your trades run smoothly and without hiccups ⚙️
• Account Slicing: Want to focus on specific accounts? Automate starting from a particular account and beyond! 🎯
• Extended Trading Hours: Take advantage of extended hours for supported brokerages and never miss out on prime trading opportunities ⏰
• Limit Order Support: Set precise limit orders with select brokerages to stay in control of your trades! 📊
• 1-Click Updates: Update .side files with new tickers, account variables, and more in a single click using .sh or ' .bat script! 🔄
• JavaScript Helper Scripts: Boost efficiency with easy-to-use JavaScript helper scripts for managing account arrays 💻

---

Supported Brokerages 🏦

This project contains the means of automating buy/sell stock orders within:

• Ally Invest
• Charles Schwab
• Chase's J.P. Morgan Invest
• Fidelity
• Firstrade
• Merrill Edge Lynch
• Sofi Invest
• Vanguard
• Robinhood (Gold Sponsor Only)
• WellsTrade (Gold Sponsor Only)

---

🚀 Unlock Premium Features w/ Gold Sponsorship! 🌟

Gold Sponsors gain exclusive access to advanced, fully optimized features that streamline and automate brokerage management. Here’s a sneak peek at what you’ll receive with Gold Sponsorship:

🌟 Optimized Python & Selenium Scripts

• Completely reworked for maximum efficiency, making them faster and easier to use.
• Unlike public versions, which require more configuration, the Gold version is seamless and user-friendly.

⚡ Up-to-Date & Faster Automation

• Access the latest brokerage automation updates and improvements.
• Bug fixes, optimizations, and faster execution are guaranteed with the private version, unlike the public version, which may not be updated frequently.

💰 Exclusive Tools

• Automated Cash Transfer/Withdrawal Tool to consolidate funds from multiple accounts.
• Exclusive Robinhood and WellsTrade automation support available only to Gold Sponsors.
• Exclusive Features: Automated limit pricing and account retrieval. Brokerages are dynamically consolidated within a single MASTER file containing all automation test suites. Additional command line arguments, environmental variables, etc., are available for enhanced customization.

Ready to upgrade?

Become a Gold Sponsor here and unlock these exclusive benefits!

---

Environmental Variables 🔧

To use this project, you will need to set the following environment variables in your .env file:

Variable	Description	Type
SCHWAB_AI	Total number of Schwab accounts	Integer
MERRILL_AI	Total number of Merrill accounts	Integer
VANGUARD_AI	Total number of Vanguard accounts	Integer
FIDELITY_AI	Fidelity account numbers	Nested List of Strings
CHASE_AI	List of AI values in Trade URL	Nested List of Strings
FIRSTRADE_AI	Firstrade account numbers	List of Strings
ALLY_AI	Ally account numbers.	List of Strings
CUSTOM_DIR	Path to the folder to store updated .side files	String
DYNAMIC	Enable dynamic account length feature (0 = Off, 1 = On)	Integer
SOFI_AI	List of account numbers for Sofi Helper Auto.side	List of Strings

As a reminder, if you are a Gold Sponsor, please refer to the private sponsors repository README instead of this public version. The sponsor version includes more features and customization options tailored specifically for your needs. Need more help?

Login Env Example

If you prefer, you can store your login information in a .env file to automatically open and log in to any brokerage. However, I strongly advise against this practice. Instead, I recommend using the login test to open the login URL and manually log in. Storing credentials in a .side file is discouraged due to security reasons. Multiple account credentials are separated by the : character.

Please note that the login test is a best-try approach. Some brokerages, like Chase, may block automated logins, but you can quickly fill out the user/password information manually if you choose to use this tool.

Variable	Description	Type	Example
CHASE_LOGIN	Chase Account Credentials	String	CHASE_LOGIN="USERNAME:PASSWORD"
FIDELITY_LOGIN	Fidelity Account Credentials	String	FIDELITY_LOGIN="USERNAME:PASSWORD"
FIRSTADE_LOGIN	Firstrade Account Credentials	String	FIRSTADE_LOGIN="USERNAME:PASSWORD"
MERRILL_LOGIN	Merrill Account Credentials	String	MERRILL_LOGIN="USERNAME:PASSWORD"
SCHWAB_LOGIN	Schwab Account Credentials	String	SCHWAB_LOGIN="USERNAME:PASSWORD"
ALLY_LOGIN	Ally Account Credentials	String	ALLY_LOGIN="USERNAME:PASSWORD"
VANGUARD_LOGIN	Vanguard Account Credentials	String	VANGUARD_LOGIN="USERNAME:PASSWORD"

Refer to .env.example for more clarity.

---

Installation ⚙️

Follow these steps to set up and use Selenium IDE for automation:

1. Install Selenium IDE:

Note: Selenium IDE is no longer available in browser extension stores. You must manually install it using the .crx file included in this project.

Steps:

1. Open your browser (Chrome or Chromium-based browsers recommended).
2. Go to your browser's Manage Extensions page.
3. Enable Developer Mode.
4. Drag the Selenium-IDE.crx file from the src folder of this project into the browser window.

5. Confirm the installation when prompted.

6. Clone the Repository & Install Dependencies: bash git clone https://github.com/Prem-ium/Auto-StockTrader cd Auto-StockTrader pip install -r requirements.txt

7. Configure Environment Variables (.env):
   Create a .env file and set up your environment variables following the formats outlined in the Environmental Variables section.

8. Run the Python Script: bash python main.py

9. Pass a stock ticker as an argument to update all .side files: bash python main.py AAPL

10. Separate multiple tickers with a comma: bash python main.py NVDA,TSLA,AAPL

11. Open Updated .side Files:

12. Open the updated .side project files in Selenium IDE.

13. Execute Desired Automation within Selenium IDE:

14. Log in to your brokerage account.
15. Begin running your desired automation tasks in either the buy or sell test tabs.

---

Donations ❤️

I've been diligently working on this project for several months, and I'm thrilled with the progress it has made. Based on user testimonials, it has proven to be an invaluable tool for automating stock ticker orders across multiple brokerage accounts and various brokerages. I am continually striving to enhance its functionality and optimize its efficiency for automated order execution.

If you appreciate my work and would like to show your support, there are two convenient ways to make a donation:

1. GitHub Sponsors
2. Donate via GitHub Sponsors
3. Preferred because this donation method is fee-free and offers perks for your contribution.

4. 

5. Buy Me A Coffee

6. Donate via Buy Me A Coffee
7. 
8. Referral Links
9. If you're unable to make a monetary donation, you can still support my work by using my curated Referral Links. Earn bonuses and rewards while contributing to my projects at the same time.
10. Explore Referral Links

Your generous donations will go a long way in helping me cover the expenses associated with developing new features and promoting the project to a wider audience. I extend my heartfelt gratitude to all those who have already contributed. Thank you for your support!

---

Experiencing Issues? 🛠️

I'm not available to respond to issues in this repository. For direct support, please consider sponsoring me below under the Silver or Gold tier. Keep in mind that the public version is mostly "as built" and is rarely updated, while the private Gold Sponsor version receives regular updates and support.

---

Pull Request Requirements 📋

To ensure a smooth review process, please follow these guidelines when submitting a pull request (PR):

1. Title: Provide a clear and concise title.
2. Description: Include a detailed description of changes, problems addressed, and any relevant context.
3. Documentation: If necessary, update comments, README, requirements, and any relevant documentation.
4. License Compliance: Ensure any changes made in forks uphold the repository's license. Do not make changes to certain areas such as the FUNDING.yml or any present copyright information without approval.

Once you have verified that your changes adhere to these guidelines, please open a pull request with your changes and click 'Request Review' on the Pull Request.

By adhering to these gu