goanda
A Golang wrapper for the OANDA v20 API. Currently OANDA has wrappers for Python, Javascript and Java. Goanda exists to extend upon those languages because of the increasing popularity of Go.
Forked from AwolDes/goanda with some API improvements including improved error handling (breaking changes). Warning: this API is subject to change until v1.0 tag.
Features
Goanda can perform the following actions on your OANDA brokerage accounts:
- Get candlesticks of all instruments
- Create and update orders
- Get data on current and past trades on OANDA
- Close/scale out of trades you have open
- Close positions (not just trades)
- Get data on your account
- NAV
- Current % of used margin
- Balance
- And more!
- Get data on all your transactions
- Get all pricing data (bid/ask spread) on specific instruments
Requirements
- Go v1.14+
Note: This package was created by a third party, and was not created by anyone affiliated with OANDA
Usage
To use this package run go get github.com/colinskow/goanda
then import it into your program and set it up following the snippets below.
Basic Example
I suggest creating a .env
file for your project to keep your secrets safe! Make sure you add a .gitignore file.
~/project/.env
OANDA_API_KEY=
OANDA_ACCOUNT=
~/project/main.go
package main
import (
"log"
"os"
"github.com/colinskow/goanda"
"github.com/davecgh/go-spew/spew"
"github.com/joho/godotenv"
)
func main() {
err := godotenv.Load()
if err != nil {
log.Fatal("Error loading .env file")
}
key := os.Getenv("OANDA_API_KEY")
accountID := os.Getenv("OANDA_ACCOUNT_ID")
oanda := goanda.NewConnection(accountID, key, false)
history, err := oanda.GetCandles("EUR_USD")
goanda.CheckErr(err)
spew.Dump(history)
}
Look at the /examples
directory for more!
Contributing
For now if you'd like to contribute create an Issue and/or submit a PR!
TODO
API (in order of priority)
- Instrument endpoints (to get prices and the order book)
- Order endpoints (to create, get or update orders for an account)
- Trade enpoints (to get information on current trades)
- Position endpoints (to get information on current positions)
- Account endpoints (to get information on the account)
- Transaction endpoints (to get information on account transactions)
- Pricing endpoints (to get pricing of instruments)
- Persistent HTTP connections (as recommended by Oanda)
- Streaming endpoints for Pricing & Transactions
Docs
- Write docs on how to use
goanda
- Write example programs for
goanda
- Write tests for
goanda
Supporting Projects
Thank you to the following projects, they really helped me while I was developing this API
- JSON to Go from @mholt - this tool helped massively with all the structs that needed to be created.
- Spew from @davecgh - this tool was awesome to debug with.
License
This project was created under the MIT license