Caution
This project is no longer maintained as Trading212 has implemented a lot of breaking changes to their platform diverging from the original design which this repo is based on. The project is left here for reference purposes only.
TradingTOT provides a Python-based solution for automating trading activities on Trading212. It leverages Selenium for web scraping and automation to interact with the trading platform, offering functionalities such as login automation and trade execution. While traders can use the Trading212 platform through the browser, this tool makes it possible to execute trades programmatically.
- An installed web browser. Only Chrome, Microsoft Edge and Safari are supported.
- Python
- Poetry
- Clone the repository to your local machine:
git clone https://github.com/HAKSOAT/tradingTOT.git - Install the required dependencies:
cd tradingTOT poetry install
To use this project, you need to configure your trading account credentials and set up environment variables for browser automation.
You need to set the following environment variables:
- TRADINGTOT_EMAIL
- TRADINGTOT_PASSWORD
- TRADINGTOT_ENVIRONMENT
TRADINGTOT_ENVIRONMENT can be live or demo.
You can also set the environment variables above in a local.env file.
This file should be located in the same directory as the tradingTOT directory i.e. the one containing the pyproject.toml file, NOT the one that is src/tradingTOT.
from tradingTOT import tradingTOT
from tradingTOT.enums import OrderType
tot = tradingTOT()
ticker = "MSFT"
equity_value_usd = 50
tot.get_account_details() # The first operation takes time if log in has never happened on this machine, or the existing token has expired.
# {'cash': 50.0, 'total': 56.05}
tot.get_equity_data(ticker) # Get information about an equity
# {
# 'category': 'EQUITY',
# 'shortName': 'MSFT',
# 'name': 'Microsoft',
# 'currencyCode': 'USD',
# 'workingScheduleId': 71,
# 'exchangeCountryCode': 'US',
# 'uiType': 'STOCK',
# ...
# }
tot.get_ask_price(ticker) # Get the ask price for an equity
# {'timestamp': 1708093800000, 'price': 406.56, 'period': 'd1'}
tot.get_costs() # Getting the cost of placing an order.
# {'orderQuantity': 0.1557,
# 'sharesValue': 49.93,
# 'total': 50.0,
# 'exchangeRate': {'fromCurrency': 'USD', 'toCurrency': 'GBP', 'rate': 0.79348},
# 'costs': {'CURRENCY_CONVERSION_FEE': 0.07}}
response = tot.place_order(OrderType.BUY, ticker, equity_value_usd) # Place a buy order. Use OrderType.SELL for selling.
tot.get_status(response["orderId"]) # Get status of placed order.
# {'status': <OrderStatus.SUBMITTED: 'SUBMITTED'>}
tot.cancel_order(response["orderId"])The package will handle the finding the path of the web browser provided you have Chrome, Microsoft Edge or Safari installed.
However, sometimes this may fail with a FileNotFoundError.
In such cases, you can set the environment variable BINARY_PATH. To do this, you need to know what the binary path is.
For example, the binary path may be the following:
On Windows: C:\Program Files\Google\Chrome\Application\chrome.exe
On Linux: /usr/bin/google-chrome
On MacOS: /Applications/Google Chrome.app
You do not have to worry about the webdriver as Selenium 4 handles driver downloads itself.
- Trading 212 API for TypeScript for Node.js use cases.
This project is not officially affiliated with Trading212 or any other trading platform. It is developed as an independent tool to assist users in automating their trading strategies. Use at your own risk and discretion.