The OANDA v20 REST API provides programmatic access to OANDA's next generation v20 trading engine.
Install using pip:
pip install v20
If you don't wish to use pip:
git clone https://github.com/oanda/v20-python.git
For documentation, usage and examples, see: http://developer.oanda.com/rest-live-v20/introduction
Each REST V20 endpoint in the documentation maps to a Context object
property which then has get() and list() methods used to get a list of objects (ie. /v3/accounts) or a single
object (ie /v3/accounts/{accountId}).
import v20
# To use the v20 API, we start by creating a `Context` which first establishes what REST URL to use (ie Practice vs Prod)
ctx = v20.Context(OANDA_REST_URL, 443, ssl=True)
# Use your API Personal Access Token by setting it to our `Context` token
ctx.set_token(OANDA_API_KEY) See what accounts we have available to interact with. Notice that our account methods (like list, get, summary)
return Response objects which have to be drilled down into with their body property which is a dict with
keys matching what you see in the "HTTP 200" response documentation for the account endpoints:
Furthermore, the dict or list values are objects with dot-notation accessible properties matching the object type. For example, the list of AccountProperties objects has these properties
account_id = ctx.account.list().body['accounts'][0].id
# Now that we have an account_id, get the account summary.
account_summary = ctx.account.summary(account_id).body['account']We can access some properties matching documentation of an AccountSummary object
print account_summary.alias
print account_summary.balance