Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/thrasher-corp/gocryptotrader

A cryptocurrency trading bot and framework supporting multiple exchanges written in Golang.
https://github.com/thrasher-corp/gocryptotrader

algorithmic-trading algorithmic-trading-library cryptocurrency cryptocurrency-trading-bot exchange go golang trading-bot trading-framework trading-platform

Last synced: 28 days ago
JSON representation

A cryptocurrency trading bot and framework supporting multiple exchanges written in Golang.

Host: GitHub
URL: https://github.com/thrasher-corp/gocryptotrader
Owner: thrasher-corp
License: mit
Created: 2014-10-28T12:32:15.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2024-05-28T14:44:48.000Z (6 months ago)
Last Synced: 2024-05-28T18:24:54.758Z (6 months ago)
Topics: algorithmic-trading, algorithmic-trading-library, cryptocurrency, cryptocurrency-trading-bot, exchange, go, golang, trading-bot, trading-framework, trading-platform
Language: Go
Homepage:
Size: 53.2 MB
Stars: 2,931
Watchers: 145
Forks: 787
Open Issues: 71
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-golang-repositories - gocryptotrader
awesome-go-quant - gocryptotrader - A cryptocurrency trading bot and framework supporting multiple exchanges written in Golang. (Golang / Trading & Backtesting)

README

        

