{"id":13700947,"url":"https://github.com/miaolz123/samaritan","last_synced_at":"2025-05-04T19:34:02.292Z","repository":{"id":55835468,"uuid":"59938473","full_name":"miaolz123/samaritan","owner":"miaolz123","description":"An Algorithmic Trading Framework for Digital Currency.","archived":true,"fork":false,"pushed_at":"2017-07-26T14:57:27.000Z","size":2292,"stargazers_count":589,"open_issues_count":20,"forks_count":193,"subscribers_count":59,"default_branch":"master","last_synced_at":"2024-08-03T20:10:36.521Z","etag":null,"topics":["algorithmic-trading-engine","bitcoin","trading-bot"],"latest_commit_sha":null,"homepage":"http://samaritan.stockdb.org","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/miaolz123.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-29T10:52:58.000Z","updated_at":"2024-07-24T10:29:50.000Z","dependencies_parsed_at":"2022-08-15T07:40:22.468Z","dependency_job_id":null,"html_url":"https://github.com/miaolz123/samaritan","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaolz123%2Fsamaritan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaolz123%2Fsamaritan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaolz123%2Fsamaritan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaolz123%2Fsamaritan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miaolz123","download_url":"https://codeload.github.com/miaolz123/samaritan/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224406065,"owners_count":17305718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["algorithmic-trading-engine","bitcoin","trading-bot"],"created_at":"2024-08-02T20:01:10.536Z","updated_at":"2024-11-13T06:31:38.568Z","avatar_url":"https://github.com/miaolz123.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Samaritan\n\n[![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\u0026utm_medium=link\u0026utm_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)\n\n[中文文档](http://samaritan.stockdb.org/#/zh-cn)\n\n## Installation\n\nYou can install samaritan from **installation package** or **Docker**.\n\nThe default username and password are `admin`, please modify them immediately after login!\n\n### From installation package\n\n1. Download the samaritan installation package on [this page](https://github.com/miaolz123/samaritan/releases)\n2. Unzip the samaritan installation package\n3. Enter the extracted samaritan installation directory\n4. Run `samaritan`\n\nThen, samaritan is running at `http://localhost:9876`.\n\n**Linux \u0026 Mac user quick start command**\n\n```shell\nwget https://github.com/miaolz123/samaritan/releases/download/v{{VERSION}}/samaritan_{{OS}}_{{ARCH}}.tar.gz\ntar -xzvf samaritan_{{OS}}_{{ARCH}}.tar.gz\ncd samaritan_{{OS}}_{{ARCH}}\n./samaritan\n```\n\nPlease replace *{{VERSION}}*, *{{OS}}*, *{{ARCH}}* first.\n\n### From Docker\n\n```shell\ndocker run --name=samaritan -p 19876:9876 miaolz123/samaritan\n```\n\nThen, samaritan is running at `http://localhost:19876`.\n\n## Supported exchanges\n\n| Exchange | Stock |\n| -------- | ----- |\n| okcoin.cn | `BTC/CNY`, `LTC/CNY` |\n| huobi | `BTC/CNY`, `LTC/CNY` |\n| poloniex | `ETH/BTC`, `XMR/BTC`, `BTC/USDT`, `LTC/BTC`, `ETC/BTC`, `XRP/BTC`, `ETH/USDT`, `ETC/ETH`, ... |\n| btcc | `BTC/CNY`, `LTC/CNY`, `LTC/BTC` |\n| chbtc | `BTC/CNY`, `LTC/CNY`, `ETH/CNY`, `ETC/CNY` |\n| okcoin.future | `BTC.WEEK/USD`, `BTC.WEEK2/USD`, `BTC.MONTH3/USD`, `LTC.WEEK/USD`, ... |\n| oanda.v20 | coming soon ...... |\n\n## Usage\n\n### Add an Exchange\n\n![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/add-exchange.png)\n\n### Add an Algorithm\n\n![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/add-algorithm.png)\n\n![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/edit-algorithm.png)\n\n### Deploy an Algorithm\n\n![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/add-trader.png)\n\n### Run a Trader\n\n![](https://raw.githubusercontent.com/miaolz123/samaritan/master/docs/_media/run-trader.png)\n\n## Algorithm Reference\n\n[Read Documentation](http://samaritan.stockdb.org/#/#algorithm-reference)\n\n## Contributing\n\nContributions are not accepted in principle until the basic infrastructure is complete.\n\nHowever, the [ISSUE](https://github.com/miaolz123/samaritan/issues) is welcome.\n\n## License\n\nCopyright (c) 2016 [miaolz123](https://github.com/miaolz123) by MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiaolz123%2Fsamaritan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiaolz123%2Fsamaritan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiaolz123%2Fsamaritan/lists"}