Files
gocryptotrader/docs/EXCHANGE_API.md
Adrian Gallagher 051675255d CI: Add support for GitHub actions (#680)
* Add initial workflows config

* Add PSQL service

* Add 32bit and frontend jobs

* Add gcc-multilib and fix typo

* Fix backtester test for linux/unix filesystem errors and npm commands

* 32-bit Add -race to purposefully throw an error to ensure envs are set correctly (will revert)

* Revert "32-bit Add -race to purposefully throw an error to ensure envs are set correctly (will revert)"

This reverts commit b97e66c49fca859f8738e01107f96f9ca4040b2e.

* Bump workers count for orderbook processing

* Remove comments to trigger 32-bit cache hit after job success

* Cancel addition plus version bump, spawn more overlords

* Update build badge to Github Actions

* Brach -> Branch
2021-05-06 14:35:05 +10:00

3.4 KiB

GoCryptoTrader Unified API

Build Status Software License GoDoc Coverage Status Go Report Card

A cryptocurrency trading bot supporting multiple exchanges written in Golang.

Please note that this bot is under development and is not ready for production!

Community

Join our slack to discuss all things related to GoCryptoTrader! GoCryptoTrader Slack

Unified API

GoCryptoTrader supports a unified API for dealing with exchanges. Each exchange has its own wrapper file which maps the exchanges own RESTful endpoints into a standardised way for bot and standalone application usage.

A full breakdown of all the supported wrapper funcs can be found here. Please note that these change on a regular basis as GoCryptoTrader is undergoing rapid development.

Each exchange supports public API endpoints which don't require any authentication (fetching ticker, orderbook, trade data) and also private API endpoints (which require authentication). Some examples include submitting, cancelling and fetching open orders). To use the authenticated API endpoints, you'll need to set your API credentials in either the config.json file or when you initialise an exchange in your application, and also have the appropriate key permissions set for the exchange. Each exchange has a credentials validator which ensures that the API credentials supplied meet the requirements to make an authenticated request.

Public API Ticker Example

    var b bitstamp.Bitstamp
    b.SetDefaults()
    ticker, err := b.FetchTicker(currency.NewPair(currency.BTC, currency.USD), asset.Spot)
    if err != nil {
        // Handle error
    }
    fmt.Println(ticker.Last)

Private API Submit Order Example

    var b bitstamp.Bitstamp
    b.SetDefaults()

    b.API.Credentials.Key = "your_key"
    b.API.Credentials.Secret = "your_secret"
    b.API.Credentials.ClientID = "your_clientid"

    o := &order.Submit{
        Pair:      currency.NewPair(currency.BTC, currency.USD),
        OrderSide: order.Sell,
        OrderType: order.Limit,
        Price:     1000000,
        Amount:    0.1,
        AssetType: asset.Spot,
    }
    resp, err := b.SubmitOrder(o)
    if err != nil {
        // Handle error
    }
    fmt.Println(resp.OrderID)