Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hootnot/oandapyv20-examples

Examples demonstrating the use of oandapyV20 (oanda-api-v20)
https://github.com/hootnot/oandapyv20-examples

finance forex oandapyv20 trading trading-bot v20

Last synced: 9 days ago
JSON representation

Examples demonstrating the use of oandapyV20 (oanda-api-v20)

Host: GitHub
URL: https://github.com/hootnot/oandapyv20-examples
Owner: hootnot
License: mit
Created: 2016-11-28T14:11:39.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2021-01-24T17:25:01.000Z (almost 4 years ago)
Last Synced: 2023-11-07T18:38:29.686Z (about 1 year ago)
Topics: finance, forex, oandapyv20, trading, trading-bot, v20
Language: Python
Homepage:
Size: 251 KB
Stars: 136
Watchers: 21
Forks: 68
Open Issues: 0
Metadata Files:
- Readme: README.rst
- License: LICENSE

Awesome Lists containing this project

README

        oandapyV20 - examples

=====================

This repo contains a number of examples to demonstrate how to

use OANDA's REST-V20 API with the oandapyV20_ Python API-wrapper.

.. _oandapyV20: https://github.com/hootnot/oanda-api-v20

.. _pydantic: https://github.com/samuelcolvin/pydantic

Setup

-----

Install

~~~~~~~

Clone the repository:

.. code-block:: bash

   $ git clone https://github.com/hootnot/oandapyV20-examples

Install *oandapyV20* and other pypi-packages the examples depend on. Maybe

you want to do this from a *virtual environment*.

.. code-block:: bash

   $ pip install -r requirements.txt

Token

~~~~~

Access to the OANDA V20 REST-API requires a token. If you do not have a token

you can obtain one. Check developer.oanda.com_ for details.

Edit the file *token.txt*  and put the token in it.

.. _developer.oanda.com: http://developer.oanda.com

AccountID

~~~~~~~~~

If you have a token, you have an account. Edit the file *account.txt* and

put the **accountID** in it. Verify that it is your **V20** accountID!

**Warning**

~~~~~~~~~~~

   Make sure you have made the setup based on a **practice** account !

   Leveraged trading is high risk. Losses can exceed investment!

Examples

--------

All examples can be run from the cloned repo directory as:

.. code-block:: bash

   $ python src/

.. |CONSOLE_APP| image:: oanda_console.gif

   :width: 500px

=============================  =============

Source                         Description

=============================  =============

**Account**

`src/instruments_list.py`      Get list of tradable instruments for account

**Streams**

`src/streaming_prices.py`      Simple streaming prices using pydantic_ to process records

`src/streaming_trans.py`       Simple streaming transactions

`src/concurrent_streaming.py`  Demonstrate concurrent streaming of prices and events along with the polling of account changes based on gevent greenlets

**Data**

`src/candle-data.py`           Retrieve candle data

**Orders**

`src/market_order.py`          Placing market orders / logging

`src/market_order_request.py`  Placing market orders using contrib.requests / logging

`src/contrib_mo_tp_sl.py`      Placing market order with takeprofit on-fill and stoploss on-fill

**Console**

`src/oanda_console.py`         Console application showing realtime tickdata (Linux/Unix only / python 3 only)

                               |CONSOLE_APP|

**Auto Trading**

`src/simplebot.py`             Simple trading bot based on a moving-average crossover. The bot gets initialized by retrieving the longest MA period of candles. After that new records are fabricated from the stream. When there is a state change an order is placed with a takeprofit and a stoploss order with it. 

                               The positions can be traced with the `src/oanda_console` application.

=============================  =============

About this software

-------------------

The *oanda-api-v20* / *oandapyV20* software is a personal project.

I have no prior or existing relationship with OANDA.

If you have any questions regarding this software, please take a look at

the documentation first:

 * oandapyV20 : http://oanda-api-v20.readthedocs.io/en/latest/?badge=latest

 * OANDA developer docs : http://developer.oanda.com

 * examples : https://github.com/hootnot/oandapyV20-examples

 * Github: https://github.com/hootnot/oanda-api-v20 check the open and closed issues

If you still have questions/issues you can open an *issue* on Gitub: https://github.com/hootnot/oanda-api-v20