Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/miaolz123/samaritan

An Algorithmic Trading Framework for Digital Currency.
https://github.com/miaolz123/samaritan

algorithmic-trading-engine bitcoin trading-bot

Last synced: 3 months ago
JSON representation

An Algorithmic Trading Framework for Digital Currency.

Host: GitHub
URL: https://github.com/miaolz123/samaritan
Owner: miaolz123
License: mit
Archived: true
Created: 2016-05-29T10:52:58.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2017-07-26T14:57:27.000Z (over 7 years ago)
Last Synced: 2024-08-03T20:10:36.521Z (6 months ago)
Topics: algorithmic-trading-engine, bitcoin, trading-bot
Language: Go
Homepage: http://samaritan.stockdb.org
Size: 2.19 MB
Stars: 589
Watchers: 59
Forks: 193
Open Issues: 20
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Samaritan

[![Travis](https://img.shields.io/travis/miaolz123/samaritan.svg)](https://travis-ci.org/miaolz123/samaritan) [![Go Report Card](https://goreportcard.com/badge/github.com/miaolz123/samaritan)](https://goreportcard.com/report/github.com/miaolz123/samaritan) [![Github All Releases](https://img.shields.io/github/downloads/miaolz123/samaritan/total.svg)](https://github.com/miaolz123/samaritan/releases) [![Gitter](https://img.shields.io/gitter/room/miaolz123/samaritan.svg)](https://gitter.im/miaolz123-samaritan/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link) [![Docker Pulls](https://img.shields.io/docker/pulls/miaolz123/samaritan.svg)](https://hub.docker.com/r/miaolz123/samaritan/) [![license](https://img.shields.io/github/license/miaolz123/samaritan.svg)](https://github.com/miaolz123/samaritan/blob/master/LICENSE)

[中文文档](http://samaritan.stockdb.org/#/zh-cn)

## Installation

You can install samaritan from **installation package** or **Docker**.

The default username and password are `admin`, please modify them immediately after login!

### From installation package

1. Download the samaritan installation package on [this page](https://github.com/miaolz123/samaritan/releases)

2. Unzip the samaritan installation package

3. Enter the extracted samaritan installation directory

4. Run `samaritan`

Then, samaritan is running at `http://localhost:9876`.

**Linux & Mac user quick start command**

```shell

wget https://github.com/miaolz123/samaritan/releases/download/v{{VERSION}}/samaritan_{{OS}}_{{ARCH}}.tar.gz

tar -xzvf samaritan_{{OS}}_{{ARCH}}.tar.gz

cd samaritan_{{OS}}_{{ARCH}}

./samaritan

```

Please replace *{{VERSION}}*, *{{OS}}*, *{{ARCH}}* first.

### From Docker

```shell

docker run --name=samaritan -p 19876:9876 miaolz123/samaritan

```

Then, samaritan is running at `http://localhost:19876`.

## Supported exchanges

| Exchange | Stock |

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

| okcoin.cn | `BTC/CNY`, `LTC/CNY` |

| huobi | `BTC/CNY`, `LTC/CNY` |

| poloniex | `ETH/BTC`, `XMR/BTC`, `BTC/USDT`, `LTC/BTC`, `ETC/BTC`, `XRP/BTC`, `ETH/USDT`, `ETC/ETH`, ... |

| btcc | `BTC/CNY`, `LTC/CNY`, `LTC/BTC` |

| chbtc | `BTC/CNY`, `LTC/CNY`, `ETH/CNY`, `ETC/CNY` |

| okcoin.future | `BTC.WEEK/USD`, `BTC.WEEK2/USD`, `BTC.MONTH3/USD`, `LTC.WEEK/USD`, ... |

| oanda.v20 | coming soon ...... |

## Usage

### Add an Exchange

![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/add-exchange.png)

### Add an Algorithm

![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/add-algorithm.png)

![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/edit-algorithm.png)

### Deploy an Algorithm

![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/add-trader.png)

### Run a Trader

![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/run-trader.png)

## Algorithm Reference

[Read Documentation](http://samaritan.stockdb.org/#/#algorithm-reference)

## Contributing

Contributions are not accepted in principle until the basic infrastructure is complete.

However, the [ISSUE](https://github.com/miaolz123/samaritan/issues) is welcome.

## License

Copyright (c) 2016 [miaolz123](https://github.com/miaolz123) by MIT