OVERVIEW

OANDAPY is a python3 wrapper for Oanda’s REST API v20. This library currently implements the features released under version 3.0.1 of OANDA’s REST API.

Head over to OANDA’s REST API v20 docs to go through their documentation. This repository start on fork from Gustavo Ferreira and have a massive change later

Requirements

This project requires:

• Python 3.4 or earlier

• git client

• virtualenvwrapper/virtualenv for local development

Installation

$ pip install oandapy

Or, you can download the source and

$ git clone git@github.com:rhenter/oandapy.git
$ cd oandapy
$ python setup.py install

USAGE

1. Create a account on https://www.oanda.com to get a API Access Token.

2. Import the oandapy module and create an instance with your access token:

>> from oandapy import APIv20
>> from oandapy.exceptions import OandaError
>>
>> access_token = "<OANDA Access token>"
>> oanda = APIv20(environment="practice", access_token=access_token)

>> try:
>>     result = con.account.get_accounts()
>> # In case of http status 400
>> except OandaError as exc:
>>     print(str(exc))
>>
>> # Use the result as object
>> print(result.as_obj())
MyModel(accounts=[NamelessModel(tags=[], id='000-000-0000000-000')])
>>
>> # Use the result as dict
>> print(result.as_dict())
{'accounts': [{'id': '000-000-0000000-000', 'tags': []}]}

Contributing

Please send pull requests, very much appreciated.

1. Fork the repository on GitHub.

2. Create a virtualenv.

3. Install requirements. pip install -r requirements-dev.txt

4. Install pre-commit. pre-commit install

5. Make a branch off of master and commit your changes to it.

6. Create a Pull Request with your contribution

NOTES

• Oanda API REST-v20 is still under development, some functionality have not yet been implemented (Pricing History, Forex Labs), but I will keep an eye on it, and as soon as it gets implemented I will update this library accordingly.

• DO NOT USE THIS LIBRARY ON PRODUCTION! It is under heavy development and still lacks testing suites. It is also partially documented.

• Use this library at your own risk.

• Happy hunting on the markets!!

Changelog

0.0.9

• Update url on setup.py

0.0.8

• Update Sphinx doc

• Update docstrings (its not ok yet)

0.0.7

• Changes to Pypi view

0.0.6

• Refactor: Move FactoryResponse to Core API and fix tests

0.0.5

• Update Readme file to get simple examples

0.0.4

• Change Setup data

0.0.3

• Add Travis and Coveralls support

• Remove Enum feature

0.0.2

• Update readme fixing typos and changing the introduction

0.0.1 (2018-12-06)

• initial release using changes file