[![Build Status](https://github.com/thrasher-corp/gocryptotrader/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/thrasher-corp/gocryptotrader/actions/workflows/tests.yml)

[![Software License](https://img.shields.io/badge/License-MIT-orange.svg?style=flat-square)](https://github.com/thrasher-corp/gocryptotrader/blob/master/LICENSE)

[![GoDoc](https://godoc.org/github.com/thrasher-corp/gocryptotrader?status.svg)](https://godoc.org/github.com/thrasher-corp/gocryptotrader)

[![Coverage Status](http://codecov.io/github/thrasher-corp/gocryptotrader/coverage.svg?branch=master)](http://codecov.io/github/thrasher-corp/gocryptotrader?branch=master)

[![Go Report Card](https://goreportcard.com/badge/github.com/thrasher-corp/gocryptotrader)](https://goreportcard.com/report/github.com/thrasher-corp/gocryptotrader)

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](https://join.slack.com/t/gocryptotrader/shared_invite/enQtNTQ5NDAxMjA2Mjc5LTc5ZDE1ZTNiOGM3ZGMyMmY1NTAxYWZhODE0MWM5N2JlZDk1NDU0YTViYzk4NTk3OTRiMDQzNGQ1YTc4YmRlMTk)

## Exchange Support Table

| Exchange | REST API | Streaming API | FIX API |

|----------|------|-----------|-----|

| Alphapoint | Yes  | Yes        | NA  |

| Binance.US| Yes  | Yes        | NA  |

| Binance| Yes  | Yes        | NA  |

| Bitfinex | Yes  | Yes        | NA  |

| Bitflyer | Yes  | No      | NA  |

| Bithumb | Yes  | Yes       | NA  |

| BitMEX | Yes | Yes | NA |

| Bitstamp | Yes  | Yes       | No  |

| BTCMarkets | Yes | Yes       | NA  |

| BTSE | Yes | Yes | NA |

| Bybit | Yes | Yes | NA |

| CoinbasePro | Yes | Yes | No|

| COINUT | Yes | Yes | NA |

| Deribit | Yes | Yes | No |

| Exmo | Yes | NA | NA |

| GateIO | Yes | Yes | NA |

| Gemini | Yes | Yes | No |

| HitBTC | Yes | Yes | No |

| Huobi.Pro | Yes | Yes | NA |

| Kraken | Yes | Yes | NA |

| Kucoin | Yes | Yes | NA |

| Lbank | Yes | No | NA |

| Okx | Yes | Yes | NA |

| Poloniex | Yes | Yes | NA |

| Yobit | Yes | NA | NA |

We are aiming to support the top 30 exchanges sorted by average liquidity as [ranked by CoinMarketCap](https://coinmarketcap.com/rankings/exchanges/). 

However, we welcome pull requests for any exchange which does not match this criterion. If you need help with this, please join us on [Slack](https://join.slack.com/t/gocryptotrader/shared_invite/enQtNTQ5NDAxMjA2Mjc5LTc5ZDE1ZTNiOGM3ZGMyMmY1NTAxYWZhODE0MWM5N2JlZDk1NDU0YTViYzk4NTk3OTRiMDQzNGQ1YTc4YmRlMTk).

** NA means not applicable as the exchange does not support the feature.

## Current Features

+ Support for all exchange fiat and digital currencies, with the ability to individually toggle them on/off.

+ AES256 encrypted config file.

+ REST API support for all exchanges.

+ Websocket support for applicable exchanges.

+ Ability to turn off/on certain exchanges.

+ Communication packages (Slack, SMS via SMSGlobal, Telegram and SMTP).

+ HTTP rate limiter package.

+ Unified API for exchange usage.

+ Customisation of HTTP client features including setting a proxy, user agent and adjusting transport settings.

+ NTP client package.

+ Database support (Postgres and SQLite3). See [database](/database/README.md).

+ OTP generation tool. See [gen otp](/cmd/gen_otp).

+ Connection monitor package.

+ gRPC service and JSON RPC proxy. See [gRPC service](/gctrpc/README.md).

+ gRPC client. See [gctcli](/cmd/gctcli/README.md).

+ Forex currency converter packages (CurrencyConverterAPI, CurrencyLayer, Exchange Rates, Fixer.io, OpenExchangeRates, Exchange Rate Host).

+ Packages for handling currency pairs, tickers and orderbooks.

+ Portfolio management tool; fetches balances from supported exchanges and allows for custom address tracking.

+ Basic event trigger system.

+ OHLCV/Candle retrieval support. See [OHLCV](/docs/OHLCV.md).

+ Scripting support. See [gctscript](/gctscript/README.md).

+ Recent and historic trade processing. See [trades](/exchanges/trade/README.md).

+ Backtesting application. An event-driven backtesting tool to test and iterate trading strategies using historical or custom data. See [backtester](/backtester/README.md).

+ WebGUI (discontinued).

+ Exchange HTTP mock testing. See [mock](/exchanges/mock/README.md).

+ Exchange multichain deposits and withdrawals for specific exchanges. See [multichain transfer support](/docs/MULTICHAIN_TRANSFER_SUPPORT.md).

## Planned Features

Planned features can be found on our [community Trello page](https://trello.com/b/ZAhMhpOy/gocryptotrader).

## Contribution

Please feel free to submit any pull requests or suggest any desired features to be added.

When submitting a PR, please abide by our coding guidelines:

+ Code must adhere to the official Go [formatting](https://golang.org/doc/effective_go.html#formatting) guidelines (i.e. uses [gofmt](https://golang.org/cmd/gofmt/)).

+ Code must be documented adhering to the official Go [commentary](https://golang.org/doc/effective_go.html#commentary) guidelines.

+ Code must adhere to our [coding style](https://github.com/thrasher-corp/gocryptotrader/blob/master/.github/CONTRIBUTING.md).

+ Pull requests need to be based on and opened against the `master` branch.

## Compiling instructions

Download and install Go from [Go Downloads](https://golang.org/dl/) for your

platform.

### Linux/OSX

GoCryptoTrader is built using [Go Modules](https://github.com/golang/go/wiki/Modules) and requires Go 1.11 or above

Using Go Modules you now clone this repository **outside** your GOPATH

```bash

git clone https://github.com/thrasher-corp/gocryptotrader.git

cd gocryptotrader

go build

mkdir ~/.gocryptotrader

cp config_example.json ~/.gocryptotrader/config.json

```

### Windows

```bash

git clone https://github.com/thrasher-corp/gocryptotrader.git

cd gocryptotrader

go build

copy config_example.json %APPDATA%\GoCryptoTrader\config.json

```

+ Make any necessary changes to the `config.json` file.

+ Run the `gocryptotrader` binary file inside your GOPATH bin folder.

## Donations



If this framework helped you in any way, or you would like to support the developers working on it, please donate Bitcoin to:

***bc1qk0jareu4jytc0cfrhr5wgshsq8282awpavfahc***

## Binaries

Binaries will be published once the codebase reaches a stable condition.

## Contributor List

### A very special thank you to all who have contributed to this program:

|User|Contribution Amount|

|--|--|

| [thrasher-](https://github.com/thrasher-) | 692 |

| [shazbert](https://github.com/shazbert) | 333 |

| [dependabot[bot]](https://github.com/apps/dependabot) | 293 |

| [gloriousCode](https://github.com/gloriousCode) | 234 |

| [dependabot-preview[bot]](https://github.com/apps/dependabot-preview) | 88 |

| [gbjk](https://github.com/gbjk) | 80 |

| [xtda](https://github.com/xtda) | 47 |

| [lrascao](https://github.com/lrascao) | 27 |

| [Beadko](https://github.com/Beadko) | 17 |

| [Rots](https://github.com/Rots) | 15 |

| [vazha](https://github.com/vazha) | 15 |

| [ydm](https://github.com/ydm) | 15 |

| [ermalguni](https://github.com/ermalguni) | 14 |

| [MadCozBadd](https://github.com/MadCozBadd) | 13 |

| [vadimzhukck](https://github.com/vadimzhukck) | 10 |

| [samuael](https://github.com/samuael) | 9 |

| [geseq](https://github.com/geseq) | 8 |

| [marcofranssen](https://github.com/marcofranssen) | 8 |

| [140am](https://github.com/140am) | 8 |

| [TaltaM](https://github.com/TaltaM) | 6 |

| [cranktakular](https://github.com/cranktakular) | 6 |

| [dackroyd](https://github.com/dackroyd) | 5 |

| [khcchiu](https://github.com/khcchiu) | 5 |

| [yangrq1018](https://github.com/yangrq1018) | 4 |

| [woshidama323](https://github.com/woshidama323) | 3 |

| [crackcomm](https://github.com/crackcomm) | 3 |

| [mshogin](https://github.com/mshogin) | 2 |

| [herenow](https://github.com/herenow) | 2 |

| [tk42](https://github.com/tk42) | 2 |

| [soxipy](https://github.com/soxipy) | 2 |

| [andreygrehov](https://github.com/andreygrehov) | 2 |

| [azhang](https://github.com/azhang) | 2 |

| [bretep](https://github.com/bretep) | 2 |

| [Christian-Achilli](https://github.com/Christian-Achilli) | 2 |

| [cornelk](https://github.com/cornelk) | 2 |

| [gam-phon](https://github.com/gam-phon) | 2 |

| [herenow](https://github.com/herenow) | 2 |

| [if1live](https://github.com/if1live) | 2 |

| [lozdog245](https://github.com/lozdog245) | 2 |

| [MarkDzulko](https://github.com/MarkDzulko) | 2 |

| [mshogin](https://github.com/mshogin) | 2 |

| [soxipy](https://github.com/soxipy) | 2 |

| [tk42](https://github.com/tk42) | 2 |

| [blombard](https://github.com/blombard) | 1 |

| [cavapoo2](https://github.com/cavapoo2) | 1 |

| [CodeLingoTeam](https://github.com/CodeLingoTeam) | 1 |

| [CodeLingoBot](https://github.com/CodeLingoBot) | 1 |

| [Daanikus](https://github.com/Daanikus) | 1 |

| [daniel-cohen](https://github.com/daniel-cohen) | 1 |

| [DirectX](https://github.com/DirectX) | 1 |

| [frankzougc](https://github.com/frankzougc) | 1 |

| [idoall](https://github.com/idoall) | 1 |

| [Jimexist](https://github.com/Jimexist) | 1 |

| [lookfirst](https://github.com/lookfirst) | 1 |

| [m1kola](https://github.com/m1kola) | 1 |

| [mattkanwisher](https://github.com/mattkanwisher) | 1 |

| [merkeld](https://github.com/merkeld) | 1 |

| [mKurrels](https://github.com/mKurrels) | 1 |

| [starit](https://github.com/starit) | 1 |

| [zeldrinn](https://github.com/zeldrinn) | 1 |