<a name="readme-top"></a>
<p align="center">
<a href="https://kieran-mackle.github.io/AutoTrader/">
<img src="https://user-images.githubusercontent.com/60687606/132320916-23445f43-dfdc-4949-9881-e18f622605d2.png" alt="AutoTrader Logo" width="15%" >
</a>
</p>
<h1 align="center">AutoTrader</h1>
<p align="center">
<a href="https://pypi.org/project/autotrader">
<img src="https://img.shields.io/pypi/v/autotrader.svg?color=blue&style=plastic" alt="Latest version" width=95 height=20>
</a>
<a href="https://pepy.tech/project/autotrader">
<img src="https://pepy.tech/badge/autotrader" alt="Total downloads" >
</a>
<a href="https://pepy.tech/project/autotrader">
<img src="https://pepy.tech/badge/autotrader/month" alt="Monthly downloads" >
</a>
<a href='https://autotrader.readthedocs.io/en/latest/?badge=latest'>
<img src='https://readthedocs.org/projects/autotrader/badge/?version=latest' alt='Documentation Status' />
</a>
<a href="https://github.com/psf/black">
<img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg">
</a>
</p>
AutoTrader is Python-based platform intended to help in the development, optimisation and deployment of automated trading systems.
A basic level of experience with Python is recommended for using AutoTrader, but the [docs](https://autotrader.readthedocs.io/en/latest/)
aim to make using it as easy as possible with detailed tutorials and documentation.
## Latest News
- [CryptoBots](https://github.com/kieran-mackle/cryptobots) has been released along with version `1.0.0`, offering ready-to-trade crypto strategies from the command line
- Version 0.7 has been released, adding integrations with [CCXT](https://github.com/ccxt/ccxt) crypto exchanges. Many more powerful upgrades too.
- AutoTrader has been featured in GitClone's recent article, [*Top Crypto Trader Open-Source Projects on Github*](https://gitclone.dev/top-crypto-trader-open-source-projects-on-github/).
## Features
- A feature-rich trading simulator, supporting [backtesting](https://autotrader.readthedocs.io/en/latest/features/backtesting.html) and
papertrading. The 'virtual broker' allows you to test your strategies in a risk-free, simulated environment before going live. Capable
of simulating multiple order types, stop-losses and take-profits, cross-exchange arbitrage and portfolio strategies, AutoTrader has
more than enough to build a profitable trading system.
- [Integrated data feeds](https://kieran-mackle.github.io/AutoTrader/tutorials/price-data), making OHLC data retrieval as easy as possible.
- [Automated interactive visualisation](https://autotrader.readthedocs.io/en/latest/features/visualisation.html) using [Bokeh](https://bokeh.org/)
- [Library of custom indicators](https://autotrader.readthedocs.io/en/latest/indicators.html).
- [Live trading](https://autotrader.readthedocs.io/en/latest/features/live-trading.html) supported for multiple venues.
- [Detailed documenation and tutorials](https://autotrader.readthedocs.io/en/latest/index.html)
- [Repository](https://github.com/kieran-mackle/autotrader-demo) of example strategies
<p align="right">[<a href="#readme-top">back to top</a>]</p>
## Supported Brokers and Exchanges
| Broker | Asset classes | Integration status |
| -------- | ------------- | ------------------ |
| [Oanda](https://www.oanda.com/) | Forex CFDs | Complete |
| [Interactive Brokers](https://www.interactivebrokers.com/en/home.php) | Many | In progress |
| [CCXT](https://github.com/ccxt/ccxt) | Cryptocurrencies | In progress |
<p align="right">[<a href="#readme-top">back to top</a>]</p>
## Installation
AutoTrader can be installed using pip:
```
pip install autotrader
```
### Updating
AutoTrader can be updated by appending the `--upgrade` flag to the install command:
```
pip install autotrader --upgrade
```
<p align="right">[<a href="#readme-top">back to top</a>]</p>
## Documentation
AutoTrader is very well documented in-code and on [Read the Docs](https://autotrader.readthedocs.io/en/latest/). There is also a [detailed walthrough](https://autotrader.readthedocs.io/en/latest/tutorials/walkthrough.html), covering everything from strategy concept to livetrading.
### Example Strategies
Example strategies can be found in the [demo repository](https://github.com/kieran-mackle/autotrader-demo).
<p align="right">[<a href="#readme-top">back to top</a>]</p>
## Backtest Demo
The chart below is produced by a backtest of the MACD trend strategy documented in the
[tutorials](https://autotrader.readthedocs.io/en/latest/tutorials/building-strategy.html) (and available in the
[demo repository](https://github.com/kieran-mackle/autotrader-demo)). Entry signals are defined by MACD crossovers, with exit targets defined
by a 1.5 risk-to-reward ratio. Stop-losses are automatically placed using the custom
[swing detection](https://autotrader.readthedocs.io/en/latest/indicators.html#swing-detection) indicator, and position sizes are dynamically calculated based
on risk percentages defined in the strategy configuration.
Running this strategy with AutoTrader in backtest mode will produce the following interactive chart.
[](https://autotrader.readthedocs.io/en/latest/tutorials/backtesting.html#interactive-chart)
Note that stop loss and take profit levels are shown for each trade taken. This allows you to see how effective your exit strategy is - are you being stopped out too
early by placing your stop losses too tight? Are you missing out on otherwise profitable trades becuase your take profits are too far away? AutoTrader helps you
visualise your strategy and answer these questions.
<p align="right">[<a href="#readme-top">back to top</a>]</p>
## Contributing
To contribute to `autotrader`, please read the instructions below,
and stick to the styling of the code.
### Setting up for Development
1. Create a new Python virtual environment to isolate the package. You
can do so using [`venv`](https://docs.python.org/3/library/venv.html) or
[anaconda](https://www.anaconda.com/).
2. Install the code in editable mode using the command below (run from
inside the `autotrader` root directory). Also install all dependencies
using the `[all]` command, which includes the developer dependencies.
```
pip install -e .[all]
```
3. Install the [pre-commit](https://pre-commit.com/) hooks.
```
pre-commit install
```
4. Start developing! After following the steps above, you are ready
to start developing the code. Make sure to follow the guidelines
below.
### Developing AutoTrader
- Fork the repository and clone to your local machine for development.
- Run [black](https://black.readthedocs.io/en/stable/index.html) on any
code you modify. This formats it according to
[PEP8](https://peps.python.org/pep-0008/) standards.
- Document as you go: use
[numpy style](https://numpydoc.readthedocs.io/en/latest/format.html)
docstrings, and add to the docs where relevant.
- Write unit tests for the code you add, and include them in `tests/`.
This project uses [pytest](https://docs.pytest.org/en/7.2.x/).
- Commit code regularly to avoid large commits with many changes.
- Write meaningful commit messages, following the
[Conventional Commits standard](https://www.conventionalcommits.org/en/v1.0.0/).
The python package [commitizen](https://commitizen-tools.github.io/commitizen/)
is a great tool to help with this, and is already configured for this
repo. Simply stage changed code, then use the `cz c` command to make a
commit.
- Open a [Pull Request](https://github.com/kieran-mackle/autoTrader/pulls)
when your code is complete and ready to be merged.
### Building the Docs
To build the documentation, run the commands below.
```
cd docs/
make html
xdg-open build/html/index.html
```
If you are actively developing the docs, consider using
[sphinx-autobuild](https://pypi.org/project/sphinx-autobuild/).
This will continuosly update the docs for you to see any changes
live, rather than re-building repeatadly. From the `docs/`
directory, run the following command:
```
sphinx-autobuild source/ build/html --open-browser
```
<p align="right">[<a href="#readme-top">back to top</a>]</p>
## Legal
### License
AutoTrader is licensed under the [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.en.html).
### Disclaimer
Never risk money you cannot afford to lose. Always test your strategies on a paper trading account before taking it live.
<p align="right">[<a href="#readme-top">back to top</a>]</p>
Raw data
{
"_id": null,
"home_page": "https://kieran-mackle.github.io/AutoTrader/",
"name": "autotrader",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "algotrading, finance, crypto, forex, python",
"author": "Kieran Mackle",
"author_email": "kemackle98@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/9a/45/8819b724897138a1f7c9e17e5f4d39fdc86fe879af1039844c57fe0f9526/autotrader-1.1.2.tar.gz",
"platform": null,
"description": "<a name=\"readme-top\"></a>\n\n<p align=\"center\">\n <a href=\"https://kieran-mackle.github.io/AutoTrader/\">\n <img src=\"https://user-images.githubusercontent.com/60687606/132320916-23445f43-dfdc-4949-9881-e18f622605d2.png\" alt=\"AutoTrader Logo\" width=\"15%\" >\n </a>\n</p>\n\n<h1 align=\"center\">AutoTrader</h1>\n\n<p align=\"center\">\n <a href=\"https://pypi.org/project/autotrader\">\n <img src=\"https://img.shields.io/pypi/v/autotrader.svg?color=blue&style=plastic\" alt=\"Latest version\" width=95 height=20>\n </a>\n \n <a href=\"https://pepy.tech/project/autotrader\">\n <img src=\"https://pepy.tech/badge/autotrader\" alt=\"Total downloads\" >\n </a>\n \n <a href=\"https://pepy.tech/project/autotrader\">\n <img src=\"https://pepy.tech/badge/autotrader/month\" alt=\"Monthly downloads\" >\n </a>\n\n <a href='https://autotrader.readthedocs.io/en/latest/?badge=latest'>\n <img src='https://readthedocs.org/projects/autotrader/badge/?version=latest' alt='Documentation Status' />\n </a>\n \n <a href=\"https://github.com/psf/black\">\n <img alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\">\n </a>\n \n</p>\n\n\nAutoTrader is Python-based platform intended to help in the development, optimisation and deployment of automated trading systems. \nA basic level of experience with Python is recommended for using AutoTrader, but the [docs](https://autotrader.readthedocs.io/en/latest/) \naim to make using it as easy as possible with detailed tutorials and documentation.\n\n## Latest News\n- [CryptoBots](https://github.com/kieran-mackle/cryptobots) has been released along with version `1.0.0`, offering ready-to-trade crypto strategies from the command line\n- Version 0.7 has been released, adding integrations with [CCXT](https://github.com/ccxt/ccxt) crypto exchanges. Many more powerful upgrades too.\n- AutoTrader has been featured in GitClone's recent article, [*Top Crypto Trader Open-Source Projects on Github*](https://gitclone.dev/top-crypto-trader-open-source-projects-on-github/).\n\n## Features\n- A feature-rich trading simulator, supporting [backtesting](https://autotrader.readthedocs.io/en/latest/features/backtesting.html) and \npapertrading. The 'virtual broker' allows you to test your strategies in a risk-free, simulated environment before going live. Capable \nof simulating multiple order types, stop-losses and take-profits, cross-exchange arbitrage and portfolio strategies, AutoTrader has \nmore than enough to build a profitable trading system.\n- [Integrated data feeds](https://kieran-mackle.github.io/AutoTrader/tutorials/price-data), making OHLC data retrieval as easy as possible.\n- [Automated interactive visualisation](https://autotrader.readthedocs.io/en/latest/features/visualisation.html) using [Bokeh](https://bokeh.org/)\n- [Library of custom indicators](https://autotrader.readthedocs.io/en/latest/indicators.html).\n- [Live trading](https://autotrader.readthedocs.io/en/latest/features/live-trading.html) supported for multiple venues.\n- [Detailed documenation and tutorials](https://autotrader.readthedocs.io/en/latest/index.html)\n- [Repository](https://github.com/kieran-mackle/autotrader-demo) of example strategies\n\n<p align=\"right\">[<a href=\"#readme-top\">back to top</a>]</p>\n\n\n## Supported Brokers and Exchanges\n\n| Broker | Asset classes | Integration status |\n| -------- | ------------- | ------------------ |\n| [Oanda](https://www.oanda.com/) | Forex CFDs | Complete |\n| [Interactive Brokers](https://www.interactivebrokers.com/en/home.php) | Many | In progress |\n| [CCXT](https://github.com/ccxt/ccxt) | Cryptocurrencies | In progress |\n\n<p align=\"right\">[<a href=\"#readme-top\">back to top</a>]</p>\n\n## Installation\nAutoTrader can be installed using pip:\n```\npip install autotrader\n```\n### Updating\nAutoTrader can be updated by appending the `--upgrade` flag to the install command:\n```\npip install autotrader --upgrade\n```\n\n<p align=\"right\">[<a href=\"#readme-top\">back to top</a>]</p>\n\n## Documentation\nAutoTrader is very well documented in-code and on [Read the Docs](https://autotrader.readthedocs.io/en/latest/). There is also a [detailed walthrough](https://autotrader.readthedocs.io/en/latest/tutorials/walkthrough.html), covering everything from strategy concept to livetrading.\n\n### Example Strategies\nExample strategies can be found in the [demo repository](https://github.com/kieran-mackle/autotrader-demo).\n\n<p align=\"right\">[<a href=\"#readme-top\">back to top</a>]</p>\n\n## Backtest Demo\nThe chart below is produced by a backtest of the MACD trend strategy documented in the \n[tutorials](https://autotrader.readthedocs.io/en/latest/tutorials/building-strategy.html) (and available in the \n[demo repository](https://github.com/kieran-mackle/autotrader-demo)). Entry signals are defined by MACD crossovers, with exit targets defined\nby a 1.5 risk-to-reward ratio. Stop-losses are automatically placed using the custom\n[swing detection](https://autotrader.readthedocs.io/en/latest/indicators.html#swing-detection) indicator, and position sizes are dynamically calculated based \non risk percentages defined in the strategy configuration.\n\nRunning this strategy with AutoTrader in backtest mode will produce the following interactive chart. \n\n[](https://autotrader.readthedocs.io/en/latest/tutorials/backtesting.html#interactive-chart)\n\nNote that stop loss and take profit levels are shown for each trade taken. This allows you to see how effective your exit strategy is - are you being stopped out too \nearly by placing your stop losses too tight? Are you missing out on otherwise profitable trades becuase your take profits are too far away? AutoTrader helps you \nvisualise your strategy and answer these questions.\n\n<p align=\"right\">[<a href=\"#readme-top\">back to top</a>]</p>\n\n\n## Contributing\nTo contribute to `autotrader`, please read the instructions below,\nand stick to the styling of the code.\n\n### Setting up for Development\n\n1. Create a new Python virtual environment to isolate the package. You \ncan do so using [`venv`](https://docs.python.org/3/library/venv.html) or\n[anaconda](https://www.anaconda.com/).\n\n2. Install the code in editable mode using the command below (run from\ninside the `autotrader` root directory). Also install all dependencies \nusing the `[all]` command, which includes the developer dependencies.\n\n```\npip install -e .[all]\n```\n\n3. Install the [pre-commit](https://pre-commit.com/) hooks.\n\n```\npre-commit install\n```\n\n4. Start developing! After following the steps above, you are ready\nto start developing the code. Make sure to follow the guidelines \nbelow.\n\n\n### Developing AutoTrader\n\n- Fork the repository and clone to your local machine for development.\n\n- Run [black](https://black.readthedocs.io/en/stable/index.html) on any\ncode you modify. This formats it according to \n[PEP8](https://peps.python.org/pep-0008/) standards.\n\n- Document as you go: use \n[numpy style](https://numpydoc.readthedocs.io/en/latest/format.html) \ndocstrings, and add to the docs where relevant.\n\n- Write unit tests for the code you add, and include them in `tests/`. \nThis project uses [pytest](https://docs.pytest.org/en/7.2.x/).\n\n- Commit code regularly to avoid large commits with many changes. \n\n- Write meaningful commit messages, following the \n[Conventional Commits standard](https://www.conventionalcommits.org/en/v1.0.0/).\nThe python package [commitizen](https://commitizen-tools.github.io/commitizen/)\nis a great tool to help with this, and is already configured for this\nrepo. Simply stage changed code, then use the `cz c` command to make a \ncommit.\n\n- Open a [Pull Request](https://github.com/kieran-mackle/autoTrader/pulls) \nwhen your code is complete and ready to be merged.\n\n\n### Building the Docs\n\nTo build the documentation, run the commands below. \n\n```\ncd docs/\nmake html\nxdg-open build/html/index.html\n```\n\nIf you are actively developing the docs, consider using\n[sphinx-autobuild](https://pypi.org/project/sphinx-autobuild/).\nThis will continuosly update the docs for you to see any changes\nlive, rather than re-building repeatadly. From the `docs/` \ndirectory, run the following command:\n\n```\nsphinx-autobuild source/ build/html --open-browser\n```\n\n<p align=\"right\">[<a href=\"#readme-top\">back to top</a>]</p>\n\n\n## Legal \n### License\nAutoTrader is licensed under the [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.en.html).\n\n### Disclaimer\nNever risk money you cannot afford to lose. Always test your strategies on a paper trading account before taking it live.\n\n<p align=\"right\">[<a href=\"#readme-top\">back to top</a>]</p>\n",
"bugtrack_url": null,
"license": "gpl-3.0",
"summary": "A Python-based platform for developing, optimising and deploying automated trading systems.",
"version": "1.1.2",
"project_urls": {
"Bug Tracker": "https://github.com/kieran-mackle/AutoTrader/issues",
"Documentation": "https://autotrader.readthedocs.io/en/latest/",
"Homepage": "https://kieran-mackle.github.io/AutoTrader/",
"Source Code": "https://github.com/kieran-mackle/AutoTrader"
},
"split_keywords": [
"algotrading",
" finance",
" crypto",
" forex",
" python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3a7b51c90d976e1625edafe06bf8937b077f91db291469c48f5591cdfc095b5a",
"md5": "89fcc061e836c9c92656f6d7ddbe3b2b",
"sha256": "5cbdb8dea619f1c81fc3c0b95389b639a5e86ae2dea444147241243b0b802de2"
},
"downloads": -1,
"filename": "autotrader-1.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "89fcc061e836c9c92656f6d7ddbe3b2b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 126256,
"upload_time": "2024-03-23T02:41:38",
"upload_time_iso_8601": "2024-03-23T02:41:38.798464Z",
"url": "https://files.pythonhosted.org/packages/3a/7b/51c90d976e1625edafe06bf8937b077f91db291469c48f5591cdfc095b5a/autotrader-1.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9a458819b724897138a1f7c9e17e5f4d39fdc86fe879af1039844c57fe0f9526",
"md5": "1970af2df3fe07b0a18643daded6fc76",
"sha256": "eb1b0e68188cb74c55f73447a72810c039c01d7c5955a1ff0f610c753d760ac9"
},
"downloads": -1,
"filename": "autotrader-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "1970af2df3fe07b0a18643daded6fc76",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 4006565,
"upload_time": "2024-03-23T02:41:41",
"upload_time_iso_8601": "2024-03-23T02:41:41.170770Z",
"url": "https://files.pythonhosted.org/packages/9a/45/8819b724897138a1f7c9e17e5f4d39fdc86fe879af1039844c57fe0f9526/autotrader-1.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-23 02:41:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kieran-mackle",
"github_project": "AutoTrader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": [
[
">=",
"1.20.3"
]
]
},
{
"name": "pandas",
"specs": [
[
">=",
"1.3.4"
]
]
},
{
"name": "art",
"specs": [
[
">=",
"5.7"
]
]
},
{
"name": "PyYAML",
"specs": []
},
{
"name": "bokeh",
"specs": [
[
">=",
"2.3.1"
]
]
},
{
"name": "scipy",
"specs": [
[
">=",
"1.7.1"
]
]
},
{
"name": "finta",
"specs": [
[
">=",
"1.3"
]
]
},
{
"name": "tqdm",
"specs": [
[
">=",
"4.64.0"
]
]
},
{
"name": "importlib-resources",
"specs": []
},
{
"name": "click",
"specs": [
[
">=",
"8.1.3"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.28.1"
]
]
},
{
"name": "python-telegram-bot",
"specs": [
[
">=",
"13.14"
]
]
}
],
"lcname": "autotrader"
}
JSON
